Skip to content

9.2.1

Latest

Choose a tag to compare

@seperman seperman released this 18 Nov 20:36
cc3ff3e

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 the exclude_paths glob 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, and Delta round-trips (#664, #666).
    • Duplicate keys pair by occurrence; items without a key pair in order.
    • 1 and 1.0 are 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_keys is 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.4 on 3.12+, ~=2.4.6 on 3.11; pandas ~=3.1.1.
    • Build backend allows flit_core<5.
    • Dropped the tomli dependency; stdlib tomllib is always used.
    • CI matrix and nox sessions updated to 3.11–3.15.

Bug fixes

  • Fixed iterable_compare_func dropping 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 the int → float change (#605, #607), thanks to Sanjays2402.
  • Fixed truncate_datetime crashing on non-truncatable types. It now applies only to datetime.datetime and datetime.time; datetime.date, timedelta and np.datetime64 values are compared exactly instead of raising AttributeError (#597, #617), thanks to SAY-5 and Sanjays2402.
  • Fixed number_to_string producing an invalid string such as 1.0+-1.0j for 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 TypeError when orjson is not installed, for list diffs that use iterable opcodes (#613), thanks to chuenchen309.
  • Fixed _dict_from_slots dropping a parent-declared mangled __slots__ attribute for a subclass instance (#506, #609), thanks to uttam12331.
  • The deep command now exits with an actionable message (pip install "deepdiff[cli]") instead of a ModuleNotFoundError traceback when the cli extra 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) to bump-my-version.
  • Added sandboxed, monitored test runs for untrusted PRs (scripts/pr_sandbox/), with make pr-sandbox / make pr-review targets (#663).
  • Made CLAUDE.md setup-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