⬆️ Upgrade to Python 3.10+ and modernize build system

[TechNickAI]

Summary

Modernizes the Python package to follow 2025 best practices:

• Drops Python 3.8-3.9 support (both EOL)
• Sets minimum to Python 3.10
• Adds proper multi-version testing infrastructure
• Modernizes build configuration

Changes

Python Version Support

• ✅ Minimum version: Python 3.10 (3.8-3.9 are EOL)
• ✅ Actively tested: 3.10, 3.11, 3.12, 3.13
• ✅ Updated classifiers in pyproject.toml

Build System Modernization

• ✅ Added optional dependencies (test, dev) to pyproject.toml
• ✅ Fixed license format to SPDX string (setuptools 77+ requirement)
• ✅ Fixed setuptools_scm tag regex to handle both v* and releases/v* patterns
• ✅ Updated GitHub Actions to v4/v5 (latest)

Multi-Version Testing

• ✅ Created tox.ini for testing across Python versions
• ✅ Added new GitHub Actions workflow (python-test.yml)
  • Tests all 4 Python versions in parallel
  • Runs linting with ruff
  • Verifies package builds correctly
• ✅ Runs on every PR to catch version-specific issues

Developer Experience

• ✅ Updated README with Development section
• ✅ Documented both tox (traditional) and uv (modern) workflows
• ✅ Clear instructions for local testing

Test Plan

• Build succeeds locally
• All tests pass on Python 3.13
• setuptools_scm correctly detects version from git tags
• No setuptools deprecation warnings (license format fixed)
• CI passes on all Python versions (will verify in PR)

Breaking Changes

⚠️ This drops support for Python 3.8 and 3.9. Both versions reached EOL:

• Python 3.8: October 2024
• Python 3.9: October 2025 (approaching EOL)

Users on these versions will need to upgrade to Python 3.10+ to use future releases.

🤖 Generated with Claude Code

---

Note

Drops Python 3.8–3.9, standardizes on 3.10+, adds multi-version testing and packaging, and updates CI/publishing workflows to latest actions.

• Python package:
  • Raise minimum to python>=3.10; update classifiers to 3.10–3.13 and set license = "MIT" in python/pyproject.toml.
  • Add optional deps test/dev; include package data via [tool.setuptools.package-data]; set zip-safe = false.
  • Add Ruff config and Black/pytest settings in pyproject.toml.
  • Introduce python/tox.ini with envs for py310–py313, lint, and build.
• CI/workflows:
  • .github/workflows/build.yaml: expand Python matrix to 3.10–3.13; cache pip; run tests with coverage; build wheel; verify import; test against installed wheel; upload artifacts; refine job names.
  • .github/workflows/pypi-publish.yml: bump to actions/checkout@v4 and setup-python@v5; add diagnostics; build from python/ and publish via pypa/gh-action-pypi-publish.
• Docs:
  • python/README.md: add Development section with tox/uv workflows, testing, and build instructions.

^{Written by Cursor Bugbot for commit 82d6823. This will update automatically on new commits. Configure here.}