add read_configuration_files method to Parameters

It was found that rereading configurations at runtime was not possible
with the current invocation of crumbs.  I've added a small method that
simply rereads all configuration files when invoked.

The version is also updated in this commit and another release is
imminent.

Author: Alex Brandt

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014 Alex Brandt
+Copyright (c) 2015 Alex Brandt
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

crumbs/__init__.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright (C) 2014 by Alex Brandt <[email protected]>
+# Copyright (C) 2015 by Alex Brandt <[email protected]>
 #
 # crumbs is freely distributable under the terms of an MIT-style license.
 # See COPYING or http://www.opensource.org/licenses/mit-license.php.
@@ -93,13 +93,15 @@ class Parameters(object):
 
     **Methods**
 
-    :``__getitem__``:            Return a parameter's value.
-    :``__init__``:               Initialize and return a ``Parameters`` object.
-    :``add_configuration_file``: Add a file path to be searched for parameter
-                                 values.
-    :``add_parameter``:          Add a parameter to ``Parameters`` object.
-    :``parse``:                  Prepare ``Parameters`` for queries and ensure
-                                 parameter values can be found.
+    :``__getitem__``:              Return a parameter's value.
+    :``__init__``:                 Initialize and return a ``Parameters``
+                                   object.
+    :``add_configuration_file``:   Add a file path to be searched for parameter
+                                   values.
+    :``add_parameter``:            Add a parameter to ``Parameters`` object.
+    :``parse``:                    Prepare ``Parameters`` for queries and ensure
+                                   parameter values can be found.
+    :``read_configuration_files``: Read all configuration files' values.
 
     **Properties**
 
@@ -497,3 +499,22 @@ def parse(self, only_known = False):
             self._group_parsers['default'].parse_known_args(args = args, namespace = self._argument_namespace)
         else:
             self._group_parsers['default'].parse_args(namespace = self._argument_namespace)
+
+    def read_configuration_files(self):
+        '''Explicitly read the configuration files.
+
+        Reads all configuration files in this Parameters object.  Even if
+        inotify is watching or a read has already occurred.
+
+        .. note::
+
+           The order that the configuration files are read is not guaranteed.
+
+        '''
+
+        for file_name, configuration_parser in self.configuration_files.items():
+            if os.access(file_name, os.R_OK):
+                configuration_parser.read(file_name)
+            else:
+                logger.warn('could not read %s', file_name)
+                warnings.warn('could not read {}'.format(file_name), ResourceWarning)

crumbs/information.py

@@ -1,14 +1,14 @@
-# Copyright (C) 2014 by Alex Brandt <[email protected]>
+# Copyright (C) 2015 by Alex Brandt <[email protected]>
 #
 # crumbs is freely distributable under the terms of an MIT-style license.
 # See COPYING or http://www.opensource.org/licenses/mit-license.php.
 
 NAME = 'crumbs'
-VERSION = '2.0.2'
+VERSION = '2.1.0'
 DESCRIPTION = 'Generalized all-in-one parameters module.'
 AUTHOR = 'Alex Brandt'
 AUTHOR_EMAIL = '[email protected]'
 URL = 'https://github.com/alunduil/crumbs'
 LICENSE = 'MIT'
 
-COPYRIGHT = '2014'
+COPYRIGHT = '2015'

setup.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright (C) 2014 by Alex Brandt <[email protected]>
+# Copyright (C) 2015 by Alex Brandt <[email protected]>
 #
 # crumbs is freely distributable under the terms of an MIT-style license.
 # See COPYING or http://www.opensource.org/licenses/mit-license.php.

test_crumbs/test_functional.py

@@ -64,6 +64,21 @@ def test_add_configuration_file(self):
 
         self._assert_configuration_readable()
 
+    def test_add_configuration_file_with_explicit_read(self):
+        '''Parameters().add_configuration_file()—re-read'''
+
+        self.p = Parameters()
+
+        self._assert_configuration_readable()
+
+        with open(self.file_name, 'a') as fh:
+            fh.write('bar = foo')
+
+        self.p.read_configuration_files()
+
+        self.assertEqual('bar', self.p['default.foo'])
+        self.assertEqual('foo', self.p['default.bar'])
+
     @unittest.skipUnless(_pyinotify_loaded, 'inotify module not available')
     def test_add_configuration_file_with_inotify(self):
         '''Parameters(inotify = True).add_configuration_file()'''