11# python-configuration
22> A library to load configuration parameters hierarchically from multiple sources and formats
33
4+ [ ![ Hatch project] ( https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg )] ( https://github.com/pypa/hatch )
45[ ![ version] ( https://img.shields.io/pypi/v/python-configuration )] ( https://pypi.org/project/python-configuration/ )
56![ python] ( https://img.shields.io/pypi/pyversions/python-configuration )
67![ wheel] ( https://img.shields.io/pypi/wheel/python-configuration )
@@ -15,20 +16,20 @@ This library is intended as a helper mechanism to load configuration files hiera
1516
1617The ` python-configuration ` library supports the following configuration formats and sources:
1718
18- - Python files: ...
19- - Dictionaries: ...
20- - Environment variables: ...
21- - Filesystem paths: ...
22- - JSON files: ...
23- - INI files: ...
24- - dotenv type files: ...
19+ - Python files
20+ - Dictionaries
21+ - Environment variables
22+ - Filesystem paths
23+ - JSON files
24+ - INI files
25+ - dotenv type files
2526- Optional support for:
2627 - YAML files: requires ` yaml `
27- - TOML files: requires ` toml `
28- - Azure Key Vault credentials: ...
29- - AWS Secrets Manager credentials: ...
30- - GCP Secret Manager credentials: ...
31- - Hashicorp Vault credentials: ...
28+ - TOML files: requires ` tomli ` for Python < 3.11
29+ - Azure Key Vault credentials: requires ` azure-keyvault `
30+ - AWS Secrets Manager credentials: requires ` boto3 `
31+ - GCP Secret Manager credentials: requires ` google-cloud-secret-manager `
32+ - Hashicorp Vault credentials: requires ` hvac `
3233
3334
3435## Installing
@@ -45,8 +46,9 @@ To include the optional TOML and/or YAML loaders, install the optional dependenc
4546pip install python-configuration[toml,yaml]
4647```
4748
48- Without the optional dependencies, the TOML and YAML loaders will not be available,
49+ Without the optional dependencies, the TOML (Python < 3.11) and YAML loaders will not be available,
4950and attempting to use them will raise an exception.
51+
5052## Getting started
5153
5254` python-configuration ` converts the various config types into dictionaries with dotted-based keys. For example, given this JSON configuration
@@ -381,7 +383,7 @@ The `config.contrib` package contains extra implementations of the `Configuratio
381383* Ability to override with environment variables
382384* Merge parameters from different configuration types
383385
384- ## Contributing : tada :
386+ ## Contributing
385387
386388If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are welcome.
387389
0 commit comments