Merge pull request #579 from qlustered/dev

9.0.0

Author: seperman

.bumpversion.cfg

@@ -1,7 +1,7 @@
 [bumpversion]
-current_version = 8.6.2
-commit = True
-tag = True
+current_version = 9.0.0
+commit = False
+tag = False
 tag_name = {new_version}
 
 [bumpversion:file:pyproject.toml]

.github/ISSUE_TEMPLATE/bug_report.md

@@ -21,7 +21,7 @@ A clear and concise description of what you expected to happen.
 **OS, DeepDiff version and Python version (please complete the following information):**
  - OS: [e.g. Ubuntu]
  - Version [e.g. 20LTS]
- - Python Version [e.g. 3.9.12]
+ - Python Version [e.g. 3.10.12]
  - DeepDiff Version [e.g. 5.8.0]
 
 **Additional context**

.github/workflows/main.yaml

@@ -8,10 +8,10 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      DEFAULT_PYTHON: '3.12'
+      DEFAULT_PYTHON: '3.14'
     strategy:
       matrix:
-        python-version: ['3.9','3.10','3.11','3.12','3.13']
+        python-version: ['3.10','3.11','3.12','3.13','3.14']
         architecture: ['x64']
 
     steps:
@@ -29,18 +29,18 @@ jobs:
         run: pip install nox==2025.5.1
 
       - name: Lint with flake8
-        if: ${{ matrix.python-version == '3.12' }}
+        if: ${{ matrix.python-version == '3.14' }}
         run: |
           nox -s flake8 -- deepdiff --count --select=E9,F63,F7,F82 --show-source --statistics
           nox -s flake8 -- deepdiff --count --exit-zero --max-complexity=26 --max-line-length=250 --statistics
 
       - name: Test with pytest (no coverage)
-        if: ${{ matrix.python-version != '3.12' }}
+        if: ${{ matrix.python-version != '3.14' }}
         run: |
           nox -s pytest-${{ matrix.python-version }} -- --benchmark-disable tests/
 
       - name: Test with pytest (+ coverage)
-        if: ${{ matrix.python-version == '3.12' }}
+        if: ${{ matrix.python-version == '3.14' }}
         run: |
           nox -s pytest-${{ matrix.python-version }} -- \
             --benchmark-disable \
@@ -49,7 +49,7 @@ jobs:
             tests/ --runslow
 
       - name: Upload coverage
-        if: ${{ matrix.python-version == '3.12' }}
+        if: ${{ matrix.python-version == '3.14' }}
         uses: codecov/codecov-action@v4
         with:
           token: ${{ secrets.CODECOV_TOKEN }}

AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

AUTHORS.md

@@ -34,7 +34,7 @@ Authors in order of the timeline of their contributions:
 - Stian Jensen [stianjensen](https://github.com/stianjensen) for improving ignoring of NoneType in diff 
 - Florian Klien [flowolf](https://github.com/flowolf) for adding math_epsilon
 - Tim Klein [timjklein36](https://github.com/timjklein36) for retaining the order of multiple dictionary items added via Delta.
-- Wilhelm Schürmann[wbsch](https://github.com/wbsch) for fixing the typo with yml files.
+- Wilhelm Schürmann [wbsch](https://github.com/wbsch) for fixing the typo with yml files.
 - [lyz-code](https://github.com/lyz-code) for adding support for regular expressions in DeepSearch and strict_checking feature in DeepSearch.
 - [dtorres-sf](https://github.com/dtorres-sf) for adding the option for custom compare function
 - Tony Wang [Tony-Wang](https://github.com/Tony-Wang) for bugfix: verbose_level==0 should disable values_changes.
@@ -77,3 +77,12 @@ Authors in order of the timeline of their contributions:
 - [Enji Cooper](https://github.com/ngie-eign) for converting legacy setuptools use to pyproject.toml
 - [Diogo Correia](https://github.com/diogotcorreia) for reporting security vulnerability in Delta and DeepDiff that could allow remote code execution.
 - [am-periphery](https://github.com/am-periphery) for reporting CVE-2026-33155: denial-of-service via crafted pickle payloads triggering massive memory allocation.
+- [echan5](https://github.com/echan5) for adding callable `group_by` support.
+- [yannrouillard](https://github.com/yannrouillard) for fixing colored view display when all list items are removed.
+- [tpvasconcelos](https://github.com/tpvasconcelos) for fixing `__slots__` handling for objects with `__getattr__`.
+- [devin13cox](https://github.com/devin13cox) for always using t1 path for reporting.
+- [vitalis89](https://github.com/vitalis89) for fixing `ignore_keys` issue in `detailed__dict__`.
+- [ljames8](https://github.com/ljames8) for fixing logarithmic similarity type hint.
+- [srini047](https://github.com/srini047) for fixing README typo.
+- [Nagato-Yuzuru](https://github.com/Nagato-Yuzuru) for colored view tests.
+- [akshat62](https://github.com/akshat62) for adding Fraction numeric support.

CHANGELOG.md

@@ -1,8 +1,24 @@
 # DeepDiff Change log
 
+- v8-7-0
+    - 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](https://github.com/echan5)
+    - Added `FlatDeltaDict` TypedDict for `to_flat_dicts` return type
+    - Fixed colored view display when all list items are removed thanks to [yannrouillard](https://github.com/yannrouillard)
+    - Fixed `hasattr()` swallowing `AttributeError` in `__slots__` handling for objects with `__getattr__` thanks to [tpvasconcelos](https://github.com/tpvasconcelos)
+    - Fixed `ignore_order=True` missing int-vs-float type changes
+    - Always use t1 path for reporting thanks to [devin13cox](https://github.com/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](https://github.com/vitalis89)
+    - Fixed logarithmic similarity type hint thanks to [ljames8](https://github.com/ljames8)
+    - Added `Fraction` numeric support thanks to [akshat62](https://github.com/akshat62)
 - v8-6-2
     - Security fix (CVE-2026-33155): Prevent denial-of-service via crafted pickle payloads that trigger massive memory allocation through the REDUCE opcode. Size-sensitive callables like `bytes()` and `bytearray()` are now wrapped to reject allocations exceeding 128 MB.
-
 - v8-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).
 
@@ -21,7 +37,7 @@
     - 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
+    - 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)
@@ -30,7 +46,7 @@
 - v8-5-0
     - Updating deprecated pydantic calls
     - Switching to pyproject.toml
-    - Fix for moving nested tables when using iterable_compare_func.  by 
+    - Fix for moving nested tables when using iterable_compare_func.
     - Fix recursion depth limit when hashing numpy.datetime64
     - Moving from legacy setuptools use to pyproject.toml
 
@@ -216,7 +232,7 @@
 - v1-0-2: Checking for ImmutableMapping type instead of dict
 - v1-0-1: Better ignore order support
 - v1-0-0: Restructuring output to make it more useful. This is NOT backward compatible.
-- v0-6-1: Fixiing iterables with unhashable when order is ignored
+- v0-6-1: Fixing iterables with unhashable when order is ignored
 - v0-6-0: Adding unicode support
 - v0-5-9: Adding decimal support
 - v0-5-8: Adding ignore order of unhashables support

CITATION.cff

@@ -5,6 +5,6 @@ authors:
   given-names: "Sep"
   orcid: "https://orcid.org/0009-0009-5828-4345"
 title: "DeepDiff"
-version: 8.6.2
-date-released: 2024
+version: 9.0.0
+date-released: 2026
 url: "https://github.com/seperman/deepdiff"

CLAUDE.md

@@ -62,6 +62,7 @@ Examples:
    source ~/.venvs/deep/bin/activate && pytest
    ```
 3. **Running module commands without venv**: Commands like `capi run`, `cettings shell`, etc. all require venv to be activated first
+4. **Using `pip` instead of `uv pip`**: This project uses `uv` for package management. Always use `uv pip` instead of `pip`.
 
 
 ### Slow quality checks only to run before creating a build
@@ -101,7 +102,7 @@ nox
 
 ## Development Notes
 
-- **Python Support**: 3.9+ and PyPy3
+- **Python Support**: 3.10+ and PyPy3
 - **Main Branch**: `master` (PRs typically go to `dev` branch)
 - **Build System**: Modern `pyproject.toml` with `flit_core`
 - **Dependencies**: Core dependency is `orderly-set>=5.4.1,<6`

LICENSE

@@ -1,7 +1,8 @@
 The MIT License (MIT)
 
-Copyright (c) 2014 - 2021 Sep Dehpour (Seperman) and contributors
-www.zepworks.com
+Copyright (c) 2014 - 2026 Sep Dehpour (Seperman) and contributors
+getqluster.com
+zepworks.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,11 +1,15 @@
-# DeepDiff v 8.6.2
+# DeepDiff v 9.0.0
 
 ![Downloads](https://img.shields.io/pypi/dm/deepdiff.svg?style=flat)
 ![Python Versions](https://img.shields.io/pypi/pyversions/deepdiff.svg?style=flat)
 ![License](https://img.shields.io/pypi/l/deepdiff.svg?version=latest)
 [![Build Status](https://github.com/seperman/deepdiff/workflows/Unit%20Tests/badge.svg)](https://github.com/seperman/deepdiff/actions)
 [![codecov](https://codecov.io/gh/seperman/deepdiff/branch/master/graph/badge.svg?token=KkHZ3siA3m)](https://codecov.io/gh/seperman/deepdiff)
 
+**DeepDiff is now part of [Qluster](https://getqluster.com).**
+
+*If you're building workflows around data validation and correction, [Qluster](https://getqluster.com) 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](https://zepworks.com/deepdiff/current/diff.html): Deep Difference of dictionaries, iterables, strings, and ANY other object.
@@ -15,57 +19,31 @@
 - [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.9+ and PyPy3.
+Tested on Python 3.10+ and PyPy3.
 
-- **[Documentation](https://zepworks.com/deepdiff/8.6.2/)**
+- **[Documentation](https://zepworks.com/deepdiff/9.0.0/)**
 
 ## What is new?
 
 Please check the [ChangeLog](CHANGELOG.md) file for the detailed information.
 
-DeepDiff 8-6-2
-- **Security (CVE-2026-33155):** Fixed a memory exhaustion DoS vulnerability in `_RestrictedUnpickler` by limiting the maximum allocation size for `bytes` and `bytearray` during deserialization.
-
-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).
-
-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
-
+DeepDiff 9-0-0
+- 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
+- Added `Fraction` numeric support thanks to @akshat62
 
 ## Installation
 
@@ -84,7 +62,7 @@ If you want to improve the performance of DeepDiff with certain functionalities
 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
+- [clevercsv](https://pypi.org/project/clevercsv/) for more robust CSV parsing
 - [orjson](https://pypi.org/project/orjson/) for speed and memory optimized parsing
 - [pydantic](https://pypi.org/project/pydantic/)
 
@@ -93,17 +71,6 @@ Install optional packages:
 
 <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.
@@ -121,14 +88,14 @@ Please take a look at the [CHANGELOG](CHANGELOG.md) file.
 
     - Method 1: Use [`uv`](https://github.com/astral-sh/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`
+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 wont add the `--runslow` flag.
+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`.