Skip to content

Add Python 3.15 support and drop Python 3.10 - #661

Merged
seperman merged 1 commit into
devfrom
python-3.15-support
Nov 13, 2026
Merged

seperman merged 1 commit into
devfrom
python-3.15-support

Conversation

@seperman

Copy link
Copy Markdown
Member

Summary

Python 3.10 reached end-of-life in October 2026. This PR moves supported versions to 3.11 – 3.15.

Runtime dependency

  • cachebox >=5.2,<6 → >=6.1.2,<7. Required: 5.x ships no cp315 wheels (it's a Rust extension). DeepDiff only uses LRUCache(capacity), .get, .insert, and in.

Build

  • flit_core >=3.11,<5. flit 4's breaking changes (dropping [tool.flit.metadata] and VCS-based sdist inclusion) don't affect us, since we already use [project] and explicit sdist include/exclude lists.

Optional / dev dependencies

  • numpy ~=2.5.4 on 3.12+, ~=2.4.6 on 3.11
  • pandas ~=3.1.1 (no version markers needed anymore)
  • polars ~=2.1.0, python-dateutil ~=4.0.0 (major bumps)
  • Sphinx ~=9.0.4 (newest series that still supports 3.11), furo >=2025.12.19
  • coverage 7.17, click 8.5, orjson 3.13, pydantic 2.14, flake8 7.5, pytest 9.2, pytest-benchmark 5.3, python-dotenv 1.2.4, jsonpickle 4.1.4, nox 2026.10.20, flit-core 4.2.0
  • Dropped tomli (stdlib tomllib is always available on 3.11+)

Code

  • deepdiff/serialization.py: always use tomllib for TOML loading
  • tests/test_hash.py: removed the pre-3.11 enum hash branch

CI / tooling

  • CI matrix and nox sessions: 3.11 – 3.15; lint and coverage now run on 3.15
  • README and CLAUDE.md updated to say 3.11+

Testing

  • The full test suite passes locally on Python 3.15.2. CI covers 3.11 – 3.14.
  • I haven't built the docs with Sphinx 9.0.

Notes

  • PyYAML 6.0.3 (latest) has no cp315 wheel, so it builds from sdist on 3.15. If the C extension can't compile, it falls back to pure Python.
  • I haven't updated the changelog or the "what's new" section in docs/index.rst; those can go in with the release.

Python 3.10 reached end-of-life in October 2026. Supported versions are
now 3.11 through 3.15.

- Bump cachebox to >=6.1.2,<7 (first release with cp315 wheels)
- numpy ~=2.5.4 on 3.12+, ~=2.4.6 on 3.11; pandas ~=3.1.1 everywhere
- Allow flit_core <5 as build backend
- Upgrade dev/test/docs/static dependencies (polars 2.1, dateutil 4.0,
  Sphinx 9.0, pytest 9.2, coverage 7.17, pydantic 2.14, etc.)
- Drop tomli dev dependency; always use stdlib tomllib
- Remove pre-3.11 enum hash branch from tests
- Update CI matrix and nox sessions to 3.11-3.15, run lint/coverage on 3.15
@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.09%. Comparing base (13a5aeb) to head (b76954c).
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@            Coverage Diff             @@
##              dev     #661      +/-   ##
==========================================
+ Coverage   95.07%   95.09%   +0.01%     
==========================================
  Files          18       18              
  Lines        4918     4915       -3     
==========================================
- Hits         4676     4674       -2     
+ Misses        242      241       -1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@seperman
seperman merged commit 556b60d into dev Nov 13, 2026
5 checks passed
@Gauravtalreja1

Copy link
Copy Markdown

@seperman Hi, Could you please publish a new DeepDiff release containing this change when possible? The current PyPI release (9.1.0) still constrains cachebox to <6, which makes installation fail on Python 3.15 because cachebox 5.x does not support it. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants