molcrafts-molcfg 1.1.0

Zero-dependency configuration library for the molcrafts ecosystem

molcfg

Zero-dependency configuration library for Python.

Quick Start

from molcfg import CliSource, ConfigLoader, DictSource, EnvSource

cfg = ConfigLoader([
    DictSource({"db": {"host": "localhost", "port": 5432}}, name="defaults"),
    EnvSource(prefix="APP", name="env"),
    CliSource(["--db.port=6432"], name="cli"),
]).load()

assert cfg["db.port"] == 6432
assert cfg.meta("db.port") == {"source": "cli", "history": ("defaults", "cli")}

pip install molcrafts-molcfg

Features

• Layered loading from dicts, TOML/JSON files, environment variables, and CLI arguments
• DEEP_MERGE, OVERRIDE, and APPEND strategies — all return isolated copies
• Recursive schema validation with defaults, strict mode, and built-in constraints
• Source tracking via Config.meta() for every value
• Attribute and dotted-path access, freeze, snapshot, and rollback
• Thread-safe wrapper and POSIX file lock
• ${path.to.key} and ${env:VAR} interpolation
• No runtime dependencies

---

Built with love by MolCrafts