Repository navigation
Add the free-threaded 3.14t build to the pytest matrix in 19 libraries #91
Description
Why
The standard, section 6: the test matrix always includes the newest stable CPython minor and that minor's free-threaded build (3.14 and 3.14t today). Only modern-di, httpware, faststream-outbox and lite-bootstrap test under free-threading.
Repos
compose2pod, db-retry, eof-fixer, faststream-concurrent-aiokafka, faststream-redis-timers, modern-di-aiogram, modern-di-aiohttp, modern-di-arq, modern-di-celery, modern-di-fastapi, modern-di-faststream, modern-di-flask, modern-di-grpc, modern-di-litestar, modern-di-pytest, modern-di-starlette, modern-di-taskiq, modern-di-typer, semvertag.
Change
In .github/workflows/_checks.yml, add "3.14t" to the pytest job's python-version matrix. modern-di's workflow is the reference; it also confirms the interpreter is free-threaded with python -c "import sys; assert not sys._is_gil_enabled()" before running the suite. Add the Programming Language :: Python :: Free Threading :: 2 - Beta classifier where the repo wants to advertise it.
A suite that fails under 3.14t is a real finding, not a reason to drop the entry: fix or record an exemption on the standard's table.
Done when
Every repo above runs its pytest job on 3.14t and is green.
Activity
lesnik512 commentedon Sep 12, 2026
Status: 17 of the 19 repos have a PR; the other two get exemption rows in #97.
Probe first, then PRs. Every repo was synced against 3.14.7 free-threaded, every installed distribution imported, and
sys._is_gil_enabled()checked afterwards; suites were run where no service container is needed. Fourteen repos were clean. The findings, and how each PR handles them:DISABLE_SQLALCHEMY_CEXT_RUNTIME=1on the3.14tentry onlyAIOKAFKA_NO_EXTENSIONS=1on the3.14tentry onlygc.collect() == 0invariant fails; bare Starlette already hands the collector the last response's objects on 3.14t because TestClient's worker thread defers refcount releasesredis[hiredis]<6; hiredis re-enables the GILThe two env workarounds are not exemptions: the entry runs, the assert step confirms the GIL is off, and the other matrix entries keep testing the C extensions. They are recorded here so the lift is not forgotten when #95 derives the matrix.
Every
3.14tentry runspython -c "import sys, <package>; assert not sys._is_gil_enabled()"before the suite. This imports the package on purpose, one step past the reference: pytest only warns when an import re-enables the GIL, so a bareimport sysassert would pass a run that silently went back to GIL mode.PRs: modern-python/compose2pod#95, modern-python/db-retry#43, modern-python/eof-fixer#40, modern-python/faststream-concurrent-aiokafka#71, modern-python/faststream-redis-timers#74, modern-python/modern-di-aiogram#20, modern-python/modern-di-aiohttp#25, modern-python/modern-di-celery#20, modern-python/modern-di-fastapi#48, modern-python/modern-di-faststream#49, modern-python/modern-di-flask#20, modern-python/modern-di-litestar#50, modern-python/modern-di-pytest#46, modern-python/modern-di-starlette#25, modern-python/modern-di-taskiq#18, modern-python/modern-di-typer#44, modern-python/semvertag#68, and #97 for the standard.
ci: run pytest on the free-threaded 3.14t build (#95)
ci: run pytest on the free-threaded 3.14t build (#43)
ci: run pytest on the free-threaded 3.14t build (#40)
ci: run pytest on the free-threaded 3.14t build (#71)
ci: run pytest on the free-threaded 3.14t build (#74)
ci: run pytest on the free-threaded 3.14t build (#20)
ci: run pytest on the free-threaded 3.14t build (#25)
ci: run pytest on the free-threaded 3.14t build (#20)
ci: run pytest on the free-threaded 3.14t build (#48)
ci: run pytest on the free-threaded 3.14t build (#49)
ci: run pytest on the free-threaded 3.14t build (#20)
ci: run pytest on the free-threaded 3.14t build (#50)
ci: run pytest on the free-threaded 3.14t build (#46)
ci: run pytest on the free-threaded 3.14t build and make the no-cycli…
ci: run pytest on the free-threaded 3.14t build (#18)
ci: run pytest on the free-threaded 3.14t build (#44)
ci: run pytest on the free-threaded 3.14t build (#68)
docs(standard): exempt modern-di-arq and modern-di-grpc from the 3.14…
lesnik512 commentedon Sep 12, 2026
All 17 PRs and #97 are merged. Every listed repo except modern-di-arq and modern-di-grpc runs its pytest job on 3.14t and is green; those two carry exemption rows on the standard with the upstream issue that lifts each.