Skip to content

Releases

9.2.1

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

9.0.0

Choose a tag to compare

@seperman seperman released this 30 Mar 06:28
41c7265
  • migration note:
    • to_dict() and to_json() now accept a verbose_level parameter and always return a usable text-view dict. When the original view is 'tree', they default to verbose_level=2 for full detail. The old view_override parameter is removed. To get the previous results, you will need to pass the explicit verbose_level to to_json and to_dict if you are using the tree view.
  • Dropping support for Python 3.9
  • Support for python 3.14
  • Added support for callable group_by thanks to echan5
  • Added FlatDeltaDict TypedDict for to_flat_dicts return type
  • Fixed colored view display when all list items are removed thanks to yannrouillard
  • Fixed hasattr() swallowing AttributeError in __slots__ handling for objects with __getattr__ thanks to tpvasconcelos
  • Fixed ignore_order=True missing int-vs-float type changes
  • Always use t1 path for reporting thanks to devin13cox
  • Fixed _convert_oversized_ints failing on NamedTuples
  • Fixed orjson TypeError for integers exceeding 64-bit range
  • Fixed parameter bug in to_flat_dicts where include_action_in_path and report_type_changes were not being passed through
  • Fixed ignore_keys issue in detailed__dict__ thanks to vitalis89
  • Fixed logarithmic similarity type hint thanks to ljames8

8.6.2 - Fix (CVE-2025-58367)

Choose a tag to compare

@seperman seperman released this 25 Mar 20:39
0d07ec2

8.6.2 - Fix (CVE-2025-58367)

8.6.1

Choose a tag to compare

@seperman seperman released this 04 Sep 05:44
60ac5b9

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

Choose a tag to compare

@seperman seperman released this 09 May 18:31
ba85943
  • Updating deprecated pydantic calls
  • Switching to pyproject.toml
  • Fix for moving nested tables when using iterable_compare_func. by
  • Fix recursion depth limit when hashing numpy.datetime64
  • Moving from legacy setuptools use to pyproject.toml

8.4.1

Choose a tag to compare

@seperman seperman released this 17 Mar 05:39
ee5af9c
  • pytz is not required.

8.4.0

Choose a tag to compare

@seperman seperman released this 16 Mar 07:56
f86189e
  • Adding BaseOperatorPlus base class for custom operators
  • default_timezone can be passed now to set your default timezone to something other than UTC.
  • New summarization algorithm that produces valid json
  • Better type hint support

8.1.1

Choose a tag to compare

@seperman seperman released this 16 Dec 23:56
c718369

Adding Python 3.13 to setup.py

8.1.0

Choose a tag to compare

@seperman seperman released this 16 Dec 23:51
e7d10fe
  • Removing deprecated lines from setup.py
  • Added prefix option to pretty()
  • 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

8.0.1

Choose a tag to compare

@seperman seperman released this 24 Oct 18:41
6d8a4c7

8.0.1 - extra import of numpy is removed