google-cloud-spanner 3.63.0__tar.gz → 3.65.0__tar.gz

google_cloud_spanner-3.65.0/MANIFEST.in

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+# 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.
+#
+include README.rst LICENSE
+recursive-include google *.py *.pyi *.json *.proto py.typed
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__

{google_cloud_spanner-3.63.0/google_cloud_spanner.egg-info → google_cloud_spanner-3.65.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: google-cloud-spanner
-Version: 3.63.0
+Version: 3.65.0
 Summary: Google Cloud Spanner API client library
-Home-page: https://github.com/googleapis/python-spanner
+Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-spanner
 Author: Google LLC
 Author-email: googleapis-packages@google.com
 License: Apache 2.0
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
@@ -27,7 +28,7 @@ Requires-Dist: grpc-google-iam-v1<1.0.0,>=0.12.4
 Requires-Dist: proto-plus<2.0.0,>=1.22.0
 Requires-Dist: sqlparse>=0.4.4
 Requires-Dist: proto-plus<2.0.0,>=1.22.2; python_version >= "3.11"
-Requires-Dist: protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<7.0.0,>=3.20.2
+Requires-Dist: protobuf<8.0.0,>=4.25.8
 Requires-Dist: grpc-interceptor>=0.15.4
 Requires-Dist: opentelemetry-api>=1.22.0
 Requires-Dist: opentelemetry-sdk>=1.22.0
@@ -53,29 +54,28 @@ Dynamic: summary
 Python Client for Cloud Spanner
 ===============================
 
-|GA| |pypi| |versions| 
+|stable| |pypi| |versions|
 
-`Cloud Spanner`_ is the world's first fully managed relational database service
-to offer both strong consistency and horizontal scalability for
-mission-critical online transaction processing (OLTP) applications. With Cloud
-Spanner you enjoy all the traditional benefits of a relational database; but
-unlike any other relational database service, Cloud Spanner scales horizontally
-to hundreds or thousands of servers to handle the biggest transactional
+`Cloud Spanner`_: is the world's first fully managed relational database service 
+to offer both strong consistency and horizontal scalability for 
+mission-critical online transaction processing (OLTP) applications. With Cloud 
+Spanner you enjoy all the traditional benefits of a relational database; but 
+unlike any other relational database service, Cloud Spanner scales horizontally 
+to hundreds or thousands of servers to handle the biggest transactional 
 workloads.
 
-
 - `Client Library Documentation`_
 - `Product Documentation`_
 
-.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
-   :target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#general-availability
+.. |stable| image:: https://img.shields.io/badge/support-stable-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#stability-levels
 .. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-spanner.svg
    :target: https://pypi.org/project/google-cloud-spanner/
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-spanner.svg
    :target: https://pypi.org/project/google-cloud-spanner/
-.. _Cloud Spanner: https://cloud.google.com/spanner/
-.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/spanner/latest
-.. _Product Documentation:  https://cloud.google.com/spanner/docs
+.. _Cloud Spanner: https://cloud.google.com/spanner/docs/
+.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/spanner/latest/summary_overview
+.. _Product Documentation:  https://cloud.google.com/spanner/docs/
 
 Quick Start
 -----------
@@ -84,49 +84,64 @@ In order to use this library, you first need to go through the following steps:
 
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
-3. `Enable the Google Cloud Spanner API.`_
-4. `Setup Authentication.`_
+3. `Enable the Cloud Spanner.`_
+4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
-.. _Enable the Google Cloud Spanner API.:  https://cloud.google.com/spanner
-.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+.. _Enable the Cloud Spanner.:  https://cloud.google.com/spanner/docs/
+.. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
 ~~~~~~~~~~~~
 
-Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
-create isolated Python environments. The basic problem it addresses is one of
-dependencies and versions, and indirectly permissions.
+Install this library in a virtual environment using `venv`_. `venv`_ is a tool that
+creates isolated Python environments. These isolated environments can have separate
+versions of Python packages, which allows you to isolate one project's dependencies
+from the dependencies of other projects.
 
-With `virtualenv`_, it's possible to install this library without needing system
+With `venv`_, it's possible to install this library without needing system
 install permissions, and without clashing with the installed system
 dependencies.
 
-.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+.. _`venv`: https://docs.python.org/3/library/venv.html
+
+
+Code samples and snippets
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Code samples and snippets live in the `samples/`_ folder.
+
+.. _samples/: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-spanner/samples
 
 
 Supported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^
-Python >= 3.9
+Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
+Python.
 
-Deprecated Python Versions
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-Python == 2.7.
-Python == 3.5.
-Python == 3.6.
-Python == 3.7.
-Python == 3.8.
+Python >= 3.9, including 3.14
+
+.. _active: https://devguide.python.org/devcycle/#in-development-main-branch
+.. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
+
+Unsupported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python <= 3.8
+
+If you are using an `end-of-life`_
+version of Python, we recommend that you update as soon as possible to an actively supported version.
+
+.. _end-of-life: https://devguide.python.org/devcycle/#end-of-life-branches
 
 Mac/Linux
 ^^^^^^^^^
 
 .. code-block:: console
 
-    pip install virtualenv
-    virtualenv <your-env>
+    python3 -m venv <your-env>
     source <your-env>/bin/activate
-    <your-env>/bin/pip install google-cloud-spanner
+    pip install google-cloud-spanner
 
 
 Windows
@@ -134,10 +149,9 @@ Windows
 
 .. code-block:: console
 
-    pip install virtualenv
-    virtualenv <your-env>
-    <your-env>\Scripts\activate
-    <your-env>\Scripts\pip.exe install google-cloud-spanner
+    py -m venv <your-env>
+    .\<your-env>\Scripts\activate
+    pip install google-cloud-spanner
 
 
 Example Usage
@@ -243,7 +257,7 @@ To add one or more records to a table, use ``insert``:
         'citizens',
         columns=['email', 'first_name', 'last_name', 'age'],
         values=[
-            ['phred@exammple.com', 'Phred', 'Phlyntstone', 32],
+            ['phred@example.com', 'Phred', 'Phlyntstone', 32],
             ['bharney@example.com', 'Bharney', 'Rhubble', 31],
         ],
     )
@@ -282,7 +296,7 @@ if any of the records does not already exist.
         'citizens',
         columns=['email', 'age'],
         values=[
-            ['phred@exammple.com', 33],
+            ['phred@example.com', 33],
             ['bharney@example.com', 32],
         ],
     )
@@ -323,7 +337,101 @@ Auto-retry of aborted transactions is enabled only for ``!autocommit`` mode, as
 Next Steps
 ~~~~~~~~~~
 
-- See the `Client Library Documentation`_ to learn how to connect to Cloud
-  Spanner using this Client Library.
-- Read the `Product documentation`_ to learn
-  more about the product and see How-to Guides.
+-  Read the `Client Library Documentation`_ for Cloud Spanner
+   to see other available methods on the client.
+-  Read the `Cloud Spanner Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Cloud Spanner Product documentation:  https://cloud.google.com/spanner/docs/
+.. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
+
+Logging
+-------
+
+This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
+Note the following:
+
+#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
+#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
+#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
+
+Simple, environment-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To enable logging for this library without any changes in your code, set the :code:`GOOGLE_SDK_PYTHON_LOGGING_SCOPE` environment variable to a valid Google
+logging scope. This configures handling of logging events (at level :code:`logging.DEBUG` or higher) from this library in a default manner, emitting the logged
+messages in a structured format. It does not currently allow customizing the logging levels captured nor the handlers, formatters, etc. used for any logging
+event.
+
+A logging scope is a period-separated namespace that begins with :code:`google`, identifying the Python module or package to log.
+
+- Valid logging scopes: :code:`google`, :code:`google.cloud.asset.v1`, :code:`google.api`, :code:`google.auth`, etc.
+- Invalid logging scopes: :code:`foo`, :code:`123`, etc.
+
+**NOTE**: If the logging scope is invalid, the library does not set up any logging handlers.
+
+Environment-Based Examples
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+- Enabling the default handler for all Google-based loggers
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
+
+- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.cloud.library_v1
+
+
+Advanced, code-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can also configure a valid logging scope using Python's standard `logging` mechanism.
+
+Code-Based Examples
+^^^^^^^^^^^^^^^^^^^
+
+- Configuring a handler for all Google-based loggers
+
+.. code-block:: python
+
+    import logging
+    
+    from google.cloud import library_v1
+    
+    base_logger = logging.getLogger("google")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: python
+
+    import logging
+    
+    from google.cloud import library_v1
+    
+    base_logger = logging.getLogger("google.cloud.library_v1")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+Logging details
+~~~~~~~~~~~~~~~
+
+#. Regardless of which of the mechanisms above you use to configure logging for this library, by default logging events are not propagated up to the root
+   logger from the `google`-level logger. If you need the events to be propagated to the root logger, you must explicitly set
+   :code:`logging.getLogger("google").propagate = True` in your code.
+#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
+   one library, but decide you need to also set up environment-based logging configuration for another library.
+
+   #. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
+      if the code -based configuration gets applied first.
+
+#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
+   executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.
+   (This is the reason for 2.i. above.)

{google_cloud_spanner-3.63.0 → google_cloud_spanner-3.65.0}/README.rst

@@ -1,29 +1,28 @@
 Python Client for Cloud Spanner
 ===============================
 
-|GA| |pypi| |versions| 
-
-`Cloud Spanner`_ is the world's first fully managed relational database service
-to offer both strong consistency and horizontal scalability for
-mission-critical online transaction processing (OLTP) applications. With Cloud
-Spanner you enjoy all the traditional benefits of a relational database; but
-unlike any other relational database service, Cloud Spanner scales horizontally
-to hundreds or thousands of servers to handle the biggest transactional
+|stable| |pypi| |versions|
+
+`Cloud Spanner`_: is the world's first fully managed relational database service 
+to offer both strong consistency and horizontal scalability for 
+mission-critical online transaction processing (OLTP) applications. With Cloud 
+Spanner you enjoy all the traditional benefits of a relational database; but 
+unlike any other relational database service, Cloud Spanner scales horizontally 
+to hundreds or thousands of servers to handle the biggest transactional 
 workloads.
 
-
 - `Client Library Documentation`_
 - `Product Documentation`_
 
-.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
-   :target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#general-availability
+.. |stable| image:: https://img.shields.io/badge/support-stable-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#stability-levels
 .. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-spanner.svg
    :target: https://pypi.org/project/google-cloud-spanner/
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-spanner.svg
    :target: https://pypi.org/project/google-cloud-spanner/
-.. _Cloud Spanner: https://cloud.google.com/spanner/
-.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/spanner/latest
-.. _Product Documentation:  https://cloud.google.com/spanner/docs
+.. _Cloud Spanner: https://cloud.google.com/spanner/docs/
+.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/spanner/latest/summary_overview
+.. _Product Documentation:  https://cloud.google.com/spanner/docs/
 
 Quick Start
 -----------
@@ -32,49 +31,64 @@ In order to use this library, you first need to go through the following steps:
 
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
-3. `Enable the Google Cloud Spanner API.`_
-4. `Setup Authentication.`_
+3. `Enable the Cloud Spanner.`_
+4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
-.. _Enable the Google Cloud Spanner API.:  https://cloud.google.com/spanner
-.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+.. _Enable the Cloud Spanner.:  https://cloud.google.com/spanner/docs/
+.. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
 ~~~~~~~~~~~~
 
-Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
-create isolated Python environments. The basic problem it addresses is one of
-dependencies and versions, and indirectly permissions.
+Install this library in a virtual environment using `venv`_. `venv`_ is a tool that
+creates isolated Python environments. These isolated environments can have separate
+versions of Python packages, which allows you to isolate one project's dependencies
+from the dependencies of other projects.
 
-With `virtualenv`_, it's possible to install this library without needing system
+With `venv`_, it's possible to install this library without needing system
 install permissions, and without clashing with the installed system
 dependencies.
 
-.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+.. _`venv`: https://docs.python.org/3/library/venv.html
+
+
+Code samples and snippets
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Code samples and snippets live in the `samples/`_ folder.
+
+.. _samples/: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-spanner/samples
 
 
 Supported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^
-Python >= 3.9
+Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
+Python.
 
-Deprecated Python Versions
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-Python == 2.7.
-Python == 3.5.
-Python == 3.6.
-Python == 3.7.
-Python == 3.8.
+Python >= 3.9, including 3.14
+
+.. _active: https://devguide.python.org/devcycle/#in-development-main-branch
+.. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
+
+Unsupported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python <= 3.8
+
+If you are using an `end-of-life`_
+version of Python, we recommend that you update as soon as possible to an actively supported version.
+
+.. _end-of-life: https://devguide.python.org/devcycle/#end-of-life-branches
 
 Mac/Linux
 ^^^^^^^^^
 
 .. code-block:: console
 
-    pip install virtualenv
-    virtualenv <your-env>
+    python3 -m venv <your-env>
     source <your-env>/bin/activate
-    <your-env>/bin/pip install google-cloud-spanner
+    pip install google-cloud-spanner
 
 
 Windows
@@ -82,10 +96,9 @@ Windows
 
 .. code-block:: console
 
-    pip install virtualenv
-    virtualenv <your-env>
-    <your-env>\Scripts\activate
-    <your-env>\Scripts\pip.exe install google-cloud-spanner
+    py -m venv <your-env>
+    .\<your-env>\Scripts\activate
+    pip install google-cloud-spanner
 
 
 Example Usage
@@ -191,7 +204,7 @@ To add one or more records to a table, use ``insert``:
         'citizens',
         columns=['email', 'first_name', 'last_name', 'age'],
         values=[
-            ['phred@exammple.com', 'Phred', 'Phlyntstone', 32],
+            ['phred@example.com', 'Phred', 'Phlyntstone', 32],
             ['bharney@example.com', 'Bharney', 'Rhubble', 31],
         ],
     )
@@ -230,7 +243,7 @@ if any of the records does not already exist.
         'citizens',
         columns=['email', 'age'],
         values=[
-            ['phred@exammple.com', 33],
+            ['phred@example.com', 33],
             ['bharney@example.com', 32],
         ],
     )
@@ -271,7 +284,101 @@ Auto-retry of aborted transactions is enabled only for ``!autocommit`` mode, as
 Next Steps
 ~~~~~~~~~~
 
-- See the `Client Library Documentation`_ to learn how to connect to Cloud
-  Spanner using this Client Library.
-- Read the `Product documentation`_ to learn
-  more about the product and see How-to Guides.
+-  Read the `Client Library Documentation`_ for Cloud Spanner
+   to see other available methods on the client.
+-  Read the `Cloud Spanner Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Cloud Spanner Product documentation:  https://cloud.google.com/spanner/docs/
+.. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
+
+Logging
+-------
+
+This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
+Note the following:
+
+#. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
+#. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
+#. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
+
+Simple, environment-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To enable logging for this library without any changes in your code, set the :code:`GOOGLE_SDK_PYTHON_LOGGING_SCOPE` environment variable to a valid Google
+logging scope. This configures handling of logging events (at level :code:`logging.DEBUG` or higher) from this library in a default manner, emitting the logged
+messages in a structured format. It does not currently allow customizing the logging levels captured nor the handlers, formatters, etc. used for any logging
+event.
+
+A logging scope is a period-separated namespace that begins with :code:`google`, identifying the Python module or package to log.
+
+- Valid logging scopes: :code:`google`, :code:`google.cloud.asset.v1`, :code:`google.api`, :code:`google.auth`, etc.
+- Invalid logging scopes: :code:`foo`, :code:`123`, etc.
+
+**NOTE**: If the logging scope is invalid, the library does not set up any logging handlers.
+
+Environment-Based Examples
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+- Enabling the default handler for all Google-based loggers
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
+
+- Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: console
+
+    export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.cloud.library_v1
+
+
+Advanced, code-based configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can also configure a valid logging scope using Python's standard `logging` mechanism.
+
+Code-Based Examples
+^^^^^^^^^^^^^^^^^^^
+
+- Configuring a handler for all Google-based loggers
+
+.. code-block:: python
+
+    import logging
+    
+    from google.cloud import library_v1
+    
+    base_logger = logging.getLogger("google")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+- Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
+
+.. code-block:: python
+
+    import logging
+    
+    from google.cloud import library_v1
+    
+    base_logger = logging.getLogger("google.cloud.library_v1")
+    base_logger.addHandler(logging.StreamHandler())
+    base_logger.setLevel(logging.DEBUG)
+
+Logging details
+~~~~~~~~~~~~~~~
+
+#. Regardless of which of the mechanisms above you use to configure logging for this library, by default logging events are not propagated up to the root
+   logger from the `google`-level logger. If you need the events to be propagated to the root logger, you must explicitly set
+   :code:`logging.getLogger("google").propagate = True` in your code.
+#. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
+   one library, but decide you need to also set up environment-based logging configuration for another library.
+
+   #. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
+      if the code -based configuration gets applied first.
+
+#. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
+   executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.
+   (This is the reason for 2.i. above.)

google_cloud_spanner-3.65.0/google/cloud/aio/_cross_sync/__init__.py

@@ -0,0 +1,19 @@
+# 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
+#
+#     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.
+
+from .cross_sync import CrossSync
+
+__all__ = [
+    "CrossSync",
+]