Build free-threaded CPython 3.14t wheels

Resolves #161

Author: HexDecimal

.github/workflows/python-package.yml

@@ -109,18 +109,25 @@ jobs:
     needs: [ruff, mypy, sdist]
     runs-on: ${{ matrix.os }}
     timeout-minutes: 15
+    continue-on-error: ${{ matrix.python-version == '3.14t' && matrix.os == 'windows-11-arm' }} # Until issues are resolved: https://github.com/actions/setup-python/issues/1267
     strategy:
       matrix:
         os: ["ubuntu-latest", "windows-latest"]
-        python-version: ["3.10", "pypy-3.10"]
+        python-version: ["3.10", "3.14t", "pypy-3.10"]
         architecture: ["x64"]
         include:
           - os: "windows-latest"
             python-version: "3.10"
             architecture: "x86"
+          - os: "windows-latest"
+            python-version: "3.14t"
+            architecture: "x86"
           - os: "windows-11-arm"
             python-version: "3.11"
             architecture: "arm64"
+          - os: "windows-11-arm"
+            python-version: "3.14t"
+            architecture: "arm64"
       fail-fast: false
 
     steps:
@@ -240,7 +247,7 @@ jobs:
     strategy:
       matrix:
         arch: ["x86_64", "aarch64"]
-        build: ["cp310-manylinux*", "pp310-manylinux*"]
+        build: ["cp310-manylinux*", "pp310-manylinux*", "cp314t-manylinux*"]
     env:
       BUILD_DESC: ""
     steps:
@@ -298,7 +305,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        python: ["cp310-*_universal2", "pp310-*"]
+        python: ["cp310-*_universal2", "cp314t-*_universal2", "pp310-*"]
     env:
       PYTHON_DESC: ""
     steps:

.vscode/settings.json

@@ -107,6 +107,7 @@
         "cooldown",
         "cplusplus",
         "CPLUSPLUS",
+        "cpython",
         "CRSEL",
         "ctypes",
         "CURRENCYSUBUNIT",
@@ -167,6 +168,7 @@
         "fmean",
         "fontx",
         "fonty",
+        "freethreading",
         "freetype",
         "frombuffer",
         "fullscreen",

build_libtcod.py

@@ -29,7 +29,7 @@
 if TYPE_CHECKING:
     from collections.abc import Iterable, Iterator
 
-Py_LIMITED_API = 0x03100000
+Py_LIMITED_API: None | int = 0x03100000
 
 HEADER_PARSE_PATHS = ("tcod/", "libtcod/src/libtcod/")
 HEADER_PARSE_EXCLUDES = ("gl2_ext_.h", "renderer_gl_internal.h", "event.h")
@@ -167,9 +167,14 @@ def walk_sources(directory: str) -> Iterator[str]:
 library_dirs: list[str] = [*build_sdl.library_dirs]
 define_macros: list[tuple[str, Any]] = []
 
-if "PYODIDE" not in os.environ:
+if "free-threading build" in sys.version:
+    Py_LIMITED_API = None
+if "PYODIDE" in os.environ:
     # Unable to apply Py_LIMITED_API to Pyodide in cffi<=1.17.1
     # https://github.com/python-cffi/cffi/issues/179
+    Py_LIMITED_API = None
+
+if Py_LIMITED_API:
     define_macros.append(("Py_LIMITED_API", Py_LIMITED_API))
 
 sources += walk_sources("tcod/")

pyproject.toml

@@ -42,7 +42,7 @@ keywords = [
     "field-of-view",
     "pathfinding",
 ]
-classifiers = [
+classifiers = [ # https://pypi.org/classifiers/
     "Development Status :: 5 - Production/Stable",
     "Environment :: Win32 (MS Windows)",
     "Environment :: MacOS X",
@@ -53,6 +53,7 @@ classifiers = [
     "Operating System :: MacOS :: MacOS X",
     "Operating System :: Microsoft :: Windows",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: Free Threading :: 2 - Beta",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
     "Topic :: Games/Entertainment",
@@ -72,9 +73,6 @@ Source = "https://github.com/libtcod/python-tcod"
 Tracker = "https://github.com/libtcod/python-tcod/issues"
 Forum = "https://github.com/libtcod/python-tcod/discussions"
 
-[tool.distutils.bdist_wheel]
-py-limited-api = "cp310"
-
 [tool.setuptools_scm]
 write_to = "tcod/version.py"
 

setup.py

@@ -40,11 +40,19 @@ def get_package_data() -> list[str]:
     print("Did you forget to run 'git submodule update --init'?")
     sys.exit(1)
 
+options = {
+    "bdist_wheel": {
+        "py_limited_api": "cp310",
+    }
+}
+if "free-threading build" in sys.version:
+    del options["bdist_wheel"]["py_limited_api"]
 
 setup(
     py_modules=["libtcodpy"],
     packages=["tcod", "tcod.sdl", "tcod.__pyinstaller"],
     package_data={"tcod": get_package_data()},
     cffi_modules=["build_libtcod.py:ffi"],
     platforms=["Windows", "MacOS", "Linux"],
+    options=options,
 )