Zconfig

==================

- Made it possible to run unit tests via 'python setup.py test' (requires
setuptools on sys.path).

- Added better error messages to test failure assertions.

================

*A note on the version number:*

Information discovered in the revision control system suggests that some
past revision has been called "2.4", though it is not clear that any
actual release was made with that version number. We're going to skip
revision 2.4 entirely to avoid potential issues with anyone using
something claiming to be ZConfig 2.4, and go straight to version 2.5.

- Add support for importing schema components from ZIP archives (including
eggs).

- Added a 'formatter' configuration option in the logging handler sections
to allow specifying a constructor for the formatter.

- Documented the package: URL scheme that can be used in extending schema.

- Added support for reopening all log files opened via configurations using
the ZConfig.components.logger package. For Zope, this is usable via the
``zc.signalhandler`` package. ``zc.signalhandler`` is not required for
ZConfig.

- Added support for rotating log files internally by size.

- Added a minimal implementation of schema-less parsing; this is mostly
intended for applications that want to read several fragments of ZConfig
configuration files and assemble a combined configuration. Used in some
``zc.buildout`` recipes.

- Converted to using ``zc.buildout`` and the standard test runner from
``zope.testing``.

- Added more tests.

==================

- Isolated some of the case-normalization code so it will at least be
easier to override. This remains non-trivial.

================

- Added "inet-binding-address" and "inet-connection-address" to the
set of standard datatypes. These are similar to the "inet-address"
type, but the default hostname is more sensible. The datatype used
should reflect how the value will be used.

- Alternate rotating logfile handler for Windows, to avoid platform
limitations on renaming open files. Contributed by Sidnei da Silva.

- For <section> and <multisection>, if the name attribute is omitted,
assume name="*", since this is what is used most often.

================

- More documentation has been written.

- Added a timedelta datatype function; the input is the same as for
the time-interval datatype, but the resulting value is a
datetime.timedelta object.

- Make sure keys specified as attributes of the <default> element are
converted by the appropriate key type, and are re-checked for
derived sections.

- Refactored the ZConfig.components.logger schema components so that a
schema can import just one of the "eventlog" or "logger" sections if
desired. This can be helpful to avoid naming conflicts.

- Added a reopen() method to the logger factories.

- Always use an absolute pathname when opening a FileHandler.

- A fix to the logger 'format' key to allow the %(process)d expansion variable
that the logging package supports.

- A new timedelta built-in datatype was added. Similar to time-interval
except that it returns a datetime.timedelta object instead.

================

- Removed compatibility with Python 2.1 and 2.2.

- Schema components must really be in Python packages; the directory
search has been modified to perform an import to locate the package
rather than incorrectly implementing the search algorithm.

- The default objects use for section values now provide a method
getSectionAttributes(); this returns a list of all the attributes of
the section object which store configuration-defined data (including
information derived from the schema).

- Default information can now be included in a schema for <key
name="+"> and <multikey name="+"> by using <default key="...">.

- More documentation has been added to discuss schema extension.

- Support for a Unicode-free Python has been fixed.

- Derived section types now inherit the datatype of the base type if
no datatype is identified explicitly.

- Derived section types can now override the keytype instead of always
inheriting from their base type.

- <import package='...'/> makes use of the current prefix if the
package name begins witha dot.

- Added two standard datatypes: dotted-name and dotted-suffix.

- Added two standard schema components: ZConfig.components.basic and
ZConfig.components.logger.