cjrh / deadpool / 23755672668

97%

push

github

Add free-threaded Python (3.14t) support (#379)

* Add free-threaded Python (3.14t) CI and fix thread-safety issues

Add Python 3.14t (free-threaded, no-GIL) to the CI matrix with
PYTHON_GIL=0 to ensure the GIL stays disabled during testing.

Fix several thread-safety issues in pool management that were
previously hidden by the GIL:
- Protect busy_workers set with a lock (concurrent add/remove/len
  from multiple run_task threads)
- Protect existing_workers and running_futs WeakSets (not
  thread-safe without GIL)
- Fix max_workers_busy_concurrently race condition (read-then-write
  without holding the stat's lock)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Fix nox interpreter discovery for free-threaded Python

The free-threaded build installs as python3.14t, not python3.14,
so nox can't find it via its default discovery. Use --force-python
to tell nox to use the current interpreter directly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Use nox native free-threaded Python support

Nox >= 2025.10.14 supports 3.14t in session python lists natively,
so add it to the nox sessions and use nox -s testcov-3.14t directly
instead of working around the interpreter discovery.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Relax test_max_memory assertion to handle PID recycling

The test expected exactly 11 unique PIDs, but PID recycling can
cause a replaced worker to get the same PID as its predecessor,
reducing the count. Use >= 10 which still proves worker replacement
is happening while tolerating occasional PID reuse.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add comment explaining PYTHON_GIL env var in CI

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

99 of 107 branches covered (92.52%)

Branch coverage included in aggregate %.

25 of 25 new or added lines in 1 file covered. (100.0%)

443 of 453 relevant lines covered (97.79%)

6.73 hits per line