a toolset to deeply merge python dictionaries.
Project description
A tools to handle merging of nested data structures in python.
Installation
deepmerge is available on pypi:
pip install deepmerge
Example
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 == result
Custom 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"])
],
# 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
Tests
$ pip install pytest
$ pytest deepmerge/tests/
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
deepmerge-0.0.5.tar.gz
(5.0 kB
view details)
Built Distribution
File details
Details for the file deepmerge-0.0.5.tar.gz
.
File metadata
- Download URL: deepmerge-0.0.5.tar.gz
- Upload date:
- Size: 5.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d8c5c309340a51e0d7a84adb020d459dc79794d789ea03a56e954ac115089fa5 |
|
MD5 | f7baf40d2229b02fd6957a53e7a843e2 |
|
BLAKE2b-256 | a9147bd117a34ed4199664ad28367814ebac54012c5f6176ed333667d7d469b6 |
Provenance
File details
Details for the file deepmerge-0.0.5-py2.py3-none-any.whl
.
File metadata
- Download URL: deepmerge-0.0.5-py2.py3-none-any.whl
- Upload date:
- Size: 8.8 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cac54cae5e0afabfbad36cfc5cfa12224d319778b1f627b7d446fb9662a01b12 |
|
MD5 | 4ead71be8bbf9458149aa8c328ba9b01 |
|
BLAKE2b-256 | ec0a7e82f75ac34767eba48be998a6db5d2b0ed1fae7a8079175e8158312ad72 |