StrataConf

A layered configuration library for Python. StrataConf merges configuration from three layers: defaults, configs and overrides. Each layer can have multiple sources with all sources and layers being maintained independently.

Features include:

• Includes via includes: from files or published packages
• Interpolation via ${...} using configuration paths or resolvers
• Object instantiation via _target_ with typed coercion
• Configuration of argparse from YAML files to enable command-line overrides
• Extracting field defaults from dataclass/Pydantic classes
• Overriding function parameter defaults via the config_defaults decorator
• Tracking actively-used configuration values
• Creating a unique fingerprint of a subset of configuration values

It is built on OmegaConf, with some changes to streamline usage (e.g., resolvers are not namespaced).

Documentation

Full documentation, including a user guide and API reference, is available at fastfedora.github.io/strataconf.

Install

pip install strataconf

Quick Start

from strataconf import Config

config = Config()
config.load_defaults("configs/defaults.yaml")     # base layer
config.load_config("configs/config.yaml")         # main layer, on top of defaults
config.add_overrides({"server": {"port": 9000}})  # highest-precedence layer

port = config.get("server.port")                  # merged + interpolated value

See the documentation for the full guide and API reference.

Development

uv sync
just test      # run the test suite
just lint      # ruff + pyright
just docs      # preview the docs (Quarto)

License

MIT — see LICENSE.