Configuration Management for Python projects, modules, applications, and microservices.
Compose structured hierarchical configurations from multiple sources. Enable your code to adapt seemlessly to the current context. Allow users in different contexts to use the config source that works best for them.
Users can create their own config sources
by creating classes that satisfy batconf.source.SourceInterfaceProto
(or subclass batconf.source.SourceInterface
)
The config lookup order is determined by the SourceList
instance,
which can be adjusted to suit your needs.
Professionally supported BatConf is now available.
Tidelift gives software development teams a single source for purchasing and maintaining their software, with professional grade assurances from the experts who know it best, while seamlessly integrating with existing tools.
Get supported BatConf with the Tidelift subscription
Most projects can copy this example with minimal modification.
from bat import GlobalConfig
from batconf.manager import Configuration, ConfigProtocol
from batconf.source import SourceList
from batconf.sources.args import CliArgsConfig, Namespace
from batconf.sources.env import EnvConfig
from batconf.sources.file import FileConfig
from batconf.sources.dataclass import DataclassConfig
def get_config(
# Known issue: https://github.com/python/mypy/issues/4536
config_class: ConfigProtocol = GlobalConfig, # type: ignore
cli_args: Namespace = None,
config_file: FileConfig = None,
config_file_name: str = None,
config_env: str = None,
) -> Configuration:
# Build a prioritized config source list
config_sources = [
CliArgsConfig(cli_args) if cli_args else None,
EnvConfig(),
config_file if config_file else FileConfig(
config_file_name, config_env=config_env
),
DataclassConfig(config_class),
]
source_list = SourceList(config_sources)
return Configuration(source_list, config_class)
the GlobalConfig
class is a python dataclass
, used for namespacing,
and providing a structured configuration tree.
Its attributes should be other Config dataclasses for sub-modules.
from dataclasses import dataclass
from .example import Config
@dataclass
class GlobalConfig:
# example module with configuration dataclass
example: Config
pip install .
install poetry >= 1.1.13
poetry install
install the dev dependencies listed in pyproject.toml
pip install -e .[dev]
pip install -e ".[dev]"
To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.