feat: adds support for Python runtime 3.14 (#2322)

* feat: adds support for Python runtime 3.14

* adds step to install gdal

* adds files required by pyarrow

* adds repo required by pyarrow

* corrects url to repo required by pyarrow

* testing a theory with a conditional

* testing a theory with a conditional version of ubuntu

* testing a new approach to installing arrow

* testing a new approach to dearmoring the key

* back to the basics

* trying a conditional again.

* adds explanatory comment resets ubuntu version to latest

* Apply suggestion from @chalmerlowe

* Apply suggestion from @chalmerlowe

* Apply suggestion from @chalmerlowe

* Apply suggestion from @chalmerlowe

Author: chalmerlowe

.github/sync-repo-settings.yaml

@@ -19,6 +19,7 @@ branchProtectionRules:
     - 'Samples - Python 3.11'
     - 'Samples - Python 3.12'
     - 'Samples - Python 3.13'
+    - 'Samples - Python 3.14'
 - pattern: v2
   requiresLinearHistory: true
   requiresCodeOwnerReviews: true

.github/workflows/unittest.yml

@@ -5,11 +5,10 @@ on:
 name: unittest
 jobs:
   unit:
-    # Use `ubuntu-latest` runner.
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python: ['3.9', '3.11', '3.12', '3.13']
+        python: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
     steps:
     - name: Checkout
       uses: actions/checkout@v4
@@ -22,6 +21,12 @@ jobs:
         python -m pip install --upgrade setuptools pip wheel
         python -m pip install nox
     - name: Run unit tests
+
+      # TODO (https://b.corp.google.com/issues/450370502) 3.14 is not yet supported by pyarrow. See
+      # https://github.com/googleapis/google-cloud-python/issues/14686
+      # https://github.com/apache/arrow/issues/47438
+      # Reinstate running tests with 3.14 once this bug is fixed
+      if: matrix.python != '3.14'
       env:
         COVERAGE_FILE: .coverage-${{ matrix.python }}
       run: |
@@ -38,7 +43,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python: ['3.9', '3.13']
+        python: ['3.9', '3.14']
     steps:
     - name: Checkout
       uses: actions/checkout@v4

CONTRIBUTING.rst

@@ -22,7 +22,7 @@ In order to add a feature:
   documentation.
 
 - The feature must work fully on the following CPython versions:
-  3.9, 3.10, 3.11, 3.12 and 3.13 on both UNIX and Windows.
+  3.9, 3.10, 3.11, 3.12, 3.13 and 3.14 on both UNIX and Windows.
 
 - The feature must not add unnecessary dependencies (where
   "unnecessary" is of course subjective, but new dependencies should
@@ -226,12 +226,14 @@ We support:
 -  `Python 3.11`_
 -  `Python 3.12`_
 -  `Python 3.13`_
+-  `Python 3.14`_
 
 .. _Python 3.9: https://docs.python.org/3.9/
 .. _Python 3.10: https://docs.python.org/3.10/
 .. _Python 3.11: https://docs.python.org/3.11/
 .. _Python 3.12: https://docs.python.org/3.12/
 .. _Python 3.13: https://docs.python.org/3.13/
+.. _Python 3.14: https://docs.python.org/3.14/
 
 
 Supported versions can be found in our ``noxfile.py`` `config`_.

noxfile.py

@@ -39,7 +39,7 @@
 
 DEFAULT_PYTHON_VERSION = "3.9"
 SYSTEM_TEST_PYTHON_VERSIONS = ["3.9", "3.11", "3.12", "3.13"]
-UNIT_TEST_PYTHON_VERSIONS = ["3.9", "3.11", "3.12", "3.13"]
+UNIT_TEST_PYTHON_VERSIONS = ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
 CURRENT_DIRECTORY = pathlib.Path(__file__).parent.absolute()
 
 

owlbot.py

@@ -56,7 +56,7 @@
         "pandas": "https://pandas.pydata.org/pandas-docs/stable/",
     },
     system_test_python_versions=["3.9", "3.13"],
-    unit_test_python_versions=["3.9", "3.10", "3.11", "3.12", "3.13"],
+    unit_test_python_versions=["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"],
     default_python_version="3.9",
 )
 

pyproject.toml

@@ -38,6 +38,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Operating System :: OS Independent",
   "Topic :: Internet",
 ]
@@ -69,13 +70,15 @@ bqstorage = [
   # https://github.com/grpc/grpc/pull/15254
   "grpcio >= 1.47.0, < 2.0.0",
   "grpcio >= 1.49.1, < 2.0.0; python_version >= '3.11'",
+  "grpcio >= 1.75.1, < 2.0.0; python_version >= '3.14'",
   "pyarrow >= 4.0.0",
 ]
 pandas = [
   "pandas >= 1.3.0",
   "pandas-gbq >= 0.26.1",
   "grpcio >= 1.47.0, < 2.0.0",
   "grpcio >= 1.49.1, < 2.0.0; python_version >= '3.11'",
+  "grpcio >= 1.75.1, < 2.0.0; python_version >= '3.14'",
   "pyarrow >= 3.0.0",
   "db-dtypes >= 1.0.4, < 2.0.0",
 ]

testing/constraints-3.14.txt

@@ -0,0 +1,2 @@
+# Constraints for Python 3.14
+grpcio >= 1.75.1