A tool to easily load (many) JSON/YAML files as pydantic settings.
Project description
What?
A simple tool for loading YAML and JSON configuration/settings using pydantic2.
There is also a version for pydantic1, see release/v1. Major versions of this package will match the major version of the respective pydantic release.
Why?
This project can be helpful for projects that have large configuration files, nested configuration files, or for those of us who don’t like writing large .env files. It is also worth noting that due to the backwards compatability between YAML and JSON that this will also parse JSON configuration.
This can also be helpful when writing out application settings in kubernetes /helm, where most configuration is written as YAML. In such a case we may want to validate/store our settings as YAML as writing JSON and JSON strings can be compersome due to syntax error in larger documents.
Installation
Install using pip:
pip install yaml-settings-pydantic
Examples
Additional information
First, it is worth reading the pydantic_settings docs about additional sources: https://docs.pydantic.dev/latest/usage/pydantic_settings/
Additionally see the example in ./tests/examples/__init__.py. It is gaurenteed to work as its contents are tested. It contains information on how to write nested configurations.
Tools
There are three classes worth knowing about:
YamlSettingsConfigDict – pydantic_settings.SetttingsConfigDict extended to include the fields used by CreateYamlSettings.
CreateYamlSettings – The pydantic PydanticBaseSettingsSource that will analyze your class for the following class variables:
Files to be used – under __env_yaml_files__ or model_config.yaml_files.
The reload settings – under __env_yaml_reload__ or model_config.yaml_reload.
CreateYamlSettings does not have to be used at all, but can be helpful if you don’t want to use BaseYamlSettings for any reason.
BaseYamlSettings – Use this directly as done in the example below. This is ‘the easy way’.
Minimal Examples
The shortest possible example is as follows:
from yaml_settings_pydantic import BaseYamlSettings
class MySettings(BaseYamlSettings):
__env_yaml_files__ = "settings.yaml"
setttingOne: str
settingTwo: str
...
...
Note that the above example can also be written like
from yaml_settings_pydantic import BaseYamlSettings, YamlSettingsConfigDict
class MySettings(BaseYamlSettings):
model_config = YamlSettingsConfigDict(yaml_files="settings.yaml")
setttingOne: str
settingTwo: str
...
...
which is more like pydantic v2. The ‘dunder’ specifications will take priority over their equivalent model_config specifications. These map as follows:
+-----------------------+------------------+
| dunder | model_config |
+-----------------------+------------------+
| __env_yaml_files__ | yaml_files |
| __env_yaml_reload__ | yaml_reload |
+-----------------------+------------------+
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for yaml_settings_pydantic-2.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2331d68671685726ccb0ab4a8712ff1033b7e5e9eaa5b1b5c9cf327b7c138e02 |
|
MD5 | eed1702de7cf59dc0ac96d2855fa97dc |
|
BLAKE2b-256 | 9aeb7c005bb28e3bb9b48ede2fac3debfb94fb420cf941d0e180a59531cd35c3 |
Hashes for yaml_settings_pydantic-2.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ed032e46aa77ca8f3cadb3b2b455e8ca8867f6545662d2228645da7e7f7e94d6 |
|
MD5 | c7878212ba2027ad1526b36a61daf8ec |
|
BLAKE2b-256 | fcc16a25ba04bc1bc3a4e44dcefeb184105d77b140b5d0a54492782fb43a7f50 |