feat: test on free‑threaded Python (#676)

* feat: test on free‑threaded Python

* add 3.14t to noxfile

* try splitting numba as a standalone dep-group

* fix doctests and notebooks

* added free threading stable classifier

Author: Saransh-cpp

.github/workflows/ci.yml

@@ -44,6 +44,7 @@ jobs:
           - "3.12"
           - "3.13"
           - "3.14"
+          - "3.14t"
     name: Python ${{ matrix.python-version }} - Lite
     steps:
       - uses: actions/checkout@v6
@@ -71,6 +72,7 @@ jobs:
           - "3.12"
           - "3.13"
           - "3.14"
+          - "3.14t"
     name: Python ${{ matrix.python-version }} - Full
     steps:
       - uses: actions/checkout@v6

noxfile.py

@@ -6,6 +6,9 @@
 
 from __future__ import annotations
 
+import os
+import sys
+import sysconfig
 from pathlib import Path
 
 import nox
@@ -16,6 +19,7 @@
 DIR = Path(__file__).parent.resolve()
 PYPROJECT = nox.project.load_toml(DIR / "pyproject.toml")
 ALL_PYTHON = nox.project.python_versions(PYPROJECT)
+ALL_PYTHON += ["3.14t"]  # add free-threaded Python variant
 
 
 @nox.session(reuse_venv=True)
@@ -44,7 +48,13 @@ def lite(session: nox.Session) -> None:
 @nox.session(reuse_venv=True, python=ALL_PYTHON)
 def tests(session: nox.Session) -> None:
     """Run the unit and regular tests."""
-    test_deps = nox.project.dependency_groups(PYPROJECT, "test-all")
+    if sys.version_info[:2] >= (3, 14) and bool(
+        sysconfig.get_config_var("Py_GIL_DISABLED")
+    ):
+        os.environ["PYTHON_GIL"] = "0"
+        test_deps = nox.project.dependency_groups(PYPROJECT, "test-all-no-gil")
+    else:
+        test_deps = nox.project.dependency_groups(PYPROJECT, "test-all-gil")
     session.install("-e.", *test_deps)
     session.run(
         "pytest",
@@ -64,15 +74,17 @@ def coverage(session: nox.Session) -> None:
 @nox.session(reuse_venv=True, python=ALL_PYTHON)
 def doctests(session: nox.Session) -> None:
     """Run the doctests."""
-    test_deps = nox.project.dependency_groups(PYPROJECT, "test-all")
+    test_deps = nox.project.dependency_groups(PYPROJECT, "test-all-gil")
     session.install("-e.", *test_deps)
     session.run("pytest", "--doctest-plus", "src/vector/", *session.posargs)
 
 
 @nox.session(reuse_venv=True, default=False)
 def notebooks(session: nox.Session) -> None:
     """Run the notebook tests"""
-    test_deps = nox.project.dependency_groups(PYPROJECT, "test", "test-optional")
+    test_deps = nox.project.dependency_groups(
+        PYPROJECT, "test", "test-optional", "test-numba"
+    )
     session.install("-e.", *test_deps)
     session.install("jupyter")
     session.run("pytest", "tests/test_notebooks.py", *session.posargs)

pyproject.toml

@@ -33,6 +33,7 @@ classifiers = [
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: Free Threading :: 3 - Stable",
   "Topic :: Scientific/Engineering",
   "Topic :: Scientific/Engineering :: Information Analysis",
   "Topic :: Scientific/Engineering :: Mathematics",
@@ -72,9 +73,11 @@ test = [
 ]
 test-optional = [
   "awkward>=2",
-  "numba>=0.57; python_version<'3.15'",
   "sympy",
 ]
+test-numba = [
+  "numba>=0.57; python_version<'3.15'",
+]
 test-extras = [
   "jax",
   "dask_awkward",
@@ -94,14 +97,19 @@ docs = [
   "hepunits",
   "matplotlib",
 ]
-test-all = [
+test-all-no-gil = [
   { include-group = "test"},
   { include-group = "test-optional"},
   { include-group = "test-extras"},
 ]
+test-all-gil = [
+  { include-group = "test-all-no-gil"},
+  { include-group = "test-numba"},
+]
 dev = [
   { include-group = "test"},
   { include-group = "test-optional"},
+  { include-group = "test-numba"},
 ]
 
 [tool.hatch]