ci: add Python 3.14 wheels and test coverage

Our version of PyO3 doesn't have 3.14 support. We we have to exclude the
Rust backend from 3.14.

No attempt was made to fix the deprecation warnings we're now seeing on
these builds.

Author: indygreg

.github/workflows/sphinx.yml

@@ -9,9 +9,9 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v6
         with:
-          version: "0.4.29"
+          version: "0.8.11"
       - name: Run Sphinx
         env:
           PIP_CONSTRAINT: 'ci/constraints.txt'

.github/workflows/test.yml

@@ -21,6 +21,7 @@ jobs:
           - '3.11'
           - '3.12'
           - '3.13'
+          - '3.14.0-rc.2'
         arch:
           - 'arm64'
           - 'x86'
@@ -77,7 +78,7 @@ jobs:
           architecture: ${{ matrix.arch }}
 
       - name: Install Rust
-        if: matrix.arch != 'x86'
+        if: matrix.arch != 'x86' && matrix.py != '3.14.0-rc.2'
         uses: dtolnay/rust-toolchain@v1
         with:
           toolchain: stable
@@ -92,14 +93,14 @@ jobs:
           python -m pip install --require-hashes -r ci/requirements.txt
 
       - name: Build (Rust)
-        if: matrix.arch != 'x86'
+        if: matrix.arch != 'x86' && matrix.py != '3.14.0-rc.2'
         env:
           PIP_CONSTRAINT: 'ci/constraints.txt'
         run: |
           python -m pip -v install --config-settings='--build-option=--rust-backend' -e .
 
       - name: Build (No Rust)
-        if: matrix.arch == 'x86'
+        if: matrix.arch == 'x86' || matrix.py == '3.14.0-rc.2'
         env:
           PIP_CONSTRAINT: 'ci/constraints.txt'
         run: |
@@ -116,7 +117,7 @@ jobs:
           pytest --numprocesses=auto --hypothesis-profile=${HYPOTHESIS_PROFILE} -v tests/
 
       - name: Test Rust Backend
-        if: matrix.arch != 'x86'
+        if: matrix.arch != 'x86' && matrix.py != '3.14.0-rc.2'
         # Rust backend is currently experimental. So ignore failures in it.
         continue-on-error: true
         env:

.github/workflows/typing.yml

@@ -14,13 +14,14 @@ jobs:
           - '3.11'
           - '3.12'
           - '3.13'
+          - '3.14'
     runs-on: 'ubuntu-24.04'
     steps:
       - uses: actions/checkout@v4
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v6
         with:
-          version: "0.4.29"
+          version: "0.8.11"
 
       - name: Install Dependencies
         run: |

.github/workflows/wheel.yml

@@ -28,6 +28,12 @@ jobs:
           - 'cp311-cp311'
           - 'cp312-cp312'
           - 'cp313-cp313'
+          - 'cp314-cp314'
+        exclude:
+          - image: 'musllinux_1_1_aarch64'
+            py: 'cp314-cp314'
+          - image: 'musllinux_1_1_x86_64'
+            py: 'cp314-cp314'
     runs-on: ${{ endsWith(matrix.image, 'aarch64') && 'ubuntu-22.04-arm' || 'ubuntu-22.04' }}
     steps:
       - uses: actions/checkout@v4
@@ -56,6 +62,7 @@ jobs:
           - 'cp311'
           - 'cp312'
           - 'cp313'
+          - 'cp314'
         arch:
           - 'arm64'
           - 'x86_64'
@@ -64,7 +71,6 @@ jobs:
       CIBW_ARCHS: ${{ matrix.arch }}
       CIBW_BUILD: ${{ matrix.py }}-*
       CIBW_BUILD_VERBOSITY: '1'
-      CIBW_PRERELEASE_PYTHONS: '1'
       ZSTD_WARNINGS_AS_ERRORS: '1'
     steps:
       - name: Set up Python
@@ -98,6 +104,7 @@ jobs:
           - '3.11'
           - '3.12'
           - '3.13'
+          - '3.14.0-rc.2'
         arch:
           - 'x86'
           - 'x64'

docs/news.rst

@@ -74,6 +74,7 @@ Changes
   defining the zstandard frame type. You can pass e.g.
   ``zstandard.FORMAT_ZSTD1_MAGICLESS`` to decode frames without header magic.
   (#217)
+* Initial Python 3.14 support. We build wheels and have CI test coverage.
 
 Backwards Compatibility Notes
 -----------------------------

pyproject.toml

@@ -18,6 +18,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 keywords = ["zstandard", "zstd", "compression"]
 
@@ -39,3 +40,6 @@ line-length = 80
 
 [tool.ruff.lint]
 select = ["E4", "E7", "E9", "F", "I"]
+
+[tool.cibuildwheel]
+enable = ["cpython-prerelease"]