ConfigBlanket

Flexible configuration orchestration for Python applications — load settings from code defaults, config files, environment variables, .env files, CI/CD variables, CLI arguments, and optional interactive prompts.

Features

• Multi-source loading with configurable precedence
• Source tracking — know where every value came from
• Typed config classes with validation
• Secret masking in repr, explain, and exports
• Nested configuration with __ env delimiter
• Pluggable file parsers (JSON, YAML, TOML, INI, dotenv)
• CI/CD aware — auto-disables prompting in CI and non-TTY environments
• CLI help — auto-generated --help from your config schema

Default precedence

CLI > CI/CD env > OS env > .env > config files > code defaults > interactive prompt

Quick start

from configblanket import Config, field

class AppConfig(Config):
    database_url: str = field(required=True, env="APP_DATABASE_URL", secret=True)
    api_key: str = field(required=True, env="APP_API_KEY", secret=True)
    debug: bool = field(default=False, env="APP_DEBUG", cli="--debug")
    port: int = field(default=8000, env="APP_PORT", cli="--port")

config = AppConfig(
    files=["config.yml", "config.local.toml"],
    dotenv=".env",
)

print(config.port)
print(config.source_of("port"))
print(config.explain())

Installation

pip install configblanket
pip install configblanket[yaml]      # YAML support
pip install configblanket[toml]      # TOML on Python < 3.11
pip install configblanket[all]       # all optional extras

Documentation

• Architecture & design
• Publishing to PyPI
• Changelog

Development

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[yaml,dev]"
pytest
python -m build
twine check dist/*

Releases are published to PyPI automatically when a GitHub Release is published. See PUBLISHING.md for setup.

License

Copyright (c) 2026 Yoseph

Released under the MIT License.