chore: bump minimum Python to 3.10

[Borda]

This pull request updates the minimum supported Python version for the project from 3.9 to 3.10. The changes ensure consistency across documentation, configuration, and CI workflows, and remove references to Python 3.9 throughout the codebase.

Python version support updates:

• Updated the minimum required Python version in pyproject.toml from 3.9 to 3.10, and removed Python 3.9 from the supported classifiers. [1] [2]
• Changed the Python version matrix in the CI workflow (.github/workflows/ci-tests.yml) to start from 3.10 instead of 3.9.

Configuration and tooling updates:

• Updated the Python version constraints for documentation dependencies to require Python >=3.10.
• Set the target version for ruff (linter) to py310 instead of py39 in pyproject.toml.
• Changed the python_version setting for mypy type checking from 3.9 to 3.10 in pyproject.toml.

---

• Drop Python 3.9 from CI test matrix
• requires-python = ">=3.10" in pyproject.toml
• ruff target-version py39 → py310
• mypy python_version 3.9 → 3.10
• Remove Python 3.9 classifier

[codecov]

Codecov Report

❌ Patch coverage is 80.01817% with 220 lines in your changes missing coverage. Please review.
✅ Project coverage is 79%. Comparing base (befdb7c) to head (e30da42).
⚠️ Report is 2 commits behind head on develop.

❌ Your patch check has failed because the patch coverage (80%) is below the target coverage (95%). You can increase the patch coverage or adjust the target coverage.
❌ Your project check has failed because the head coverage (79%) is below the target coverage (95%). You can increase the head coverage or adjust the target coverage.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop   #2260    +/-   ##
========================================
+ Coverage       78%     79%    +1%     
========================================
  Files           66      67     +1     
  Lines         8410    8811   +401     
========================================
+ Hits          6552    6927   +375     
- Misses        1858    1884    +26     

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

This pull request raises the project’s minimum supported Python version to 3.10 and aligns configuration/typing across the repo to use Python 3.10+ features and tooling settings.

Changes:

• Bump requires-python to >=3.10 and update lint/type-checker target versions accordingly.
• Drop Python 3.9 from CI and modernize type annotations (e.g., Optional[T] → T | None, typing.Callable → collections.abc.Callable).
• Update docs dependency markers to reflect the new minimum Python version.

Assessment (n/5):

• Code quality: 4/5
• Testing: 4/5
• Docs: 3/5

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
tests/metrics/conftest.py	Updates type annotations to Python 3.10 union syntax.
src/supervision/dataset/formats/coco.py	Replaces typing.Union with `
pyproject.toml	Bumps minimum Python, updates classifiers and tool target versions (ruff/mypy), and adjusts docs dependency markers.
examples/heatmap_and_track/script.py	Updates optional parameter typing to Python 3.10 union syntax.
examples/compact_mask/benchmark.py	Switches Callable import to collections.abc for modern typing.
.github/workflows/ci-tests.yml	Updates the CI Python matrix to reflect supported versions.

[Copilot]

Pull request overview

Copilot reviewed 84 out of 85 changed files in this pull request and generated 4 comments.

Comments suppressed due to low confidence (2)

src/supervision/utils/conversion.py:71

• Same as above: this wrapper should preserve the wrapped function’s metadata via @functools.wraps(image_processing_fun). Without it, the exported function’s docstring/signature become those of the wrapper, which can break documentation/introspection tooling.
  src/supervision/utils/conversion.py:105
• This wrapper should preserve annotate_func metadata via @functools.wraps(annotate_func) for consistent introspection/docs. Currently the wrapper replaces the original function name/docstring/signature.

[Copilot]

Pull request overview

Copilot reviewed 92 out of 93 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 92 out of 93 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

src/supervision/detection/utils/internal.py:463

• get_data_item() now declares it accepts list[bool] as an index, but the isinstance(index, list) branch treats the list elements as integer indices (value[i] for i in index). For boolean-mask lists this silently indexes with True/False (i.e., 1/0) rather than filtering, producing incorrect subsets (and potentially IndexError). Handle list[bool] explicitly (e.g., if index and isinstance(index[0], bool): ...) and keep the existing list[int] behavior separate; also consider the empty-list case.