معرفی شرکت ها
confz-1.7.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
ConfZ is a configuration management library for Python based on pydantic.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | OS Independent |
| نام فایل | confz-1.7.0 |
| نام | confz |
| نسخه کتابخانه | 1.7.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Zühlke |
| ایمیل نویسنده | - |
| آدرس صفحه اصلی | https://github.com/Zuehlke/ConfZ |
| آدرس اینترنتی | https://pypi.org/project/confz/ |
| مجوز | MIT |
# ConfZ – Pydantic Config Management
[](https://github.com/Zuehlke/ConfZ/actions/workflows/test.yml)
[](https://confz.readthedocs.io/en/latest/)
[](https://github.com/Zuehlke/ConfZ/actions/workflows/coverage.yml) <!-- hard-code because can not merge if below 100 -->
[](https://pypi.org/project/confz/)
[](https://pypi.org/project/confz/)
`ConfZ` is a configuration management library for Python based on [pydantic](https://pydantic-docs.helpmanual.io/).
It easily allows you to
* load your configuration from config files, environment variables, command line arguments and more
* transform the loaded data into a desired format and validate it
* access the results as Python dataclass-like objects with full IDE support
It furthermore supports you in common use cases like:
* Multiple environments
* Singleton with lazy loading
* Config changes for unit tests
* Custom config sources
## :package: Installation
`ConfZ` is on [PyPI](https://pypi.org/project/confz/) and can be installed with pip:
```shell
pip install confz
```
## :rocket: Quick Start
The first step of using `ConfZ` is to declare your config classes and sources, for example in `config.py`:
```python
from pathlib import Path
from confz import ConfZ, ConfZFileSource
from pydantic import SecretStr, AnyUrl
class DBConfig(ConfZ):
user: str
password: SecretStr
class APIConfig(ConfZ):
host: AnyUrl
port: int
db: DBConfig
CONFIG_SOURCES = ConfZFileSource(file=Path('/path/to/config.yml'))
```
Thanks to [pydantic](https://pydantic-docs.helpmanual.io/), you can use a wide variety of
[field types](https://pydantic-docs.helpmanual.io/usage/types/) and
[validators](https://pydantic-docs.helpmanual.io/usage/validators/).
From now on, in any other file, you can access your config directly:
```python
from config import APIConfig
print(f"Serving API at {APIConfig().host}, port {APIConfig().port}.")
```
As can be seen, the config does neither have to be loaded explicitly, nor instantiated globally. `ConfZ` automatically
loads your config as defined in `CONFIG_SOURCES` the first time you access it. Thanks to its singleton mechanism, this
happens the first time only, afterwards you get back a cached,
[immutable](https://pydantic-docs.helpmanual.io/usage/models/#faux-immutability) instance, behaving like any other
_pydantic_ instance.
```python
assert APIConfig() is APIConfig() # true because of singleton mechanism
APIConfig().port = 1234 # raises an error because of immutability
APIConfig().json() # call pydantic's method to get a json representation
```
**Note:** While the implicit and hidden loading of your config might be surprising and feel a bit like Python magic at
first, it allows you to reduce a lot of boilerplate. Instead of having to load your config explicitly and then passing
it down to all code layers that need it, you can directly access it from anywhere by just importing your config class
and accessing for example `APIConfig().db.user` directly.
### More Config Sources
`ConfZ` is highly flexible in defining the source of your config. Do you have multiple environments? No Problem:
```python
from pathlib import Path
from confz import ConfZ, ConfZFileSource
class MyConfig(ConfZ):
...
CONFIG_SOURCES = ConfZFileSource(
folder=Path('/path/to/config/folder'),
file_from_env='ENVIRONMENT'
)
```
Your config file can now be defined in the environment variable `ENVIRONMENT` and is relative to `folder`.
You can also provide a list as config source and read for example from environment variables including a .env file and
from command line arguments:
```python
from pathlib import Path
from confz import ConfZ, ConfZEnvSource, ConfZCLArgSource
class MyConfig(ConfZ):
...
CONFIG_SOURCES = [
ConfZEnvSource(allow_all=True, file=Path(".env.local")),
ConfZCLArgSource(prefix='conf_')
]
```
`ConfZ` now tries to populate your config either from environment variables having the same name as your attributes or
by reading command line arguments that start with `conf_`. Recursive models are supported too, for example if you want
to control the user-name in the API above, you can either set the environment variable `DB.USER` or pass the command
line argument `--conf_db.user`.
### Explicit Loading
In some scenarios, the config should not be a global singleton, but loaded explicitly and passed around locally.
Instead of defining `CONFIG_SOURCES` as class variable, the sources can also be defined in the constructor directly:
```python
from pathlib import Path
from confz import ConfZ, ConfZFileSource, ConfZEnvSource
class MyConfig(ConfZ):
number: int
text: str
config1 = MyConfig(config_sources=ConfZFileSource(file=Path('/path/to/config.yml')))
config2 = MyConfig(config_sources=ConfZEnvSource(prefix='CONF_', allow=['text']), number=1)
config3 = MyConfig(number=1, text='hello world')
```
As can be seen, additional keyword-arguments can be provided as well.
**Note:** If neither class variable `CONFIG_SOURCES` nor constructor argument `config_sources` is provided, `ConfZ`
behaves like a regular _pydantic_ class.
### Change Config Values
In some scenarios, you might want to change your config values, for example within a unit test. However, if you set the
`CONFIG_SOURCES` class variable, this is not directly possible. To overcome this, every config class provides a context
manager to temporarily change your config:
```python
from pathlib import Path
from confz import ConfZ, ConfZFileSource, ConfZDataSource
class MyConfig(ConfZ):
number: int
CONFIG_SOURCES = ConfZFileSource(file=Path('/path/to/config.yml'))
print(MyConfig().number) # will print the value from the config-file
new_source = ConfZDataSource(data={'number': 42})
with MyConfig.change_config_sources(new_source):
print(MyConfig().number) # will print '42'
print(MyConfig().number) # will print the value from the config-file again
```
### Early Validation
By default, your config gets loaded the first time you instantiate the class, e.g. with `MyConfig().attribute`. This
prevents side effects like loading a file while you import your config classes. If the config class cannot populate all
mandatory fields in the correct format, _pydantic_ will raise an error at this point. To make sure this does not happen
in an inconvenient moment, you can also instruct `ConfZ` to load all configs beforehand:
```python
from confz import validate_all_configs
if __name__ == '__main__':
validate_all_configs()
# your application code
```
The function `validate_all_configs` will instantiate all config classes defined in your code at any (reachable)
location that have `CONFIG_SOURCES` set.
## :book: Documentation
Now you've seen the two ways how `ConfZ` can be used: With class variable config sources, unlocking a singleton with
lazy loading, or with keyword argument config sources, allowing to directly load your config values. In both cases,
defining your config sources from files, command line arguments and environment variables is highly flexible
(and also extendable, by the way), while _pydantic_ still makes sure that everything matches your expectations in the
end. You've also seen how to temporarily change your config for example in unit tests and how to validate
your singleton config classes early in the code already.
The full documentation of `ConfZ`'s features can be found at [readthedocs](https://confz.readthedocs.io/).
## :information_source: About
`ConfZ` was programmed and will be maintained by [Zühlke](https://www.zuehlke.com).
The first version was realized by [Silvan](https://github.com/silvanmelchior).
Special thanks to Iwan with his [ConfMe](https://github.com/iwanbolzern/ConfMe), which inspired this project.
Want to contribute to `ConfZ`? Check out the contribution [instruction & guidelines](CONTRIBUTING.md).
نیازمندی
| مقدار | نام |
|---|---|
| >=1.9.0,<2.0.0 | pydantic |
| >=5.4.1,<7.0.0 | PyYAML |
| >=0.19.2,<0.22.0 | python-dotenv |
| >=0.10.2,<0.11.0 | toml |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7.2,<4.0.0 | Python |
نحوه نصب
نصب پکیج whl confz-1.7.0:
pip install confz-1.7.0.whl
نصب پکیج tar.gz confz-1.7.0:
pip install confz-1.7.0.tar.gz