philiprehberger-dict-merge 0.1.5

Deep merge dictionaries safely with conflict resolution

philiprehberger-dict-merge

Deep merge dictionaries safely with conflict resolution.

Installation

pip install philiprehberger-dict-merge

Usage

from philiprehberger_dict_merge import merge, Strategy

base = {"db": {"host": "localhost", "port": 5432}, "debug": False}
override = {"db": {"port": 3306, "name": "mydb"}, "debug": True}

merge(base, override)
# {"db": {"host": "localhost", "port": 3306, "name": "mydb"}, "debug": True}

# Multiple dicts
merge(defaults, config_file, env_overrides)

# Keep first value on conflict
merge(a, b, strategy=Strategy.KEEP_FIRST)

# Append lists instead of replacing
merge(a, b, list_strategy="append")

API

• merge(*dicts, strategy=Strategy.REPLACE, list_strategy="replace") — Deep merge
• Strategy.REPLACE — Later values win (default)
• Strategy.KEEP_FIRST — Earlier values win
• Strategy.ERROR — Raise on conflict
• List strategies: "replace", "append", "unique", "concat"

Development

pip install -e .
python -m pytest tests/ -v

License

MIT