8.7.0

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 8.6.2
+current_version = 8.7.0
 commit = True
 tag = True
 tag_name = {new_version}

.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

@@ -77,3 +77,11 @@ 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.

CHANGELOG.md

@@ -1,8 +1,23 @@
 # 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)
 - 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).
 

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: 8.7.0
+date-released: 2026
 url: "https://github.com/seperman/deepdiff"

CLAUDE.md

@@ -101,7 +101,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
+qluster.ai
+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 8.7.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://qluster.ai).**
+
+*If you're building workflows around data validation and correction, [Qluster](https://qluster.ai) 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,14 +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/8.7.0/)**
 
 ## What is new?
 
 Please check the [ChangeLog](CHANGELOG.md) file for the detailed information.
 
+DeepDiff 8-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
+- 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
+
 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.
 
@@ -84,7 +105,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 +114,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.

deepdiff/__init__.py

@@ -1,6 +1,6 @@
 """This module offers the DeepDiff, DeepSearch, grep, Delta and DeepHash classes."""
 # flake8: noqa
-__version__ = '8.6.2'
+__version__ = '8.7.0'
 import logging
 
 if __name__ == '__main__':

deepdiff/colored_view.py

@@ -109,9 +109,10 @@ def _colorize_json(self, obj: Any, path: str = 'root', indent: int = 0) -> str:
             return '{\n' + ',\n'.join(items) + f'\n{current_indent}' + '}'
 
         elif isinstance(obj, (list, tuple)):
-            if not obj:
-                return '[]'
             removed_map = self._get_path_removed(path)
+            if not obj and not removed_map:
+                return '[]'
+
             for index in removed_map:
                 self._colorize_skip_paths.add(f"{path}[{index}]")