ci: Run tests on Python 3.14t

Author: alexander-alderman-webb

.github/workflows/test-integrations-ai.yml

@@ -29,7 +29,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.8","3.9","3.10","3.11","3.12","3.13","3.14"]
+        python-version: ["3.8","3.9","3.10","3.11","3.12","3.13","3.14","3.14t"]
         # python3.6 reached EOL and is no longer being supported on
         # new versions of hosted runners on Github Actions
         # ubuntu-20.04 is the last version that supported python3.6

.github/workflows/test-integrations-cloud.yml

@@ -29,7 +29,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.6","3.7","3.8","3.9","3.10","3.11","3.12","3.13","3.14"]
+        python-version: ["3.6","3.7","3.8","3.9","3.10","3.11","3.12","3.13","3.14","3.14t"]
         # python3.6 reached EOL and is no longer being supported on
         # new versions of hosted runners on Github Actions
         # ubuntu-20.04 is the last version that supported python3.6

.github/workflows/test-integrations-flags.yml

@@ -29,7 +29,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.7","3.8","3.9","3.12","3.13","3.14"]
+        python-version: ["3.7","3.8","3.9","3.12","3.13","3.14","3.14t"]
         # python3.6 reached EOL and is no longer being supported on
         # new versions of hosted runners on Github Actions
         # ubuntu-20.04 is the last version that supported python3.6

.github/workflows/test-integrations-graphql.yml

@@ -29,7 +29,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.6","3.8","3.9","3.10","3.11","3.12","3.13","3.14"]
+        python-version: ["3.6","3.8","3.9","3.10","3.11","3.12","3.13","3.14","3.14t"]
         # python3.6 reached EOL and is no longer being supported on
         # new versions of hosted runners on Github Actions
         # ubuntu-20.04 is the last version that supported python3.6

.github/workflows/test-integrations-network.yml

@@ -29,7 +29,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.6","3.7","3.8","3.9","3.10","3.11","3.12","3.13","3.14"]
+        python-version: ["3.6","3.7","3.8","3.9","3.10","3.11","3.12","3.13","3.14","3.14t"]
         # python3.6 reached EOL and is no longer being supported on
         # new versions of hosted runners on Github Actions
         # ubuntu-20.04 is the last version that supported python3.6

.github/workflows/test-integrations-web-1.yml

@@ -29,7 +29,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.6","3.7","3.8","3.9","3.10","3.11","3.12","3.13","3.14"]
+        python-version: ["3.6","3.7","3.8","3.9","3.10","3.11","3.12","3.13","3.14","3.14t"]
         # python3.6 reached EOL and is no longer being supported on
         # new versions of hosted runners on Github Actions
         # ubuntu-20.04 is the last version that supported python3.6

scripts/populate_tox/populate_tox.py

@@ -11,6 +11,7 @@
 import subprocess
 import sys
 import time
+from dataclasses import dataclass
 from bisect import bisect_left
 from collections import defaultdict
 from datetime import datetime, timedelta, timezone  # noqa: F401
@@ -68,6 +69,27 @@
 }
 
 
+@dataclass(order=True)
+class ThreadedVersion:
+    version: Version
+    no_gil: bool
+
+    def __init__(self, version: str | Version, no_gil=False):
+        self.version = Version(version) if isinstance(version, str) else version
+        self.no_gil = no_gil
+
+    def __str__(self):
+        version = f"py{self.version.major}.{self.version.minor}"
+        if self.no_gil:
+            version += "t"
+
+        return version
+
+
+# Free-threading is experimentally supported in 3.13, and officially supported in 3.14.
+MIN_FREE_THREADING_SUPPORT = ThreadedVersion("3.14")
+
+
 def _fetch_sdk_metadata() -> PackageMetadata:
     (dist,) = distributions(
         name="sentry-sdk", path=[Path(__file__).parent.parent.parent]
@@ -404,12 +426,18 @@ def supported_python_versions(
     return supported
 
 
-def pick_python_versions_to_test(python_versions: list[Version]) -> list[Version]:
+def pick_python_versions_to_test(
+    python_versions: list[Version], has_free_threading_wheel: bool
+) -> list[Version]:
     """
     Given a list of Python versions, pick those that make sense to test on.
 
     Currently, this is the oldest, the newest, and the second newest Python
     version.
+
+    the free-threaded variant of the newest version is also selected if
+    - a free-threaded wheel is distributed; and
+    - the SDK supports free-threading on the newest supported version.
     """
     filtered_python_versions = {
         python_versions[0],
@@ -421,7 +449,16 @@ def pick_python_versions_to_test(python_versions: list[Version]) -> list[Version
     except IndexError:
         pass
 
-    return sorted(filtered_python_versions)
+    versions_to_test = sorted(
+        ThreadedVersion(version) for version in filtered_python_versions
+    )
+
+    if has_free_threading_wheel and versions_to_test[-1] >= MIN_FREE_THREADING_SUPPORT:
+        versions_to_test.append(
+            ThreadedVersion(versions_to_test[-1].version, no_gil=True)
+        )
+
+    return versions_to_test
 
 
 def _parse_python_versions_from_classifiers(classifiers: list[str]) -> list[Version]:
@@ -475,12 +512,23 @@ def determine_python_versions(pypi_data: dict) -> Union[SpecifierSet, list[Versi
     return []
 
 
-def _render_python_versions(python_versions: list[Version]) -> str:
-    return (
-        "{"
-        + ",".join(f"py{version.major}.{version.minor}" for version in python_versions)
-        + "}"
-    )
+def has_free_threading_wheel(pypi_data: dict) -> bool:
+    for download in pypi_data["urls"]:
+        print(download)
+
+        if download["packagetype"] == "bdist_wheel":
+            abi_tag = download["filename"].removesuffix(".whl").split("-")[-2]
+
+            if abi_tag == "none" or (
+                abi_tag.endswith("t") and abi_tag.startswith("cp314")
+            ):
+                return True
+
+    return False
+
+
+def _render_python_versions(python_versions: list[ThreadedVersion]) -> str:
+    return "{" + ",".join(str(version) for version in python_versions) + "}"
 
 
 def _render_dependencies(integration: str, releases: list[Version]) -> list[str]:
@@ -590,7 +638,8 @@ def _add_python_versions_to_release(
             determine_python_versions(release_pypi_data),
             target_python_versions,
             release,
-        )
+        ),
+        has_free_threading_wheel(release_pypi_data),
     )
 
     release.rendered_python_versions = _render_python_versions(release.python_versions)
@@ -647,8 +696,16 @@ def _normalize_name(package: str) -> str:
     return package.lower().replace("-", "_")
 
 
+def _extract_wheel_info_to_cache(wheel: dict):
+    return {
+        "packagetype": wheel["packagetype"],
+        "filename": wheel["filename"],
+    }
+
+
 def _normalize_release(release: dict) -> dict:
     """Filter out unneeded parts of the release JSON."""
+    urls = [_extract_wheel_info_to_cache(wheel) for wheel in release["urls"]]
     normalized = {
         "info": {
             "classifiers": release["info"]["classifiers"],
@@ -657,6 +714,7 @@ def _normalize_release(release: dict) -> dict:
             "version": release["info"]["version"],
             "yanked": release["info"]["yanked"],
         },
+        "urls": urls,
     }
     return normalized
 
@@ -766,7 +824,7 @@ def main() -> dict[str, list]:
 
     print(
         "Done generating tox.ini. Make sure to also update the CI YAML "
-        "files to reflect the new test targets."
+        "files by executing split_tox_gh_actions.py."
     )
 
     return packages