Changes#

3.2.0 (13 Sep 2023)#

Use the standard library’s tomllib module on Python 3.11 and above and switch to tomli for earlier versions.

Thanks to Wim Glenn for the work!

3.1.0 (28 Nov 2022)#

Add support for deleting items and attributes via the ConfigNode interface.

3.0.0 (20 Sep 2022)#

Drop Python 2 support.
get() can now be used without specifying a name to return the value of nodes representing simple attributes.
Explicit support for pathlib.Path objects.

2.6.0 (5 Aug 2020)#

ConfigNode instances can now be merged.
Add support for an optional root in each file when using the “extends” pattern.

2.5.1 (4 Jun 2020)#

Change default false_values for if_supplied() to be a tuple rather a frozenset, fixing a bug that occurred when source data wasn’t hashable.

2.5.0 (1 Jun 2020)#

Move the code for the “Config file that extends another config file” pattern into a helper function in configurator.patterns.load_with_extends().

2.4.0 (31 May 2020)#

Allow the list of values considered false by if_supplied() to be specified.
if_supplied() no longer considers False to be false, as when present, that’s often an explicitly provided value.

2.3.0 (27 May 2020)#

Config instances can now be pickled.

2.2.0 (25 May 2020)#

value() has been added to allow literal values to be used in the left side of mappings passed to Config.merge().

2.1.0 (25 May 2020)#

Configuration values my now be set using attribute or item setting on ConfigNode instances.
node() can be used to obtain or create a ConfigNode from a dotted path and will give you a node even for a value of a dict or item in a list.
ConfigNode instances now have a set() method that can be used to replace the value of that part of the configuration, regardless of whether it is a container, list item or dictionary value.

2.0.0 (15 Apr 2020)#

Performance improvements when import parsers.
Removed the ability to provide new parsers using pkg_resources entry points.

1.3.0 (29 Jan 2020)#

Add Config.from_env() class method to help with extacting large numbers of environment variables into configuration.

1.2.0 (29 May 2019)#

Enable the context manager returned by Config.push() to return the state of a global config object to what it was before push() was called.

1.1.0 (29 May 2019)#

Add support for pushing and popping config data onto a global Config.

1.0.0 (4 Apr 2019)#

Support for optional configuration files in Config.from_path().
Add if_supplied() mapping operation.
Fully documented.

0.5.0 (15 Mar 2019)#

Initial release without docs.