chore(python): Add support for Python 3.14 (#644)

chalmerlowe · gcf-owl-bot[bot] · parthea · web-flow · commit 2e8194f580fd · 2025-11-11T04:17:45.000-08:00
This PR adds support for Python 3.14 to the library.

Key changes include:
- Update to `.github/workflows` files to account for Python runtimes
both 3.14 and 3.8.
- Adding Python 3.14 to the test matrix in
`.github/workflows/unittest.yml`, etc.
- Updating `.github/sync-repo-settings.yaml` to include 3.14 unit tests
in required checks.
- Update to `.kokoro/presubmit` files to update the system test and
`presubmit.cfg`
- Adding `testing/constraints-3.14.txt`.
- Updates `CONTRIBUTING.rst` to list Python 3.14 as a supported version.
- Updates `mypy.ini` to suppress several known type hinting errors in
two files.
- Updating `noxfile.py` to include 3.14 sessions.
- Updates to `owlbot.py` to include Python 3.14.
- Updating `setup.py` to include the Python 3.14 classifier and add
conditional dependencies for `grpcio`.

---------

Co-authored-by: Owl Bot &lt;gcf-owl-bot[bot]@users.noreply.github.com&gt;
Co-authored-by: Anthonios Partheniou &lt;partheniou@google.com&gt;
diff --git a/packages/google-cloud-datastore/.github/.OwlBot.lock.yaml b/packages/google-cloud-datastore/.github/.OwlBot.lock.yaml
@@ -13,5 +13,4 @@
 # limitations under the License.
 docker:
   image: gcr.io/cloud-devrel-public-resources/owlbot-python:latest
-  digest: sha256:710b70faff81151657d89db6e028c23a1051787598c8276bdd8eef25c92da8ab
-# created: 2025-04-10T17:48:54.829145676Z
+  digest: sha256:fbbc8db67afd8b7d71bf694c5081a32da0c528eba166fbcffb3b6e56ddf907d5
diff --git a/packages/google-cloud-datastore/.github/sync-repo-settings.yaml b/packages/google-cloud-datastore/.github/sync-repo-settings.yaml
@@ -30,6 +30,7 @@ branchProtectionRules:
     - 'unit (3.11)'
     - 'unit (3.12)'
     - 'unit (3.13)'
+    - 'unit (3.14)'
     - 'cover'
     - 'mypy'
 # List of explicit permissions to add (additive only)
diff --git a/packages/google-cloud-datastore/.github/workflows/lint.yml b/packages/google-cloud-datastore/.github/workflows/lint.yml
@@ -12,7 +12,7 @@ jobs:
     - name: Setup Python
       uses: actions/setup-python@v5
       with:
-        python-version: "3.8"
+        python-version: "3.14"
     - name: Install nox
       run: |
         python -m pip install --upgrade setuptools pip wheel
diff --git a/packages/google-cloud-datastore/.github/workflows/mypy.yml b/packages/google-cloud-datastore/.github/workflows/mypy.yml
@@ -12,7 +12,7 @@ jobs:
     - name: Setup Python
       uses: actions/setup-python@v5
       with:
-        python-version: "3.8"
+        python-version: "3.14"
     - name: Install nox
       run: |
         python -m pip install --upgrade setuptools pip wheel
diff --git a/packages/google-cloud-datastore/.github/workflows/unittest.yml b/packages/google-cloud-datastore/.github/workflows/unittest.yml
@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-22.04
     strategy:
       matrix:
-        python: ['3.7', '3.8', '3.9', '3.10', '3.11', '3.12', '3.13']
+        python: ['3.7', '3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
     steps:
     - name: Checkout
       uses: actions/checkout@v4
@@ -45,7 +45,7 @@ jobs:
     - name: Setup Python
       uses: actions/setup-python@v5
       with:
-        python-version: "3.8"
+        python-version: "3.14"
     - name: Install coverage
       run: |
         python -m pip install --upgrade setuptools pip wheel
diff --git a/packages/google-cloud-datastore/.kokoro/presubmit/presubmit.cfg b/packages/google-cloud-datastore/.kokoro/presubmit/presubmit.cfg
@@ -5,3 +5,8 @@ env_vars: {
     key: "RUN_SYSTEM_TESTS"
     value: "false"
 }
+
+env_vars: {
+    key: "NOX_SESSION"
+    value: "blacken doctests format"
+}
diff --git a/packages/google-cloud-datastore/.kokoro/presubmit/system-3.12.cfg b/packages/google-cloud-datastore/.kokoro/presubmit/system-3.12.cfg
@@ -3,5 +3,5 @@
 # Only run this nox session.
 env_vars: {
     key: "NOX_SESSION"
-    value: "system-3.8"
+    value: "system-3.12"
 }
diff --git a/packages/google-cloud-datastore/.kokoro/presubmit/system-3.14.cfg b/packages/google-cloud-datastore/.kokoro/presubmit/system-3.14.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Only run this nox session.
+env_vars: {
+    key: "NOX_SESSION"
+    value: "system-3.14"
+}
diff --git a/packages/google-cloud-datastore/.kokoro/samples/python3.14/common.cfg b/packages/google-cloud-datastore/.kokoro/samples/python3.14/common.cfg
@@ -0,0 +1,40 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Build logs will be here
+action {
+  define_artifacts {
+    regex: "**/*sponge_log.xml"
+  }
+}
+
+# Specify which tests to run
+env_vars: {
+    key: "RUN_TESTS_SESSION"
+    value: "py-3.14"
+}
+
+# Declare build specific Cloud project.
+env_vars: {
+    key: "BUILD_SPECIFIC_GCLOUD_PROJECT"
+    value: "python-docs-samples-tests-314"
+}
+
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/python-datastore/.kokoro/test-samples.sh"
+}
+
+# Configure the docker image for kokoro-trampoline.
+env_vars: {
+    key: "TRAMPOLINE_IMAGE"
+    value: "gcr.io/cloud-devrel-kokoro-resources/python-samples-testing-docker"
+}
+
+# Download secrets for samples
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/python-docs-samples"
+
+# Download trampoline resources.
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
+
+# Use the trampoline script to run in docker.
+build_file: "python-datastore/.kokoro/trampoline_v2.sh"
diff --git a/packages/google-cloud-datastore/.kokoro/samples/python3.14/continuous.cfg b/packages/google-cloud-datastore/.kokoro/samples/python3.14/continuous.cfg
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
diff --git a/packages/google-cloud-datastore/.kokoro/samples/python3.14/periodic-head.cfg b/packages/google-cloud-datastore/.kokoro/samples/python3.14/periodic-head.cfg
@@ -0,0 +1,11 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
+
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/python-datastore/.kokoro/test-samples-against-head.sh"
+}
diff --git a/packages/google-cloud-datastore/.kokoro/samples/python3.14/periodic.cfg b/packages/google-cloud-datastore/.kokoro/samples/python3.14/periodic.cfg
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "False"
+}
diff --git a/packages/google-cloud-datastore/.kokoro/samples/python3.14/presubmit.cfg b/packages/google-cloud-datastore/.kokoro/samples/python3.14/presubmit.cfg
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
diff --git a/packages/google-cloud-datastore/CONTRIBUTING.rst b/packages/google-cloud-datastore/CONTRIBUTING.rst
@@ -22,7 +22,7 @@ In order to add a feature:
   documentation.
 
 - The feature must work fully on the following CPython versions:
-  3.7, 3.8, 3.9, 3.10, 3.11, 3.12 and 3.13 on both UNIX and Windows.
+  3.7, 3.8, 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
@@ -253,6 +253,7 @@ We support:
 -  `Python 3.11`_
 -  `Python 3.12`_
 -  `Python 3.13`_
+-  `Python 3.14`_
 
 .. _Python 3.7: https://docs.python.org/3.7/
 .. _Python 3.8: https://docs.python.org/3.8/
@@ -261,6 +262,7 @@ We support:
 .. _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`_.
diff --git a/packages/google-cloud-datastore/README.rst b/packages/google-cloud-datastore/README.rst
@@ -65,7 +65,7 @@ Supported Python Versions
 Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
 Python.
 
-Python >= 3.7
+Python >= 3.7, including 3.14
 
 .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
 .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
diff --git a/packages/google-cloud-datastore/mypy.ini b/packages/google-cloud-datastore/mypy.ini
@@ -1,7 +1,17 @@
 [mypy]
-python_version = 3.8
+python_version = 3.10
 namespace_packages = True
 ignore_missing_imports = True
 
 [mypy-google.cloud.datastore._app_engine_key_pb2]
 ignore_errors = True
+
+# TODO(https://github.com/googleapis/gapic-generator-python/issues/2410):
+# Remove once this generator bug is fixed
+[mypy-google.cloud.datastore_v1.services.datastore.async_client]
+ignore_errors = True
+
+# TODO(https://github.com/googleapis/gapic-generator-python/issues/2410):
+# Remove once this generator bug is fixed
+[mypy-google.cloud.datastore_v1.services.datastore.client]
+ignore_errors = True
diff --git a/packages/google-cloud-datastore/noxfile.py b/packages/google-cloud-datastore/noxfile.py
@@ -32,7 +32,7 @@
 ISORT_VERSION = "isort==5.11.0"
 LINT_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
 
-DEFAULT_PYTHON_VERSION = "3.8"
+DEFAULT_PYTHON_VERSION = "3.14"
 
 UNIT_TEST_PYTHON_VERSIONS: List[str] = [
     "3.7",
@@ -42,6 +42,7 @@
     "3.11",
     "3.12",
     "3.13",
+    "3.14",
 ]
 UNIT_TEST_STANDARD_DEPENDENCIES = [
     "mock",
@@ -58,7 +59,7 @@
 UNIT_TEST_EXTRAS: List[str] = []
 UNIT_TEST_EXTRAS_BY_PYTHON: Dict[str, List[str]] = {}
 
-SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.8"]
+SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.12"]
 SYSTEM_TEST_STANDARD_DEPENDENCIES: List[str] = [
     "mock",
     "pytest",
@@ -157,7 +158,7 @@ def mypy(session):
 @nox.session(python=DEFAULT_PYTHON_VERSION)
 def lint_setup_py(session):
     """Verify that setup.py is valid (including RST check)."""
-    session.install("docutils", "pygments")
+    session.install("docutils", "pygments", "setuptools")
     session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
 
 
@@ -197,7 +198,12 @@ def install_unittest_dependencies(session, *constraints):
 def unit(session, protobuf_implementation):
     # Install all test dependencies, then install this package in-place.
 
-    if protobuf_implementation == "cpp" and session.python in ("3.11", "3.12", "3.13"):
+    if protobuf_implementation == "cpp" and session.python in (
+        "3.11",
+        "3.12",
+        "3.13",
+        "3.14",
+    ):
         session.skip("cpp implementation is not supported in python 3.11+")
 
     constraints_path = str(
@@ -415,15 +421,20 @@ def docfx(session):
     )
 
 
-@nox.session(python="3.13")
+@nox.session(python="3.14")
 @nox.parametrize(
     "protobuf_implementation",
     ["python", "upb", "cpp"],
 )
 def prerelease_deps(session, protobuf_implementation):
     """Run all tests with prerelease versions of dependencies installed."""
 
-    if protobuf_implementation == "cpp" and session.python in ("3.11", "3.12", "3.13"):
+    if protobuf_implementation == "cpp" and session.python in (
+        "3.11",
+        "3.12",
+        "3.13",
+        "3.14",
+    ):
         session.skip("cpp implementation is not supported in python 3.11+")
 
     # Install all dependencies
diff --git a/packages/google-cloud-datastore/owlbot.py b/packages/google-cloud-datastore/owlbot.py
diff --git a/packages/google-cloud-datastore/samples/snippets/noxfile.py b/packages/google-cloud-datastore/samples/snippets/noxfile.py
diff --git a/packages/google-cloud-datastore/samples/snippets/schedule-export/noxfile.py b/packages/google-cloud-datastore/samples/snippets/schedule-export/noxfile.py
diff --git a/packages/google-cloud-datastore/setup.py b/packages/google-cloud-datastore/setup.py
diff --git a/packages/google-cloud-datastore/testing/constraints-3.14.txt b/packages/google-cloud-datastore/testing/constraints-3.14.txt

Original file line number	Diff line number	Diff line change
`@@ -5,3 +5,8 @@ env_vars: {`
`5`	`5`	`key: "RUN_SYSTEM_TESTS"`
`6`	`6`	`value: "false"`
`7`	`7`	`}`
	`8`	`+`
	`9`	`+env_vars: {`
	`10`	`+ key: "NOX_SESSION"`
	`11`	`+ value: "blacken doctests format"`
	`12`	`+}`
Original file line number	Diff line number	Diff line change
`@@ -3,5 +3,5 @@`
`3`	`3`	`# Only run this nox session.`
`4`	`4`	`env_vars: {`
`5`	`5`	`key: "NOX_SESSION"`
`6`		`- value: "system-3.8"`
	`6`	`+ value: "system-3.12"`
`7`	`7`	`}`