- The Configurator now accepts a dotted name *string* to a package as

  a ``package`` constructor argument. The ``package`` argument was
  previously required to be a package *object* (not a dotted name
  string).

- The ``repoze.bfg.configuration.Configurator.with_package`` method
  was added.  This method returns a new Configurator using the same
  application registry as the configurator object it is called
  upon. The new configurator is created afresh with its ``package``
  constructor argument set to the value passed to ``with_package``.
  This feature will make it easier for future BFG versions to allow
  dotted names as arguments in places where currently only object
  references are allowed (the work to allow dotted names isntead of
  object references everywhere has not yet been done, however).

- The ``repoze.bfg.configuration.Configurator.maybe_dotted`` method
  resolves a Python dotted name string supplied as its ``dotted``
  argument to a global Python object.  If the value cannot be
  resolved, a ``repoze.bfg.configuration.ConfigurationError`` is
  raised.  If the value supplied as ``dotted`` is not a string, the
  value is returned unconditionally without any resolution attempted.

1 files changed, 25 insertions, 0 deletions

diff --git a/CHANGES.txt b/CHANGES.txt
index f5e64f18f..823bc7e38 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -1,6 +1,31 @@
 Next release
 ============
 
+Features
+--------
+
+- The Configurator now accepts a dotted name *string* to a package as
+  a ``package`` constructor argument. The ``package`` argument was
+  previously required to be a package *object* (not a dotted name
+  string).
+
+- The ``repoze.bfg.configuration.Configurator.with_package`` method
+  was added.  This method returns a new Configurator using the same
+  application registry as the configurator object it is called
+  upon. The new configurator is created afresh with its ``package``
+  constructor argument set to the value passed to ``with_package``.
+  This feature will make it easier for future BFG versions to allow
+  dotted names as arguments in places where currently only object
+  references are allowed (the work to allow dotted names isntead of
+  object references everywhere has not yet been done, however).
+
+- The ``repoze.bfg.configuration.Configurator.maybe_dotted`` method
+  resolves a Python dotted name string supplied as its ``dotted``
+  argument to a global Python object.  If the value cannot be
+  resolved, a ``repoze.bfg.configuration.ConfigurationError`` is
+  raised.  If the value supplied as ``dotted`` is not a string, the
+  value is returned unconditionally without any resolution attempted.
+
 Internal
 --------