Skip to content

Fix CI: use Python 3.10 for docs job#63

Open
kephale wants to merge 1 commit into
mainfrom
fix/ci-docs-python-version
Open

Fix CI: use Python 3.10 for docs job#63
kephale wants to merge 1 commit into
mainfrom
fix/ci-docs-python-version

Conversation

@kephale

@kephale kephale commented Jun 8, 2026

Copy link
Copy Markdown
Member

Summary

  • Fix docs job failure: The docs CI job was using Python 3.9, but pyproject.toml requires >=3.10, causing pip install ".[docs]" to fail with a version incompatibility error. Changed to Python 3.10.
  • Update GitHub Actions versions: Bumped actions/checkout from v2 to v4 and actions/setup-python from v2 to v5 in the test and deploy jobs (the docs job already used v4/v5).
  • Align metadata with supported versions: Updated Python classifiers from 3.8/3.9/3.10 to 3.10/3.11/3.12, and updated black/ruff target-version from py38 to py310, matching the project's requires-python = ">=3.10".

Context

The last 3 CI runs (Feb 2025) all failed. The most recent run on main (run 22385795318) shows all 9 test matrix jobs passing, but the docs job fails at the "Install dependencies" step because Python 3.9 cannot satisfy requires-python = ">=3.10".

Test plan

  • CI workflow runs and all jobs pass (tests + docs)
  • Docs build successfully with Python 3.10

The docs job was configured to use Python 3.9, but pyproject.toml
requires Python >=3.10. This caused `pip install ".[docs]"` to fail
because the package itself cannot be installed on Python 3.9.

Also updates:
- actions/checkout and actions/setup-python to v4/v5 in test and
  deploy jobs (docs job already used v4/v5)
- Python classifiers to match actually supported versions (3.10-3.12)
- black and ruff target-version to py310 (matching requires-python)
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.

1 participant