Changelog#

All notable changes to this project will be documented in this file.

This project adheres to Calendar Versioning with a strict backwards-compatibility policy.

The first number of the version is the year. The second number is incremented with each release, starting at 1 for each year. The third number is when we need to start branches for older releases (only for emergencies).

You shouldn’t ever be afraid to upgrade environ-config if you’re using its public APIs and pay attention to DeprecationWarnings. Whenever there is a need to break compatibility, it is announced here in the changelog and raises a DeprecationWarning for a year (if possible) before it’s finally really broken.

XX.Y.Z (UNRELEASED)#

Backwards-incompatible changes#

none

Deprecations#

none

Changes#

none

22.1.0 (2022-04-02)#

Deprecations:#

  • Python 2.7, 3.5, and 3.6 support has been dropped. environ-config now requires Python 3.7 or later.

Changes:#

  • Lazily init the AWS SecretsManager client to make unit testing easier. #25

21.2.0 (2021-05-17)#

Deprecations:#

  • This is the last release supporting Python versions older than 3.7.

Changes:#

21.1.0 (2021-04-14)#

Backward-incompatible changes:#

none

Deprecations:#

none

Changes:#

  • Fixed environment variables’ names when prefix is empty. #14

  • Added the optional keyword argument to environ.group() #17

  • Added DirectorySecrets secret reader, which can read secrets from a directory of files. Useful for Docker or Kubernetes mounted secrets inside a container. #19

20.1.0 (2020-03-23)#

Backward-incompatible changes:#

none

Deprecations:#

none

Changes:#

  • Configurations can be immutable now. #12

19.1.0 (2019-09-02)#

Backward-incompatible changes:#

  • Changed license from MIT to Apache License 2.

Deprecations:#

none

Changes:#

  • Added AppConfig.from_environ() to instantiate the configuration class. This is an alternative to environ.from_environ(AppConfig). #5

  • Added environ.generate_help(AppConfig) and AppConfig.generate_help() to create a help string based on the configuration.

  • Allow passing customization of the "from_environ" and "generate_help" class methods. #7

  • If environ.var is passed an attr.Factory, the callable is used to generate the default value. #10

18.2.0 (2018-01-12)#

Backward-incompatible changes:#

  • Use RawConfigParser for ini-style secrets to avoid interpolation errors.

Changes:#

none

18.1.0 (2018-01-04)#

Backward-incompatible changes:#

  • convert → converter

Changes:#

  • Fix for attrs 17.4.0.

17.1.0 (2017-12-14)#

Initial release.