From cc633ee5fa68b8d62df1519530053edb90100a14 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Wed, 5 Nov 2025 06:11:19 +0000
Subject: [PATCH 01/45] chore: onboard to librarian

---
 .github/.OwlBot.lock.yaml                     |  17 -
 .github/.OwlBot.yaml                          |  30 --
 .github/release-please.yml                    |  15 -
 .github/release-trigger.yml                   |   2 -
 .../generator-input/.repo-metadata.json       |  18 +
 .librarian/generator-input/owlbot.py          | 324 ++++++++++++++++++
 .librarian/state.yaml                         |  18 +
 .release-please-manifest.json                 |   3 -
 noxfile.py                                    |   6 +-
 owlbot.py                                     |  48 ++-
 release-please-config.json                    |  35 --
 11 files changed, 395 insertions(+), 121 deletions(-)
 delete mode 100644 .github/.OwlBot.lock.yaml
 delete mode 100644 .github/.OwlBot.yaml
 delete mode 100644 .github/release-please.yml
 delete mode 100644 .github/release-trigger.yml
 create mode 100644 .librarian/generator-input/.repo-metadata.json
 create mode 100644 .librarian/generator-input/owlbot.py
 create mode 100644 .librarian/state.yaml
 delete mode 100644 .release-please-manifest.json
 delete mode 100644 release-please-config.json

diff --git a/.github/.OwlBot.lock.yaml b/.github/.OwlBot.lock.yaml
deleted file mode 100644
index 0ba6990347..0000000000
--- a/.github/.OwlBot.lock.yaml
+++ /dev/null
@@ -1,17 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-docker:
-  image: gcr.io/cloud-devrel-public-resources/owlbot-python:latest
-  digest: sha256:fbbc8db67afd8b7d71bf694c5081a32da0c528eba166fbcffb3b6e56ddf907d5
-# created: 2025-10-30T00:16:55.473963098Z
diff --git a/.github/.OwlBot.yaml b/.github/.OwlBot.yaml
deleted file mode 100644
index 5db16e2a9d..0000000000
--- a/.github/.OwlBot.yaml
+++ /dev/null
@@ -1,30 +0,0 @@
-# Copyright 2021 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-docker:
-  image: gcr.io/cloud-devrel-public-resources/owlbot-python:latest
-
-deep-remove-regex:
-  - /owl-bot-staging
-
-deep-copy-regex:
-  - source: /google/spanner/(v.*)/.*-py/(.*)
-    dest: /owl-bot-staging/spanner/$1/$2
-  - source: /google/spanner/admin/instance/(v.*)/.*-py/(.*)
-    dest: /owl-bot-staging/spanner_admin_instance/$1/$2
-  - source: /google/spanner/admin/database/(v.*)/.*-py/(.*)
-    dest: /owl-bot-staging/spanner_admin_database/$1/$2
-
-begin-after-commit-hash: b154da710c5c9eedee127c07f74b6158c9c22382
-
diff --git a/.github/release-please.yml b/.github/release-please.yml
deleted file mode 100644
index dbd2cc9deb..0000000000
--- a/.github/release-please.yml
+++ /dev/null
@@ -1,15 +0,0 @@
-releaseType: python
-handleGHRelease: true
-manifest: true
-# NOTE: this section is generated by synthtool.languages.python
-# See https://github.com/googleapis/synthtool/blob/master/synthtool/languages/python.py
-branches:
-- branch: v2
-  handleGHRelease: true
-  releaseType: python
-- branch: v1
-  handleGHRelease: true
-  releaseType: python
-- branch: v0
-  handleGHRelease: true
-  releaseType: python
diff --git a/.github/release-trigger.yml b/.github/release-trigger.yml
deleted file mode 100644
index 3c0f1bfc7e..0000000000
--- a/.github/release-trigger.yml
+++ /dev/null
@@ -1,2 +0,0 @@
-enabled: true
-multiScmName: python-spanner
diff --git a/.librarian/generator-input/.repo-metadata.json b/.librarian/generator-input/.repo-metadata.json
new file mode 100644
index 0000000000..9569af6e31
--- /dev/null
+++ b/.librarian/generator-input/.repo-metadata.json
@@ -0,0 +1,18 @@
+{
+    "name": "spanner",
+    "name_pretty": "Cloud Spanner",
+    "product_documentation": "https://cloud.google.com/spanner/docs/",
+    "client_documentation": "https://cloud.google.com/python/docs/reference/spanner/latest",
+    "issue_tracker": "https://issuetracker.google.com/issues?q=componentid:190851%2B%20status:open",
+    "release_level": "stable",
+    "language": "python",
+    "library_type": "GAPIC_COMBO",
+    "repo": "googleapis/python-spanner",
+    "distribution_name": "google-cloud-spanner",
+    "api_id": "spanner.googleapis.com",
+    "requires_billing": true,
+    "default_version": "v1",
+    "codeowner_team": "@googleapis/spanner-client-libraries-python",
+    "api_shortname": "spanner",
+    "api_description": "is a fully managed, mission-critical, \nrelational database service that offers transactional consistency at global scale, \nschemas, SQL (ANSI 2011 with extensions), and automatic, synchronous replication \nfor high availability.\n\nBe sure to activate the Cloud Spanner API on the Developer's Console to\nuse Cloud Spanner from your project."
+}
diff --git a/.librarian/generator-input/owlbot.py b/.librarian/generator-input/owlbot.py
new file mode 100644
index 0000000000..4547c4d2d0
--- /dev/null
+++ b/.librarian/generator-input/owlbot.py
@@ -0,0 +1,324 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""This script is used to synthesize generated parts of this library."""
+
+from pathlib import Path
+import shutil
+from typing import List, Optional
+import re
+
+import synthtool as s
+from synthtool import gcp
+from synthtool.languages import python
+
+common = gcp.CommonTemplates()
+
+
+def get_staging_dirs(
+    # This is a customized version of the s.get_staging_dirs() function
+    # from synthtool to # cater for copying 3 different folders from
+    # googleapis-gen:
+    # spanner, spanner/admin/instance and spanner/admin/database.
+    # Source:
+    # https://github.com/googleapis/synthtool/blob/master/synthtool/transforms.py#L280
+    default_version: Optional[str] = None,
+    sub_directory: Optional[str] = None,
+) -> List[Path]:
+    """Returns the list of directories, one per version, copied from
+    https://github.com/googleapis/googleapis-gen. Will return in lexical sorting
+    order with the exception of the default_version which will be last (if specified).
+
+    Args:
+      default_version (str): the default version of the API. The directory for this version
+        will be the last item in the returned list if specified.
+      sub_directory (str): if a `sub_directory` is provided, only the directories within the
+        specified `sub_directory` will be returned.
+
+    Returns: the empty list if no file were copied.
+    """
+
+    staging = Path("owl-bot-staging")
+
+    if sub_directory:
+        staging /= sub_directory
+
+    if staging.is_dir():
+        # Collect the subdirectories of the staging directory.
+        versions = [v.name for v in staging.iterdir() if v.is_dir()]
+        # Reorder the versions so the default version always comes last.
+        versions = [v for v in versions if v != default_version]
+        versions.sort()
+        if default_version is not None:
+            versions += [default_version]
+        dirs = [staging / v for v in versions]
+        for dir in dirs:
+            s._tracked_paths.add(dir)
+        return dirs
+    else:
+        return []
+
+
+spanner_default_version = "v1"
+spanner_admin_instance_default_version = "v1"
+spanner_admin_database_default_version = "v1"
+
+clean_up_generated_samples = True
+
+for library in get_staging_dirs(spanner_default_version, "spanner"):
+    if clean_up_generated_samples:
+        shutil.rmtree("samples/generated_samples", ignore_errors=True)
+        clean_up_generated_samples = False
+
+    # Customization for MetricsInterceptor
+
+    assert 6 == s.replace(
+        [
+            library / "google/cloud/spanner_v1/services/spanner/transports/*.py",
+            library / "google/cloud/spanner_v1/services/spanner/client.py",
+        ],
+        """from google.cloud.spanner_v1.types import transaction""",
+        """from google.cloud.spanner_v1.types import transaction
+from google.cloud.spanner_v1.metrics.metrics_interceptor import MetricsInterceptor""",
+    )
+
+    assert 1 == s.replace(
+        library / "google/cloud/spanner_v1/services/spanner/transports/*.py",
+        """api_audience: Optional\[str\] = None,
+            \*\*kwargs,
+            \) -> None:
+        \"\"\"Instantiate the transport.""",
+"""api_audience: Optional[str] = None,
+            metrics_interceptor: Optional[MetricsInterceptor] = None,
+            **kwargs,
+    ) -> None:
+        \"\"\"Instantiate the transport."""
+    )
+
+    assert 4 == s.replace(
+        library / "google/cloud/spanner_v1/services/spanner/transports/*.py",
+        """api_audience: Optional\[str\] = None,
+            \) -> None:
+        \"\"\"Instantiate the transport.""",
+"""api_audience: Optional[str] = None,
+            metrics_interceptor: Optional[MetricsInterceptor] = None,
+    ) -> None:
+        \"\"\"Instantiate the transport."""
+    )
+
+    assert 1 == s.replace(
+        library / "google/cloud/spanner_v1/services/spanner/transports/grpc.py",
+        """\)\n\n        self._interceptor = _LoggingClientInterceptor\(\)""",
+        """)
+
+        # Wrap the gRPC channel with the metric interceptor
+        if metrics_interceptor is not None:
+            self._metrics_interceptor = metrics_interceptor
+            self._grpc_channel = grpc.intercept_channel(
+                self._grpc_channel, metrics_interceptor
+            )
+
+        self._interceptor = _LoggingClientInterceptor()"""
+    )
+
+    assert 1 == s.replace(
+        library / "google/cloud/spanner_v1/services/spanner/transports/grpc.py",
+        """self._stubs: Dict\[str, Callable\] = \{\}\n\n        if api_mtls_endpoint:""",
+        """self._stubs: Dict[str, Callable] = {}
+        self._metrics_interceptor = None
+
+        if api_mtls_endpoint:"""
+    )
+
+    assert 1 == s.replace(
+        library / "google/cloud/spanner_v1/services/spanner/client.py",
+        """# initialize with the provided callable or the passed in class
+            self._transport = transport_init\(
+                credentials=credentials,
+                credentials_file=self._client_options.credentials_file,
+                host=self._api_endpoint,
+                scopes=self._client_options.scopes,
+                client_cert_source_for_mtls=self._client_cert_source,
+                quota_project_id=self._client_options.quota_project_id,
+                client_info=client_info,
+                always_use_jwt_access=True,
+                api_audience=self._client_options.api_audience,
+            \)""",
+            """# initialize with the provided callable or the passed in class
+            self._transport = transport_init(
+                credentials=credentials,
+                credentials_file=self._client_options.credentials_file,
+                host=self._api_endpoint,
+                scopes=self._client_options.scopes,
+                client_cert_source_for_mtls=self._client_cert_source,
+                quota_project_id=self._client_options.quota_project_id,
+                client_info=client_info,
+                always_use_jwt_access=True,
+                api_audience=self._client_options.api_audience,
+                metrics_interceptor=MetricsInterceptor(),
+            )""",
+    )
+
+    assert 12 == s.replace(
+        library / "tests/unit/gapic/spanner_v1/test_spanner.py",
+        """api_audience=None,\n(\s+)\)""",
+        """api_audience=None,
+            metrics_interceptor=mock.ANY,
+        )"""
+    )
+
+    assert 1 == s.replace(
+        library / "tests/unit/gapic/spanner_v1/test_spanner.py",
+        """api_audience="https://language.googleapis.com"\n(\s+)\)""",
+        """api_audience="https://language.googleapis.com",
+            metrics_interceptor=mock.ANY,
+        )"""
+    )
+
+    count = s.replace(
+        [
+            library / "google/cloud/spanner_v1/services/*/transports/grpc*",
+            library / "tests/unit/gapic/spanner_v1/*",
+        ],
+        "^\s+options=\\[.*?\\]",
+        """options=[
+                    ("grpc.max_send_message_length", -1),
+                    ("grpc.max_receive_message_length", -1),
+                    ("grpc.keepalive_time_ms", 120000),
+                ]""",
+        flags=re.MULTILINE | re.DOTALL,
+    )
+    if count < 1:
+        raise Exception("Expected replacements for gRPC channel options not made.")
+
+    s.move(
+        library,
+        excludes=[
+            "google/cloud/spanner/**",
+            "*.*",
+            "noxfile.py",
+            "docs/index.rst",
+            "google/cloud/spanner_v1/__init__.py",
+            "**/gapic_version.py",
+            "testing/constraints-3.7.txt",
+        ],
+    )
+
+for library in get_staging_dirs(
+    spanner_admin_instance_default_version, "spanner_admin_instance"
+):
+    count = s.replace(
+        [
+            library / "google/cloud/spanner_admin_instance_v1/services/*/transports/grpc*",
+            library / "tests/unit/gapic/spanner_admin_instance_v1/*",
+        ],
+        "^\s+options=\\[.*?\\]",
+        """options=[
+                    ("grpc.max_send_message_length", -1),
+                    ("grpc.max_receive_message_length", -1),
+                    ("grpc.keepalive_time_ms", 120000),
+                ]""",
+        flags=re.MULTILINE | re.DOTALL,
+    )
+    if count < 1:
+        raise Exception("Expected replacements for gRPC channel options not made.")
+    s.move(
+        library,
+        excludes=["google/cloud/spanner_admin_instance/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
+    )
+
+for library in get_staging_dirs(
+    spanner_admin_database_default_version, "spanner_admin_database"
+):
+    count = s.replace(
+        [
+            library / "google/cloud/spanner_admin_database_v1/services/*/transports/grpc*",
+            library / "tests/unit/gapic/spanner_admin_database_v1/*",
+        ],
+        "^\s+options=\\[.*?\\]",
+        """options=[
+                    ("grpc.max_send_message_length", -1),
+                    ("grpc.max_receive_message_length", -1),
+                    ("grpc.keepalive_time_ms", 120000),
+                ]""",
+        flags=re.MULTILINE | re.DOTALL,
+    )
+    if count < 1:
+        raise Exception("Expected replacements for gRPC channel options not made.")
+    s.move(
+        library,
+        excludes=["google/cloud/spanner_admin_database/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
+    )
+
+s.remove_staging_dirs()
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(
+    microgenerator=True,
+    samples=True,
+    cov_level=98,
+    split_system_tests=True,
+    system_test_extras=["tracing"],
+    system_test_python_versions=["3.12"]
+)
+s.move(
+    templated_files,
+    excludes=[
+        ".coveragerc",
+        ".github/workflows",  # exclude gh actions as credentials are needed for tests
+        "README.rst",
+        ".github/release-please.yml",
+        ".kokoro/test-samples-impl.sh",
+        ".kokoro/presubmit/presubmit.cfg",
+        ".kokoro/samples/python3.7/**",
+        ".kokoro/samples/python3.8/**",
+    ],
+)
+
+# Ensure CI runs on a new instance each time
+s.replace(
+    ".kokoro/build.sh",
+    "# Setup project id.",
+    """\
+# Set up creating a new instance for each system test run
+export GOOGLE_CLOUD_TESTS_CREATE_SPANNER_INSTANCE=true
+
+# Setup project id.""",
+)
+
+# Update samples folder in CONTRIBUTING.rst
+s.replace("CONTRIBUTING.rst", "samples/snippets", "samples/samples")
+
+# ----------------------------------------------------------------------------
+# Samples templates
+# ----------------------------------------------------------------------------
+
+python.py_samples()
+
+s.replace(
+    "samples/**/noxfile.py",
+    'BLACK_VERSION = "black==22.3.0"',
+    'BLACK_VERSION = "black==23.7.0"',
+)
+s.replace(
+    "samples/**/noxfile.py",
+    r'ALL_VERSIONS = \["3.7", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13"\]',
+    'ALL_VERSIONS = ["3.9", "3.10", "3.11", "3.12", "3.13"]',
+)
+
+# Use a python runtime which is available in the owlbot post processor here
+# https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
+s.shell.run(["nox", "-s", "blacken-3.10"], hide_output=False)
diff --git a/.librarian/state.yaml b/.librarian/state.yaml
new file mode 100644
index 0000000000..4d4416143e
--- /dev/null
+++ b/.librarian/state.yaml
@@ -0,0 +1,18 @@
+image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:27eae7edfe88876a47cbdb89ec6491192706e94ce46ac0e3ff4d202ef3220fed
+libraries:
+  - id: google-cloud-spanner
+    version: 3.59.0
+    last_generated_commit: 53f97391f3451398f7b53c7f86dabd325d205677
+    apis:
+      - path: google/spanner/v1
+        service_config: spanner.yaml
+      - path: google/spanner/admin/database/v1
+        service_config: spanner.yaml
+      - path: google/spanner/admin/instance/v1
+        service_config: spanner.yaml
+    source_roots:
+      - .
+    preserve_regex: []
+    remove_regex:
+      - google/spanner_v1
+    tag_format: v{version}
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
deleted file mode 100644
index 6c2193e315..0000000000
--- a/.release-please-manifest.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-    ".": "3.59.0"
-}
diff --git a/noxfile.py b/noxfile.py
index b101f46b2e..366147e1d0 100644
--- a/noxfile.py
+++ b/noxfile.py
@@ -32,10 +32,10 @@
 ISORT_VERSION = "isort==5.11.0"
 LINT_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
 
-DEFAULT_PYTHON_VERSION = "3.12"
+DEFAULT_PYTHON_VERSION = "3.14"
 
-DEFAULT_MOCK_SERVER_TESTS_PYTHON_VERSION = "3.12"
-SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.12"]
+DEFAULT_MOCK_SERVER_TESTS_PYTHON_VERSION = "3.14"
+SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.14"]
 
 UNIT_TEST_PYTHON_VERSIONS: List[str] = [
     "3.9",
diff --git a/owlbot.py b/owlbot.py
index 4547c4d2d0..83349b6375 100644
--- a/owlbot.py
+++ b/owlbot.py
@@ -14,10 +14,10 @@
 
 """This script is used to synthesize generated parts of this library."""
 
-from pathlib import Path
+import re
 import shutil
+from pathlib import Path
 from typing import List, Optional
-import re
 
 import synthtool as s
 from synthtool import gcp
@@ -99,11 +99,11 @@ def get_staging_dirs(
             \*\*kwargs,
             \) -> None:
         \"\"\"Instantiate the transport.""",
-"""api_audience: Optional[str] = None,
+        """api_audience: Optional[str] = None,
             metrics_interceptor: Optional[MetricsInterceptor] = None,
             **kwargs,
     ) -> None:
-        \"\"\"Instantiate the transport."""
+        \"\"\"Instantiate the transport.""",
     )
 
     assert 4 == s.replace(
@@ -111,10 +111,10 @@ def get_staging_dirs(
         """api_audience: Optional\[str\] = None,
             \) -> None:
         \"\"\"Instantiate the transport.""",
-"""api_audience: Optional[str] = None,
+        """api_audience: Optional[str] = None,
             metrics_interceptor: Optional[MetricsInterceptor] = None,
     ) -> None:
-        \"\"\"Instantiate the transport."""
+        \"\"\"Instantiate the transport.""",
     )
 
     assert 1 == s.replace(
@@ -129,7 +129,7 @@ def get_staging_dirs(
                 self._grpc_channel, metrics_interceptor
             )
 
-        self._interceptor = _LoggingClientInterceptor()"""
+        self._interceptor = _LoggingClientInterceptor()""",
     )
 
     assert 1 == s.replace(
@@ -138,7 +138,7 @@ def get_staging_dirs(
         """self._stubs: Dict[str, Callable] = {}
         self._metrics_interceptor = None
 
-        if api_mtls_endpoint:"""
+        if api_mtls_endpoint:""",
     )
 
     assert 1 == s.replace(
@@ -155,7 +155,7 @@ def get_staging_dirs(
                 always_use_jwt_access=True,
                 api_audience=self._client_options.api_audience,
             \)""",
-            """# initialize with the provided callable or the passed in class
+        """# initialize with the provided callable or the passed in class
             self._transport = transport_init(
                 credentials=credentials,
                 credentials_file=self._client_options.credentials_file,
@@ -175,7 +175,7 @@ def get_staging_dirs(
         """api_audience=None,\n(\s+)\)""",
         """api_audience=None,
             metrics_interceptor=mock.ANY,
-        )"""
+        )""",
     )
 
     assert 1 == s.replace(
@@ -183,7 +183,7 @@ def get_staging_dirs(
         """api_audience="https://language.googleapis.com"\n(\s+)\)""",
         """api_audience="https://language.googleapis.com",
             metrics_interceptor=mock.ANY,
-        )"""
+        )""",
     )
 
     count = s.replace(
@@ -220,7 +220,8 @@ def get_staging_dirs(
 ):
     count = s.replace(
         [
-            library / "google/cloud/spanner_admin_instance_v1/services/*/transports/grpc*",
+            library
+            / "google/cloud/spanner_admin_instance_v1/services/*/transports/grpc*",
             library / "tests/unit/gapic/spanner_admin_instance_v1/*",
         ],
         "^\s+options=\\[.*?\\]",
@@ -235,7 +236,14 @@ def get_staging_dirs(
         raise Exception("Expected replacements for gRPC channel options not made.")
     s.move(
         library,
-        excludes=["google/cloud/spanner_admin_instance/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
+        excludes=[
+            "google/cloud/spanner_admin_instance/**",
+            "*.*",
+            "docs/index.rst",
+            "noxfile.py",
+            "**/gapic_version.py",
+            "testing/constraints-3.7.txt",
+        ],
     )
 
 for library in get_staging_dirs(
@@ -243,7 +251,8 @@ def get_staging_dirs(
 ):
     count = s.replace(
         [
-            library / "google/cloud/spanner_admin_database_v1/services/*/transports/grpc*",
+            library
+            / "google/cloud/spanner_admin_database_v1/services/*/transports/grpc*",
             library / "tests/unit/gapic/spanner_admin_database_v1/*",
         ],
         "^\s+options=\\[.*?\\]",
@@ -258,7 +267,14 @@ def get_staging_dirs(
         raise Exception("Expected replacements for gRPC channel options not made.")
     s.move(
         library,
-        excludes=["google/cloud/spanner_admin_database/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
+        excludes=[
+            "google/cloud/spanner_admin_database/**",
+            "*.*",
+            "docs/index.rst",
+            "noxfile.py",
+            "**/gapic_version.py",
+            "testing/constraints-3.7.txt",
+        ],
     )
 
 s.remove_staging_dirs()
@@ -272,7 +288,7 @@ def get_staging_dirs(
     cov_level=98,
     split_system_tests=True,
     system_test_extras=["tracing"],
-    system_test_python_versions=["3.12"]
+    system_test_python_versions=["3.12"],
 )
 s.move(
     templated_files,
diff --git a/release-please-config.json b/release-please-config.json
deleted file mode 100644
index faae5c405c..0000000000
--- a/release-please-config.json
+++ /dev/null
@@ -1,35 +0,0 @@
-{
-    "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
-    "packages": {
-      ".": {
-        "release-type": "python",
-        "extra-files": [
-          "google/cloud/spanner_admin_instance_v1/gapic_version.py",
-          "google/cloud/spanner_v1/gapic_version.py",
-          "google/cloud/spanner_admin_database_v1/gapic_version.py",
-          {
-            "type": "json",
-            "path": "samples/generated_samples/snippet_metadata_google.spanner.v1.json",
-            "jsonpath": "$.clientLibrary.version"
-          },
-          {
-            "type": "json",
-            "path": "samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json",
-            "jsonpath": "$.clientLibrary.version"
-          },
-          {
-            "type": "json",
-            "path": "samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json",
-            "jsonpath": "$.clientLibrary.version"
-          }
-        ]
-      }
-    },
-    "release-type": "python",
-    "plugins": [
-      {
-        "type": "sentence-case"
-      }
-    ],
-    "initial-version": "0.1.0"
-}

From c0b2ba35647d426cdf375baeacd73e1708616606 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Wed, 5 Nov 2025 09:50:09 +0000
Subject: [PATCH 02/45] add setup file

---
 .github/release-trigger.yml          |   2 +
 .librarian/generator-input/owlbot.py |   2 +-
 .librarian/generator-input/setup.py  | 103 +++++++++++++++++++++++++++
 .release-please-manifest.json        |   3 +
 4 files changed, 109 insertions(+), 1 deletion(-)
 create mode 100644 .github/release-trigger.yml
 create mode 100644 .librarian/generator-input/setup.py
 create mode 100644 .release-please-manifest.json

diff --git a/.github/release-trigger.yml b/.github/release-trigger.yml
new file mode 100644
index 0000000000..3c0f1bfc7e
--- /dev/null
+++ b/.github/release-trigger.yml
@@ -0,0 +1,2 @@
+enabled: true
+multiScmName: python-spanner
diff --git a/.librarian/generator-input/owlbot.py b/.librarian/generator-input/owlbot.py
index 4547c4d2d0..c6d8445908 100644
--- a/.librarian/generator-input/owlbot.py
+++ b/.librarian/generator-input/owlbot.py
@@ -321,4 +321,4 @@ def get_staging_dirs(
 
 # Use a python runtime which is available in the owlbot post processor here
 # https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
-s.shell.run(["nox", "-s", "blacken-3.10"], hide_output=False)
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/.librarian/generator-input/setup.py b/.librarian/generator-input/setup.py
new file mode 100644
index 0000000000..858982f783
--- /dev/null
+++ b/.librarian/generator-input/setup.py
@@ -0,0 +1,103 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+import io
+import os
+
+import setuptools  # type: ignore
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+name = "google-cloud-spanner"
+
+
+description = "Google Cloud Spanner API client library"
+
+version = {}
+with open(os.path.join(package_root, "google/cloud/spanner_v1/gapic_version.py")) as fp:
+    exec(fp.read(), version)
+version = version["__version__"]
+
+if version[0] == "0":
+    release_status = "Development Status :: 4 - Beta"
+else:
+    release_status = "Development Status :: 5 - Production/Stable"
+
+dependencies = [
+    "google-api-core[grpc] >= 1.34.0, <3.0.0,!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,!=2.10.*",
+    "google-cloud-core >= 1.4.4, < 3.0.0",
+    "grpc-google-iam-v1 >= 0.12.4, <1.0.0",
+    "proto-plus >= 1.22.0, <2.0.0",
+    "sqlparse >= 0.4.4",
+    "proto-plus >= 1.22.2, <2.0.0; python_version>='3.11'",
+    "protobuf>=3.20.2,<7.0.0,!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5",
+    "grpc-interceptor >= 0.15.4",
+]
+extras = {
+    "tracing": [
+        "opentelemetry-api >= 1.22.0",
+        "opentelemetry-sdk >= 1.22.0",
+        "opentelemetry-semantic-conventions >= 0.43b0",
+        "opentelemetry-resourcedetector-gcp >= 1.8.0a0",
+        "google-cloud-monitoring >= 2.16.0",
+        "mmh3 >= 4.1.0 ",
+    ],
+    "libcst": "libcst >= 0.2.5",
+}
+
+url = "https://github.com/googleapis/python-spanner"
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package
+    for package in setuptools.find_namespace_packages()
+    if package.startswith("google")
+]
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url=url,
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=3.9",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
new file mode 100644
index 0000000000..6c2193e315
--- /dev/null
+++ b/.release-please-manifest.json
@@ -0,0 +1,3 @@
+{
+    ".": "3.59.0"
+}

From 58244e13bad7db0e651667661fef487a929b4e57 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Wed, 5 Nov 2025 18:38:04 +0000
Subject: [PATCH 03/45] update blacken

---
 owlbot.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/owlbot.py b/owlbot.py
index 83349b6375..e33e3a6f40 100644
--- a/owlbot.py
+++ b/owlbot.py
@@ -337,4 +337,4 @@ def get_staging_dirs(
 
 # Use a python runtime which is available in the owlbot post processor here
 # https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
-s.shell.run(["nox", "-s", "blacken-3.10"], hide_output=False)
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)

From 97f48f4374af1e15f8e1b8af5e728d0f52c39eda Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Wed, 5 Nov 2025 18:41:41 +0000
Subject: [PATCH 04/45] revert system test version to 3.12

---
 .librarian/generator-input/noxfile.py | 595 ++++++++++++++++++++++++++
 .librarian/state.yaml                 |   6 +-
 noxfile.py                            |   8 +-
 owlbot.py                             |  48 +--
 4 files changed, 619 insertions(+), 38 deletions(-)
 create mode 100644 .librarian/generator-input/noxfile.py

diff --git a/.librarian/generator-input/noxfile.py b/.librarian/generator-input/noxfile.py
new file mode 100644
index 0000000000..81c522d0d5
--- /dev/null
+++ b/.librarian/generator-input/noxfile.py
@@ -0,0 +1,595 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+
+import os
+import pathlib
+import re
+import shutil
+from typing import Dict, List
+import warnings
+
+import nox
+
+FLAKE8_VERSION = "flake8==6.1.0"
+BLACK_VERSION = "black[jupyter]==23.7.0"
+ISORT_VERSION = "isort==5.11.0"
+LINT_PATHS = ["google", "tests", "noxfile.py", "setup.py"]
+
+DEFAULT_PYTHON_VERSION = "3.14"
+
+DEFAULT_MOCK_SERVER_TESTS_PYTHON_VERSION = "3.12"
+SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.12"]
+
+UNIT_TEST_PYTHON_VERSIONS: List[str] = [
+    "3.9",
+    "3.10",
+    "3.11",
+    "3.12",
+    "3.13",
+]
+UNIT_TEST_STANDARD_DEPENDENCIES = [
+    "mock",
+    "asyncmock",
+    "pytest",
+    "pytest-cov",
+    "pytest-asyncio",
+]
+MOCK_SERVER_ADDITIONAL_DEPENDENCIES = [
+    "google-cloud-testutils",
+]
+UNIT_TEST_EXTERNAL_DEPENDENCIES: List[str] = []
+UNIT_TEST_LOCAL_DEPENDENCIES: List[str] = []
+UNIT_TEST_DEPENDENCIES: List[str] = []
+UNIT_TEST_EXTRAS: List[str] = []
+UNIT_TEST_EXTRAS_BY_PYTHON: Dict[str, List[str]] = {}
+
+SYSTEM_TEST_STANDARD_DEPENDENCIES: List[str] = [
+    "mock",
+    "pytest",
+    "google-cloud-testutils",
+]
+SYSTEM_TEST_EXTERNAL_DEPENDENCIES: List[str] = []
+SYSTEM_TEST_LOCAL_DEPENDENCIES: List[str] = []
+SYSTEM_TEST_DEPENDENCIES: List[str] = []
+SYSTEM_TEST_EXTRAS: List[str] = [
+    "tracing",
+]
+SYSTEM_TEST_EXTRAS_BY_PYTHON: Dict[str, List[str]] = {}
+
+CURRENT_DIRECTORY = pathlib.Path(__file__).parent.absolute()
+
+nox.options.sessions = [
+    "unit-3.9",
+    "unit-3.10",
+    "unit-3.11",
+    "unit-3.12",
+    "unit-3.13",
+    "system",
+    "cover",
+    "lint",
+    "lint_setup_py",
+    "blacken",
+    "docs",
+    "docfx",
+    "format",
+]
+
+# Error if a python version is missing
+nox.options.error_on_missing_interpreters = True
+
+
+@nox.session(python=DEFAULT_PYTHON_VERSION)
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install(FLAKE8_VERSION, BLACK_VERSION)
+    session.run(
+        "black",
+        "--check",
+        *LINT_PATHS,
+    )
+    session.run("flake8", "google", "tests")
+
+
+# Use a python runtime which is available in the owlbot post processor here
+# https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
+@nox.session(python=DEFAULT_PYTHON_VERSION)
+def blacken(session):
+    """Run black. Format code to uniform standard."""
+    session.install(BLACK_VERSION)
+    session.run(
+        "black",
+        *LINT_PATHS,
+    )
+
+
+@nox.session(python=DEFAULT_PYTHON_VERSION)
+def format(session):
+    """
+    Run isort to sort imports. Then run black
+    to format code to uniform standard.
+    """
+    session.install(BLACK_VERSION, ISORT_VERSION)
+    # Use the --fss option to sort imports using strict alphabetical order.
+    # See https://pycqa.github.io/isort/docs/configuration/options.html#force-sort-within-sections
+    session.run(
+        "isort",
+        "--fss",
+        *LINT_PATHS,
+    )
+    session.run(
+        "black",
+        *LINT_PATHS,
+    )
+
+
+@nox.session(python=DEFAULT_PYTHON_VERSION)
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments", "setuptools>=79.0.1")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def install_unittest_dependencies(session, *constraints):
+    standard_deps = UNIT_TEST_STANDARD_DEPENDENCIES + UNIT_TEST_DEPENDENCIES
+    session.install(*standard_deps, *constraints)
+
+    if UNIT_TEST_EXTERNAL_DEPENDENCIES:
+        warnings.warn(
+            "'unit_test_external_dependencies' is deprecated. Instead, please "
+            "use 'unit_test_dependencies' or 'unit_test_local_dependencies'.",
+            DeprecationWarning,
+        )
+        session.install(*UNIT_TEST_EXTERNAL_DEPENDENCIES, *constraints)
+
+    if UNIT_TEST_LOCAL_DEPENDENCIES:
+        session.install(*UNIT_TEST_LOCAL_DEPENDENCIES, *constraints)
+
+    if UNIT_TEST_EXTRAS_BY_PYTHON:
+        extras = UNIT_TEST_EXTRAS_BY_PYTHON.get(session.python, [])
+    elif UNIT_TEST_EXTRAS:
+        extras = UNIT_TEST_EXTRAS
+    else:
+        extras = []
+
+    if extras:
+        session.install("-e", f".[{','.join(extras)}]", *constraints)
+    else:
+        session.install("-e", ".", *constraints)
+
+    # XXX Work around Kokoro image's older pip, which borks the OT install.
+    session.run("pip", "install", "--upgrade", "pip")
+    constraints_path = str(
+        CURRENT_DIRECTORY / "testing" / f"constraints-{session.python}.txt"
+    )
+    session.install("-e", ".[tracing]", "-c", constraints_path)
+    # XXX: Dump installed versions to debug OT issue
+    session.run("pip", "list")
+
+
+@nox.session(python=UNIT_TEST_PYTHON_VERSIONS)
+@nox.parametrize(
+    "protobuf_implementation",
+    ["python", "upb", "cpp"],
+)
+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"):
+        session.skip("cpp implementation is not supported in python 3.11+")
+
+    constraints_path = str(
+        CURRENT_DIRECTORY / "testing" / f"constraints-{session.python}.txt"
+    )
+    install_unittest_dependencies(session, "-c", constraints_path)
+
+    # TODO(https://github.com/googleapis/synthtool/issues/1976):
+    # Remove the 'cpp' implementation once support for Protobuf 3.x is dropped.
+    # The 'cpp' implementation requires Protobuf<4.
+    if protobuf_implementation == "cpp":
+        session.install("protobuf<4")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        f"--junitxml=unit_{session.python}_sponge_log.xml",
+        "--cov=google",
+        "--cov=tests/unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+        env={
+            "PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION": protobuf_implementation,
+        },
+    )
+
+
+@nox.session(python=DEFAULT_MOCK_SERVER_TESTS_PYTHON_VERSION)
+def mockserver(session):
+    # Install all test dependencies, then install this package in-place.
+
+    constraints_path = str(
+        CURRENT_DIRECTORY / "testing" / f"constraints-{session.python}.txt"
+    )
+    standard_deps = (
+        UNIT_TEST_STANDARD_DEPENDENCIES
+        + UNIT_TEST_DEPENDENCIES
+        + MOCK_SERVER_ADDITIONAL_DEPENDENCIES
+    )
+    session.install(*standard_deps, "-c", constraints_path)
+    session.install("-e", ".", "-c", constraints_path)
+
+    # Run py.test against the mockserver tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        f"--junitxml=unit_{session.python}_sponge_log.xml",
+        "--cov=google",
+        "--cov=tests/unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "mockserver_tests"),
+        *session.posargs,
+    )
+
+
+def install_systemtest_dependencies(session, *constraints):
+    # Use pre-release gRPC for system tests.
+    # Exclude version 1.52.0rc1 which has a known issue.
+    # See https://github.com/grpc/grpc/issues/32163
+    session.install("--pre", "grpcio!=1.52.0rc1")
+
+    session.install(*SYSTEM_TEST_STANDARD_DEPENDENCIES, *constraints)
+
+    if SYSTEM_TEST_EXTERNAL_DEPENDENCIES:
+        session.install(*SYSTEM_TEST_EXTERNAL_DEPENDENCIES, *constraints)
+
+    if SYSTEM_TEST_LOCAL_DEPENDENCIES:
+        session.install("-e", *SYSTEM_TEST_LOCAL_DEPENDENCIES, *constraints)
+
+    if SYSTEM_TEST_DEPENDENCIES:
+        session.install("-e", *SYSTEM_TEST_DEPENDENCIES, *constraints)
+
+    if SYSTEM_TEST_EXTRAS_BY_PYTHON:
+        extras = SYSTEM_TEST_EXTRAS_BY_PYTHON.get(session.python, [])
+    elif SYSTEM_TEST_EXTRAS:
+        extras = SYSTEM_TEST_EXTRAS
+    else:
+        extras = []
+
+    if extras:
+        session.install("-e", f".[{','.join(extras)}]", *constraints)
+    else:
+        session.install("-e", ".", *constraints)
+
+
+@nox.session(python=SYSTEM_TEST_PYTHON_VERSIONS)
+@nox.parametrize(
+    "protobuf_implementation,database_dialect",
+    [
+        ("python", "GOOGLE_STANDARD_SQL"),
+        ("python", "POSTGRESQL"),
+        ("upb", "GOOGLE_STANDARD_SQL"),
+        ("upb", "POSTGRESQL"),
+        ("cpp", "GOOGLE_STANDARD_SQL"),
+        ("cpp", "POSTGRESQL"),
+    ],
+)
+def system(session, protobuf_implementation, database_dialect):
+    """Run the system test suite."""
+    constraints_path = str(
+        CURRENT_DIRECTORY / "testing" / f"constraints-{session.python}.txt"
+    )
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+
+    # Check the value of `RUN_SYSTEM_TESTS` env var. It defaults to true.
+    if os.environ.get("RUN_SYSTEM_TESTS", "true") == "false":
+        session.skip("RUN_SYSTEM_TESTS is set to false, skipping")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", "") and not os.environ.get(
+        "SPANNER_EMULATOR_HOST", ""
+    ):
+        session.skip(
+            "Credentials or emulator host must be set via environment variable"
+        )
+    if not (
+        os.environ.get("SPANNER_EMULATOR_HOST") or protobuf_implementation == "python"
+    ):
+        session.skip(
+            "Only run system tests on real Spanner with one protobuf implementation to speed up the build"
+        )
+
+    if protobuf_implementation == "cpp" and session.python in ("3.11", "3.12", "3.13"):
+        session.skip("cpp implementation is not supported in python 3.11+")
+
+    # Install pyopenssl for mTLS testing.
+    if os.environ.get("GOOGLE_API_USE_CLIENT_CERTIFICATE", "false") == "true":
+        session.install("pyopenssl")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    install_systemtest_dependencies(session, "-c", constraints_path)
+
+    # TODO(https://github.com/googleapis/synthtool/issues/1976):
+    # Remove the 'cpp' implementation once support for Protobuf 3.x is dropped.
+    # The 'cpp' implementation requires Protobuf<4.
+    if protobuf_implementation == "cpp":
+        session.install("protobuf<4")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run(
+            "py.test",
+            "--quiet",
+            f"--junitxml=system_{session.python}_sponge_log.xml",
+            system_test_path,
+            *session.posargs,
+            env={
+                "PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION": protobuf_implementation,
+                "SPANNER_DATABASE_DIALECT": database_dialect,
+                "SKIP_BACKUP_TESTS": "true",
+            },
+        )
+    elif system_test_folder_exists:
+        session.run(
+            "py.test",
+            "--quiet",
+            f"--junitxml=system_{session.python}_sponge_log.xml",
+            system_test_folder_path,
+            *session.posargs,
+            env={
+                "PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION": protobuf_implementation,
+                "SPANNER_DATABASE_DIALECT": database_dialect,
+                "SKIP_BACKUP_TESTS": "true",
+            },
+        )
+
+
+@nox.session(python=DEFAULT_PYTHON_VERSION)
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=98")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.10")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".[tracing]")
+    session.install(
+        # We need to pin to specific versions of the `sphinxcontrib-*` packages
+        # which still support sphinx 4.x.
+        # See https://github.com/googleapis/sphinx-docfx-yaml/issues/344
+        # and https://github.com/googleapis/sphinx-docfx-yaml/issues/345.
+        "sphinxcontrib-applehelp==1.0.4",
+        "sphinxcontrib-devhelp==1.0.2",
+        "sphinxcontrib-htmlhelp==2.0.1",
+        "sphinxcontrib-qthelp==1.0.3",
+        "sphinxcontrib-serializinghtml==1.1.5",
+        "sphinx==4.5.0",
+        "alabaster",
+        "recommonmark",
+    )
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
+
+
+@nox.session(python="3.10")
+def docfx(session):
+    """Build the docfx yaml files for this library."""
+
+    session.install("-e", ".[tracing]")
+    session.install(
+        # We need to pin to specific versions of the `sphinxcontrib-*` packages
+        # which still support sphinx 4.x.
+        # See https://github.com/googleapis/sphinx-docfx-yaml/issues/344
+        # and https://github.com/googleapis/sphinx-docfx-yaml/issues/345.
+        "sphinxcontrib-applehelp==1.0.4",
+        "sphinxcontrib-devhelp==1.0.2",
+        "sphinxcontrib-htmlhelp==2.0.1",
+        "sphinxcontrib-qthelp==1.0.3",
+        "sphinxcontrib-serializinghtml==1.1.5",
+        "gcp-sphinx-docfx-yaml",
+        "alabaster",
+        "recommonmark",
+    )
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-D",
+        (
+            "extensions=sphinx.ext.autodoc,"
+            "sphinx.ext.autosummary,"
+            "docfx_yaml.extension,"
+            "sphinx.ext.intersphinx,"
+            "sphinx.ext.coverage,"
+            "sphinx.ext.napoleon,"
+            "sphinx.ext.todo,"
+            "sphinx.ext.viewcode,"
+            "recommonmark"
+        ),
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
+
+
+@nox.session(python="3.13")
+@nox.parametrize(
+    "protobuf_implementation,database_dialect",
+    [
+        ("python", "GOOGLE_STANDARD_SQL"),
+        ("python", "POSTGRESQL"),
+        ("upb", "GOOGLE_STANDARD_SQL"),
+        ("upb", "POSTGRESQL"),
+        ("cpp", "GOOGLE_STANDARD_SQL"),
+        ("cpp", "POSTGRESQL"),
+    ],
+)
+def prerelease_deps(session, protobuf_implementation, database_dialect):
+    """Run all tests with prerelease versions of dependencies installed."""
+
+    if protobuf_implementation == "cpp" and session.python in ("3.11", "3.12", "3.13"):
+        session.skip("cpp implementation is not supported in python 3.11+")
+
+    # Install all dependencies
+    session.install("-e", ".[all, tests, tracing]")
+    unit_deps_all = UNIT_TEST_STANDARD_DEPENDENCIES + UNIT_TEST_EXTERNAL_DEPENDENCIES
+    session.install(*unit_deps_all)
+    system_deps_all = (
+        SYSTEM_TEST_STANDARD_DEPENDENCIES + SYSTEM_TEST_EXTERNAL_DEPENDENCIES
+    )
+    session.install(*system_deps_all)
+
+    # Because we test minimum dependency versions on the minimum Python
+    # version, the first version we test with in the unit tests sessions has a
+    # constraints file containing all dependencies and extras.
+    with open(
+        CURRENT_DIRECTORY
+        / "testing"
+        / f"constraints-{UNIT_TEST_PYTHON_VERSIONS[0]}.txt",
+        encoding="utf-8",
+    ) as constraints_file:
+        constraints_text = constraints_file.read()
+
+    # Ignore leading whitespace and comment lines.
+    constraints_deps = [
+        match.group(1)
+        for match in re.finditer(
+            r"^\s*([a-zA-Z0-9._-]+)", constraints_text, flags=re.MULTILINE
+        )
+    ]
+
+    if constraints_deps:
+        session.install(*constraints_deps)
+
+    prerel_deps = [
+        "protobuf",
+        # dependency of grpc
+        "six",
+        "grpc-google-iam-v1",
+        "googleapis-common-protos",
+        "grpcio",
+        "grpcio-status",
+        "google-api-core",
+        "google-auth",
+        "proto-plus",
+        "google-cloud-testutils",
+        # dependencies of google-cloud-testutils"
+        "click",
+    ]
+
+    for dep in prerel_deps:
+        session.install("--pre", "--no-deps", "--upgrade", dep)
+
+    # Remaining dependencies
+    other_deps = [
+        "requests",
+    ]
+    session.install(*other_deps)
+
+    # Print out prerelease package versions
+    session.run(
+        "python", "-c", "import google.protobuf; print(google.protobuf.__version__)"
+    )
+    session.run("python", "-c", "import grpc; print(grpc.__version__)")
+    session.run("python", "-c", "import google.auth; print(google.auth.__version__)")
+
+    session.run(
+        "py.test",
+        "tests/unit",
+        env={
+            "PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION": protobuf_implementation,
+            "SPANNER_DATABASE_DIALECT": database_dialect,
+            "SKIP_BACKUP_TESTS": "true",
+        },
+    )
+
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+
+    # Only run system tests for one protobuf implementation on real Spanner to speed up the build.
+    if os.environ.get("SPANNER_EMULATOR_HOST") or protobuf_implementation == "python":
+        # Only run system tests if found.
+        if os.path.exists(system_test_path):
+            session.run(
+                "py.test",
+                "--verbose",
+                f"--junitxml=system_{session.python}_sponge_log.xml",
+                system_test_path,
+                *session.posargs,
+                env={
+                    "PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION": protobuf_implementation,
+                    "SPANNER_DATABASE_DIALECT": database_dialect,
+                    "SKIP_BACKUP_TESTS": "true",
+                },
+            )
+        elif os.path.exists(system_test_folder_path):
+            session.run(
+                "py.test",
+                "--verbose",
+                f"--junitxml=system_{session.python}_sponge_log.xml",
+                system_test_folder_path,
+                *session.posargs,
+                env={
+                    "PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION": protobuf_implementation,
+                    "SPANNER_DATABASE_DIALECT": database_dialect,
+                    "SKIP_BACKUP_TESTS": "true",
+                },
+            )
diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 4d4416143e..32336eb8bf 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -2,7 +2,7 @@ image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-li
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0
-    last_generated_commit: 53f97391f3451398f7b53c7f86dabd325d205677
+    last_generated_commit: 3a77bd60b37c086effb39819e9183fbc83e3a693
     apis:
       - path: google/spanner/v1
         service_config: spanner.yaml
@@ -14,5 +14,7 @@ libraries:
       - .
     preserve_regex: []
     remove_regex:
-      - google/spanner_v1
+      - google/cloud/spanner_admin_database_v1
+      - google/cloud/spanner_admin_instance_v1
+      - google/cloud/spanner_v1
     tag_format: v{version}
diff --git a/noxfile.py b/noxfile.py
index 366147e1d0..81c522d0d5 100644
--- a/noxfile.py
+++ b/noxfile.py
@@ -30,12 +30,12 @@
 FLAKE8_VERSION = "flake8==6.1.0"
 BLACK_VERSION = "black[jupyter]==23.7.0"
 ISORT_VERSION = "isort==5.11.0"
-LINT_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+LINT_PATHS = ["google", "tests", "noxfile.py", "setup.py"]
 
 DEFAULT_PYTHON_VERSION = "3.14"
 
-DEFAULT_MOCK_SERVER_TESTS_PYTHON_VERSION = "3.14"
-SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.14"]
+DEFAULT_MOCK_SERVER_TESTS_PYTHON_VERSION = "3.12"
+SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.12"]
 
 UNIT_TEST_PYTHON_VERSIONS: List[str] = [
     "3.9",
@@ -113,7 +113,7 @@ def lint(session):
 
 # Use a python runtime which is available in the owlbot post processor here
 # https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
-@nox.session(python=["3.10", DEFAULT_PYTHON_VERSION])
+@nox.session(python=DEFAULT_PYTHON_VERSION)
 def blacken(session):
     """Run black. Format code to uniform standard."""
     session.install(BLACK_VERSION)
diff --git a/owlbot.py b/owlbot.py
index e33e3a6f40..c6d8445908 100644
--- a/owlbot.py
+++ b/owlbot.py
@@ -14,10 +14,10 @@
 
 """This script is used to synthesize generated parts of this library."""
 
-import re
-import shutil
 from pathlib import Path
+import shutil
 from typing import List, Optional
+import re
 
 import synthtool as s
 from synthtool import gcp
@@ -99,11 +99,11 @@ def get_staging_dirs(
             \*\*kwargs,
             \) -> None:
         \"\"\"Instantiate the transport.""",
-        """api_audience: Optional[str] = None,
+"""api_audience: Optional[str] = None,
             metrics_interceptor: Optional[MetricsInterceptor] = None,
             **kwargs,
     ) -> None:
-        \"\"\"Instantiate the transport.""",
+        \"\"\"Instantiate the transport."""
     )
 
     assert 4 == s.replace(
@@ -111,10 +111,10 @@ def get_staging_dirs(
         """api_audience: Optional\[str\] = None,
             \) -> None:
         \"\"\"Instantiate the transport.""",
-        """api_audience: Optional[str] = None,
+"""api_audience: Optional[str] = None,
             metrics_interceptor: Optional[MetricsInterceptor] = None,
     ) -> None:
-        \"\"\"Instantiate the transport.""",
+        \"\"\"Instantiate the transport."""
     )
 
     assert 1 == s.replace(
@@ -129,7 +129,7 @@ def get_staging_dirs(
                 self._grpc_channel, metrics_interceptor
             )
 
-        self._interceptor = _LoggingClientInterceptor()""",
+        self._interceptor = _LoggingClientInterceptor()"""
     )
 
     assert 1 == s.replace(
@@ -138,7 +138,7 @@ def get_staging_dirs(
         """self._stubs: Dict[str, Callable] = {}
         self._metrics_interceptor = None
 
-        if api_mtls_endpoint:""",
+        if api_mtls_endpoint:"""
     )
 
     assert 1 == s.replace(
@@ -155,7 +155,7 @@ def get_staging_dirs(
                 always_use_jwt_access=True,
                 api_audience=self._client_options.api_audience,
             \)""",
-        """# initialize with the provided callable or the passed in class
+            """# initialize with the provided callable or the passed in class
             self._transport = transport_init(
                 credentials=credentials,
                 credentials_file=self._client_options.credentials_file,
@@ -175,7 +175,7 @@ def get_staging_dirs(
         """api_audience=None,\n(\s+)\)""",
         """api_audience=None,
             metrics_interceptor=mock.ANY,
-        )""",
+        )"""
     )
 
     assert 1 == s.replace(
@@ -183,7 +183,7 @@ def get_staging_dirs(
         """api_audience="https://language.googleapis.com"\n(\s+)\)""",
         """api_audience="https://language.googleapis.com",
             metrics_interceptor=mock.ANY,
-        )""",
+        )"""
     )
 
     count = s.replace(
@@ -220,8 +220,7 @@ def get_staging_dirs(
 ):
     count = s.replace(
         [
-            library
-            / "google/cloud/spanner_admin_instance_v1/services/*/transports/grpc*",
+            library / "google/cloud/spanner_admin_instance_v1/services/*/transports/grpc*",
             library / "tests/unit/gapic/spanner_admin_instance_v1/*",
         ],
         "^\s+options=\\[.*?\\]",
@@ -236,14 +235,7 @@ def get_staging_dirs(
         raise Exception("Expected replacements for gRPC channel options not made.")
     s.move(
         library,
-        excludes=[
-            "google/cloud/spanner_admin_instance/**",
-            "*.*",
-            "docs/index.rst",
-            "noxfile.py",
-            "**/gapic_version.py",
-            "testing/constraints-3.7.txt",
-        ],
+        excludes=["google/cloud/spanner_admin_instance/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
     )
 
 for library in get_staging_dirs(
@@ -251,8 +243,7 @@ def get_staging_dirs(
 ):
     count = s.replace(
         [
-            library
-            / "google/cloud/spanner_admin_database_v1/services/*/transports/grpc*",
+            library / "google/cloud/spanner_admin_database_v1/services/*/transports/grpc*",
             library / "tests/unit/gapic/spanner_admin_database_v1/*",
         ],
         "^\s+options=\\[.*?\\]",
@@ -267,14 +258,7 @@ def get_staging_dirs(
         raise Exception("Expected replacements for gRPC channel options not made.")
     s.move(
         library,
-        excludes=[
-            "google/cloud/spanner_admin_database/**",
-            "*.*",
-            "docs/index.rst",
-            "noxfile.py",
-            "**/gapic_version.py",
-            "testing/constraints-3.7.txt",
-        ],
+        excludes=["google/cloud/spanner_admin_database/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
     )
 
 s.remove_staging_dirs()
@@ -288,7 +272,7 @@ def get_staging_dirs(
     cov_level=98,
     split_system_tests=True,
     system_test_extras=["tracing"],
-    system_test_python_versions=["3.12"],
+    system_test_python_versions=["3.12"]
 )
 s.move(
     templated_files,

From f1c559e6340adafdeae9994bb87c1a784f9b5901 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Thu, 6 Nov 2025 10:21:32 +0000
Subject: [PATCH 05/45] wip

---
 .librarian/generator-input/config.yaml | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 .librarian/generator-input/config.yaml

diff --git a/.librarian/generator-input/config.yaml b/.librarian/generator-input/config.yaml
new file mode 100644
index 0000000000..8d9022e45b
--- /dev/null
+++ b/.librarian/generator-input/config.yaml
@@ -0,0 +1,6 @@
+global_files_allowlist:
+  # Allow the container to read and write the root `CHANGELOG.md`
+  # file during the `release` step to update the latest client library
+  # versions which are hardcoded in the file.
+  - path: "CHANGELOG.md"
+    permissions: "read-write"
\ No newline at end of file

From f5bb5b05e85286778a9f997935fdbf46ab92157e Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Thu, 6 Nov 2025 11:25:11 +0000
Subject: [PATCH 06/45] wip

---
 .librarian/generator-input/owlbot.py | 2 +-
 .librarian/state.yaml                | 5 +----
 owlbot.py                            | 2 +-
 3 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/.librarian/generator-input/owlbot.py b/.librarian/generator-input/owlbot.py
index c6d8445908..deda1925b4 100644
--- a/.librarian/generator-input/owlbot.py
+++ b/.librarian/generator-input/owlbot.py
@@ -321,4 +321,4 @@ def get_staging_dirs(
 
 # Use a python runtime which is available in the owlbot post processor here
 # https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
-s.shell.run(["nox", "-s", "blacken"], hide_output=False)
+s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)
diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 32336eb8bf..028e6d89a4 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -13,8 +13,5 @@ libraries:
     source_roots:
       - .
     preserve_regex: []
-    remove_regex:
-      - google/cloud/spanner_admin_database_v1
-      - google/cloud/spanner_admin_instance_v1
-      - google/cloud/spanner_v1
+    remove_regex: []
     tag_format: v{version}
diff --git a/owlbot.py b/owlbot.py
index c6d8445908..deda1925b4 100644
--- a/owlbot.py
+++ b/owlbot.py
@@ -321,4 +321,4 @@ def get_staging_dirs(
 
 # Use a python runtime which is available in the owlbot post processor here
 # https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
-s.shell.run(["nox", "-s", "blacken"], hide_output=False)
+s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)

From 8fac832a646b443fc9c86801651bc907ac895ebe Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Thu, 6 Nov 2025 12:16:54 +0000
Subject: [PATCH 07/45] wip

---
 .librarian/state.yaml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 028e6d89a4..32336eb8bf 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -13,5 +13,8 @@ libraries:
     source_roots:
       - .
     preserve_regex: []
-    remove_regex: []
+    remove_regex:
+      - google/cloud/spanner_admin_database_v1
+      - google/cloud/spanner_admin_instance_v1
+      - google/cloud/spanner_v1
     tag_format: v{version}

From 27df1a4f7bfb6d4ab09473979004b243cd59bd1d Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Thu, 6 Nov 2025 12:17:10 +0000
Subject: [PATCH 08/45] wip

---
 .librarian/state.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 32336eb8bf..c2d9c98129 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -1,4 +1,4 @@
-image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:27eae7edfe88876a47cbdb89ec6491192706e94ce46ac0e3ff4d202ef3220fed
+image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator:latest
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0

From 1047741949343bd0970827c7142676a2ca2582e1 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Thu, 6 Nov 2025 12:33:11 +0000
Subject: [PATCH 09/45] wip

---
 .librarian/state.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index c2d9c98129..f25e5e4244 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -17,4 +17,5 @@ libraries:
       - google/cloud/spanner_admin_database_v1
       - google/cloud/spanner_admin_instance_v1
       - google/cloud/spanner_v1
+      - .coveragerc
     tag_format: v{version}

From 4ad99dcbbf84d324a88764cdbde1cbc38b0e6e33 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Thu, 6 Nov 2025 12:37:55 +0000
Subject: [PATCH 10/45] wip

---
 .librarian/state.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index f25e5e4244..6f79da14e8 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -18,4 +18,5 @@ libraries:
       - google/cloud/spanner_admin_instance_v1
       - google/cloud/spanner_v1
       - .coveragerc
+      - .flake8
     tag_format: v{version}

From 125179aa69ae75f090d78fdfcf995fdddbda7d88 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Thu, 6 Nov 2025 12:41:09 +0000
Subject: [PATCH 11/45] wip

---
 .librarian/state.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 6f79da14e8..fba286ff59 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -19,4 +19,6 @@ libraries:
       - google/cloud/spanner_v1
       - .coveragerc
       - .flake8
+      - .github
+      - .gitignore
     tag_format: v{version}

From 8201304f5505e78f00e704ade76612186d3efe44 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Thu, 6 Nov 2025 23:19:04 +0000
Subject: [PATCH 12/45] wip

---
 .librarian/state.yaml | 31 ++++++++++++++++++++++++-------
 1 file changed, 24 insertions(+), 7 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index fba286ff59..f77a1752a5 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -14,11 +14,28 @@ libraries:
       - .
     preserve_regex: []
     remove_regex:
-      - google/cloud/spanner_admin_database_v1
-      - google/cloud/spanner_admin_instance_v1
-      - google/cloud/spanner_v1
-      - .coveragerc
-      - .flake8
-      - .github
-      - .gitignore
+      - ^google/pubsub
+      - ^google/pubsub_v1
+      - ^tests/unit/gapic
+      - ^tests/__init__.py
+      - ^tests/unit/__init__.py
+      - ^.coveragerc
+      - ^.flake8
+      - ^.pre-commit-config.yaml
+      - ^.repo-metadata.json
+      - ^.trampolinerc
+      - ^LICENSE
+      - ^MANIFEST.in
+      - ^SECURITY.md
+      - ^mypy.ini
+      - ^noxfile.py
+      - ^owlbot.py
+      - ^renovate.json
+      - ^samples/AUTHORING_GUIDE.md
+      - ^samples/CONTRIBUTING.md
+      - ^samples/generated_samples
+      - ^scripts/fixup_pubsub_v1_keywords.py
+      - ^setup.py
+      - ^testing/constraints-3.9
+      - ^testing/constraints-3.1
     tag_format: v{version}

From 5f89e3318d83f776775f45922fcd9011c45db9b1 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 00:18:34 +0000
Subject: [PATCH 13/45] wip

---
 .librarian/state.yaml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index f77a1752a5..49d9506906 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -1,4 +1,4 @@
-image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator:latest
+image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:27eae7edfe88876a47cbdb89ec6491192706e94ce46ac0e3ff4d202ef3220fed
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0
@@ -14,8 +14,9 @@ libraries:
       - .
     preserve_regex: []
     remove_regex:
-      - ^google/pubsub
-      - ^google/pubsub_v1
+      - ^google/cloud/spanner_v1
+      - ^google/cloud/spanner_admin_database_v1
+      - ^google/cloud/spanner_admin_instance_v1
       - ^tests/unit/gapic
       - ^tests/__init__.py
       - ^tests/unit/__init__.py

From c916a9204e47c5d5a84c94051f789fb469d02f6d Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 00:33:14 +0000
Subject: [PATCH 14/45] wip

---
 .librarian/state.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 49d9506906..25493fcb8d 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -14,7 +14,7 @@ libraries:
       - .
     preserve_regex: []
     remove_regex:
-      - ^google/cloud/spanner_v1
+      - ^google/cloud/spanner_v1/services/spanner
       - ^google/cloud/spanner_admin_database_v1
       - ^google/cloud/spanner_admin_instance_v1
       - ^tests/unit/gapic

From 5adda80dbfd4cf0f44d7da465aef047104d93a93 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 01:02:58 +0000
Subject: [PATCH 15/45] wip

---
 .librarian/state.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 25493fcb8d..76d6c8dc1a 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -1,4 +1,4 @@
-image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:27eae7edfe88876a47cbdb89ec6491192706e94ce46ac0e3ff4d202ef3220fed
+image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator:latest
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0

From dc42efccd921e842f6d0e07bb76b5a83c6397474 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 01:20:09 +0000
Subject: [PATCH 16/45] wip

---
 owlbot.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/owlbot.py b/owlbot.py
index deda1925b4..0abf22c6da 100644
--- a/owlbot.py
+++ b/owlbot.py
@@ -76,7 +76,7 @@ def get_staging_dirs(
 
 clean_up_generated_samples = True
 
-for library in get_staging_dirs(spanner_default_version, "spanner"):
+for library in get_staging_dirs("v1"):
     if clean_up_generated_samples:
         shutil.rmtree("samples/generated_samples", ignore_errors=True)
         clean_up_generated_samples = False

From 7fc29481632cfd8d8e84070e2027f55d13490236 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 01:20:43 +0000
Subject: [PATCH 17/45] wip

---
 .librarian/generator-input/owlbot.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.librarian/generator-input/owlbot.py b/.librarian/generator-input/owlbot.py
index deda1925b4..0abf22c6da 100644
--- a/.librarian/generator-input/owlbot.py
+++ b/.librarian/generator-input/owlbot.py
@@ -76,7 +76,7 @@ def get_staging_dirs(
 
 clean_up_generated_samples = True
 
-for library in get_staging_dirs(spanner_default_version, "spanner"):
+for library in get_staging_dirs("v1"):
     if clean_up_generated_samples:
         shutil.rmtree("samples/generated_samples", ignore_errors=True)
         clean_up_generated_samples = False

From 6658906d2a2b5f59eca51e2233ff8426e5ef9cfa Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 01:34:30 +0000
Subject: [PATCH 18/45] wip

---
 .librarian/generator-input/owlbot.py | 87 +++++-----------------------
 1 file changed, 14 insertions(+), 73 deletions(-)

diff --git a/.librarian/generator-input/owlbot.py b/.librarian/generator-input/owlbot.py
index 0abf22c6da..be6abc988e 100644
--- a/.librarian/generator-input/owlbot.py
+++ b/.librarian/generator-input/owlbot.py
@@ -25,58 +25,9 @@
 
 common = gcp.CommonTemplates()
 
-
-def get_staging_dirs(
-    # This is a customized version of the s.get_staging_dirs() function
-    # from synthtool to # cater for copying 3 different folders from
-    # googleapis-gen:
-    # spanner, spanner/admin/instance and spanner/admin/database.
-    # Source:
-    # https://github.com/googleapis/synthtool/blob/master/synthtool/transforms.py#L280
-    default_version: Optional[str] = None,
-    sub_directory: Optional[str] = None,
-) -> List[Path]:
-    """Returns the list of directories, one per version, copied from
-    https://github.com/googleapis/googleapis-gen. Will return in lexical sorting
-    order with the exception of the default_version which will be last (if specified).
-
-    Args:
-      default_version (str): the default version of the API. The directory for this version
-        will be the last item in the returned list if specified.
-      sub_directory (str): if a `sub_directory` is provided, only the directories within the
-        specified `sub_directory` will be returned.
-
-    Returns: the empty list if no file were copied.
-    """
-
-    staging = Path("owl-bot-staging")
-
-    if sub_directory:
-        staging /= sub_directory
-
-    if staging.is_dir():
-        # Collect the subdirectories of the staging directory.
-        versions = [v.name for v in staging.iterdir() if v.is_dir()]
-        # Reorder the versions so the default version always comes last.
-        versions = [v for v in versions if v != default_version]
-        versions.sort()
-        if default_version is not None:
-            versions += [default_version]
-        dirs = [staging / v for v in versions]
-        for dir in dirs:
-            s._tracked_paths.add(dir)
-        return dirs
-    else:
-        return []
-
-
-spanner_default_version = "v1"
-spanner_admin_instance_default_version = "v1"
-spanner_admin_database_default_version = "v1"
-
 clean_up_generated_samples = True
 
-for library in get_staging_dirs("v1"):
+for library in "v1":
     if clean_up_generated_samples:
         shutil.rmtree("samples/generated_samples", ignore_errors=True)
         clean_up_generated_samples = False
@@ -202,22 +153,7 @@ def get_staging_dirs(
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
 
-    s.move(
-        library,
-        excludes=[
-            "google/cloud/spanner/**",
-            "*.*",
-            "noxfile.py",
-            "docs/index.rst",
-            "google/cloud/spanner_v1/__init__.py",
-            "**/gapic_version.py",
-            "testing/constraints-3.7.txt",
-        ],
-    )
 
-for library in get_staging_dirs(
-    spanner_admin_instance_default_version, "spanner_admin_instance"
-):
     count = s.replace(
         [
             library / "google/cloud/spanner_admin_instance_v1/services/*/transports/grpc*",
@@ -233,14 +169,7 @@ def get_staging_dirs(
     )
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
-    s.move(
-        library,
-        excludes=["google/cloud/spanner_admin_instance/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
-    )
 
-for library in get_staging_dirs(
-    spanner_admin_database_default_version, "spanner_admin_database"
-):
     count = s.replace(
         [
             library / "google/cloud/spanner_admin_database_v1/services/*/transports/grpc*",
@@ -256,11 +185,23 @@ def get_staging_dirs(
     )
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
+    
     s.move(
         library,
-        excludes=["google/cloud/spanner_admin_database/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
+        excludes=[
+            "google/cloud/spanner/**",
+            "google/cloud/spanner_admin_instance/**"
+            "google/cloud/spanner_admin_database/**"
+            "*.*",
+            "noxfile.py",
+            "docs/index.rst",
+            "google/cloud/spanner_v1/__init__.py",
+            "**/gapic_version.py",
+            "testing/constraints-3.7.txt",
+        ],
     )
 
+
 s.remove_staging_dirs()
 
 # ----------------------------------------------------------------------------

From 5c600887cdfb3a2d3e21b7c5ea4ce863c81c1c44 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 01:40:04 +0000
Subject: [PATCH 19/45] wip

---
 config.yaml |  6 ++++
 owlbot.py   | 87 +++++++++--------------------------------------------
 2 files changed, 20 insertions(+), 73 deletions(-)
 create mode 100644 config.yaml

diff --git a/config.yaml b/config.yaml
new file mode 100644
index 0000000000..8d9022e45b
--- /dev/null
+++ b/config.yaml
@@ -0,0 +1,6 @@
+global_files_allowlist:
+  # Allow the container to read and write the root `CHANGELOG.md`
+  # file during the `release` step to update the latest client library
+  # versions which are hardcoded in the file.
+  - path: "CHANGELOG.md"
+    permissions: "read-write"
\ No newline at end of file
diff --git a/owlbot.py b/owlbot.py
index 0abf22c6da..f9ca02c02c 100644
--- a/owlbot.py
+++ b/owlbot.py
@@ -25,58 +25,9 @@
 
 common = gcp.CommonTemplates()
 
-
-def get_staging_dirs(
-    # This is a customized version of the s.get_staging_dirs() function
-    # from synthtool to # cater for copying 3 different folders from
-    # googleapis-gen:
-    # spanner, spanner/admin/instance and spanner/admin/database.
-    # Source:
-    # https://github.com/googleapis/synthtool/blob/master/synthtool/transforms.py#L280
-    default_version: Optional[str] = None,
-    sub_directory: Optional[str] = None,
-) -> List[Path]:
-    """Returns the list of directories, one per version, copied from
-    https://github.com/googleapis/googleapis-gen. Will return in lexical sorting
-    order with the exception of the default_version which will be last (if specified).
-
-    Args:
-      default_version (str): the default version of the API. The directory for this version
-        will be the last item in the returned list if specified.
-      sub_directory (str): if a `sub_directory` is provided, only the directories within the
-        specified `sub_directory` will be returned.
-
-    Returns: the empty list if no file were copied.
-    """
-
-    staging = Path("owl-bot-staging")
-
-    if sub_directory:
-        staging /= sub_directory
-
-    if staging.is_dir():
-        # Collect the subdirectories of the staging directory.
-        versions = [v.name for v in staging.iterdir() if v.is_dir()]
-        # Reorder the versions so the default version always comes last.
-        versions = [v for v in versions if v != default_version]
-        versions.sort()
-        if default_version is not None:
-            versions += [default_version]
-        dirs = [staging / v for v in versions]
-        for dir in dirs:
-            s._tracked_paths.add(dir)
-        return dirs
-    else:
-        return []
-
-
-spanner_default_version = "v1"
-spanner_admin_instance_default_version = "v1"
-spanner_admin_database_default_version = "v1"
-
 clean_up_generated_samples = True
 
-for library in get_staging_dirs("v1"):
+for library in s.get_staging_dirs("v1"):
     if clean_up_generated_samples:
         shutil.rmtree("samples/generated_samples", ignore_errors=True)
         clean_up_generated_samples = False
@@ -202,22 +153,7 @@ def get_staging_dirs(
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
 
-    s.move(
-        library,
-        excludes=[
-            "google/cloud/spanner/**",
-            "*.*",
-            "noxfile.py",
-            "docs/index.rst",
-            "google/cloud/spanner_v1/__init__.py",
-            "**/gapic_version.py",
-            "testing/constraints-3.7.txt",
-        ],
-    )
 
-for library in get_staging_dirs(
-    spanner_admin_instance_default_version, "spanner_admin_instance"
-):
     count = s.replace(
         [
             library / "google/cloud/spanner_admin_instance_v1/services/*/transports/grpc*",
@@ -233,14 +169,7 @@ def get_staging_dirs(
     )
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
-    s.move(
-        library,
-        excludes=["google/cloud/spanner_admin_instance/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
-    )
 
-for library in get_staging_dirs(
-    spanner_admin_database_default_version, "spanner_admin_database"
-):
     count = s.replace(
         [
             library / "google/cloud/spanner_admin_database_v1/services/*/transports/grpc*",
@@ -256,11 +185,23 @@ def get_staging_dirs(
     )
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
+    
     s.move(
         library,
-        excludes=["google/cloud/spanner_admin_database/**", "*.*", "docs/index.rst", "noxfile.py", "**/gapic_version.py", "testing/constraints-3.7.txt",],
+        excludes=[
+            "google/cloud/spanner/**",
+            "google/cloud/spanner_admin_instance/**"
+            "google/cloud/spanner_admin_database/**"
+            "*.*",
+            "noxfile.py",
+            "docs/index.rst",
+            "google/cloud/spanner_v1/__init__.py",
+            "**/gapic_version.py",
+            "testing/constraints-3.7.txt",
+        ],
     )
 
+
 s.remove_staging_dirs()
 
 # ----------------------------------------------------------------------------

From b45b0a2704ddc479f568106a522b5a6eadfcddc2 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 01:42:23 +0000
Subject: [PATCH 20/45] wip

---
 .librarian/generator-input/owlbot.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.librarian/generator-input/owlbot.py b/.librarian/generator-input/owlbot.py
index be6abc988e..f9ca02c02c 100644
--- a/.librarian/generator-input/owlbot.py
+++ b/.librarian/generator-input/owlbot.py
@@ -27,7 +27,7 @@
 
 clean_up_generated_samples = True
 
-for library in "v1":
+for library in s.get_staging_dirs("v1"):
     if clean_up_generated_samples:
         shutil.rmtree("samples/generated_samples", ignore_errors=True)
         clean_up_generated_samples = False

From a53781a4d88279463dd4778898f2940d60d7428c Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 01:58:56 +0000
Subject: [PATCH 21/45] wip

---
 .librarian/state.yaml | 14 +++++++++++++-
 owlbot.py             | 29 +++++------------------------
 2 files changed, 18 insertions(+), 25 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 76d6c8dc1a..fde54f5a1b 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -14,7 +14,10 @@ libraries:
       - .
     preserve_regex: []
     remove_regex:
-      - ^google/cloud/spanner_v1/services/spanner
+      - ^google/cloud/spanner_v1/gapic_metadata.json
+      - ^google/cloud/spanner_v1/gapic_version.py
+      - ^google/cloud/spanner_v1/py.typed
+      - ^google/cloud/spanner_v1/services
       - ^google/cloud/spanner_admin_database_v1
       - ^google/cloud/spanner_admin_instance_v1
       - ^tests/unit/gapic
@@ -39,4 +42,13 @@ libraries:
       - ^setup.py
       - ^testing/constraints-3.9
       - ^testing/constraints-3.1
+      - ^docs/_static
+      - ^docs/_templates
+      - ^docs/spanner_v1
+      - ^docs/spanner_admin_database_v1
+      - ^docs/spanner_admin_instance_v1
+      - ^docs/conf.py
+      - ^docs/index.rst
+      - ^docs/multiprocessing.rst
+      - ^docs/summary_overview.md
     tag_format: v{version}
diff --git a/owlbot.py b/owlbot.py
index f9ca02c02c..4f85d064a8 100644
--- a/owlbot.py
+++ b/owlbot.py
@@ -153,7 +153,6 @@
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
 
-
     count = s.replace(
         [
             library / "google/cloud/spanner_admin_instance_v1/services/*/transports/grpc*",
@@ -185,23 +184,20 @@
     )
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
-    
     s.move(
         library,
         excludes=[
             "google/cloud/spanner/**",
-            "google/cloud/spanner_admin_instance/**"
-            "google/cloud/spanner_admin_database/**"
             "*.*",
             "noxfile.py",
             "docs/index.rst",
             "google/cloud/spanner_v1/__init__.py",
-            "**/gapic_version.py",
             "testing/constraints-3.7.txt",
+            "google/cloud/spanner_admin_instance/**",
+            "google/cloud/spanner_admin_database/**"
         ],
     )
 
-
 s.remove_staging_dirs()
 
 # ----------------------------------------------------------------------------
@@ -219,27 +215,12 @@
     templated_files,
     excludes=[
         ".coveragerc",
-        ".github/workflows",  # exclude gh actions as credentials are needed for tests
+        ".github/**",
+        ".kokoro/**",
         "README.rst",
-        ".github/release-please.yml",
-        ".kokoro/test-samples-impl.sh",
-        ".kokoro/presubmit/presubmit.cfg",
-        ".kokoro/samples/python3.7/**",
-        ".kokoro/samples/python3.8/**",
     ],
 )
 
-# Ensure CI runs on a new instance each time
-s.replace(
-    ".kokoro/build.sh",
-    "# Setup project id.",
-    """\
-# Set up creating a new instance for each system test run
-export GOOGLE_CLOUD_TESTS_CREATE_SPANNER_INSTANCE=true
-
-# Setup project id.""",
-)
-
 # Update samples folder in CONTRIBUTING.rst
 s.replace("CONTRIBUTING.rst", "samples/snippets", "samples/samples")
 
@@ -262,4 +243,4 @@
 
 # Use a python runtime which is available in the owlbot post processor here
 # https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
-s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)
+s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)
\ No newline at end of file

From e8084053dee0e3982bc6c666efaddeeff7f4ea9d Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 02:02:48 +0000
Subject: [PATCH 22/45] wip

---
 .librarian/generator-input/owlbot.py | 29 +++++-----------------------
 1 file changed, 5 insertions(+), 24 deletions(-)

diff --git a/.librarian/generator-input/owlbot.py b/.librarian/generator-input/owlbot.py
index f9ca02c02c..4f85d064a8 100644
--- a/.librarian/generator-input/owlbot.py
+++ b/.librarian/generator-input/owlbot.py
@@ -153,7 +153,6 @@
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
 
-
     count = s.replace(
         [
             library / "google/cloud/spanner_admin_instance_v1/services/*/transports/grpc*",
@@ -185,23 +184,20 @@
     )
     if count < 1:
         raise Exception("Expected replacements for gRPC channel options not made.")
-    
     s.move(
         library,
         excludes=[
             "google/cloud/spanner/**",
-            "google/cloud/spanner_admin_instance/**"
-            "google/cloud/spanner_admin_database/**"
             "*.*",
             "noxfile.py",
             "docs/index.rst",
             "google/cloud/spanner_v1/__init__.py",
-            "**/gapic_version.py",
             "testing/constraints-3.7.txt",
+            "google/cloud/spanner_admin_instance/**",
+            "google/cloud/spanner_admin_database/**"
         ],
     )
 
-
 s.remove_staging_dirs()
 
 # ----------------------------------------------------------------------------
@@ -219,27 +215,12 @@
     templated_files,
     excludes=[
         ".coveragerc",
-        ".github/workflows",  # exclude gh actions as credentials are needed for tests
+        ".github/**",
+        ".kokoro/**",
         "README.rst",
-        ".github/release-please.yml",
-        ".kokoro/test-samples-impl.sh",
-        ".kokoro/presubmit/presubmit.cfg",
-        ".kokoro/samples/python3.7/**",
-        ".kokoro/samples/python3.8/**",
     ],
 )
 
-# Ensure CI runs on a new instance each time
-s.replace(
-    ".kokoro/build.sh",
-    "# Setup project id.",
-    """\
-# Set up creating a new instance for each system test run
-export GOOGLE_CLOUD_TESTS_CREATE_SPANNER_INSTANCE=true
-
-# Setup project id.""",
-)
-
 # Update samples folder in CONTRIBUTING.rst
 s.replace("CONTRIBUTING.rst", "samples/snippets", "samples/samples")
 
@@ -262,4 +243,4 @@
 
 # Use a python runtime which is available in the owlbot post processor here
 # https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
-s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)
+s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)
\ No newline at end of file

From 6b27075eef54cc8efff430e20300e8f41309aeab Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 7 Nov 2025 02:20:16 +0000
Subject: [PATCH 23/45] wip

---
 .librarian/generator-input/config.yaml | 6 ------
 1 file changed, 6 deletions(-)
 delete mode 100644 .librarian/generator-input/config.yaml

diff --git a/.librarian/generator-input/config.yaml b/.librarian/generator-input/config.yaml
deleted file mode 100644
index 8d9022e45b..0000000000
--- a/.librarian/generator-input/config.yaml
+++ /dev/null
@@ -1,6 +0,0 @@
-global_files_allowlist:
-  # Allow the container to read and write the root `CHANGELOG.md`
-  # file during the `release` step to update the latest client library
-  # versions which are hardcoded in the file.
-  - path: "CHANGELOG.md"
-    permissions: "read-write"
\ No newline at end of file

From 5e33afbbd4e018c82903a8900ee95cf19e82091d Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Sat, 8 Nov 2025 00:57:48 +0000
Subject: [PATCH 24/45] wip

---
 .librarian/generator-input/owlbot.py | 2 +-
 .librarian/state.yaml                | 6 ++++--
 owlbot.py                            | 2 +-
 3 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/.librarian/generator-input/owlbot.py b/.librarian/generator-input/owlbot.py
index 4f85d064a8..31efb36c92 100644
--- a/.librarian/generator-input/owlbot.py
+++ b/.librarian/generator-input/owlbot.py
@@ -243,4 +243,4 @@
 
 # Use a python runtime which is available in the owlbot post processor here
 # https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
-s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)
\ No newline at end of file
+s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)
diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index fde54f5a1b..118ecc9e0e 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -2,7 +2,7 @@ image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-li
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0
-    last_generated_commit: 3a77bd60b37c086effb39819e9183fbc83e3a693
+    last_generated_commit: 9fcfbea0aa5b50fa22e190faceb073d74504172b
     apis:
       - path: google/spanner/v1
         service_config: spanner.yaml
@@ -18,6 +18,7 @@ libraries:
       - ^google/cloud/spanner_v1/gapic_version.py
       - ^google/cloud/spanner_v1/py.typed
       - ^google/cloud/spanner_v1/services
+      - ^google/cloud/spanner_v1/types
       - ^google/cloud/spanner_admin_database_v1
       - ^google/cloud/spanner_admin_instance_v1
       - ^tests/unit/gapic
@@ -38,8 +39,9 @@ libraries:
       - ^samples/AUTHORING_GUIDE.md
       - ^samples/CONTRIBUTING.md
       - ^samples/generated_samples
-      - ^scripts/fixup_pubsub_v1_keywords.py
+      - ^scripts/fixup_
       - ^setup.py
+      - ^testing/constraints-3.8
       - ^testing/constraints-3.9
       - ^testing/constraints-3.1
       - ^docs/_static
diff --git a/owlbot.py b/owlbot.py
index 4f85d064a8..31efb36c92 100644
--- a/owlbot.py
+++ b/owlbot.py
@@ -243,4 +243,4 @@
 
 # Use a python runtime which is available in the owlbot post processor here
 # https://github.com/googleapis/synthtool/blob/master/docker/owlbot/python/Dockerfile
-s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)
\ No newline at end of file
+s.shell.run(["nox", "-s", "blacken-3.14"], hide_output=False)

From e98a4b728227abd5e96bf962f77c3f92f870dc84 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Sat, 8 Nov 2025 01:09:05 +0000
Subject: [PATCH 25/45] wip

---
 .librarian/state.yaml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 118ecc9e0e..0a4cfc9c24 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -2,7 +2,7 @@ image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-li
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0
-    last_generated_commit: 9fcfbea0aa5b50fa22e190faceb073d74504172b
+    last_generated_commit: 1b5f8632487bce889ce05366647addc6ef5ee36d
     apis:
       - path: google/spanner/v1
         service_config: spanner.yaml
@@ -24,7 +24,6 @@ libraries:
       - ^tests/unit/gapic
       - ^tests/__init__.py
       - ^tests/unit/__init__.py
-      - ^.coveragerc
       - ^.flake8
       - ^.pre-commit-config.yaml
       - ^.repo-metadata.json

From b1d24275bc249d46f43f3f439d17eff4c7ee7046 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Mon, 10 Nov 2025 05:36:16 +0000
Subject: [PATCH 26/45] update sha

---
 .librarian/state.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 0a4cfc9c24..95fb113138 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -1,4 +1,4 @@
-image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator:latest
+image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator:@sha256:39628f6e89c9cad27973b9a39a50f7052bec0435ee58c7027b4fa6b655943e31
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0

From 2a4476489e857a18591537908ed11a3f00974be0 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Mon, 10 Nov 2025 05:39:33 +0000
Subject: [PATCH 27/45] update sha

---
 .librarian/state.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 95fb113138..e7edc44d15 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -1,4 +1,4 @@
-image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator:@sha256:39628f6e89c9cad27973b9a39a50f7052bec0435ee58c7027b4fa6b655943e31
+image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:39628f6e89c9cad27973b9a39a50f7052bec0435ee58c7027b4fa6b655943e31
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0

From 5919f3cbae4eaa5d32f4570ee214971658c81cb6 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Mon, 10 Nov 2025 05:46:25 +0000
Subject: [PATCH 28/45] wip

---
 .librarian/state.yaml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index e7edc44d15..724f22eecc 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -23,8 +23,7 @@ libraries:
       - ^google/cloud/spanner_admin_instance_v1
       - ^tests/unit/gapic
       - ^tests/__init__.py
-      - ^tests/unit/__init__.py
-      - ^.flake8
+      - ^tests/unit/__init__.pyå
       - ^.pre-commit-config.yaml
       - ^.repo-metadata.json
       - ^.trampolinerc

From 22c7cfae66f14244d7e6f26b008319f03671c70f Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Mon, 10 Nov 2025 21:44:14 +0000
Subject: [PATCH 29/45] wip

---
 .librarian/state.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 724f22eecc..3b06ed2ad8 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -28,6 +28,7 @@ libraries:
       - ^.repo-metadata.json
       - ^.trampolinerc
       - ^LICENSE
+      - ^.flake8
       - ^MANIFEST.in
       - ^SECURITY.md
       - ^mypy.ini

From 7ed3697e7862733114f13ef2e9cb128dadfee8fa Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Mon, 10 Nov 2025 21:54:38 +0000
Subject: [PATCH 30/45] wip

---
 .librarian/state.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 3b06ed2ad8..994c4b3a39 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -23,7 +23,7 @@ libraries:
       - ^google/cloud/spanner_admin_instance_v1
       - ^tests/unit/gapic
       - ^tests/__init__.py
-      - ^tests/unit/__init__.pyå
+      - ^tests/unit/__init__.py
       - ^.pre-commit-config.yaml
       - ^.repo-metadata.json
       - ^.trampolinerc

From d39305e3bc531085937448248d4cc653da161a33 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 11 Nov 2025 22:01:47 +0000
Subject: [PATCH 31/45] wip

---
 .librarian/state.yaml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 994c4b3a39..c13e4099cb 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -28,8 +28,6 @@ libraries:
       - ^.repo-metadata.json
       - ^.trampolinerc
       - ^LICENSE
-      - ^.flake8
-      - ^MANIFEST.in
       - ^SECURITY.md
       - ^mypy.ini
       - ^noxfile.py

From e730ecc08b720960b44e5ae0df613b22f4fcfa63 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 11 Nov 2025 22:11:03 +0000
Subject: [PATCH 32/45] wip

---
 .librarian/state.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index c13e4099cb..c2ea7714f6 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -2,7 +2,7 @@ image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-li
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0
-    last_generated_commit: 1b5f8632487bce889ce05366647addc6ef5ee36d
+    last_generated_commit: cf0434f4bd20618db60ddd16a1e7db2c0dfb9158
     apis:
       - path: google/spanner/v1
         service_config: spanner.yaml
@@ -43,11 +43,11 @@ libraries:
       - ^testing/constraints-3.1
       - ^docs/_static
       - ^docs/_templates
-      - ^docs/spanner_v1
+      - ^docs/spanner_v1/services_.rst
+      - ^docs/spanner_v1/spanner.rst
+      - ^docs/spanner_v1/types.rst
       - ^docs/spanner_admin_database_v1
       - ^docs/spanner_admin_instance_v1
-      - ^docs/conf.py
-      - ^docs/index.rst
       - ^docs/multiprocessing.rst
       - ^docs/summary_overview.md
     tag_format: v{version}

From c5a37fcd888a78f449c05371a51aca4298a998bc Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 11 Nov 2025 22:21:49 +0000
Subject: [PATCH 33/45] wip

---
 .librarian/state.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index c2ea7714f6..0de15ef4ff 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -41,6 +41,7 @@ libraries:
       - ^testing/constraints-3.8
       - ^testing/constraints-3.9
       - ^testing/constraints-3.1
+      - ^docs/conf.py
       - ^docs/_static
       - ^docs/_templates
       - ^docs/spanner_v1/services_.rst

From dc179243a4f010fbd5f3bae6ab6a9922836e6709 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 11 Nov 2025 22:47:20 +0000
Subject: [PATCH 34/45] wip

---
 .librarian/state.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 0de15ef4ff..2e3ea1d9cd 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -43,6 +43,7 @@ libraries:
       - ^testing/constraints-3.1
       - ^docs/conf.py
       - ^docs/_static
+      - ^docs/spanner_v1/types_.rst
       - ^docs/_templates
       - ^docs/spanner_v1/services_.rst
       - ^docs/spanner_v1/spanner.rst

From ea2fb8151d67fd9f41976631ce439dc51ace7e41 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 11 Nov 2025 22:50:34 +0000
Subject: [PATCH 35/45] generated changes

---
 docs/_templates/layout.html                   |  4 +-
 docs/conf.py                                  | 45 ++++++++++---------
 .../gapic_version.py                          |  2 +-
 .../gapic_version.py                          |  2 +-
 google/cloud/spanner_v1/gapic_version.py      |  2 +-
 ...data_google.spanner.admin.database.v1.json |  2 +-
 ...data_google.spanner.admin.instance.v1.json |  2 +-
 .../snippet_metadata_google.spanner.v1.json   |  2 +-
 setup.py                                      | 19 ++++----
 9 files changed, 42 insertions(+), 38 deletions(-)

diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html
index 6316a537f7..95e9c77fcf 100644
--- a/docs/_templates/layout.html
+++ b/docs/_templates/layout.html
@@ -20,8 +20,8 @@
           {% endblock %}
 
           <div class="body" role="main">
-          	<div class="admonition" id="python2-eol"> 
-          	 As of January 1, 2020 this library no longer supports Python 2 on the latest released version. 
+          	<div class="admonition" id="python2-eol">
+          	 As of January 1, 2020 this library no longer supports Python 2 on the latest released version.
           	 Library versions released prior to that date will continue to be available. For more information please
           	 visit <a href="https://cloud.google.com/python/docs/python2-sunset/">Python 2 support on Google Cloud</a>.
           	</div>
diff --git a/docs/conf.py b/docs/conf.py
index 78e49ed55c..4e0af4e74e 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,11 +1,11 @@
 # -*- coding: utf-8 -*-
-# Copyright 2024 Google LLC
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
@@ -13,7 +13,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# google-cloud-spanner documentation build configuration file
+#
+# google-cloud-spanner-admin-instance documentation build configuration file
 #
 # This file is execfile()d with the current directory set to its
 # containing dir.
@@ -42,7 +43,7 @@
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-needs_sphinx = "1.5.5"
+needs_sphinx = "4.5.0"
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -80,9 +81,9 @@
 root_doc = "index"
 
 # General information about the project.
-project = "google-cloud-spanner"
-copyright = "2019, Google"
-author = "Google APIs"
+project = u"google-cloud-spanner-admin-instance"
+copyright = u"2025, Google, LLC"
+author = u"Google APIs"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -154,9 +155,9 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
-    "description": "Google Cloud Client Libraries for google-cloud-spanner",
+    "description": "Google Cloud Client Libraries for google-cloud-spanner-admin-instance",
     "github_user": "googleapis",
-    "github_repo": "python-spanner",
+    "github_repo": "google-cloud-python",
     "github_banner": True,
     "font_family": "'Roboto', Georgia, sans",
     "head_font_family": "'Roboto', Georgia, serif",
@@ -248,7 +249,7 @@
 # html_search_scorer = 'scorer.js'
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = "google-cloud-spanner-doc"
+htmlhelp_basename = "google-cloud-spanner-admin-instance-doc"
 
 # -- Options for warnings ------------------------------------------------------
 
@@ -266,13 +267,13 @@
 
 latex_elements = {
     # The paper size ('letterpaper' or 'a4paper').
-    #'papersize': 'letterpaper',
+    # 'papersize': 'letterpaper',
     # The font size ('10pt', '11pt' or '12pt').
-    #'pointsize': '10pt',
+    # 'pointsize': '10pt',
     # Additional stuff for the LaTeX preamble.
-    #'preamble': '',
+    # 'preamble': '',
     # Latex figure (float) alignment
-    #'figure_align': 'htbp',
+    # 'figure_align': 'htbp',
 }
 
 # Grouping the document tree into LaTeX files. List of tuples
@@ -281,8 +282,8 @@
 latex_documents = [
     (
         root_doc,
-        "google-cloud-spanner.tex",
-        "google-cloud-spanner Documentation",
+        "google-cloud-spanner-admin-instance.tex",
+        u"google-cloud-spanner-admin-instance Documentation",
         author,
         "manual",
     )
@@ -316,8 +317,8 @@
 man_pages = [
     (
         root_doc,
-        "google-cloud-spanner",
-        "google-cloud-spanner Documentation",
+        "google-cloud-spanner-admin-instance",
+        "google-cloud-spanner-admin-instance Documentation",
         [author],
         1,
     )
@@ -335,11 +336,11 @@
 texinfo_documents = [
     (
         root_doc,
-        "google-cloud-spanner",
-        "google-cloud-spanner Documentation",
+        "google-cloud-spanner-admin-instance",
+        "google-cloud-spanner-admin-instance Documentation",
         author,
-        "google-cloud-spanner",
-        "google-cloud-spanner Library",
+        "google-cloud-spanner-admin-instance",
+        "google-cloud-spanner-admin-instance Library",
         "APIs",
     )
 ]
diff --git a/google/cloud/spanner_admin_database_v1/gapic_version.py b/google/cloud/spanner_admin_database_v1/gapic_version.py
index 17acb3026a..745f02e051 100644
--- a/google/cloud/spanner_admin_database_v1/gapic_version.py
+++ b/google/cloud/spanner_admin_database_v1/gapic_version.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2022 Google LLC
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
diff --git a/google/cloud/spanner_admin_instance_v1/gapic_version.py b/google/cloud/spanner_admin_instance_v1/gapic_version.py
index 17acb3026a..745f02e051 100644
--- a/google/cloud/spanner_admin_instance_v1/gapic_version.py
+++ b/google/cloud/spanner_admin_instance_v1/gapic_version.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2022 Google LLC
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
diff --git a/google/cloud/spanner_v1/gapic_version.py b/google/cloud/spanner_v1/gapic_version.py
index 17acb3026a..745f02e051 100644
--- a/google/cloud/spanner_v1/gapic_version.py
+++ b/google/cloud/spanner_v1/gapic_version.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2022 Google LLC
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
diff --git a/samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json b/samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json
index e89008727d..e6eeb1f977 100644
--- a/samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json
+++ b/samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-spanner-admin-database",
-    "version": "0.0.0"
+    "version": "3.59.0"
   },
   "snippets": [
     {
diff --git a/samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json b/samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json
index f58e9794e2..92ae0279ef 100644
--- a/samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json
+++ b/samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-spanner-admin-instance",
-    "version": "0.0.0"
+    "version": "3.59.0"
   },
   "snippets": [
     {
diff --git a/samples/generated_samples/snippet_metadata_google.spanner.v1.json b/samples/generated_samples/snippet_metadata_google.spanner.v1.json
index f7f33c3d29..4d84b1ab9a 100644
--- a/samples/generated_samples/snippet_metadata_google.spanner.v1.json
+++ b/samples/generated_samples/snippet_metadata_google.spanner.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-spanner",
-    "version": "0.0.0"
+    "version": "3.59.0"
   },
   "snippets": [
     {
diff --git a/setup.py b/setup.py
index 216b095d0b..858982f783 100644
--- a/setup.py
+++ b/setup.py
@@ -44,15 +44,18 @@
     "proto-plus >= 1.22.2, <2.0.0; python_version>='3.11'",
     "protobuf>=3.20.2,<7.0.0,!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5",
     "grpc-interceptor >= 0.15.4",
-    # Make OpenTelemetry a core dependency
-    "opentelemetry-api >= 1.22.0",
-    "opentelemetry-sdk >= 1.22.0",
-    "opentelemetry-semantic-conventions >= 0.43b0",
-    "opentelemetry-resourcedetector-gcp >= 1.8.0a0",
-    "google-cloud-monitoring >= 2.16.0",
-    "mmh3 >= 4.1.0 ",
 ]
-extras = {"libcst": "libcst >= 0.2.5"}
+extras = {
+    "tracing": [
+        "opentelemetry-api >= 1.22.0",
+        "opentelemetry-sdk >= 1.22.0",
+        "opentelemetry-semantic-conventions >= 0.43b0",
+        "opentelemetry-resourcedetector-gcp >= 1.8.0a0",
+        "google-cloud-monitoring >= 2.16.0",
+        "mmh3 >= 4.1.0 ",
+    ],
+    "libcst": "libcst >= 0.2.5",
+}
 
 url = "https://github.com/googleapis/python-spanner"
 

From 5e143437a1b7f4a06e65eb0cb839ec0d09cca840 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 11 Nov 2025 22:51:14 +0000
Subject: [PATCH 36/45] update sha

---
 .librarian/state.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 2e3ea1d9cd..7136aadc7c 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -1,4 +1,4 @@
-image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:39628f6e89c9cad27973b9a39a50f7052bec0435ee58c7027b4fa6b655943e31
+image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:c8612d3fffb3f6a32353b2d1abd16b61e87811866f7ec9d65b59b02eb452a620
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0

From 362360435a60ec651bf464170066c4fc7ed7c3c3 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 11 Nov 2025 22:53:16 +0000
Subject: [PATCH 37/45] remove files

---
 .github/auto-approve.yml        |  3 ---
 .github/release-trigger.yml     |  2 --
 .github/snippet-bot.yml         |  0
 .github/sync-repo-settings.yaml | 15 ---------------
 4 files changed, 20 deletions(-)
 delete mode 100644 .github/auto-approve.yml
 delete mode 100644 .github/release-trigger.yml
 delete mode 100644 .github/snippet-bot.yml
 delete mode 100644 .github/sync-repo-settings.yaml

diff --git a/.github/auto-approve.yml b/.github/auto-approve.yml
deleted file mode 100644
index 311ebbb853..0000000000
--- a/.github/auto-approve.yml
+++ /dev/null
@@ -1,3 +0,0 @@
-# https://github.com/googleapis/repo-automation-bots/tree/main/packages/auto-approve
-processes:
-  - "OwlBotTemplateChanges"
diff --git a/.github/release-trigger.yml b/.github/release-trigger.yml
deleted file mode 100644
index 3c0f1bfc7e..0000000000
--- a/.github/release-trigger.yml
+++ /dev/null
@@ -1,2 +0,0 @@
-enabled: true
-multiScmName: python-spanner
diff --git a/.github/snippet-bot.yml b/.github/snippet-bot.yml
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/.github/sync-repo-settings.yaml b/.github/sync-repo-settings.yaml
deleted file mode 100644
index d726d1193d..0000000000
--- a/.github/sync-repo-settings.yaml
+++ /dev/null
@@ -1,15 +0,0 @@
-# https://github.com/googleapis/repo-automation-bots/tree/main/packages/sync-repo-settings
-# Rules for main branch protection
-branchProtectionRules:
-# Identifies the protection rule pattern. Name of the branch to be protected.
-# Defaults to `main`
-- pattern: main
-  requiresCodeOwnerReviews: true
-  requiresStrictStatusChecks: true
-  requiredStatusCheckContexts:
-    - 'Kokoro'
-    - 'Kokoro system-3.12'
-    - 'cla/google'
-    - 'Samples - Lint'
-    - 'Samples - Python 3.9'
-    - 'Samples - Python 3.12'

From 594ccfe45eae90713f888276859cb31c4e5add7d Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Wed, 12 Nov 2025 02:10:22 +0000
Subject: [PATCH 38/45] update python version for lint

---
 .github/workflows/presubmit.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/presubmit.yaml b/.github/workflows/presubmit.yaml
index 67db6136d1..6e5f1af29b 100644
--- a/.github/workflows/presubmit.yaml
+++ b/.github/workflows/presubmit.yaml
@@ -17,7 +17,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v6
         with:
-          python-version: 3.13
+          python-version: 3.14
       - name: Install nox
         run: python -m pip install nox
       - name: Check formatting

From 4b3bc2ce6dd50cb42068eef4ee954d749a9ac758 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Fri, 14 Nov 2025 02:36:04 +0000
Subject: [PATCH 39/45] revert setup file to main

---
 setup.py | 19 ++++++++-----------
 1 file changed, 8 insertions(+), 11 deletions(-)

diff --git a/setup.py b/setup.py
index 858982f783..216b095d0b 100644
--- a/setup.py
+++ b/setup.py
@@ -44,18 +44,15 @@
     "proto-plus >= 1.22.2, <2.0.0; python_version>='3.11'",
     "protobuf>=3.20.2,<7.0.0,!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5",
     "grpc-interceptor >= 0.15.4",
+    # Make OpenTelemetry a core dependency
+    "opentelemetry-api >= 1.22.0",
+    "opentelemetry-sdk >= 1.22.0",
+    "opentelemetry-semantic-conventions >= 0.43b0",
+    "opentelemetry-resourcedetector-gcp >= 1.8.0a0",
+    "google-cloud-monitoring >= 2.16.0",
+    "mmh3 >= 4.1.0 ",
 ]
-extras = {
-    "tracing": [
-        "opentelemetry-api >= 1.22.0",
-        "opentelemetry-sdk >= 1.22.0",
-        "opentelemetry-semantic-conventions >= 0.43b0",
-        "opentelemetry-resourcedetector-gcp >= 1.8.0a0",
-        "google-cloud-monitoring >= 2.16.0",
-        "mmh3 >= 4.1.0 ",
-    ],
-    "libcst": "libcst >= 0.2.5",
-}
+extras = {"libcst": "libcst >= 0.2.5"}
 
 url = "https://github.com/googleapis/python-spanner"
 

From 907ed25c3f9f40b5013f6076a888a411edec2b77 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Mon, 17 Nov 2025 23:20:22 +0000
Subject: [PATCH 40/45] reorder apis

---
 .librarian/state.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 7136aadc7c..e277d77af6 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -4,12 +4,12 @@ libraries:
     version: 3.59.0
     last_generated_commit: cf0434f4bd20618db60ddd16a1e7db2c0dfb9158
     apis:
-      - path: google/spanner/v1
-        service_config: spanner.yaml
       - path: google/spanner/admin/database/v1
         service_config: spanner.yaml
       - path: google/spanner/admin/instance/v1
         service_config: spanner.yaml
+      - path: google/spanner/v1
+        service_config: spanner.yaml
     source_roots:
       - .
     preserve_regex: []

From 5e8d17b90c530eb72551358451a3f7244818598b Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Mon, 17 Nov 2025 23:31:09 +0000
Subject: [PATCH 41/45] fix docs

---
 .librarian/state.yaml |  2 +-
 docs/conf.py          | 24 ++++++++++++------------
 2 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index e277d77af6..d7f8c76918 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -2,7 +2,7 @@ image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-li
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0
-    last_generated_commit: cf0434f4bd20618db60ddd16a1e7db2c0dfb9158
+    last_generated_commit: 136201b66f70829232b7ec63fa6e35ca765bcacb
     apis:
       - path: google/spanner/admin/database/v1
         service_config: spanner.yaml
diff --git a/docs/conf.py b/docs/conf.py
index 4e0af4e74e..010a6b6cda 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -14,7 +14,7 @@
 # limitations under the License.
 #
 #
-# google-cloud-spanner-admin-instance documentation build configuration file
+# google-cloud-spanner documentation build configuration file
 #
 # This file is execfile()d with the current directory set to its
 # containing dir.
@@ -81,7 +81,7 @@
 root_doc = "index"
 
 # General information about the project.
-project = u"google-cloud-spanner-admin-instance"
+project = u"google-cloud-spanner"
 copyright = u"2025, Google, LLC"
 author = u"Google APIs"
 
@@ -155,7 +155,7 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
-    "description": "Google Cloud Client Libraries for google-cloud-spanner-admin-instance",
+    "description": "Google Cloud Client Libraries for google-cloud-spanner",
     "github_user": "googleapis",
     "github_repo": "google-cloud-python",
     "github_banner": True,
@@ -249,7 +249,7 @@
 # html_search_scorer = 'scorer.js'
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = "google-cloud-spanner-admin-instance-doc"
+htmlhelp_basename = "google-cloud-spanner-doc"
 
 # -- Options for warnings ------------------------------------------------------
 
@@ -282,8 +282,8 @@
 latex_documents = [
     (
         root_doc,
-        "google-cloud-spanner-admin-instance.tex",
-        u"google-cloud-spanner-admin-instance Documentation",
+        "google-cloud-spanner.tex",
+        u"google-cloud-spanner Documentation",
         author,
         "manual",
     )
@@ -317,8 +317,8 @@
 man_pages = [
     (
         root_doc,
-        "google-cloud-spanner-admin-instance",
-        "google-cloud-spanner-admin-instance Documentation",
+        "google-cloud-spanner",
+        "google-cloud-spanner Documentation",
         [author],
         1,
     )
@@ -336,11 +336,11 @@
 texinfo_documents = [
     (
         root_doc,
-        "google-cloud-spanner-admin-instance",
-        "google-cloud-spanner-admin-instance Documentation",
+        "google-cloud-spanner",
+        "google-cloud-spanner Documentation",
         author,
-        "google-cloud-spanner-admin-instance",
-        "google-cloud-spanner-admin-instance Library",
+        "google-cloud-spanner",
+        "google-cloud-spanner Library",
         "APIs",
     )
 ]

From 41e701c850f37eb4d7f5e2c0f035620a4780b869 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 18 Nov 2025 22:02:53 +0000
Subject: [PATCH 42/45] address failure

---
 .librarian/state.yaml                 | 2 +-
 google/cloud/spanner_dbapi/version.py | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index d7f8c76918..e277d77af6 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -2,7 +2,7 @@ image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-li
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0
-    last_generated_commit: 136201b66f70829232b7ec63fa6e35ca765bcacb
+    last_generated_commit: cf0434f4bd20618db60ddd16a1e7db2c0dfb9158
     apis:
       - path: google/spanner/admin/database/v1
         service_config: spanner.yaml
diff --git a/google/cloud/spanner_dbapi/version.py b/google/cloud/spanner_dbapi/version.py
index 6fbb80eb90..0ae3005c43 100644
--- a/google/cloud/spanner_dbapi/version.py
+++ b/google/cloud/spanner_dbapi/version.py
@@ -13,8 +13,8 @@
 # limitations under the License.
 
 import platform
-from google.cloud.spanner_v1 import gapic_version as package_version
 
 PY_VERSION = platform.python_version()
-VERSION = package_version.__version__
+__version__ = "3.59.0"
+VERSION = __version__
 DEFAULT_USER_AGENT = "gl-dbapi/" + VERSION

From 69fccf72b11f890657d1666ef8ef1aec016d5092 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 18 Nov 2025 22:10:09 +0000
Subject: [PATCH 43/45] rename owlbot.py to librarian.py

---
 .librarian/state.yaml     | 2 +-
 owlbot.py => librarian.py | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename owlbot.py => librarian.py (100%)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index e277d77af6..4585e16f11 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -1,4 +1,4 @@
-image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:c8612d3fffb3f6a32353b2d1abd16b61e87811866f7ec9d65b59b02eb452a620
+image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:e601da6e29c993e14c52867f2c088dfb841beae618d2a4f1e0f7970a888ab020
 libraries:
   - id: google-cloud-spanner
     version: 3.59.0
diff --git a/owlbot.py b/librarian.py
similarity index 100%
rename from owlbot.py
rename to librarian.py

From 6f8a89bc6cdb29aba5f260a8a67c2883a8540b59 Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 18 Nov 2025 22:12:58 +0000
Subject: [PATCH 44/45] rename file

---
 .librarian/generator-input/{owlbot.py => librarian.py} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename .librarian/generator-input/{owlbot.py => librarian.py} (100%)

diff --git a/.librarian/generator-input/owlbot.py b/.librarian/generator-input/librarian.py
similarity index 100%
rename from .librarian/generator-input/owlbot.py
rename to .librarian/generator-input/librarian.py

From 97d7374a2da97a0ae65623e3f7d7f76a34571b5c Mon Sep 17 00:00:00 2001
From: ohmayr <omairn@google.com>
Date: Tue, 18 Nov 2025 22:14:23 +0000
Subject: [PATCH 45/45] chore: create a release

---
 .librarian/state.yaml                            |  2 +-
 CHANGELOG.md                                     | 16 ++++++++++++++++
 .../spanner_admin_database_v1/gapic_version.py   |  2 +-
 .../spanner_admin_instance_v1/gapic_version.py   |  2 +-
 google/cloud/spanner_dbapi/version.py            |  2 +-
 google/cloud/spanner_v1/gapic_version.py         |  2 +-
 ...etadata_google.spanner.admin.database.v1.json |  2 +-
 ...etadata_google.spanner.admin.instance.v1.json |  2 +-
 .../snippet_metadata_google.spanner.v1.json      |  2 +-
 9 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/.librarian/state.yaml b/.librarian/state.yaml
index 4585e16f11..28820b0b65 100644
--- a/.librarian/state.yaml
+++ b/.librarian/state.yaml
@@ -1,7 +1,7 @@
 image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:e601da6e29c993e14c52867f2c088dfb841beae618d2a4f1e0f7970a888ab020
 libraries:
   - id: google-cloud-spanner
-    version: 3.59.0
+    version: 3.60.0
     last_generated_commit: cf0434f4bd20618db60ddd16a1e7db2c0dfb9158
     apis:
       - path: google/spanner/admin/database/v1
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b5bbe07325..071c851d7c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,22 @@
 
 [1]: https://pypi.org/project/google-cloud-spanner/#history
 
+## [3.60.0](https://github.com/googleapis/python-spanner/compare/v3.59.0...v3.60.0) (2025-11-18)
+
+
+### Features
+
+* add cloud.region, request_tag and transaction_tag in span attributes (#1449) ([d37fb80a39aea859059ae7d85adc75095a6e14e6](https://github.com/googleapis/python-spanner/commit/d37fb80a39aea859059ae7d85adc75095a6e14e6))
+* Exposing AutoscalingConfig in InstancePartition ([8b6f154085543953556acde161a739414988b7f0](https://github.com/googleapis/python-spanner/commit/8b6f154085543953556acde161a739414988b7f0))
+* enable OpenTelemetry metrics and tracing by default (#1410) ([bb5095dfb615159a575933a332382ba93ba4bbd1](https://github.com/googleapis/python-spanner/commit/bb5095dfb615159a575933a332382ba93ba4bbd1))
+* add support for experimental host (#1452) ([9535e5e096f6ab53f2817af4fd7ac1fa2ca71660](https://github.com/googleapis/python-spanner/commit/9535e5e096f6ab53f2817af4fd7ac1fa2ca71660))
+
+
+### Bug Fixes
+
+* Deprecate credentials_file argument ([8b6f154085543953556acde161a739414988b7f0](https://github.com/googleapis/python-spanner/commit/8b6f154085543953556acde161a739414988b7f0))
+* configure keepAlive time for gRPC TCP connections (#1448) ([efb2833e52e54b096e552a4d91f94b017ac733bb](https://github.com/googleapis/python-spanner/commit/efb2833e52e54b096e552a4d91f94b017ac733bb))
+
 ## [3.59.0](https://github.com/googleapis/python-spanner/compare/v3.58.0...v3.59.0) (2025-10-18)
 
 
diff --git a/google/cloud/spanner_admin_database_v1/gapic_version.py b/google/cloud/spanner_admin_database_v1/gapic_version.py
index 745f02e051..992322a033 100644
--- a/google/cloud/spanner_admin_database_v1/gapic_version.py
+++ b/google/cloud/spanner_admin_database_v1/gapic_version.py
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "3.59.0"  # {x-release-please-version}
+__version__ = "3.60.0"  # {x-release-please-version}
diff --git a/google/cloud/spanner_admin_instance_v1/gapic_version.py b/google/cloud/spanner_admin_instance_v1/gapic_version.py
index 745f02e051..992322a033 100644
--- a/google/cloud/spanner_admin_instance_v1/gapic_version.py
+++ b/google/cloud/spanner_admin_instance_v1/gapic_version.py
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "3.59.0"  # {x-release-please-version}
+__version__ = "3.60.0"  # {x-release-please-version}
diff --git a/google/cloud/spanner_dbapi/version.py b/google/cloud/spanner_dbapi/version.py
index 0ae3005c43..ee7431572b 100644
--- a/google/cloud/spanner_dbapi/version.py
+++ b/google/cloud/spanner_dbapi/version.py
@@ -15,6 +15,6 @@
 import platform
 
 PY_VERSION = platform.python_version()
-__version__ = "3.59.0"
+__version__ = "3.60.0"
 VERSION = __version__
 DEFAULT_USER_AGENT = "gl-dbapi/" + VERSION
diff --git a/google/cloud/spanner_v1/gapic_version.py b/google/cloud/spanner_v1/gapic_version.py
index 745f02e051..992322a033 100644
--- a/google/cloud/spanner_v1/gapic_version.py
+++ b/google/cloud/spanner_v1/gapic_version.py
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "3.59.0"  # {x-release-please-version}
+__version__ = "3.60.0"  # {x-release-please-version}
diff --git a/samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json b/samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json
index e6eeb1f977..0bfe97d988 100644
--- a/samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json
+++ b/samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-spanner-admin-database",
-    "version": "3.59.0"
+    "version": "3.60.0"
   },
   "snippets": [
     {
diff --git a/samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json b/samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json
index 92ae0279ef..9b51de3471 100644
--- a/samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json
+++ b/samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-spanner-admin-instance",
-    "version": "3.59.0"
+    "version": "3.60.0"
   },
   "snippets": [
     {
diff --git a/samples/generated_samples/snippet_metadata_google.spanner.v1.json b/samples/generated_samples/snippet_metadata_google.spanner.v1.json
index 4d84b1ab9a..1ec5a82e5a 100644
--- a/samples/generated_samples/snippet_metadata_google.spanner.v1.json
+++ b/samples/generated_samples/snippet_metadata_google.spanner.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-spanner",
-    "version": "3.59.0"
+    "version": "3.60.0"
   },
   "snippets": [
     {