molcrafts-molcfg 1.4.0

Configuration library for the molcrafts ecosystem

molcfg

Configuration library for Python — layered sources, profiles, validation, and source tracking.

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, JSON/TOML/YAML 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
• Registry + Build to resolve config strings like "silu" into classes or instances
• 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

---

Built with love by MolCrafts