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