Skip to main content

DeepDiff v 9.2.0

Downloads Python Versions License Build Status codecov

DeepDiff is now part of Qluster.

If you're building workflows around data validation and correction, Qluster gives your team a structured way to manage rules, review failures, approve fixes, and reuse decisions—without building the entire system from scratch.

Modules

  • DeepDiff: Deep Difference of dictionaries, iterables, strings, and ANY other object.
  • DeepSearch: Search for objects within other objects.
  • DeepHash: Hash any object based on their content.
  • Delta: Store the difference of objects and apply them to other objects.
  • Extract: Extract an item from a nested Python object using its path.
  • commandline: Use DeepDiff from commandline.

Tested on Python 3.11+ and PyPy3.

What is new?

Please check the ChangeLog file for the detailed information.

DeepDiff 9-2-0

  • Added iterable_match_keys to match list items by key per path, e.g. {"root['orders']": "order_id", "root['orders'][*]['lines']": ("sku", "warehouse")}. Inserted, removed and reordered records are reported per record at real list indexes, and Delta round-trips (#664)
  • Support for Python 3.15
  • Dropping support for Python 3.10, which reached end-of-life in October 2026
  • Fixed iterable_compare_func dropping an added item whose content equals an item that was already matched, e.g. [{"id": 1}] vs [{"id": 1}, {"id": 1}] returned {} (#665)
  • Fixed missing type changes between equal-comparing items inside ordered iterables, e.g. DeepDiff([2], [2.0]) now reports the int → float change like DeepDiff(2, 2.0) already does (#605) thanks to @Sanjays2402
  • Fixed truncate_datetime crashing on non-truncatable types: it now applies only to datetime.datetime and datetime.time objects, so datetime.date, timedelta and np.datetime64 values are compared exactly instead of raising AttributeError 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) 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 thanks to @chuenchen309
  • Fixed _dict_from_slots dropping a parent-declared mangled __slots__ attribute for a subclass instance (#506) 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) thanks to @uttam12331
  • Fixed typos in docstrings and comments thanks to @Labib-Bin-Salam
  • Updated dependencies, and switched release tooling from bump2version to bump-my-version

Installation

Install from PyPi:

pip install deepdiff

If you want to use DeepDiff from commandline:

pip install "deepdiff[cli]"

If you want to improve the performance of DeepDiff with certain functionalities such as improved json serialization:

pip install "deepdiff[optimize]"

Install optional packages:

Documentation

https://zepworks.com/deepdiff/current/

ChangeLog

Please take a look at the CHANGELOG file.

Survey

📣 Please fill out our fast 10-question survey so that we can learn how & why you use DeepDiff, and what improvements we should make. Thank you! 👯

Local dev

  1. Clone the repo

  2. Switch to the dev branch

  3. Create your own branch

  4. Install dependencies

    • Method 1: Use uv to install the dependencies: uv sync --all-extras.
    • Method 2: Use pip: pip install -e ".[cli,coverage,dev,docs,static,test]"
  5. Build uv build

Contribute

  1. Please make your PR against the dev branch
  2. Please make sure that your PR has tests. Since DeepDiff is used in many sensitive data driven projects, we strive to maintain around 100% test coverage on the code.

Please run pytest --cov=deepdiff --runslow to see the coverage report. Note that the --runslow flag will run some slow tests too. In most cases you only want to run the fast tests which so you won't add the --runslow flag.

Or to see a more user friendly version, please run: pytest --cov=deepdiff --cov-report term-missing --runslow.

Thank you!

Authors

Please take a look at the AUTHORS file.

Metadata

Release files for deepdiff 9.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for deepdiff 9.2.0
File Size Uploaded Provenance Actions
deepdiff-9.2.0.tar.gz 405.0 kB Without provenance Details for deepdiff-9.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for deepdiff 9.2.0
File Interpreter ABI Platform Actions
deepdiff-9.2.0-py3-none-any.whl Python 3 none any Details for deepdiff-9.2.0-py3-none-any.whl

Total release size: 603.3 kB

Release files / deepdiff-9.2.0.tar.gz

Download URL deepdiff-9.2.0.tar.gz
Size 405.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4c066508e23bfbd45e906ee2f5c6a0d3995438c1625e919c960ba2a31c95f9ac
BLAKE2b-256 checksum
How to use checksums
78a215d434ee4fa08120dfa579c7fa7a97acee90a6ff7df7f3d0ea7a9f5cabfc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / deepdiff-9.2.0-py3-none-any.whl

Download URL deepdiff-9.2.0-py3-none-any.whl
Size 198.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9e93e9519a6cb93549e242f15cf1a65db920c132ba719d0cfe444f8167516cfd
BLAKE2b-256 checksum
How to use checksums
511545f00c8510198513240fce7eea27b11b2dd3a7be4704cc1a044ac151de40
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for deepdiff 9.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

9.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page