googleapis · parthea · Nov 12, 2025 · Nov 11, 2025 · Nov 11, 2025 · Nov 11, 2025
@@ -13,5 +13,4 @@
 # limitations under the License.
 docker:
  image: gcr.io/cloud-devrel-public-resources/owlbot-python:latest
-  digest: sha256:25de45b58e52021d3a24a6273964371a97a4efeefe6ad3845a64e697c63b6447
-# created: 2025-04-14T14:34:43.260858345Z
+  digest: sha256:fbbc8db67afd8b7d71bf694c5081a32da0c528eba166fbcffb3b6e56ddf907d5
@@ -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

@@ -11,7 +11,7 @@ jobs:
    runs-on: ubuntu-22.04
    strategy:
      matrix:
-        python: ['3.8', '3.9', '3.10', '3.11', '3.12']
+        python: ['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

@@ -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-pubsublite/.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-pubsublite/.kokoro/trampoline_v2.sh"
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
@@ -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-pubsublite/.kokoro/test-samples-against-head.sh"
+}
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "False"
+}
@@ -0,0 +1,6 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+env_vars: {
+    key: "INSTALL_LIBRARY_FROM_SOURCE"
+    value: "True"
+}
@@ -22,7 +22,7 @@ In order to add a feature:
  documentation.

 - The feature must work fully on the following CPython versions:
-  3.8, 3.9, 3.10, 3.11 and 3.12 on both UNIX and Windows.
+  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
@@ -143,12 +143,12 @@ Running System Tests
   $ nox -s system

   # Run a single system test
-   $ nox -s system-3.8 -- -k <name of test>
+   $ nox -s system-3.14 -- -k <name of test>


  .. note::

-      System tests are only configured to run under Python 3.8.
+      System tests are only configured to run under Python 3.14.
      For expediency, we do not run them in older versions of Python 3.

  This alone will not run the tests. You'll need to change some local
@@ -195,11 +195,11 @@ configure them just like the System Tests.

   # Run all tests in a folder
   $ cd samples/snippets
-   $ nox -s py-3.8
+   $ nox -s py-3.14

   # Run a single sample test
   $ cd samples/snippets
-   $ nox -s py-3.8 -- -k <name of test>
+   $ nox -s py-3.14 -- -k <name of test>

 ********************************************
 Note About ``README`` as it pertains to PyPI
@@ -226,12 +226,16 @@ We support:
 -  `Python 3.10`_
 -  `Python 3.11`_
 -  `Python 3.12`_
+-  `Python 3.13`_
+-  `Python 3.14`_

 .. _Python 3.8: https://docs.python.org/3.8/
 .. _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`_.

@@ -33,9 +33,17 @@
 ISORT_VERSION = "isort==5.11.0"
 LINT_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]

-DEFAULT_PYTHON_VERSION = "3.8"
-
-UNIT_TEST_PYTHON_VERSIONS: List[str] = ["3.8", "3.9", "3.10", "3.11", "3.12"]
+DEFAULT_PYTHON_VERSION = "3.14"
+
+UNIT_TEST_PYTHON_VERSIONS: List[str] = [
+    "3.8",
+    "3.9",
+    "3.10",
+    "3.11",
+    "3.12",
+    "3.13",
+    "3.14",
+]
 UNIT_TEST_STANDARD_DEPENDENCIES = [
    "mock",
    "asyncmock",
@@ -49,7 +57,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.14"]
 SYSTEM_TEST_STANDARD_DEPENDENCIES: List[str] = [
    "mock",
    "pytest",
@@ -64,16 +72,7 @@
 CURRENT_DIRECTORY = pathlib.Path(__file__).parent.absolute()

 nox.options.sessions = [
-    "unit",
-    "pytype",  # Custom pytype session
    "system",
-    "cover",
-    "lint",
-    "lint_setup_py",
-    "blacken",
-    "docs",
-    "docfx",
-    "format",
 ]

 # Error if a python version is missing
@@ -129,7 +128,7 @@ def format(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")


@@ -169,7 +168,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(
@@ -323,7 +327,9 @@ def docs(session):
    )


-@nox.session(python=DEFAULT_PYTHON_VERSION)
+# TODO(https://github.com/googleapis/python-pubsublite/issues/257):
+# Use Python 3.14 runtime when this bug is fixed
+@nox.session(python="3.8")
 def pytype(session):
    """Run type checks."""
    constraints_path = str(
@@ -381,15 +387,20 @@ def docfx(session):
    )


-@nox.session(python="3.12")
+@nox.session(python=DEFAULT_PYTHON_VERSION)
 @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

@@ -64,8 +64,9 @@
 templated_files = gcp.CommonTemplates().py_library(
    cov_level=96,
    microgenerator=True,
-    unit_test_python_versions=["3.8", "3.9", "3.10", "3.11", "3.12"],
+    unit_test_python_versions=["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"],
    versions=gcp.common.detect_versions(path="./google", default_first=True),
+    default_python_version="3.14",
 )
 s.move(
    templated_files,

@@ -89,7 +89,7 @@ def get_pytest_env_vars() -> Dict[str, str]:

 # DO NOT EDIT - automatically generated.
 # All versions used to test samples.
-ALL_VERSIONS = ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+ALL_VERSIONS = ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]

 # Any default versions that should be ignored.
 IGNORED_VERSIONS = TEST_CONFIG["ignored_versions"]

@@ -79,6 +79,8 @@
        "Programming Language :: Python :: 3.10",
        "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",
    ],

@@ -15,12 +15,7 @@
 #
 import os

-# try/except added for compatibility with python < 3.8
-try:
-    from unittest import mock
-    from unittest.mock import AsyncMock  # pragma: NO COVER
-except ImportError:  # pragma: NO COVER
-    import mock
+from unittest import mock

 import grpc
 from grpc.experimental import aio

@@ -15,12 +15,7 @@
 #
 import os

-# try/except added for compatibility with python < 3.8
-try:
-    from unittest import mock
-    from unittest.mock import AsyncMock  # pragma: NO COVER
-except ImportError:  # pragma: NO COVER
-    import mock
+from unittest import mock

 import grpc
 from grpc.experimental import aio