# DeepDiff v 7.0.1
[](https://github.com/seperman/deepdiff/actions)
[](https://codecov.io/gh/seperman/deepdiff)
## Modules
- [DeepDiff](https://zepworks.com/deepdiff/current/diff.html): Deep Difference of dictionaries, iterables, strings, and ANY other object.
- [DeepSearch](https://zepworks.com/deepdiff/current/dsearch.html): Search for objects within other objects.
- [DeepHash](https://zepworks.com/deepdiff/current/deephash.html): Hash any object based on their content.
- [Delta](https://zepworks.com/deepdiff/current/delta.html): Store the difference of objects and apply them to other objects.
- [Extract](https://zepworks.com/deepdiff/current/extract.html): Extract an item from a nested Python object using its path.
- [commandline](https://zepworks.com/deepdiff/current/commandline.html): Use DeepDiff from commandline.
Tested on Python 3.8+ and PyPy3.
- **[Documentation](https://zepworks.com/deepdiff/7.0.1/)**
## What is new?
Please check the [ChangeLog](CHANGELOG.md) file for the detailed information.
DeepDiff 7-0-1
- Fixes the translation between Difflib opcodes and Delta flat rows.
DeepDiff 7-0-0
- DeepDiff 7 comes with an improved delta object. [Delta to flat dictionaries](https://zepworks.com/deepdiff/current/serialization.html#delta-serialize-to-flat-dictionaries) have undergone a major change. We have also introduced [Delta serialize to flat rows](https://zepworks.com/deepdiff/current/serialization.html#delta-serialize-to-flat-rows).
- Subtracting delta objects have dramatically improved at the cost of holding more metadata about the original objects.
- When `verbose=2`, and the "path" of an item has changed in a report between t1 and t2, we include it as `new_path`.
- `path(use_t2=True)` returns the correct path to t2 in any reported change in the [`tree view`](https://zepworks.com/deepdiff/current/view.html#tree-view)
- Python 3.7 support is dropped and Python 3.12 is officially supported.
DeepDiff 6-7-1
- Support for subtracting delta objects when iterable_compare_func is used.
- Better handling of force adding a delta to an object.
- Fix for [`Can't compare dicts with both single and double quotes in keys`](https://github.com/seperman/deepdiff/issues/430)
- Updated docs for Inconsistent Behavior with math_epsilon and ignore_order = True
DeepDiff 6-7-0
- Delta can be subtracted from other objects now.
- verify_symmetry is deprecated. Use bidirectional instead.
- always_include_values flag in Delta can be enabled to include values in the delta for every change.
- Fix for Delta.__add__ breaks with esoteric dict keys.
- You can load a delta from the list of flat dictionaries.
DeepDiff 6-6-1
- Fix for [DeepDiff raises decimal exception when using significant digits](https://github.com/seperman/deepdiff/issues/426)
- Introducing group_by_sort_key
- Adding group_by 2D. For example `group_by=['last_name', 'zip_code']`
## 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:
- [yaml](https://pypi.org/project/PyYAML/)
- [tomli](https://pypi.org/project/tomli/) (python 3.10 and older) and [tomli-w](https://pypi.org/project/tomli-w/) for writing
- [clevercsv](https://pypi.org/project/clevercsv/) for more rubust CSV parsing
- [orjson](https://pypi.org/project/orjson/) for speed and memory optimized parsing
- [pydantic](https://pypi.org/project/pydantic/)
# 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](https://qluster.ai/solution) 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](https://www.qluster.ai/try-qluster) to Qluster and get your feedback.
# ChangeLog
Please take a look at the [CHANGELOG](CHANGELOG.md) file.
# Survey
:mega: **Please fill out our [fast 5-question survey](https://forms.gle/E6qXexcgjoKnSzjB8)** so that we can learn how & why you use DeepDiff, and what improvements we should make. Thank you! :dancers:
# 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](AUTHORS.md) file.
Raw data
{
"_id": null,
"home_page": "https://github.com/seperman/deepdiff",
"name": "deepdiff",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Seperman",
"author_email": "sep@zepworks.com",
"download_url": "https://files.pythonhosted.org/packages/70/10/6f4b0bd0627d542f63a24f38e29d77095dc63d5f45bc1a7b4a6ca8750fa9/deepdiff-7.0.1.tar.gz",
"platform": null,
"description": "# DeepDiff v 7.0.1\n\n\n\n\n[](https://github.com/seperman/deepdiff/actions)\n[](https://codecov.io/gh/seperman/deepdiff)\n\n## Modules\n\n- [DeepDiff](https://zepworks.com/deepdiff/current/diff.html): Deep Difference of dictionaries, iterables, strings, and ANY other object.\n- [DeepSearch](https://zepworks.com/deepdiff/current/dsearch.html): Search for objects within other objects.\n- [DeepHash](https://zepworks.com/deepdiff/current/deephash.html): Hash any object based on their content.\n- [Delta](https://zepworks.com/deepdiff/current/delta.html): Store the difference of objects and apply them to other objects.\n- [Extract](https://zepworks.com/deepdiff/current/extract.html): Extract an item from a nested Python object using its path.\n- [commandline](https://zepworks.com/deepdiff/current/commandline.html): Use DeepDiff from commandline.\n\nTested on Python 3.8+ and PyPy3.\n\n- **[Documentation](https://zepworks.com/deepdiff/7.0.1/)**\n\n## What is new?\n\nPlease check the [ChangeLog](CHANGELOG.md) file for the detailed information.\n\nDeepDiff 7-0-1\n\n- Fixes the translation between Difflib opcodes and Delta flat rows.\n\nDeepDiff 7-0-0\n\n- DeepDiff 7 comes with an improved delta object. [Delta to flat dictionaries](https://zepworks.com/deepdiff/current/serialization.html#delta-serialize-to-flat-dictionaries) have undergone a major change. We have also introduced [Delta serialize to flat rows](https://zepworks.com/deepdiff/current/serialization.html#delta-serialize-to-flat-rows).\n- Subtracting delta objects have dramatically improved at the cost of holding more metadata about the original objects.\n- When `verbose=2`, and the \"path\" of an item has changed in a report between t1 and t2, we include it as `new_path`.\n- `path(use_t2=True)` returns the correct path to t2 in any reported change in the [`tree view`](https://zepworks.com/deepdiff/current/view.html#tree-view)\n- Python 3.7 support is dropped and Python 3.12 is officially supported.\n\n\nDeepDiff 6-7-1\n\n- Support for subtracting delta objects when iterable_compare_func is used.\n- Better handling of force adding a delta to an object. \n- Fix for [`Can't compare dicts with both single and double quotes in keys`](https://github.com/seperman/deepdiff/issues/430)\n- Updated docs for Inconsistent Behavior with math_epsilon and ignore_order = True\n\nDeepDiff 6-7-0\n\n- Delta can be subtracted from other objects now.\n- verify_symmetry is deprecated. Use bidirectional instead.\n- always_include_values flag in Delta can be enabled to include values in the delta for every change.\n- Fix for Delta.__add__ breaks with esoteric dict keys.\n- You can load a delta from the list of flat dictionaries.\n\nDeepDiff 6-6-1\n\n- Fix for [DeepDiff raises decimal exception when using significant digits](https://github.com/seperman/deepdiff/issues/426)\n- Introducing group_by_sort_key\n- Adding group_by 2D. For example `group_by=['last_name', 'zip_code']`\n\n\n## Installation\n\n### Install from PyPi:\n\n`pip install deepdiff`\n\nIf you want to use DeepDiff from commandline:\n\n`pip install \"deepdiff[cli]\"`\n\nIf you want to improve the performance of DeepDiff with certain functionalities such as improved json serialization:\n\n`pip install \"deepdiff[optimize]\"`\n\nInstall optional packages:\n- [yaml](https://pypi.org/project/PyYAML/)\n- [tomli](https://pypi.org/project/tomli/) (python 3.10 and older) and [tomli-w](https://pypi.org/project/tomli-w/) for writing\n- [clevercsv](https://pypi.org/project/clevercsv/) for more rubust CSV parsing\n- [orjson](https://pypi.org/project/orjson/) for speed and memory optimized parsing\n- [pydantic](https://pypi.org/project/pydantic/)\n\n\n# Documentation\n\n<https://zepworks.com/deepdiff/current/>\n\n### A message from Sep, the creator of DeepDiff\n\n> \ud83d\udc4b Hi there,\n>\n> Thank you for using DeepDiff!\n> As an engineer, I understand the frustration of wrestling with **unruly data** in pipelines.\n> That's why I developed a new tool - [Qluster](https://qluster.ai/solution) to empower non-engineers to control and resolve data issues at scale autonomously and **stop bugging the engineers**! \ud83d\udee0\ufe0f\n>\n> If you are going through this pain now, I would love to give you [early access](https://www.qluster.ai/try-qluster) to Qluster and get your feedback.\n\n\n# ChangeLog\n\nPlease take a look at the [CHANGELOG](CHANGELOG.md) file.\n\n# Survey\n\n:mega: **Please fill out our [fast 5-question survey](https://forms.gle/E6qXexcgjoKnSzjB8)** so that we can learn how & why you use DeepDiff, and what improvements we should make. Thank you! :dancers:\n\n# Contribute\n\n1. Please make your PR against the dev branch\n2. 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.\n\nPlease 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.\n\nOr to see a more user friendly version, please run: `pytest --cov=deepdiff --cov-report term-missing --runslow`.\n\nThank you!\n\n# Authors\n\nPlease take a look at the [AUTHORS](AUTHORS.md) file.\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Deep Difference and Search of any Python object/data. Recreate objects by adding adding deltas to each other.",
"version": "7.0.1",
"project_urls": {
"Download": "https://github.com/seperman/deepdiff/tarball/master",
"Homepage": "https://github.com/seperman/deepdiff"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "18e6d27d37dc55dbf40cdbd665aa52844b065ac760c9a02a02265f97ea7a4256",
"md5": "803c2ecbd2eeccd2f4619660a63af8ff",
"sha256": "447760081918216aa4fd4ca78a4b6a848b81307b2ea94c810255334b759e1dc3"
},
"downloads": -1,
"filename": "deepdiff-7.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "803c2ecbd2eeccd2f4619660a63af8ff",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 80825,
"upload_time": "2024-04-08T22:59:21",
"upload_time_iso_8601": "2024-04-08T22:59:21.885319Z",
"url": "https://files.pythonhosted.org/packages/18/e6/d27d37dc55dbf40cdbd665aa52844b065ac760c9a02a02265f97ea7a4256/deepdiff-7.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "70106f4b0bd0627d542f63a24f38e29d77095dc63d5f45bc1a7b4a6ca8750fa9",
"md5": "8441479ea5f349a8ed8fa7a4da0cba56",
"sha256": "260c16f052d4badbf60351b4f77e8390bee03a0b516246f6839bc813fb429ddf"
},
"downloads": -1,
"filename": "deepdiff-7.0.1.tar.gz",
"has_sig": false,
"md5_digest": "8441479ea5f349a8ed8fa7a4da0cba56",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 421718,
"upload_time": "2024-04-08T22:59:24",
"upload_time_iso_8601": "2024-04-08T22:59:24.578704Z",
"url": "https://files.pythonhosted.org/packages/70/10/6f4b0bd0627d542f63a24f38e29d77095dc63d5f45bc1a7b4a6ca8750fa9/deepdiff-7.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-08 22:59:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "seperman",
"github_project": "deepdiff",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "ordered-set",
"specs": [
[
"<",
"4.2.0"
],
[
">=",
"4.1.0"
]
]
}
],
"lcname": "deepdiff"
}
JSON
