Skip to main content

Deep Difference and Search of any Python object/data. Recreate objects by adding adding deltas to each other.

Project description

DeepDiff v 8.6.0

Downloads Python Versions License Build Status codecov

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.9+ and PyPy3.

What is new?

Please check the ChangeLog file for the detailed information.

DeepDiff 8-6-0

  • Added Colored View thanks to @mauvilsa
  • Added support for applying deltas to NamedTuple thanks to @paulsc
  • Fixed test_delta.py with Python 3.14 thanks to @Romain-Geissler-1A
  • Added python property serialization to json
  • Added ip address serialization
  • Switched to UV from pip
  • Added Claude.md
  • Added uuid hashing thanks to @akshat62
  • Added ignore_uuid_types flag to DeepDiff to avoid type reports when comparing UUID and string.
  • Added comprehensive type hints across the codebase (multiple commits for better type safety)
  • Added support for memoryview serialization
  • Added support for bytes serialization (non-UTF8 compatible)
  • Fixed bug where group_by with numbers would leak type info into group path reports
  • Fixed bug in _get_clean_to_keys_mapping without explicit significant digits
  • Added support for python dict key serialization
  • Enhanced support for IP address serialization with safe module imports
  • Added development tooling improvements (pyright config, .envrc example)
  • Updated documentation and development instructions

DeepDiff 8-5-0

  • 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

DeepDiff 8-4-2

  • fixes the type hints for the base
  • fixes summarize so if json dumps fails, we can still get a repr of the results
  • adds ipaddress support

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/

A message from Sep, the creator of DeepDiff

👋 Hi there,

Thank you for using DeepDiff! As an engineer, I understand the frustration of wrestling with unruly data in pipelines. That's why I developed a new tool - Qluster to empower non-engineers to control and resolve data issues at scale autonomously and stop bugging the engineers! 🛠️

If you are going through this pain now, I would love to give you early access to Qluster and get your feedback.

ChangeLog

Please take a look at the CHANGELOG file.

Survey

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

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 flit 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 wont 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.

Project details


Release history Release notifications | RSS feed

This version

8.6.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deepdiff-8.6.0.tar.gz (631.8 kB view details)

Uploaded Source

Built Distribution

deepdiff-8.6.0-py3-none-any.whl (91.1 kB view details)

Uploaded Python 3

File details

Details for the file deepdiff-8.6.0.tar.gz.

File metadata

  • Download URL: deepdiff-8.6.0.tar.gz
  • Upload date:
  • Size: 631.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.32.3

File hashes

Hashes for deepdiff-8.6.0.tar.gz
Algorithm Hash digest
SHA256 6197216c2d777c3106a9989055c230e25848e599b26dcbcdc66226bd8d7fe901
MD5 3150c58589a640651359a08a1a9a983c
BLAKE2b-256 036557d5047a03700ccb3eaab9d86837168701b1527fdd2bd9fe7a212bee83b1

See more details on using hashes here.

File details

Details for the file deepdiff-8.6.0-py3-none-any.whl.

File metadata

  • Download URL: deepdiff-8.6.0-py3-none-any.whl
  • Upload date:
  • Size: 91.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.32.3

File hashes

Hashes for deepdiff-8.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 db80677a434ac1f84147fd1598e93f1beb06d467e107af45fcf77cf8a681169f
MD5 413b14df6f1c87b4511d36d269279cba
BLAKE2b-256 4a4d4c9ba906175430d6f1cb40b7aa90673720c2c4b3fcea03a3719b1906f983

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page