[do not merge]: Dry run for packages/google-cloud-spanner migration

.librarian/generator-input/client-post-processing/spanner-integration.yaml

@@ -0,0 +1,152 @@
+# Copyright 2026 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.
+description: Integrate Google Cloud Spanner customizations for MetricsInterceptor and gRPC options
+# TODO(Fill in issue number below to add more context)
+url: https://github.com/googleapis/gapic-generator-python/issues/123
+replacements:
+  - paths: [
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/base.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/grpc.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/grpc_asyncio.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/rest.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/rest_base.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/client.py",
+    ]
+    before: |
+      from google.cloud.spanner_v1.types import transaction
+    after: |
+      from google.cloud.spanner_v1.types import transaction
+      from google.cloud.spanner_v1.metrics.metrics_interceptor import MetricsInterceptor
+    count: 6
+
+  - paths: [
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/base.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/grpc.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/grpc_asyncio.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/rest.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/rest_base.py",
+    ]
+    before: |
+      (?P<indent>\s+)api_audience: Optional\[str\] = None,\n\s+\*\*kwargs,\n\s+\) -> None:
+    after: |
+      \g<indent>api_audience: Optional[str] = None,
+      \g<indent>    metrics_interceptor: Optional[MetricsInterceptor] = None,
+      \g<indent>    **kwargs,
+      \g<indent>) -> None:
+    count: 1 # Using regex with backreferences for correctness
+
+  - paths: [
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/grpc.py",
+    ]
+    before: |
+      \)\n\n        self._interceptor = _LoggingClientInterceptor\(\)
+    after: |
+      )
+
+              # 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()
+    count: 1
+
+  - paths: [
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/grpc.py",
+    ]
+    before: |
+      self._stubs: Dict\[str, Callable\] = \{\}\n\n        if api_mtls_endpoint:
+    after: |
+      self._stubs: Dict[str, Callable] = {}
+              self._metrics_interceptor = None
+
+              if api_mtls_endpoint:
+    count: 1
+
+  - paths: [
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/client.py",
+    ]
+    before: |
+      # 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,
+                  \)
+    after: |
+      # 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(),
+                  )
+    count: 1
+
+  - paths: [
+      "packages/google-cloud-spanner/tests/unit/gapic/spanner_v1/test_spanner.py",
+    ]
+    before: |
+      api_audience=None,\n(\s+)\)
+    after: |
+      api_audience=None,
+                  metrics_interceptor=mock.ANY,
+              )
+    count: 12
+
+  - paths: [
+      "packages/google-cloud-spanner/tests/unit/gapic/spanner_v1/test_spanner.py",
+    ]
+    before: |
+      api_audience="https://language.googleapis.com"\n(\s+)\)
+    after: |
+      api_audience="https://language.googleapis.com",
+                  metrics_interceptor=mock.ANY,
+              )
+    count: 1
+
+  - paths: [
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/grpc.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_v1/services/spanner/transports/grpc_asyncio.py",
+      "packages/google-cloud-spanner/tests/unit/gapic/spanner_v1/test_spanner.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_admin_instance_v1/services/instance_admin/transports/grpc.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_admin_instance_v1/services/instance_admin/transports/grpc_asyncio.py",
+      "packages/google-cloud-spanner/tests/unit/gapic/spanner_admin_instance_v1/test_instance_admin.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/services/database_admin/transports/grpc.py",
+      "packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/services/database_admin/transports/grpc_asyncio.py",
+      "packages/google-cloud-spanner/tests/unit/gapic/spanner_admin_database_v1/test_database_admin.py",
+    ]
+    before: |
+      ^\s+options=\[[\s\S]*?\]
+    after: |
+      options=[
+                          ("grpc.max_send_message_length", -1),
+                          ("grpc.max_receive_message_length", -1),
+                          ("grpc.keepalive_time_ms", 120000),
+                      ]
+    count: 9 # One per file roughly, or adjusts based on regex triggers

.librarian/state.yaml

@@ -3161,6 +3161,74 @@ libraries:
     remove_regex:
       - packages/google-cloud-source-context/
     tag_format: '{id}-v{version}'
+  - id: google-cloud-spanner
+    version: 3.63.0
+    last_generated_commit: 64f1dbf504bab7b58ed96a539a5b26a7ebfc65c7
+    apis:
+      - path: google/spanner/admin/instance/v1
+        service_config: spanner.yaml
+      - path: google/spanner/admin/database/v1
+        service_config: spanner.yaml
+      - path: google/spanner/v1
+        service_config: spanner.yaml
+    source_roots:
+      - packages/google-cloud-spanner
+    preserve_regex:
+      - packages/google-cloud-spanner/CHANGELOG.md
+      - docs/CHANGELOG.md
+    remove_regex:
+      - ^packages/google-cloud-spanner/.coveragerc
+      - ^packages/google-cloud-spanner/.flake8
+      - ^packages/google-cloud-spanner/.repo-metadata.json
+      - ^packages/google-cloud-spanner/LICENSE
+      - ^packages/google-cloud-spanner/MANIFEST.in
+      - ^packages/google-cloud-spanner/README.rst
+      - ^packages/google-cloud-spanner/mypy.ini
+      - ^packages/google-cloud-spanner/noxfile.py
+      - ^packages/google-cloud-spanner/setup.py
+      - ^packages/google-cloud-spanner/docs/conf.py
+      - ^packages/google-cloud-spanner/docs/index.rst
+      - ^packages/google-cloud-spanner/docs/summary_overview.md
+      - ^packages/google-cloud-spanner/docs/README.rst
+      - ^packages/google-cloud-spanner/docs/_static
+      - ^packages/google-cloud-spanner/docs/_templates
+      - ^packages/google-cloud-spanner/docs/multiprocessing.rst
+      - ^packages/google-cloud-spanner/docs/spanner_v1/spanner.rst
+      - ^packages/google-cloud-spanner/docs/spanner_v1/services_.rst
+      - ^packages/google-cloud-spanner/docs/spanner_v1/types_.rst
+      - ^packages/google-cloud-spanner/docs/spanner_admin_database_v1/spanner_admin_database.rst
+      - ^packages/google-cloud-spanner/docs/spanner_admin_database_v1/services_.rst
+      - ^packages/google-cloud-spanner/docs/spanner_admin_database_v1/types_.rst
+      - ^packages/google-cloud-spanner/docs/spanner_admin_instance_v1/spanner_admin_instance.rst
+      - ^packages/google-cloud-spanner/docs/spanner_admin_instance_v1/services_.rst
+      - ^packages/google-cloud-spanner/docs/spanner_admin_instance_v1/types_.rst
+      - ^packages/google-cloud-spanner/google/cloud/spanner/__init__.py
+      - ^packages/google-cloud-spanner/google/cloud/spanner/gapic_version.py
+      - ^packages/google-cloud-spanner/google/cloud/spanner/py.typed
+      - ^packages/google-cloud-spanner/google/cloud/spanner_v1/__init__.py
+      - ^packages/google-cloud-spanner/google/cloud/spanner_v1/gapic_metadata.json
+      - ^packages/google-cloud-spanner/google/cloud/spanner_v1/gapic_version.py
+      - ^packages/google-cloud-spanner/google/cloud/spanner_v1/py.typed
+      - ^packages/google-cloud-spanner/google/cloud/spanner_v1/services
+      - ^packages/google-cloud-spanner/google/cloud/spanner_v1/types
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/__init__.py
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/gapic_metadata.json
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/gapic_version.py
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/py.typed
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/services
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/types
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_instance_v1/__init__.py
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_instance_v1/gapic_metadata.json
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_instance_v1/gapic_version.py
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_instance_v1/py.typed
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_instance_v1/services
+      - ^packages/google-cloud-spanner/google/cloud/spanner_admin_instance_v1/types
+      - ^packages/google-cloud-spanner/testing
+      - ^packages/google-cloud-spanner/tests/__init__.py
+      - ^packages/google-cloud-spanner/tests/unit/__init__.py
+      - ^packages/google-cloud-spanner/tests/unit/gapic
+      - ^packages/google-cloud-spanner/samples/generated_samples
+    tag_format: '{id}-v{version}'
   - id: google-cloud-speech
     version: 2.37.0
     last_generated_commit: c662840a94dbdf708caa44893a2d49119cdd391c

packages/google-cloud-spanner/.coveragerc

@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2020 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!
+[run]
+branch = True
+omit =
+  /tmp/*
+  .nox/*
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  /tmp/*
+  .nox/*
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py

packages/google-cloud-spanner/.devcontainer/Dockerfile

@@ -0,0 +1,16 @@
+ARG VARIANT="3.13"
+FROM mcr.microsoft.com/devcontainers/python:${VARIANT}
+
+#install nox
+COPY requirements.txt /requirements.txt
+RUN python3 -m pip install --upgrade --quiet --require-hashes -r requirements.txt
+
+# install gh
+RUN curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg \
+&& chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg \
+&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
+&& apt-get update \
+&& apt-get install gh -y
+
+# install gloud sdk
+RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y

packages/google-cloud-spanner/.devcontainer/devcontainer.json

@@ -0,0 +1,13 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/python
+{
+	"name": "Python 3",
+	"build": {
+		// Sets the run context to one level up instead of the .devcontainer folder.
+		"args": { "VARIANT": "3.8" },
+		// Update the 'dockerFile' property if you aren't using the standard 'Dockerfile' filename.
+		"dockerfile": "Dockerfile"
+	},
+
+	"postCreateCommand": "bash .devcontainer/postCreate.sh"
+}

packages/google-cloud-spanner/.devcontainer/postCreate.sh

@@ -0,0 +1,3 @@
+echo "Post Create Starting"
+
+nox -s blacken

packages/google-cloud-spanner/.devcontainer/requirements.in

@@ -0,0 +1 @@
+nox==2024.10.9

packages/google-cloud-spanner/.devcontainer/requirements.txt

@@ -0,0 +1,72 @@
+#
+# This file is autogenerated by pip-compile with Python 3.8
+# by the following command:
+#
+#    pip-compile --generate-hashes requirements.in
+#
+argcomplete==3.6.2 \
+    --hash=sha256:65b3133a29ad53fb42c48cf5114752c7ab66c1c38544fdf6460f450c09b42591 \
+    --hash=sha256:d0519b1bc867f5f4f4713c41ad0aba73a4a5f007449716b16f385f2166dc6adf
+    # via nox
+colorlog==6.9.0 \
+    --hash=sha256:5906e71acd67cb07a71e779c47c4bcb45fb8c2993eebe9e5adcd6a6f1b283eff \
+    --hash=sha256:bfba54a1b93b94f54e1f4fe48395725a3d92fd2a4af702f6bd70946bdc0c6ac2
+    # via nox
+distlib==0.4.0 \
+    --hash=sha256:9659f7d87e46584a30b5780e43ac7a2143098441670ff0a49d5f9034c54a6c16 \
+    --hash=sha256:feec40075be03a04501a973d81f633735b4b69f98b05450592310c0f401a4e0d
+    # via virtualenv
+filelock==3.19.1 \
+    --hash=sha256:66eda1888b0171c998b35be2bcc0f6d75c388a7ce20c3f3f37aa8e96c2dddf58 \
+    --hash=sha256:d38e30481def20772f5baf097c122c3babc4fcdb7e14e57049eb9d88c6dc017d
+    # via virtualenv
+nox==2025.5.1 \
+    --hash=sha256:2a571dfa7a58acc726521ac3cd8184455ebcdcbf26401c7b737b5bc6701427b2 \
+    --hash=sha256:56abd55cf37ff523c254fcec4d152ed51e5fe80e2ab8317221d8b828ac970a31
+    # via -r requirements.in
+packaging==25.0 \
+    --hash=sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484 \
+    --hash=sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f
+    # via nox
+platformdirs==4.4.0 \
+    --hash=sha256:abd01743f24e5287cd7a5db3752faf1a2d65353f38ec26d98e25a6db65958c85 \
+    --hash=sha256:ca753cf4d81dc309bc67b0ea38fd15dc97bc30ce419a7f58d13eb3bf14c4febf
+    # via virtualenv
+tomli==2.2.1 \
+    --hash=sha256:023aa114dd824ade0100497eb2318602af309e5a55595f76b626d6d9f3b7b0a6 \
+    --hash=sha256:02abe224de6ae62c19f090f68da4e27b10af2b93213d36cf44e6e1c5abd19fdd \
+    --hash=sha256:286f0ca2ffeeb5b9bd4fcc8d6c330534323ec51b2f52da063b11c502da16f30c \
+    --hash=sha256:2d0f2fdd22b02c6d81637a3c95f8cd77f995846af7414c5c4b8d0545afa1bc4b \
+    --hash=sha256:33580bccab0338d00994d7f16f4c4ec25b776af3ffaac1ed74e0b3fc95e885a8 \
+    --hash=sha256:400e720fe168c0f8521520190686ef8ef033fb19fc493da09779e592861b78c6 \
+    --hash=sha256:40741994320b232529c802f8bc86da4e1aa9f413db394617b9a256ae0f9a7f77 \
+    --hash=sha256:465af0e0875402f1d226519c9904f37254b3045fc5084697cefb9bdde1ff99ff \
+    --hash=sha256:4a8f6e44de52d5e6c657c9fe83b562f5f4256d8ebbfe4ff922c495620a7f6cea \
+    --hash=sha256:4e340144ad7ae1533cb897d406382b4b6fede8890a03738ff1683af800d54192 \
+    --hash=sha256:678e4fa69e4575eb77d103de3df8a895e1591b48e740211bd1067378c69e8249 \
+    --hash=sha256:6972ca9c9cc9f0acaa56a8ca1ff51e7af152a9f87fb64623e31d5c83700080ee \
+    --hash=sha256:7fc04e92e1d624a4a63c76474610238576942d6b8950a2d7f908a340494e67e4 \
+    --hash=sha256:889f80ef92701b9dbb224e49ec87c645ce5df3fa2cc548664eb8a25e03127a98 \
+    --hash=sha256:8d57ca8095a641b8237d5b079147646153d22552f1c637fd3ba7f4b0b29167a8 \
+    --hash=sha256:8dd28b3e155b80f4d54beb40a441d366adcfe740969820caf156c019fb5c7ec4 \
+    --hash=sha256:9316dc65bed1684c9a98ee68759ceaed29d229e985297003e494aa825ebb0281 \
+    --hash=sha256:a198f10c4d1b1375d7687bc25294306e551bf1abfa4eace6650070a5c1ae2744 \
+    --hash=sha256:a38aa0308e754b0e3c67e344754dff64999ff9b513e691d0e786265c93583c69 \
+    --hash=sha256:a92ef1a44547e894e2a17d24e7557a5e85a9e1d0048b0b5e7541f76c5032cb13 \
+    --hash=sha256:ac065718db92ca818f8d6141b5f66369833d4a80a9d74435a268c52bdfa73140 \
+    --hash=sha256:b82ebccc8c8a36f2094e969560a1b836758481f3dc360ce9a3277c65f374285e \
+    --hash=sha256:c954d2250168d28797dd4e3ac5cf812a406cd5a92674ee4c8f123c889786aa8e \
+    --hash=sha256:cb55c73c5f4408779d0cf3eef9f762b9c9f147a77de7b258bef0a5628adc85cc \
+    --hash=sha256:cd45e1dc79c835ce60f7404ec8119f2eb06d38b1deba146f07ced3bbc44505ff \
+    --hash=sha256:d3f5614314d758649ab2ab3a62d4f2004c825922f9e370b29416484086b264ec \
+    --hash=sha256:d920f33822747519673ee656a4b6ac33e382eca9d331c87770faa3eef562aeb2 \
+    --hash=sha256:db2b95f9de79181805df90bedc5a5ab4c165e6ec3fe99f970d0e302f384ad222 \
+    --hash=sha256:e59e304978767a54663af13c07b3d1af22ddee3bb2fb0618ca1593e4f593a106 \
+    --hash=sha256:e85e99945e688e32d5a35c1ff38ed0b3f41f43fad8df0bdf79f72b2ba7bc5272 \
+    --hash=sha256:ece47d672db52ac607a3d9599a9d48dcb2f2f735c6c2d1f34130085bb12b112a \
+    --hash=sha256:f4039b9cbc3048b2416cc57ab3bda989a6fcf9b36cf8937f01a6e731b64f80d7
+    # via nox
+virtualenv==20.34.0 \
+    --hash=sha256:341f5afa7eee943e4984a9207c025feedd768baff6753cd660c857ceb3e36026 \
+    --hash=sha256:44815b2c9dee7ed86e387b842a84f20b93f7f417f95886ca1996a72a4138eb1a
+    # via nox