pyknf

Merge layered JSON and TOML configuration files into a dict. This is the same Rust merge the knf command line runs, called natively.

pip install pyknf    # the module, and the `knf` executable

from knf import deep_merge

config = deep_merge(["base.toml", "prod.json"], override={"server": {"port": 8080}})

Files are merged left to right, exactly like knf base.toml prod.json. Objects merge key by key. Arrays, scalars and None replace wholesale. If you pass override, it is merged last as one more layer, which makes it the Python version of --set. It must be a dict of JSON-like values: None, bool, int (within 64 bits), float, str, list/tuple and nested dicts with str keys, at most 128 levels deep and without cycles. Anything else raises TypeError or ValueError naming the key path, before any file is read.

A file that can't be read raises FileNotFoundError, PermissionError or IsADirectoryError, as open() would. Invalid JSON or TOML raises knf.ParseError, a ValueError like json.JSONDecodeError. TOML datetimes come back as their TOML spelling in a str.

See the project README for the merge semantics in full.