Changelog

[0.11.0] - 2022-02-28

Added

Python 3.10 support (added to test suite)

Removed

Python 3.6 support

Changed

Use tomli instead of toml package in in preparation for https://www.python.org/dev/peps/pep-0680/ (tomli is the basis for pythons future builtin toml support)
Updated dependencies

[0.10.0] - 2021-04-17

Changed

Allow settings_files to contain pathlib.Path objects as well as strings.

Removed

Assigning strings to settings_files will no longer coerce strings into lists.

[0.9.0] - 2020-10-13

Added

A "_from_file" key at the root of a file loads the file into the root configuration

Removed

Remove deprecated climatecontrol.Settings (use climatecontrol.Climate instead)
Remove deprecated options implicit_depth and update_on_init.

[0.8.0] - 2019-02-27

Added

Allow "_from_env" postfix in variables and load settings from the specified environment variable (similar to "from_file").
Add "update_log" property which specifies a log of all variables loaded or removed/replaced.
Allow overwriting / merging lists
Allow environment variables to target list indexes (CLIMATECONTROL_SECTION__0__VALUE=testvalue)
Settings proxy object to allow attribute queries (i.e. climatecontrol.settings.a.b[0].c).
Added initial support for dataclasses as extension climatecontrol.ext.dataclasses
Add "from_*_content" processor allowing direct content to be used in variables (can be helpful for environment variables i.e. CLIMATECONTROL_SECTION1_FROM_JSON_CONTENT='{"v1": 1, "v2": 2}').
Add inferred settings files and search for them along the directory structure up to project root (climatecontrol.core.Climate.inferred_settings_files).

Changed

Use fragments as base data structure for building settings map
Add python 3.7 and 3.8 to CI and update development environment config to 3.8
Format using black
Dissallow setting or deleting objects from settings object (to avoid confusion when setting the object does not change the settings object after an update)

Deprecated

Deprecated implicit_depth argument in settings object
Deprecate use of Settings class (use Climate instead, Settings is now an alias of Climate)

Removed

Remove python 3.5 support

[0.7.3] - 2019-01-17

Fixed

Fix update with bad config leaving the object in a broken state ( #15 )

[0.7.2] - 2018-10-04

Fixed

Fix bug where value of "from_file" variable was logged instead of the file.

Added

Support for click 7.0

[0.7.1] - 2018-08-14

Fixed

Logging settings update recursively and do not overwrite unrelated defaults

Removed

Actually remove deprecated max_depth (see 0.7)

[0.7] - 2018-07-28

Removed

Remove deprecated max_depth option for EnvParser/Settings. Use implicit_depth instead.
Removed unneeded (and undocumented) features:
- Filtering (error-prone and undocumented)
- Dynamic preparsers (should now be handled through subclassing)
- Ordering of source loading (should now be handled through subclassing)
- Remove hard dependency on toml (if no serialization libraries like toml or yaml are installed, will fall back to json).
- Remove unneeded logtools module.

Fixed

#13 : Update fragments (separate files) are now preprocessed separately. "from_file" variables can no longer override subsequent file settings.

Added

Add serialization to json and yaml when generating configurations.
Allow "from_file" modules to be parsed recursively (if a from_file setting is set to a json/yaml/toml file, it's contents will be parsed as a settings file instead of a simple string)
Add debug logging which settings attributes were set.

[0.6] - 2018-04-23

Added

#9: Add temporary_changes method to Settings object
#10: Add better logging on setup

[0.5] - 2018-03-13

Changed

splitting behaviour has changed: By default, a double split_char ("__") indicates a new nested settings section. This allows environment variables to look more natural when they are describing nested settings. The option implicit_depth may be used to override this behaviour and have a single "_" indicate a new nested section.
max_depth parameter has been deprecated in favor of implicit_depth