Support the free-threaded build of CPython 3.13

.github/workflows/ci-cd.yml

@@ -38,7 +38,7 @@ env:
   PY_COLORS: 1  # Recognized by the `py` package, dependency of `pytest`
   PYTHONIOENCODING: utf-8
   PYTHONUTF8: 1
-  PYTHON_LATEST: 3.12
+  PYTHON_LATEST: 3.13
 
 
 jobs:
@@ -184,6 +184,7 @@ jobs:
     strategy:
       matrix:
         pyver:
+        - 3.13t
         - 3.13
         - 3.12
         - 3.11
@@ -231,7 +232,7 @@ jobs:
 
     - name: Setup Python ${{ matrix.pyver }}
       id: python-install
-      uses: actions/setup-python@v5
+      uses: quansight-labs/setup-python@v5
       with:
         python-version: ${{ matrix.pyver }}
         allow-prereleases: true
@@ -392,7 +393,7 @@ jobs:
     - name: Install dependencies
       uses: py-actions/py-dependency-install@v4
       with:
-        path: requirements/test.txt
+        path: requirements/codspeed.txt
     - name: Determine pre-compiled compatible wheel
       env:
         # NOTE: When `pip` is forced to colorize output piped into `jq`,

.github/workflows/reusable-linters.yml

@@ -21,7 +21,7 @@ env:
   PY_COLORS: 1  # Recognized by the `py` package, dependency of `pytest`
   PYTHONIOENCODING: utf-8
   PYTHONUTF8: 1
-  PYTHON_LATEST: 3.12
+  PYTHON_LATEST: 3.13
 
 jobs:
 

CHANGES/1456.feature.rst

@@ -0,0 +1 @@
+Implemented support for the free-threaded build of CPython 3.13 -- by :user:`lysnikolaou`.

CHANGES/1456.packaging.rst

@@ -0,0 +1 @@
+Started building wheels for the free-threaded build of CPython 3.13 -- by :user:`lysnikolaou`.

docs/spelling_wordlist.txt

@@ -1,5 +1,6 @@
 Bluesky
 Bugfixes
+CPython
 Changelog
 Codecov
 Cython

packaging/pep517_backend/_backend.py

@@ -4,6 +4,7 @@
 from __future__ import annotations
 
 import os
+import sysconfig
 import typing as t
 from contextlib import contextmanager, nullcontext, suppress
 from functools import partial
@@ -371,10 +372,12 @@ def get_requires_for_build_wheel(
             stacklevel=999,
         )
 
-    c_ext_build_deps = [] if is_pure_python_build else [
-        'Cython ~= 3.0.0; python_version >= "3.12"',
-        'Cython; python_version < "3.12"',
-    ]
+    if is_pure_python_build:
+        c_ext_build_deps = []
+    elif sysconfig.get_config_var("Py_GIL_DISABLED"):
+        c_ext_build_deps = ['Cython == 3.1.0a1']
+    else:
+        c_ext_build_deps = ['Cython ~= 3.0.0']
 
     return _setuptools_get_requires_for_build_wheel(
         config_settings=config_settings,

pyproject.toml

@@ -64,6 +64,7 @@ linetrace = "True"  # Implies `profile=True`
 
 [tool.cibuildwheel]
 build-frontend = "build"
+enable = ["cpython-freethreading"]
 before-test = [
   # NOTE: Attempt to have pip pre-compile PyYAML wheel with our build
   # NOTE: constraints unset. The hope is that pip will cache that wheel

pytest.ini

@@ -39,7 +39,7 @@ doctest_optionflags = ALLOW_UNICODE ELLIPSIS
 # Marks tests with an empty parameterset as xfail(run=False)
 empty_parameter_set_mark = xfail
 
-faulthandler_timeout = 30
+faulthandler_timeout = 60
 
 filterwarnings =
   error
@@ -80,6 +80,7 @@ norecursedirs =
   .github
   .tox
   *.egg
+  .hypothesis
 
 testpaths = tests/
 

requirements/codspeed.txt

@@ -0,0 +1,2 @@
+-r test.txt
+pytest-codspeed==3.1.2

requirements/cython.txt

@@ -1 +1,2 @@
-cython==3.0.11
+cython==3.1.0a1; python_version >= '3.13'
+cython==3.0.11; python_version <= '3.12'

requirements/test.txt

@@ -7,4 +7,3 @@ propcache==0.2.1
 pytest==8.3.4
 pytest-cov>=2.3.1
 pytest-xdist
-pytest_codspeed==3.1.2

scripts/cibw_before_build.sh

@@ -0,0 +1,7 @@
+# TODO: Delete when there's a PyPI Cython release (3.1.0) that supports free-threaded Python 3.13.
+FREE_THREADED_BUILD="$(python -c"import sysconfig; print(bool(sysconfig.get_config_var('Py_GIL_DISABLED')))")"
+if [[ $FREE_THREADED_BUILD == "True" ]]; then
+    python -m pip install -U pip
+    python -m pip install -i https://pypi.anaconda.org/scientific-python-nightly-wheels/simple cython
+    python -m pip install setuptools expandvars
+fi

tests/test_quoting_benchmarks.py

@@ -1,6 +1,11 @@
 """codspeed benchmark for yarl._quoting module."""
 
-from pytest_codspeed import BenchmarkFixture
+import pytest
+
+try:
+    from pytest_codspeed import BenchmarkFixture
+except ImportError:
+    BenchmarkFixture = None
 
 from yarl._quoting import _Quoter, _Unquoter
 
@@ -15,69 +20,99 @@
 LONG_QUERY_WITH_PCT = LONG_QUERY + "&d=%25%2F%3F%3A%40%26%3B%3D%2B"
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_quote_query_string(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             QUERY_QUOTER("a=1&b=2&c=3&d=4&e=5&f=6&g=7&h=8&i=9&j=0")
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_quoter_ascii(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             QUOTER_SLASH_SAFE("/path/to")
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_quote_long_path(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             PATH_QUOTER(LONG_PATH)
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_quoter_pct(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             QUOTER("abc%0a")
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_long_query(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             QUERY_QUOTER(LONG_QUERY)
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_long_query_with_pct(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             QUERY_QUOTER(LONG_QUERY_WITH_PCT)
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_quoter_quote_utf8(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             PATH_QUOTER("/шлях/файл")
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_unquoter_short(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             UNQUOTER("/path/to")
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_unquoter_long_ascii(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             UNQUOTER(LONG_QUERY)
 
 
+@pytest.mark.skipif(
+    BenchmarkFixture is None, reason="pytest-codspeed needs to be installed"
+)
 def test_unquoter_long_pct(benchmark: BenchmarkFixture) -> None:
     @benchmark
     def _run() -> None: