Support the free-threaded build of CPython 3.13

.coveragerc

@@ -15,11 +15,15 @@ skip_covered = true
 skip_empty = true
 show_missing = true
 exclude_also =
-    ^\s*@pytest\.mark\.xfail
-    if TYPE_CHECKING
-    assert False
-    : \.\.\.(\s*#.*)?$
-    ^ +\.\.\.$
+  ^\s*@pytest\.mark\.xfail
+  if TYPE_CHECKING
+  assert False
+  : \.\.\.(\s*#.*)?$
+  ^ +\.\.\.$
+omit =
+  benchmark.py
+  url_benchmark.py
+  tests/*_benchmarks.py
 
 [run]
 branch = true

.github/workflows/ci-cd.yml

@@ -191,6 +191,7 @@ jobs:
     strategy:
       matrix:
         pyver:
+        - 3.13t
         - 3.13
         - 3.12
         - 3.11
@@ -257,7 +258,10 @@ jobs:
     - name: Install dependencies
       uses: py-actions/py-dependency-install@v4
       with:
-        path: requirements/test.txt
+        path: >-
+          requirements/test${{
+            matrix.pyver == '3.13t' && '-freethreading' || ''
+          }}.txt
     - name: Determine pre-compiled compatible wheel
       env:
         # NOTE: When `pip` is forced to colorize output piped into `jq`,
@@ -371,7 +375,8 @@ jobs:
           pytest,
           OS-${{ runner.os }},
           VM-${{ matrix.os }},
-          Py-${{ steps.python-install.outputs.python-version }}
+          Py-${{ steps.python-install.outputs.python-version }}${{
+            matrix.pyver == '3.13t' && 't' || '' }}
         fail_ci_if_error: true
 
   benchmark:
@@ -417,7 +422,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`,

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
 from collections.abc import Iterator
 from contextlib import contextmanager, nullcontext, suppress
 from functools import partial
@@ -373,10 +374,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.12']
 
     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
@@ -91,3 +92,12 @@ pure-python = "false"
 
 [tool.cibuildwheel.windows]
 before-test = []  # Windows cmd has different syntax and pip chooses wheels
+
+# TODO: Remove this when there's a Cython 3.1 final release
+# Remove PIP_CONSTRAINT from the environment
+[[tool.cibuildwheel.overrides]]
+select = "cp313t-*"
+
+test-requires = "-r requirements/test-freethreading.txt"
+inherit.environment = "append"
+environment = {PIP_CONSTRAINT = "requirements/cython-freethreading.txt"}

requirements/codspeed.txt

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

requirements/cython-freethreading.txt

@@ -0,0 +1 @@
+cython==3.1.0a1

requirements/dev.txt

@@ -1,2 +1,2 @@
--r test.txt
+-r codspeed.txt
 -r towncrier.txt

requirements/test-freethreading.txt

@@ -0,0 +1,2 @@
+-r cython-freethreading.txt
+-r test-pure.txt

requirements/test-pure.txt

@@ -0,0 +1,8 @@
+covdefaults
+hypothesis>=6.0
+idna==3.10
+multidict==6.2.0
+propcache==0.3.1
+pytest==8.3.5
+pytest-cov>=2.3.1
+pytest-xdist

requirements/test.txt

@@ -1,10 +1,2 @@
 -r cython.txt
-covdefaults
-hypothesis>=6.0
-idna==3.10
-multidict==6.2.0
-propcache==0.3.1
-pytest==8.3.5
-pytest-cov>=2.3.1
-pytest-xdist
-pytest_codspeed==3.2.0
+-r test-pure.txt

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:  # pragma: no branch  # only hit in cibuildwheel
+    pytestmark = pytest.mark.skip("pytest-codspeed needs to be installed")
 
 from yarl._quoting import _Quoter, _Unquoter
 
@@ -15,70 +20,70 @@
 LONG_QUERY_WITH_PCT = LONG_QUERY + "&d=%25%2F%3F%3A%40%26%3B%3D%2B"
 
 
-def test_quote_query_string(benchmark: BenchmarkFixture) -> None:
+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")
 
 
-def test_quoter_ascii(benchmark: BenchmarkFixture) -> None:
+def test_quoter_ascii(benchmark: "BenchmarkFixture") -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             QUOTER_SLASH_SAFE("/path/to")
 
 
-def test_quote_long_path(benchmark: BenchmarkFixture) -> None:
+def test_quote_long_path(benchmark: "BenchmarkFixture") -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             PATH_QUOTER(LONG_PATH)
 
 
-def test_quoter_pct(benchmark: BenchmarkFixture) -> None:
+def test_quoter_pct(benchmark: "BenchmarkFixture") -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             QUOTER("abc%0a")
 
 
-def test_long_query(benchmark: BenchmarkFixture) -> None:
+def test_long_query(benchmark: "BenchmarkFixture") -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             QUERY_QUOTER(LONG_QUERY)
 
 
-def test_long_query_with_pct(benchmark: BenchmarkFixture) -> None:
+def test_long_query_with_pct(benchmark: "BenchmarkFixture") -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             QUERY_QUOTER(LONG_QUERY_WITH_PCT)
 
 
-def test_quoter_quote_utf8(benchmark: BenchmarkFixture) -> None:
+def test_quoter_quote_utf8(benchmark: "BenchmarkFixture") -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             PATH_QUOTER("/шлях/файл")
 
 
-def test_unquoter_short(benchmark: BenchmarkFixture) -> None:
+def test_unquoter_short(benchmark: "BenchmarkFixture") -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             UNQUOTER("/path/to")
 
 
-def test_unquoter_long_ascii(benchmark: BenchmarkFixture) -> None:
+def test_unquoter_long_ascii(benchmark: "BenchmarkFixture") -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):
             UNQUOTER(LONG_QUERY)
 
 
-def test_unquoter_long_pct(benchmark: BenchmarkFixture) -> None:
+def test_unquoter_long_pct(benchmark: "BenchmarkFixture") -> None:
     @benchmark
     def _run() -> None:
         for _ in range(100):