A tool to handle merging of nested data structures in Python.
Installation
deepmerge is available on pypi:
pip install deepmergeExample
Generic Strategy
from deepmerge import always_merger
base = {"foo": ["bar"]}
next = {"foo": ["baz"]}
expected_result = {'foo': ['bar', 'baz']}
result = always_merger.merge(base, next)
assert expected_result == resultCustom Strategy
from deepmerge import Merger
my_merger = Merger(
# pass in a list of tuple, with the
# strategies you are looking to apply
# to each type.
[
(list, ["append"]),
(dict, ["merge"]),
(set, ["union"])
],
# next, choose the fallback strategies,
# applied to all other types:
["override"],
# finally, choose the strategies in
# the case where the types conflict:
["override"]
)
base = {"foo": ["bar"]}
next = {"bar": "baz"}
my_merger.merge(base, next)
assert base == {"foo": ["bar"], "bar": "baz"}You can also pass in your own merge functions, instead of a string.
For more information, see the docs
Supported Versions
deepmerge is supported on Python 3.8+.
For older Python versions the last supported version of deepmerge is listed below:
3.7 : 1.1.1
1 maintainer
Release files for deepmerge 3.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| deepmerge-3.0.1.tar.gz | 22.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| deepmerge-3.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 37.2 kB
Release files / deepmerge-3.0.1.tar.gz
| Download URL | deepmerge-3.0.1.tar.gz |
|---|---|
| Size | 22.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
35b39a4cb92cf328d6eca61cbbf65f68a37c2ceb3085f0f853cbb2e52a59fc23
|
|
BLAKE2b-256 checksum How to use checksums |
386e5cb3548b4d3112fea529375e55e6f3cdc52b8054e3a66f203b1f888ba885
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / deepmerge-3.0.1-py3-none-any.whl
| Download URL | deepmerge-3.0.1-py3-none-any.whl |
|---|---|
| Size | 14.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
35c96f6a68fcf90719a5b31d9f8042ecef6c00fb56836660d33455d0f5cfda65
|
|
BLAKE2b-256 checksum How to use checksums |
2091600003aaad107e27553fbc9cbfc57e96fa37e0223d2ef9d7d3a0e8d8d070
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
