Skip to content

chore: move to Python 3.14, keep testing 3.12 and 3.13 - #34

Merged
Trosper3 merged 1 commit into
mainfrom
chore/python-3.14
Nov 17, 2026
Merged

Trosper3 merged 1 commit into
mainfrom
chore/python-3.14

Conversation

@wrigjl

@wrigjl wrigjl commented Nov 17, 2026

Copy link
Copy Markdown
Collaborator

Summary

Moves the image, devcontainer and default local environment to Python 3.14, and adds 3.14 to the unit-test matrix. 3.12 and 3.13 stay in the matrix, and requires-python stays >=3.12.

File Change
pyproject.toml qiskit-aer==0.17.2 → 0.18.4; add py314 to black's target-version
uv.lock re-locked; qiskit-aer is the only package that changes
.python-version 3.13 → 3.14
Dockerfile both stages → uv:0.13.9-python3.14-trixie-slim
.devcontainer/devcontainer.json devcontainers/python:3.13 → 3.14
rbs.toml unit-test matrix ["3.12", "3.13", "3.14"]
README.md the Python version mentions in setup, test and CI

ruff's target-version stays py312, the minimum supported version.

Why qiskit-aer has to move

qiskit-aer 0.17.2 has a cp314 wheel for x86_64 Linux but not for aarch64. On ARM (Docker on Apple Silicon, the devcontainer on a Mac, or an ARM host), uv falls back to building it from source, and the slim image has no compiler:

error: Failed to build `qiskit-aer==0.17.2`
  CMake Error: CMake was unable to find a build program corresponding to "Unix Makefiles".
  Building Linux wheels for Python 3.14 requires a compiler (e.g gcc).

CI runs on x86_64, so CI alone wouldn't have caught this. qiskit-aer 0.18.0 and later have cp314 wheels for both architectures. 0.18.4 works with the current qiskit 2.4.1, and its requires_python is >=3.11, so 3.12 is unaffected. Every other compiled runtime dependency (qiskit, numpy, scipy, rustworkx, psutil, markupsafe, charset-normalizer) already has cp314 wheels for both architectures at its locked version.

Testing

  • ruff and black are clean, and pip-audit finds no known vulnerabilities.
  • Unit tests: 84 passed on each of 3.12, 3.13 and 3.14. They also pass on 3.13 and 3.14 with deprecation warnings treated as errors.
  • Docker image built on arm64 from this branch: Python 3.14.10 with qiskit-aer 0.18.4, healthy within 2 s, and the integration suite passes (7 tests).
  • Python 3.14 changed the default multiprocessing start method on Linux to forkserver. run_with_timeout already requests spawn explicitly, so it's unaffected.

Follow-up (not in this PR)

Every image build warns that build-system.requires = ["uv_build>=0.10,<0.11"] doesn't include the running uv 0.13.9. uv works around it by downloading the older backend, so it's harmless, but raising that range is a one-line follow-up.

🤖 Generated with Claude Code

Use Python 3.14 for the image, devcontainer and default local
environment, and add 3.14 to the unit-test matrix alongside 3.12 and
3.13. requires-python stays >=3.12.

qiskit-aer 0.17.2 has no cp314 wheel for linux aarch64, so building
the image on ARM (e.g. Docker on Apple Silicon) fell back to compiling
it from source and failed in the slim image; upgrade to 0.18.4, which
has cp314 wheels for both x86_64 and aarch64.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Redux Build System — CI Report

uv · commit e2b934b

Operation Status Summary Time
audit ✅ no known vulnerabilities 9.5s
format-check ✅ all files formatted 0.8s
lint ✅ 0 issues 0.0s
typecheck ⏭️ not implemented —
unit-test · 3.12 ✅ 84 passed · coverage 88% 106.1s
unit-test · 3.13 ✅ 84 passed · coverage 87% 81.3s
unit-test · 3.14 ✅ 84 passed · coverage 88% 95.8s
build ✅ built local/quantumsolver:ci · 598MB 15.0s
integration-test ✅ /health ready · 7 passed 15.2s
push ⏭️ only on push to main —

Overall: ✅ 8 passed · 0 failed · 2 skipped

@Trosper3 Trosper3 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, thanks Jason. The qiskit-aer bump is well explained (no ARM wheel for 3.14 at 0.17.2), it's the only package that changes in the lock, and 3.12 and 3.13 stay in the matrix. Merged together with #35 and #36 locally, the suite passes on 3.13 and 3.14.

@Trosper3
Trosper3 merged commit 7d10563 into main Nov 17, 2026
4 checks passed
@Trosper3
Trosper3 deleted the chore/python-3.14 branch November 17, 2026 23:00
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.

2 participants