Repository navigation
Releases
Releases · qlustered/deepdiff
9.2.1
New features
iterable_match_keys: match list items by key per path, e.g.{"root['orders']": "order_id", "root['orders'][*]['lines']": ("sku", "warehouse")}. Paths use theexclude_pathsglob syntax; a key spec is a key name, a tuple of key names, or a callable. Matching is O(n + m), inserted/removed/reordered records are reported per record at real list indexes, andDeltaround-trips (#664, #666).- Duplicate keys pair by occurrence; items without a key pair in order.
1and1.0are the same key; booleans and strings never match numbers.- With
ignore_order, keyed lists are still paired by key, without reporting moves. - Subtree multiprocessing falls back to serial when
iterable_match_keysis used. - New docs page:
docs/iterable_match_keys.rst.
Python support
- Added Python 3.15 support (#661).
- Dropped Python 3.10, which reached end-of-life in October 2026. Supported versions are now 3.11–3.15.
cachebox>=6.1.2,<7(first release with cp315 wheels); numpy~=2.5.4on 3.12+,~=2.4.6on 3.11; pandas~=3.1.1.- Build backend allows
flit_core<5. - Dropped the
tomlidependency; stdlibtomllibis always used. - CI matrix and nox sessions updated to 3.11–3.15.
Bug fixes
- Fixed
iterable_compare_funcdropping an added item whose content equals an already matched item, e.g.[{"id": 1}]vs[{"id": 1}, {"id": 1}]returned{}(#665, #666). - Fixed missing type changes between equal-comparing items inside ordered iterables, e.g.
DeepDiff([2], [2.0])now reports theint→floatchange (#605, #607), thanks to Sanjays2402. - Fixed
truncate_datetimecrashing on non-truncatable types. It now applies only todatetime.datetimeanddatetime.time;datetime.date,timedeltaandnp.datetime64values are compared exactly instead of raisingAttributeError(#597, #617), thanks to SAY-5 and Sanjays2402. - Fixed
number_to_stringproducing an invalid string such as1.0+-1.0jfor complex numbers with a negative imaginary part, which crashed e.g.DeepHash(1-1j, significant_digits=3)(#551, #598, #616), thanks to koriyoshi2041 and Sanjays2402. - Fixed Delta JSON round-trip crashing with
TypeErrorwhen orjson is not installed, for list diffs that use iterable opcodes (#613), thanks to chuenchen309. - Fixed
_dict_from_slotsdropping a parent-declared mangled__slots__attribute for a subclass instance (#506, #609), thanks to uttam12331. - The
deepcommand now exits with an actionable message (pip install "deepdiff[cli]") instead of aModuleNotFoundErrortraceback when thecliextra is not installed (#594, #608), thanks to uttam12331. - Fixed typos in docstrings and comments (#600), thanks to Labib-Bin-Salam.
Dependencies
- Upgraded dev/test/docs/static dependencies (polars 2.1, python-dateutil 4.0, Sphinx 9.0, pytest 9.2, coverage 7.17, pydantic 2.14, etc.) and regenerated
uv.lock(#667). - Bumped certifi to 2026.10.18 (#654) and soupsieve to 2.8.4 (#610).
Tooling and docs
- Switched release tooling from
bump2version(broken on Python 3.15) tobump-my-version. - Added sandboxed, monitored test runs for untrusted PRs (
scripts/pr_sandbox/), withmake pr-sandbox/make pr-reviewtargets (#663). - Made
CLAUDE.mdsetup-agnostic instead of hardcoding a venv path (#662). - Version bumped to 9.2.0; CHANGELOG, AUTHORS, README "What is new" and docs index updated. The
__slots__fix (#506) was moved from the v9-1-0 changelog section to v9-2-0, since it was merged after 9.1.0 was released. - Added qluster information to the docs
9.0.0
- migration note:
to_dict()andto_json()now accept averbose_levelparameter and always return a usable text-view dict. When the original view is'tree', they default toverbose_level=2for full detail. The oldview_overrideparameter is removed. To get the previous results, you will need to pass the explicit verbose_level toto_jsonandto_dictif you are using the tree view.
- Dropping support for Python 3.9
- Support for python 3.14
- Added support for callable
group_bythanks to echan5 - Added
FlatDeltaDictTypedDict forto_flat_dictsreturn type - Fixed colored view display when all list items are removed thanks to yannrouillard
- Fixed
hasattr()swallowingAttributeErrorin__slots__handling for objects with__getattr__thanks to tpvasconcelos - Fixed
ignore_order=Truemissing int-vs-float type changes - Always use t1 path for reporting thanks to devin13cox
- Fixed
_convert_oversized_intsfailing on NamedTuples - Fixed orjson
TypeErrorfor integers exceeding 64-bit range - Fixed parameter bug in
to_flat_dictswhereinclude_action_in_pathandreport_type_changeswere not being passed through - Fixed
ignore_keysissue indetailed__dict__thanks to vitalis89 - Fixed logarithmic similarity type hint thanks to ljames8
8.6.2 - Fix (CVE-2025-58367)
8.6.2 - Fix (CVE-2025-58367)
8.6.1
DeepDiff 8-6-1
- Patched security vulnerability in the Delta class which was vulnerable to class pollution via its constructor, and when combined with a gadget available in DeltaDiff itself, it could lead to Denial of Service and Remote Code Execution (via insecure Pickle deserialization).
8.5.0
8.4.1
8.4.0
8.1.1
8.1.0
- Removing deprecated lines from setup.py
- Added
prefixoption topretty() - Fixes hashing of numpy boolean values.
- Fixes slots comparison when the attribute doesn't exist.
- Relaxing orderly-set reqs
- Added Python 3.13 support
- Only lower if clean_key is instance of str #504
- Fixes issue where the key deep_distance is not returned when both compared items are equal #510
- Fixes exclude_paths fails to work in certain cases
- exclude_paths fails to work #509
- Fixes to_json() method chokes on standard json.dumps() kwargs such as sort_keys
- to_dict() method chokes on standard json.dumps() kwargs #490
- Fixes accessing the affected_root_keys property on the diff object returned by DeepDiff fails when one of the dicts is empty
- Fixes accessing the affected_root_keys property on the diff object returned by DeepDiff fails when one of the dicts is empty #508