From 25d9d2c32638eb3e551921eecea435452c548bcb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Thu, 31 Oct 2024 08:51:12 +0100
Subject: [PATCH 001/133] deps: update all deps (#413)

* deps: update all deps

* chore: update tests

* chore: run code formatter

* chore: ignore warning

* chore: make script work on Python 3.8

* chore: install setuptools

* deps: update pip before running nox

* deps: upgrade setuptools

* build: remove kokoro presubmit workflows

* build: add migration 1310 test runner

* build: only run units + 1.4 compliance

* build: try this config

* build: only run unit tests on Kokoro
---
 .github/workflows/test_suite.yml        |   28 +-
 .gitignore                              |    4 +-
 .kokoro/build.sh                        |    2 +
 .kokoro/presubmit/compliance.cfg        |    2 +-
 create_test_database.py                 |    4 +
 noxfile.py                              |   18 +-
 requirements.txt                        | 1007 +++++++++++------------
 setup.py                                |   46 +-
 test/_helpers.py                        |    2 +-
 test/test_suite_20.py                   |   24 +-
 test/unit/test_opentelemetry_tracing.py |    5 +-
 11 files changed, 588 insertions(+), 554 deletions(-)

diff --git a/.github/workflows/test_suite.yml b/.github/workflows/test_suite.yml
index 5d4e2c30..518325f0 100644
--- a/.github/workflows/test_suite.yml
+++ b/.github/workflows/test_suite.yml
@@ -14,7 +14,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: 3.8
+          python-version: 3.12
       - name: Install nox
         run: python -m pip install nox
       - name: Run Lint
@@ -102,7 +102,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: 3.8
+          python-version: 3.12
       - name: Install nox
         run: python -m pip install nox
       - name: Run Compliance Tests
@@ -134,3 +134,27 @@ jobs:
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: appdev-soda-spanner-staging
+
+  migration1310_tests:
+    runs-on: ubuntu-latest
+
+    services:
+      emulator-0:
+        image: gcr.io/cloud-spanner-emulator/emulator:latest
+        ports:
+          - 9010:9010
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.8
+      - name: Install nox
+        run: python -m pip install nox
+      - name: Run Migration Tests
+        run: nox -s migration_test_1310
+        env:
+          SPANNER_EMULATOR_HOST: localhost:9010
+          GOOGLE_CLOUD_PROJECT: appdev-soda-spanner-staging
diff --git a/.gitignore b/.gitignore
index ff157fe9..6cb13eed 100644
--- a/.gitignore
+++ b/.gitignore
@@ -57,4 +57,6 @@ system_tests/local_test_setup
 
 # Make sure a generated file isn't accidentally committed.
 pylintrc
-pylintrc.test
\ No newline at end of file
+pylintrc.test
+
+test.cfg
\ No newline at end of file
diff --git a/.kokoro/build.sh b/.kokoro/build.sh
index da86aa22..2c87f749 100755
--- a/.kokoro/build.sh
+++ b/.kokoro/build.sh
@@ -43,6 +43,8 @@ fi
 # otherwise run all the sessions.
 if [[ -n "${NOX_SESSION:-}" ]]; then
     python3 -m nox -s ${NOX_SESSION:-}
+elif [[ "${RUN_COMPLIANCE_TESTS}" -eq "false" ]]; then
+    python3 -m nox -s unit
 else
     python3 -m nox
 fi
diff --git a/.kokoro/presubmit/compliance.cfg b/.kokoro/presubmit/compliance.cfg
index 972cbc50..1261d8a0 100644
--- a/.kokoro/presubmit/compliance.cfg
+++ b/.kokoro/presubmit/compliance.cfg
@@ -3,5 +3,5 @@
 # Only run this nox session.
 env_vars: {
     key: "NOX_SESSION"
-    value: "compliance_test_20"
+    value: "unit"
 }
diff --git a/create_test_database.py b/create_test_database.py
index 915c5040..1e29d44f 100644
--- a/create_test_database.py
+++ b/create_test_database.py
@@ -90,6 +90,10 @@ def create_test_instance():
     except AlreadyExists:
         pass  # instance was already created
 
+    if USE_EMULATOR:
+        database = instance.database("compliance-test")
+        database.drop()
+
     try:
         database = instance.database("compliance-test")
         created_op = database.create()
diff --git a/noxfile.py b/noxfile.py
index 614e593d..80713b16 100644
--- a/noxfile.py
+++ b/noxfile.py
@@ -78,9 +78,10 @@ class = StreamHandler
 BLACK_VERSION = "black==22.3.0"
 BLACK_PATHS = ["google", "test", "noxfile.py", "setup.py", "samples"]
 DEFAULT_PYTHON_VERSION = "3.8"
+DEFAULT_PYTHON_VERSION_FOR_SQLALCHEMY_20 = "3.12"
 
 
-@nox.session(python=DEFAULT_PYTHON_VERSION)
+@nox.session(python=DEFAULT_PYTHON_VERSION_FOR_SQLALCHEMY_20)
 def lint(session):
     """Run linters.
 
@@ -101,7 +102,7 @@ def lint(session):
     )
 
 
-@nox.session(python=DEFAULT_PYTHON_VERSION)
+@nox.session(python=DEFAULT_PYTHON_VERSION_FOR_SQLALCHEMY_20)
 def blacken(session):
     """Run black.
 
@@ -118,10 +119,10 @@ def blacken(session):
     )
 
 
-@nox.session(python=DEFAULT_PYTHON_VERSION)
+@nox.session(python=DEFAULT_PYTHON_VERSION_FOR_SQLALCHEMY_20)
 def lint_setup_py(session):
     """Verify that setup.py is valid (including RST check)."""
-    session.install("docutils", "pygments")
+    session.install("docutils", "pygments", "setuptools")
     session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
 
 
@@ -208,7 +209,7 @@ def compliance_test_14(session):
     )
 
 
-@nox.session(python=DEFAULT_PYTHON_VERSION)
+@nox.session(python=DEFAULT_PYTHON_VERSION_FOR_SQLALCHEMY_20)
 def compliance_test_20(session):
     """Run SQLAlchemy dialect compliance test suite."""
 
@@ -255,12 +256,13 @@ def compliance_test_20(session):
 def unit(session):
     """Run unit tests."""
     # Run SQLAlchemy dialect compliance test suite with OpenTelemetry.
+    session.install("setuptools")
     session.install("pytest")
     session.install("mock")
     session.install(".")
-    session.install("opentelemetry-api==1.1.0")
-    session.install("opentelemetry-sdk==1.1.0")
-    session.install("opentelemetry-instrumentation==0.20b0")
+    session.install("opentelemetry-api==1.27.0")
+    session.install("opentelemetry-sdk==1.27.0")
+    session.install("opentelemetry-instrumentation==0.48b0")
     session.run("python", "create_test_config.py", "my-project", "my-instance")
     session.run("py.test", "--quiet", os.path.join("test/unit"), *session.posargs)
 
diff --git a/requirements.txt b/requirements.txt
index 6772a155..04fea757 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,592 +1,571 @@
 #
-# This file is autogenerated by pip-compile with python 3.8
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.12
+# by the following command:
 #
 #    pip-compile --generate-hashes
 #
-alembic==1.8.1 \
-    --hash=sha256:0a024d7f2de88d738d7395ff866997314c837be6104e90c5724350313dee4da4 \
-    --hash=sha256:cd0b5e45b14b706426b833f06369b9a6d5ee03f826ec3238723ce8caaf6e5ffa
+alembic==1.13.3 \
+    --hash=sha256:203503117415561e203aa14541740643a611f641517f0209fcae63e9fa09f1a2 \
+    --hash=sha256:908e905976d15235fae59c9ac42c4c5b75cfcefe3d27c0fbf7ae15a37715d80e
     # via -r requirements.in
-build==0.8.0 \
-    --hash=sha256:19b0ed489f92ace6947698c3ca8436cb0556a66e2aa2d34cd70e2a5d27cd0437 \
-    --hash=sha256:887a6d471c901b1a6e6574ebaeeebb45e5269a79d095fe9a8f88d6614ed2e5f0
+build==1.2.2.post1 \
+    --hash=sha256:1d61c0887fa860c01971625baae8bdd338e517b836a2f70dd1f7aa3a6b2fc5b5 \
+    --hash=sha256:b36993e92ca9375a219c99e606a122ff365a760a2d4bba0caa09bd5278b608b7
     # via
     #   -r requirements.in
     #   pip-tools
-cachetools==5.2.0 \
-    --hash=sha256:6a94c6402995a99c3970cc7e4884bb60b4a8639938157eeed436098bf9831757 \
-    --hash=sha256:f9f17d2aec496a9aa6b76f53e3b614c965223c061982d434d160f930c698a9db
+cachetools==5.5.0 \
+    --hash=sha256:02134e8439cdc2ffb62023ce1debca2944c3f289d66bb17ead3ab3dede74b292 \
+    --hash=sha256:2cc24fb4cbe39633fb7badd9db9ca6295d766d9c2995f245725a46715d050f2a
     # via google-auth
-certifi==2023.7.22 \
-    --hash=sha256:539cc1d13202e33ca466e88b2807e29f4c13049d6d87031a3c110744495cb082 \
-    --hash=sha256:92d6037539857d8206b8f6ae472e8b77db8058fec5937a1ef3f54304089edbb9
+certifi==2024.8.30 \
+    --hash=sha256:922820b53db7a7257ffbda3f597266d435245903d80737e34f8a45ff3e3230d8 \
+    --hash=sha256:bec941d2aa8195e248a60b31ff9f0558284cf01a52591ceda73ea9afffd69fd9
     # via requests
-charset-normalizer==3.3.2 \
-    --hash=sha256:06435b539f889b1f6f4ac1758871aae42dc3a8c0e24ac9e60c2384973ad73027 \
-    --hash=sha256:06a81e93cd441c56a9b65d8e1d043daeb97a3d0856d177d5c90ba85acb3db087 \
-    --hash=sha256:0a55554a2fa0d408816b3b5cedf0045f4b8e1a6065aec45849de2d6f3f8e9786 \
-    --hash=sha256:0b2b64d2bb6d3fb9112bafa732def486049e63de9618b5843bcdd081d8144cd8 \
-    --hash=sha256:10955842570876604d404661fbccbc9c7e684caf432c09c715ec38fbae45ae09 \
-    --hash=sha256:122c7fa62b130ed55f8f285bfd56d5f4b4a5b503609d181f9ad85e55c89f4185 \
-    --hash=sha256:1ceae2f17a9c33cb48e3263960dc5fc8005351ee19db217e9b1bb15d28c02574 \
-    --hash=sha256:1d3193f4a680c64b4b6a9115943538edb896edc190f0b222e73761716519268e \
-    --hash=sha256:1f79682fbe303db92bc2b1136016a38a42e835d932bab5b3b1bfcfbf0640e519 \
-    --hash=sha256:2127566c664442652f024c837091890cb1942c30937add288223dc895793f898 \
-    --hash=sha256:22afcb9f253dac0696b5a4be4a1c0f8762f8239e21b99680099abd9b2b1b2269 \
-    --hash=sha256:25baf083bf6f6b341f4121c2f3c548875ee6f5339300e08be3f2b2ba1721cdd3 \
-    --hash=sha256:2e81c7b9c8979ce92ed306c249d46894776a909505d8f5a4ba55b14206e3222f \
-    --hash=sha256:3287761bc4ee9e33561a7e058c72ac0938c4f57fe49a09eae428fd88aafe7bb6 \
-    --hash=sha256:34d1c8da1e78d2e001f363791c98a272bb734000fcef47a491c1e3b0505657a8 \
-    --hash=sha256:37e55c8e51c236f95b033f6fb391d7d7970ba5fe7ff453dad675e88cf303377a \
-    --hash=sha256:3d47fa203a7bd9c5b6cee4736ee84ca03b8ef23193c0d1ca99b5089f72645c73 \
-    --hash=sha256:3e4d1f6587322d2788836a99c69062fbb091331ec940e02d12d179c1d53e25fc \
-    --hash=sha256:42cb296636fcc8b0644486d15c12376cb9fa75443e00fb25de0b8602e64c1714 \
-    --hash=sha256:45485e01ff4d3630ec0d9617310448a8702f70e9c01906b0d0118bdf9d124cf2 \
-    --hash=sha256:4a78b2b446bd7c934f5dcedc588903fb2f5eec172f3d29e52a9096a43722adfc \
-    --hash=sha256:4ab2fe47fae9e0f9dee8c04187ce5d09f48eabe611be8259444906793ab7cbce \
-    --hash=sha256:4d0d1650369165a14e14e1e47b372cfcb31d6ab44e6e33cb2d4e57265290044d \
-    --hash=sha256:549a3a73da901d5bc3ce8d24e0600d1fa85524c10287f6004fbab87672bf3e1e \
-    --hash=sha256:55086ee1064215781fff39a1af09518bc9255b50d6333f2e4c74ca09fac6a8f6 \
-    --hash=sha256:572c3763a264ba47b3cf708a44ce965d98555f618ca42c926a9c1616d8f34269 \
-    --hash=sha256:573f6eac48f4769d667c4442081b1794f52919e7edada77495aaed9236d13a96 \
-    --hash=sha256:5b4c145409bef602a690e7cfad0a15a55c13320ff7a3ad7ca59c13bb8ba4d45d \
-    --hash=sha256:6463effa3186ea09411d50efc7d85360b38d5f09b870c48e4600f63af490e56a \
-    --hash=sha256:65f6f63034100ead094b8744b3b97965785388f308a64cf8d7c34f2f2e5be0c4 \
-    --hash=sha256:663946639d296df6a2bb2aa51b60a2454ca1cb29835324c640dafb5ff2131a77 \
-    --hash=sha256:6897af51655e3691ff853668779c7bad41579facacf5fd7253b0133308cf000d \
-    --hash=sha256:68d1f8a9e9e37c1223b656399be5d6b448dea850bed7d0f87a8311f1ff3dabb0 \
-    --hash=sha256:6ac7ffc7ad6d040517be39eb591cac5ff87416c2537df6ba3cba3bae290c0fed \
-    --hash=sha256:6b3251890fff30ee142c44144871185dbe13b11bab478a88887a639655be1068 \
-    --hash=sha256:6c4caeef8fa63d06bd437cd4bdcf3ffefe6738fb1b25951440d80dc7df8c03ac \
-    --hash=sha256:6ef1d82a3af9d3eecdba2321dc1b3c238245d890843e040e41e470ffa64c3e25 \
-    --hash=sha256:753f10e867343b4511128c6ed8c82f7bec3bd026875576dfd88483c5c73b2fd8 \
-    --hash=sha256:7cd13a2e3ddeed6913a65e66e94b51d80a041145a026c27e6bb76c31a853c6ab \
-    --hash=sha256:7ed9e526742851e8d5cc9e6cf41427dfc6068d4f5a3bb03659444b4cabf6bc26 \
-    --hash=sha256:7f04c839ed0b6b98b1a7501a002144b76c18fb1c1850c8b98d458ac269e26ed2 \
-    --hash=sha256:802fe99cca7457642125a8a88a084cef28ff0cf9407060f7b93dca5aa25480db \
-    --hash=sha256:80402cd6ee291dcb72644d6eac93785fe2c8b9cb30893c1af5b8fdd753b9d40f \
-    --hash=sha256:8465322196c8b4d7ab6d1e049e4c5cb460d0394da4a27d23cc242fbf0034b6b5 \
-    --hash=sha256:86216b5cee4b06df986d214f664305142d9c76df9b6512be2738aa72a2048f99 \
-    --hash=sha256:87d1351268731db79e0f8e745d92493ee2841c974128ef629dc518b937d9194c \
-    --hash=sha256:8bdb58ff7ba23002a4c5808d608e4e6c687175724f54a5dade5fa8c67b604e4d \
-    --hash=sha256:8c622a5fe39a48f78944a87d4fb8a53ee07344641b0562c540d840748571b811 \
-    --hash=sha256:8d756e44e94489e49571086ef83b2bb8ce311e730092d2c34ca8f7d925cb20aa \
-    --hash=sha256:8f4a014bc36d3c57402e2977dada34f9c12300af536839dc38c0beab8878f38a \
-    --hash=sha256:9063e24fdb1e498ab71cb7419e24622516c4a04476b17a2dab57e8baa30d6e03 \
-    --hash=sha256:90d558489962fd4918143277a773316e56c72da56ec7aa3dc3dbbe20fdfed15b \
-    --hash=sha256:923c0c831b7cfcb071580d3f46c4baf50f174be571576556269530f4bbd79d04 \
-    --hash=sha256:95f2a5796329323b8f0512e09dbb7a1860c46a39da62ecb2324f116fa8fdc85c \
-    --hash=sha256:96b02a3dc4381e5494fad39be677abcb5e6634bf7b4fa83a6dd3112607547001 \
-    --hash=sha256:9f96df6923e21816da7e0ad3fd47dd8f94b2a5ce594e00677c0013018b813458 \
-    --hash=sha256:a10af20b82360ab00827f916a6058451b723b4e65030c5a18577c8b2de5b3389 \
-    --hash=sha256:a50aebfa173e157099939b17f18600f72f84eed3049e743b68ad15bd69b6bf99 \
-    --hash=sha256:a981a536974bbc7a512cf44ed14938cf01030a99e9b3a06dd59578882f06f985 \
-    --hash=sha256:a9a8e9031d613fd2009c182b69c7b2c1ef8239a0efb1df3f7c8da66d5dd3d537 \
-    --hash=sha256:ae5f4161f18c61806f411a13b0310bea87f987c7d2ecdbdaad0e94eb2e404238 \
-    --hash=sha256:aed38f6e4fb3f5d6bf81bfa990a07806be9d83cf7bacef998ab1a9bd660a581f \
-    --hash=sha256:b01b88d45a6fcb69667cd6d2f7a9aeb4bf53760d7fc536bf679ec94fe9f3ff3d \
-    --hash=sha256:b261ccdec7821281dade748d088bb6e9b69e6d15b30652b74cbbac25e280b796 \
-    --hash=sha256:b2b0a0c0517616b6869869f8c581d4eb2dd83a4d79e0ebcb7d373ef9956aeb0a \
-    --hash=sha256:b4a23f61ce87adf89be746c8a8974fe1c823c891d8f86eb218bb957c924bb143 \
-    --hash=sha256:bd8f7df7d12c2db9fab40bdd87a7c09b1530128315d047a086fa3ae3435cb3a8 \
-    --hash=sha256:beb58fe5cdb101e3a055192ac291b7a21e3b7ef4f67fa1d74e331a7f2124341c \
-    --hash=sha256:c002b4ffc0be611f0d9da932eb0f704fe2602a9a949d1f738e4c34c75b0863d5 \
-    --hash=sha256:c083af607d2515612056a31f0a8d9e0fcb5876b7bfc0abad3ecd275bc4ebc2d5 \
-    --hash=sha256:c180f51afb394e165eafe4ac2936a14bee3eb10debc9d9e4db8958fe36afe711 \
-    --hash=sha256:c235ebd9baae02f1b77bcea61bce332cb4331dc3617d254df3323aa01ab47bd4 \
-    --hash=sha256:cd70574b12bb8a4d2aaa0094515df2463cb429d8536cfb6c7ce983246983e5a6 \
-    --hash=sha256:d0eccceffcb53201b5bfebb52600a5fb483a20b61da9dbc885f8b103cbe7598c \
-    --hash=sha256:d965bba47ddeec8cd560687584e88cf699fd28f192ceb452d1d7ee807c5597b7 \
-    --hash=sha256:db364eca23f876da6f9e16c9da0df51aa4f104a972735574842618b8c6d999d4 \
-    --hash=sha256:ddbb2551d7e0102e7252db79ba445cdab71b26640817ab1e3e3648dad515003b \
-    --hash=sha256:deb6be0ac38ece9ba87dea880e438f25ca3eddfac8b002a2ec3d9183a454e8ae \
-    --hash=sha256:e06ed3eb3218bc64786f7db41917d4e686cc4856944f53d5bdf83a6884432e12 \
-    --hash=sha256:e27ad930a842b4c5eb8ac0016b0a54f5aebbe679340c26101df33424142c143c \
-    --hash=sha256:e537484df0d8f426ce2afb2d0f8e1c3d0b114b83f8850e5f2fbea0e797bd82ae \
-    --hash=sha256:eb00ed941194665c332bf8e078baf037d6c35d7c4f3102ea2d4f16ca94a26dc8 \
-    --hash=sha256:eb6904c354526e758fda7167b33005998fb68c46fbc10e013ca97f21ca5c8887 \
-    --hash=sha256:eb8821e09e916165e160797a6c17edda0679379a4be5c716c260e836e122f54b \
-    --hash=sha256:efcb3f6676480691518c177e3b465bcddf57cea040302f9f4e6e191af91174d4 \
-    --hash=sha256:f27273b60488abe721a075bcca6d7f3964f9f6f067c8c4c605743023d7d3944f \
-    --hash=sha256:f30c3cb33b24454a82faecaf01b19c18562b1e89558fb6c56de4d9118a032fd5 \
-    --hash=sha256:fb69256e180cb6c8a894fee62b3afebae785babc1ee98b81cdf68bbca1987f33 \
-    --hash=sha256:fd1abc0d89e30cc4e02e4064dc67fcc51bd941eb395c502aac3ec19fab46b519 \
-    --hash=sha256:ff8fa367d09b717b2a17a052544193ad76cd49979c805768879cb63d9ca50561
+charset-normalizer==3.4.0 \
+    --hash=sha256:0099d79bdfcf5c1f0c2c72f91516702ebf8b0b8ddd8905f97a8aecf49712c621 \
+    --hash=sha256:0713f3adb9d03d49d365b70b84775d0a0d18e4ab08d12bc46baa6132ba78aaf6 \
+    --hash=sha256:07afec21bbbbf8a5cc3651aa96b980afe2526e7f048fdfb7f1014d84acc8b6d8 \
+    --hash=sha256:0b309d1747110feb25d7ed6b01afdec269c647d382c857ef4663bbe6ad95a912 \
+    --hash=sha256:0d99dd8ff461990f12d6e42c7347fd9ab2532fb70e9621ba520f9e8637161d7c \
+    --hash=sha256:0de7b687289d3c1b3e8660d0741874abe7888100efe14bd0f9fd7141bcbda92b \
+    --hash=sha256:1110e22af8ca26b90bd6364fe4c763329b0ebf1ee213ba32b68c73de5752323d \
+    --hash=sha256:130272c698667a982a5d0e626851ceff662565379baf0ff2cc58067b81d4f11d \
+    --hash=sha256:136815f06a3ae311fae551c3df1f998a1ebd01ddd424aa5603a4336997629e95 \
+    --hash=sha256:14215b71a762336254351b00ec720a8e85cada43b987da5a042e4ce3e82bd68e \
+    --hash=sha256:1db4e7fefefd0f548d73e2e2e041f9df5c59e178b4c72fbac4cc6f535cfb1565 \
+    --hash=sha256:1ffd9493de4c922f2a38c2bf62b831dcec90ac673ed1ca182fe11b4d8e9f2a64 \
+    --hash=sha256:2006769bd1640bdf4d5641c69a3d63b71b81445473cac5ded39740a226fa88ab \
+    --hash=sha256:20587d20f557fe189b7947d8e7ec5afa110ccf72a3128d61a2a387c3313f46be \
+    --hash=sha256:223217c3d4f82c3ac5e29032b3f1c2eb0fb591b72161f86d93f5719079dae93e \
+    --hash=sha256:27623ba66c183eca01bf9ff833875b459cad267aeeb044477fedac35e19ba907 \
+    --hash=sha256:285e96d9d53422efc0d7a17c60e59f37fbf3dfa942073f666db4ac71e8d726d0 \
+    --hash=sha256:2de62e8801ddfff069cd5c504ce3bc9672b23266597d4e4f50eda28846c322f2 \
+    --hash=sha256:2f6c34da58ea9c1a9515621f4d9ac379871a8f21168ba1b5e09d74250de5ad62 \
+    --hash=sha256:309a7de0a0ff3040acaebb35ec45d18db4b28232f21998851cfa709eeff49d62 \
+    --hash=sha256:35c404d74c2926d0287fbd63ed5d27eb911eb9e4a3bb2c6d294f3cfd4a9e0c23 \
+    --hash=sha256:3710a9751938947e6327ea9f3ea6332a09bf0ba0c09cae9cb1f250bd1f1549bc \
+    --hash=sha256:3d59d125ffbd6d552765510e3f31ed75ebac2c7470c7274195b9161a32350284 \
+    --hash=sha256:40d3ff7fc90b98c637bda91c89d51264a3dcf210cade3a2c6f838c7268d7a4ca \
+    --hash=sha256:425c5f215d0eecee9a56cdb703203dda90423247421bf0d67125add85d0c4455 \
+    --hash=sha256:43193c5cda5d612f247172016c4bb71251c784d7a4d9314677186a838ad34858 \
+    --hash=sha256:44aeb140295a2f0659e113b31cfe92c9061622cadbc9e2a2f7b8ef6b1e29ef4b \
+    --hash=sha256:47334db71978b23ebcf3c0f9f5ee98b8d65992b65c9c4f2d34c2eaf5bcaf0594 \
+    --hash=sha256:4796efc4faf6b53a18e3d46343535caed491776a22af773f366534056c4e1fbc \
+    --hash=sha256:4a51b48f42d9358460b78725283f04bddaf44a9358197b889657deba38f329db \
+    --hash=sha256:4b67fdab07fdd3c10bb21edab3cbfe8cf5696f453afce75d815d9d7223fbe88b \
+    --hash=sha256:4ec9dd88a5b71abfc74e9df5ebe7921c35cbb3b641181a531ca65cdb5e8e4dea \
+    --hash=sha256:4f9fc98dad6c2eaa32fc3af1417d95b5e3d08aff968df0cd320066def971f9a6 \
+    --hash=sha256:54b6a92d009cbe2fb11054ba694bc9e284dad30a26757b1e372a1fdddaf21920 \
+    --hash=sha256:55f56e2ebd4e3bc50442fbc0888c9d8c94e4e06a933804e2af3e89e2f9c1c749 \
+    --hash=sha256:5726cf76c982532c1863fb64d8c6dd0e4c90b6ece9feb06c9f202417a31f7dd7 \
+    --hash=sha256:5d447056e2ca60382d460a604b6302d8db69476fd2015c81e7c35417cfabe4cd \
+    --hash=sha256:5ed2e36c3e9b4f21dd9422f6893dec0abf2cca553af509b10cd630f878d3eb99 \
+    --hash=sha256:5ff2ed8194587faf56555927b3aa10e6fb69d931e33953943bc4f837dfee2242 \
+    --hash=sha256:62f60aebecfc7f4b82e3f639a7d1433a20ec32824db2199a11ad4f5e146ef5ee \
+    --hash=sha256:63bc5c4ae26e4bc6be6469943b8253c0fd4e4186c43ad46e713ea61a0ba49129 \
+    --hash=sha256:6b40e8d38afe634559e398cc32b1472f376a4099c75fe6299ae607e404c033b2 \
+    --hash=sha256:6b493a043635eb376e50eedf7818f2f322eabbaa974e948bd8bdd29eb7ef2a51 \
+    --hash=sha256:6dba5d19c4dfab08e58d5b36304b3f92f3bd5d42c1a3fa37b5ba5cdf6dfcbcee \
+    --hash=sha256:6fd30dc99682dc2c603c2b315bded2799019cea829f8bf57dc6b61efde6611c8 \
+    --hash=sha256:707b82d19e65c9bd28b81dde95249b07bf9f5b90ebe1ef17d9b57473f8a64b7b \
+    --hash=sha256:7706f5850360ac01d80c89bcef1640683cc12ed87f42579dab6c5d3ed6888613 \
+    --hash=sha256:7782afc9b6b42200f7362858f9e73b1f8316afb276d316336c0ec3bd73312742 \
+    --hash=sha256:79983512b108e4a164b9c8d34de3992f76d48cadc9554c9e60b43f308988aabe \
+    --hash=sha256:7f683ddc7eedd742e2889d2bfb96d69573fde1d92fcb811979cdb7165bb9c7d3 \
+    --hash=sha256:82357d85de703176b5587dbe6ade8ff67f9f69a41c0733cf2425378b49954de5 \
+    --hash=sha256:84450ba661fb96e9fd67629b93d2941c871ca86fc38d835d19d4225ff946a631 \
+    --hash=sha256:86f4e8cca779080f66ff4f191a685ced73d2f72d50216f7112185dc02b90b9b7 \
+    --hash=sha256:8cda06946eac330cbe6598f77bb54e690b4ca93f593dee1568ad22b04f347c15 \
+    --hash=sha256:8ce7fd6767a1cc5a92a639b391891bf1c268b03ec7e021c7d6d902285259685c \
+    --hash=sha256:8ff4e7cdfdb1ab5698e675ca622e72d58a6fa2a8aa58195de0c0061288e6e3ea \
+    --hash=sha256:9289fd5dddcf57bab41d044f1756550f9e7cf0c8e373b8cdf0ce8773dc4bd417 \
+    --hash=sha256:92a7e36b000bf022ef3dbb9c46bfe2d52c047d5e3f3343f43204263c5addc250 \
+    --hash=sha256:92db3c28b5b2a273346bebb24857fda45601aef6ae1c011c0a997106581e8a88 \
+    --hash=sha256:95c3c157765b031331dd4db3c775e58deaee050a3042fcad72cbc4189d7c8dca \
+    --hash=sha256:980b4f289d1d90ca5efcf07958d3eb38ed9c0b7676bf2831a54d4f66f9c27dfa \
+    --hash=sha256:9ae4ef0b3f6b41bad6366fb0ea4fc1d7ed051528e113a60fa2a65a9abb5b1d99 \
+    --hash=sha256:9c98230f5042f4945f957d006edccc2af1e03ed5e37ce7c373f00a5a4daa6149 \
+    --hash=sha256:9fa2566ca27d67c86569e8c85297aaf413ffab85a8960500f12ea34ff98e4c41 \
+    --hash=sha256:a14969b8691f7998e74663b77b4c36c0337cb1df552da83d5c9004a93afdb574 \
+    --hash=sha256:a8aacce6e2e1edcb6ac625fb0f8c3a9570ccc7bfba1f63419b3769ccf6a00ed0 \
+    --hash=sha256:a8e538f46104c815be19c975572d74afb53f29650ea2025bbfaef359d2de2f7f \
+    --hash=sha256:aa41e526a5d4a9dfcfbab0716c7e8a1b215abd3f3df5a45cf18a12721d31cb5d \
+    --hash=sha256:aa693779a8b50cd97570e5a0f343538a8dbd3e496fa5dcb87e29406ad0299654 \
+    --hash=sha256:ab22fbd9765e6954bc0bcff24c25ff71dcbfdb185fcdaca49e81bac68fe724d3 \
+    --hash=sha256:ab2e5bef076f5a235c3774b4f4028a680432cded7cad37bba0fd90d64b187d19 \
+    --hash=sha256:ab973df98fc99ab39080bfb0eb3a925181454d7c3ac8a1e695fddfae696d9e90 \
+    --hash=sha256:af73657b7a68211996527dbfeffbb0864e043d270580c5aef06dc4b659a4b578 \
+    --hash=sha256:b197e7094f232959f8f20541ead1d9862ac5ebea1d58e9849c1bf979255dfac9 \
+    --hash=sha256:b295729485b06c1a0683af02a9e42d2caa9db04a373dc38a6a58cdd1e8abddf1 \
+    --hash=sha256:b8831399554b92b72af5932cdbbd4ddc55c55f631bb13ff8fe4e6536a06c5c51 \
+    --hash=sha256:b8dcd239c743aa2f9c22ce674a145e0a25cb1566c495928440a181ca1ccf6719 \
+    --hash=sha256:bcb4f8ea87d03bc51ad04add8ceaf9b0f085ac045ab4d74e73bbc2dc033f0236 \
+    --hash=sha256:bd7af3717683bea4c87acd8c0d3d5b44d56120b26fd3f8a692bdd2d5260c620a \
+    --hash=sha256:bf4475b82be41b07cc5e5ff94810e6a01f276e37c2d55571e3fe175e467a1a1c \
+    --hash=sha256:c3e446d253bd88f6377260d07c895816ebf33ffffd56c1c792b13bff9c3e1ade \
+    --hash=sha256:c57516e58fd17d03ebe67e181a4e4e2ccab1168f8c2976c6a334d4f819fe5944 \
+    --hash=sha256:c94057af19bc953643a33581844649a7fdab902624d2eb739738a30e2b3e60fc \
+    --hash=sha256:cab5d0b79d987c67f3b9e9c53f54a61360422a5a0bc075f43cab5621d530c3b6 \
+    --hash=sha256:ce031db0408e487fd2775d745ce30a7cd2923667cf3b69d48d219f1d8f5ddeb6 \
+    --hash=sha256:cee4373f4d3ad28f1ab6290684d8e2ebdb9e7a1b74fdc39e4c211995f77bec27 \
+    --hash=sha256:d5b054862739d276e09928de37c79ddeec42a6e1bfc55863be96a36ba22926f6 \
+    --hash=sha256:dbe03226baf438ac4fda9e2d0715022fd579cb641c4cf639fa40d53b2fe6f3e2 \
+    --hash=sha256:dc15e99b2d8a656f8e666854404f1ba54765871104e50c8e9813af8a7db07f12 \
+    --hash=sha256:dcaf7c1524c0542ee2fc82cc8ec337f7a9f7edee2532421ab200d2b920fc97cf \
+    --hash=sha256:dd4eda173a9fcccb5f2e2bd2a9f423d180194b1bf17cf59e3269899235b2a114 \
+    --hash=sha256:dd9a8bd8900e65504a305bf8ae6fa9fbc66de94178c420791d0293702fce2df7 \
+    --hash=sha256:de7376c29d95d6719048c194a9cf1a1b0393fbe8488a22008610b0361d834ecf \
+    --hash=sha256:e7fdd52961feb4c96507aa649550ec2a0d527c086d284749b2f582f2d40a2e0d \
+    --hash=sha256:e91f541a85298cf35433bf66f3fab2a4a2cff05c127eeca4af174f6d497f0d4b \
+    --hash=sha256:e9e3c4c9e1ed40ea53acf11e2a386383c3304212c965773704e4603d589343ed \
+    --hash=sha256:ee803480535c44e7f5ad00788526da7d85525cfefaf8acf8ab9a310000be4b03 \
+    --hash=sha256:f09cb5a7bbe1ecae6e87901a2eb23e0256bb524a79ccc53eb0b7629fbe7677c4 \
+    --hash=sha256:f19c1585933c82098c2a520f8ec1227f20e339e33aca8fa6f956f6691b784e67 \
+    --hash=sha256:f1a2f519ae173b5b6a2c9d5fa3116ce16e48b3462c8b96dfdded11055e3d6365 \
+    --hash=sha256:f28f891ccd15c514a0981f3b9db9aa23d62fe1a99997512b0491d2ed323d229a \
+    --hash=sha256:f3e73a4255342d4eb26ef6df01e3962e73aa29baa3124a8e824c5d3364a65748 \
+    --hash=sha256:f606a1881d2663630ea5b8ce2efe2111740df4b687bd78b34a8131baa007f79b \
+    --hash=sha256:fe9f97feb71aa9896b81973a7bbada8c49501dc73e58a10fcef6663af95e5079 \
+    --hash=sha256:ffc519621dce0c767e96b9c53f09c5d215578e10b02c285809f76509a3931482
     # via requests
-click==8.1.3 \
-    --hash=sha256:7682dc8afb30297001674575ea00d1814d808d6a36af415a82bd481d37ba7b8e \
-    --hash=sha256:bb4d8133cb15a609f44e8213d9b391b0809795062913b383c62be0ee95b1db48
+click==8.1.7 \
+    --hash=sha256:ae74fb96c20a0277a1d615f1e4d73c8414f5a98db8b799a7931d1582f3390c28 \
+    --hash=sha256:ca9853ad459e787e2192211578cc907e7594e294c7ccc834310722b41b9ca6de
     # via
     #   -r requirements.in
     #   pip-tools
-Deprecated==1.2.14 \
+deprecated==1.2.14 \
     --hash=sha256:6fac8b097794a90302bdbb17b9b815e732d3c4720583ff1b198499d78470466c \
     --hash=sha256:e5323eb936458dccc2582dc6f9c322c852a775a27065ff2b0c4970b9d53d01b3
-    # via opentelemetry-api
-google-api-core[grpc]==2.10.2 \
-    --hash=sha256:10c06f7739fe57781f87523375e8e1a3a4674bf6392cd6131a3222182b971320 \
-    --hash=sha256:34f24bd1d5f72a8c4519773d99ca6bf080a6c4e041b4e9f024fe230191dda62e
+    # via
+    #   opentelemetry-api
+    #   opentelemetry-semantic-conventions
+google-api-core[grpc]==2.21.0 \
+    --hash=sha256:4a152fd11a9f774ea606388d423b68aa7e6d6a0ffe4c8266f74979613ec09f81 \
+    --hash=sha256:6869eacb2a37720380ba5898312af79a4d30b8bca1548fb4093e0697dc4bdf5d
     # via
     #   google-cloud-core
     #   google-cloud-spanner
-google-auth==2.13.0 \
-    --hash=sha256:9352dd6394093169157e6971526bab9a2799244d68a94a4a609f0dd751ef6f5e \
-    --hash=sha256:99510e664155f1a3c0396a076b5deb6367c52ea04d280152c85ac7f51f50eb42
+google-auth==2.35.0 \
+    --hash=sha256:25df55f327ef021de8be50bad0dfd4a916ad0de96da86cd05661c9297723ad3f \
+    --hash=sha256:f4c64ed4e01e8e8b646ef34c018f8bf3338df0c8e37d8b3bba40e7f574a3278a
     # via
     #   google-api-core
     #   google-cloud-core
-google-cloud-core==2.3.3 \
-    --hash=sha256:37b80273c8d7eee1ae816b3a20ae43585ea50506cb0e60f3cf5be5f87f1373cb \
-    --hash=sha256:fbd11cad3e98a7e5b0343dc07cb1039a5ffd7a5bb96e1f1e27cee4bda4a90863
+google-cloud-core==2.4.1 \
+    --hash=sha256:9b7749272a812bde58fff28868d0c5e2f585b82f37e09a1f6ed2d4d10f134073 \
+    --hash=sha256:a9e6a4422b9ac5c29f79a0ede9485473338e2ce78d91f2370c01e730eab22e61
     # via google-cloud-spanner
-google-cloud-spanner==3.22.2 \
-    --hash=sha256:97c1c1d207d63340011e2204e448fa3ccbd9ecc45102e9943a3e65992a136e62 \
-    --hash=sha256:e045f8c94d190c5d480cb149239fbb9d49153276cc30b967693f532c75bc1757
+google-cloud-spanner==3.49.1 \
+    --hash=sha256:261eafb63b0dd55256afcb5f7149b7527e55b5c8aca8059f77771dfe935ab03b \
+    --hash=sha256:c064d1175319f8c9b634a3888de226f4ec70493f7ec08a45321a4b17a47fc3ca
     # via -r requirements.in
-googleapis-common-protos[grpc]==1.56.4 \
-    --hash=sha256:8eb2cbc91b69feaf23e32452a7ae60e791e09967d81d4fcc7fc388182d1bd394 \
-    --hash=sha256:c25873c47279387cfdcbdafa36149887901d36202cb645a0e4f29686bf6e4417
+googleapis-common-protos[grpc]==1.65.0 \
+    --hash=sha256:2972e6c496f435b92590fd54045060867f3fe9be2c82ab148fc8885035479a63 \
+    --hash=sha256:334a29d07cddc3aa01dee4988f9afd9b2916ee2ff49d6b757155dc0d197852c0
     # via
     #   google-api-core
     #   grpc-google-iam-v1
     #   grpcio-status
-greenlet==1.1.3.post0 \
-    --hash=sha256:0120a879aa2b1ac5118bce959ea2492ba18783f65ea15821680a256dfad04754 \
-    --hash=sha256:025b8de2273d2809f027d347aa2541651d2e15d593bbce0d5f502ca438c54136 \
-    --hash=sha256:05ae7383f968bba4211b1fbfc90158f8e3da86804878442b4fb6c16ccbcaa519 \
-    --hash=sha256:0914f02fcaa8f84f13b2df4a81645d9e82de21ed95633765dd5cc4d3af9d7403 \
-    --hash=sha256:0971d37ae0eaf42344e8610d340aa0ad3d06cd2eee381891a10fe771879791f9 \
-    --hash=sha256:0a954002064ee919b444b19c1185e8cce307a1f20600f47d6f4b6d336972c809 \
-    --hash=sha256:0aa1845944e62f358d63fcc911ad3b415f585612946b8edc824825929b40e59e \
-    --hash=sha256:104f29dd822be678ef6b16bf0035dcd43206a8a48668a6cae4d2fe9c7a7abdeb \
-    --hash=sha256:11fc7692d95cc7a6a8447bb160d98671ab291e0a8ea90572d582d57361360f05 \
-    --hash=sha256:17a69967561269b691747e7f436d75a4def47e5efcbc3c573180fc828e176d80 \
-    --hash=sha256:2794eef1b04b5ba8948c72cc606aab62ac4b0c538b14806d9c0d88afd0576d6b \
-    --hash=sha256:2c6e942ca9835c0b97814d14f78da453241837419e0d26f7403058e8db3e38f8 \
-    --hash=sha256:2ccdc818cc106cc238ff7eba0d71b9c77be868fdca31d6c3b1347a54c9b187b2 \
-    --hash=sha256:325f272eb997916b4a3fc1fea7313a8adb760934c2140ce13a2117e1b0a8095d \
-    --hash=sha256:39464518a2abe9c505a727af7c0b4efff2cf242aa168be5f0daa47649f4d7ca8 \
-    --hash=sha256:3a24f3213579dc8459e485e333330a921f579543a5214dbc935bc0763474ece3 \
-    --hash=sha256:3aeac044c324c1a4027dca0cde550bd83a0c0fbff7ef2c98df9e718a5086c194 \
-    --hash=sha256:3c22998bfef3fcc1b15694818fc9b1b87c6cc8398198b96b6d355a7bcb8c934e \
-    --hash=sha256:467b73ce5dcd89e381292fb4314aede9b12906c18fab903f995b86034d96d5c8 \
-    --hash=sha256:4a8b58232f5b72973350c2b917ea3df0bebd07c3c82a0a0e34775fc2c1f857e9 \
-    --hash=sha256:4f74aa0092602da2069df0bc6553919a15169d77bcdab52a21f8c5242898f519 \
-    --hash=sha256:5662492df0588a51d5690f6578f3bbbd803e7f8d99a99f3bf6128a401be9c269 \
-    --hash=sha256:5c2d21c2b768d8c86ad935e404cc78c30d53dea009609c3ef3a9d49970c864b5 \
-    --hash=sha256:5edf75e7fcfa9725064ae0d8407c849456553a181ebefedb7606bac19aa1478b \
-    --hash=sha256:60839ab4ea7de6139a3be35b77e22e0398c270020050458b3d25db4c7c394df5 \
-    --hash=sha256:62723e7eb85fa52e536e516ee2ac91433c7bb60d51099293671815ff49ed1c21 \
-    --hash=sha256:64e10f303ea354500c927da5b59c3802196a07468332d292aef9ddaca08d03dd \
-    --hash=sha256:66aa4e9a726b70bcbfcc446b7ba89c8cec40f405e51422c39f42dfa206a96a05 \
-    --hash=sha256:695d0d8b5ae42c800f1763c9fce9d7b94ae3b878919379150ee5ba458a460d57 \
-    --hash=sha256:70048d7b2c07c5eadf8393e6398595591df5f59a2f26abc2f81abca09610492f \
-    --hash=sha256:7afa706510ab079fd6d039cc6e369d4535a48e202d042c32e2097f030a16450f \
-    --hash=sha256:7cf37343e43404699d58808e51f347f57efd3010cc7cee134cdb9141bd1ad9ea \
-    --hash=sha256:8149a6865b14c33be7ae760bcdb73548bb01e8e47ae15e013bf7ef9290ca309a \
-    --hash=sha256:814f26b864ed2230d3a7efe0336f5766ad012f94aad6ba43a7c54ca88dd77cba \
-    --hash=sha256:82a38d7d2077128a017094aff334e67e26194f46bd709f9dcdacbf3835d47ef5 \
-    --hash=sha256:83a7a6560df073ec9de2b7cb685b199dfd12519bc0020c62db9d1bb522f989fa \
-    --hash=sha256:8415239c68b2ec9de10a5adf1130ee9cb0ebd3e19573c55ba160ff0ca809e012 \
-    --hash=sha256:88720794390002b0c8fa29e9602b395093a9a766b229a847e8d88349e418b28a \
-    --hash=sha256:890f633dc8cb307761ec566bc0b4e350a93ddd77dc172839be122be12bae3e10 \
-    --hash=sha256:8926a78192b8b73c936f3e87929931455a6a6c6c385448a07b9f7d1072c19ff3 \
-    --hash=sha256:8c0581077cf2734569f3e500fab09c0ff6a2ab99b1afcacbad09b3c2843ae743 \
-    --hash=sha256:8fda1139d87ce5f7bd80e80e54f9f2c6fe2f47983f1a6f128c47bf310197deb6 \
-    --hash=sha256:91a84faf718e6f8b888ca63d0b2d6d185c8e2a198d2a7322d75c303e7097c8b7 \
-    --hash=sha256:924df1e7e5db27d19b1359dc7d052a917529c95ba5b8b62f4af611176da7c8ad \
-    --hash=sha256:949c9061b8c6d3e6e439466a9be1e787208dec6246f4ec5fffe9677b4c19fcc3 \
-    --hash=sha256:9649891ab4153f217f319914455ccf0b86986b55fc0573ce803eb998ad7d6854 \
-    --hash=sha256:96656c5f7c95fc02c36d4f6ef32f4e94bb0b6b36e6a002c21c39785a4eec5f5d \
-    --hash=sha256:a812df7282a8fc717eafd487fccc5ba40ea83bb5b13eb3c90c446d88dbdfd2be \
-    --hash=sha256:a8d24eb5cb67996fb84633fdc96dbc04f2d8b12bfcb20ab3222d6be271616b67 \
-    --hash=sha256:bef49c07fcb411c942da6ee7d7ea37430f830c482bf6e4b72d92fd506dd3a427 \
-    --hash=sha256:bffba15cff4802ff493d6edcf20d7f94ab1c2aee7cfc1e1c7627c05f1102eee8 \
-    --hash=sha256:c0643250dd0756f4960633f5359884f609a234d4066686754e834073d84e9b51 \
-    --hash=sha256:c6f90234e4438062d6d09f7d667f79edcc7c5e354ba3a145ff98176f974b8132 \
-    --hash=sha256:c8c9301e3274276d3d20ab6335aa7c5d9e5da2009cccb01127bddb5c951f8870 \
-    --hash=sha256:c8ece5d1a99a2adcb38f69af2f07d96fb615415d32820108cd340361f590d128 \
-    --hash=sha256:cb863057bed786f6622982fb8b2c122c68e6e9eddccaa9fa98fd937e45ee6c4f \
-    --hash=sha256:ccbe7129a282ec5797df0451ca1802f11578be018a32979131065565da89b392 \
-    --hash=sha256:d25cdedd72aa2271b984af54294e9527306966ec18963fd032cc851a725ddc1b \
-    --hash=sha256:d75afcbb214d429dacdf75e03a1d6d6c5bd1fa9c35e360df8ea5b6270fb2211c \
-    --hash=sha256:d7815e1519a8361c5ea2a7a5864945906f8e386fa1bc26797b4d443ab11a4589 \
-    --hash=sha256:eb6ac495dccb1520667cfea50d89e26f9ffb49fa28496dea2b95720d8b45eb54 \
-    --hash=sha256:ec615d2912b9ad807afd3be80bf32711c0ff9c2b00aa004a45fd5d5dde7853d9 \
-    --hash=sha256:f5e09dc5c6e1796969fd4b775ea1417d70e49a5df29aaa8e5d10675d9e11872c \
-    --hash=sha256:f6661b58412879a2aa099abb26d3c93e91dedaba55a6394d1fb1512a77e85de9 \
-    --hash=sha256:f7d20c3267385236b4ce54575cc8e9f43e7673fc761b069c820097092e318e3b \
-    --hash=sha256:fe7c51f8a2ab616cb34bc33d810c887e89117771028e1e3d3b77ca25ddeace04
-    # via sqlalchemy
-grpc-google-iam-v1==0.12.6 \
-    --hash=sha256:2bc4b8fdf22115a65d751c9317329322602c39b7c86a289c9b72d228d960ef5f \
-    --hash=sha256:5c10f3d8dc2d88678ab1a9b0cb5482735c5efee71e6c0cd59f872eef22913f5c
+grpc-google-iam-v1==0.13.1 \
+    --hash=sha256:3ff4b2fd9d990965e410965253c0da6f66205d5a8291c4c31c6ebecca18a9001 \
+    --hash=sha256:c3e86151a981811f30d5e7330f271cee53e73bb87755e88cc3b6f0c7b5fe374e
     # via google-cloud-spanner
-grpcio==1.53.0 \
-    --hash=sha256:0698c094688a2dd4c7c2f2c0e3e142cac439a64d1cef6904c97f6cde38ba422f \
-    --hash=sha256:104a2210edd3776c38448b4f76c2f16e527adafbde171fc72a8a32976c20abc7 \
-    --hash=sha256:14817de09317dd7d3fbc8272864288320739973ef0f4b56bf2c0032349da8cdf \
-    --hash=sha256:1948539ce78805d4e6256ab0e048ec793956d54787dc9d6777df71c1d19c7f81 \
-    --hash=sha256:19caa5b7282a89b799e63776ff602bb39604f7ca98db6df27e2de06756ae86c3 \
-    --hash=sha256:1b172e6d497191940c4b8d75b53de82dc252e15b61de2951d577ec5b43316b29 \
-    --hash=sha256:1c734a2d4843e4e14ececf5600c3c4750990ec319e1299db7e4f0d02c25c1467 \
-    --hash=sha256:2a912397eb8d23c177d6d64e3c8bc46b8a1c7680b090d9f13a640b104aaec77c \
-    --hash=sha256:2eddaae8af625e45b5c8500dcca1043264d751a6872cde2eda5022df8a336959 \
-    --hash=sha256:55930c56b8f5b347d6c8c609cc341949a97e176c90f5cbb01d148d778f3bbd23 \
-    --hash=sha256:658ffe1e39171be00490db5bd3b966f79634ac4215a1eb9a85c6cd6783bf7f6e \
-    --hash=sha256:6601d812105583948ab9c6e403a7e2dba6e387cc678c010e74f2d6d589d1d1b3 \
-    --hash=sha256:6b6d60b0958be711bab047e9f4df5dbbc40367955f8651232bfdcdd21450b9ab \
-    --hash=sha256:6beb84f83360ff29a3654f43f251ec11b809dcb5524b698d711550243debd289 \
-    --hash=sha256:752d2949b40e12e6ad3ed8cc552a65b54d226504f6b1fb67cab2ccee502cc06f \
-    --hash=sha256:7dc8584ca6c015ad82e186e82f4c0fe977394588f66b8ecfc4ec873285314619 \
-    --hash=sha256:82434ba3a5935e47908bc861ce1ebc43c2edfc1001d235d6e31e5d3ed55815f7 \
-    --hash=sha256:8270d1dc2c98ab57e6dbf36fa187db8df4c036f04a398e5d5e25b4e01a766d70 \
-    --hash=sha256:8a48fd3a7222be226bb86b7b413ad248f17f3101a524018cdc4562eeae1eb2a3 \
-    --hash=sha256:95952d3fe795b06af29bb8ec7bbf3342cdd867fc17b77cc25e6733d23fa6c519 \
-    --hash=sha256:976a7f24eb213e8429cab78d5e120500dfcdeb01041f1f5a77b17b9101902615 \
-    --hash=sha256:9c84a481451e7174f3a764a44150f93b041ab51045aa33d7b5b68b6979114e48 \
-    --hash=sha256:a34d6e905f071f9b945cabbcc776e2055de1fdb59cd13683d9aa0a8f265b5bf9 \
-    --hash=sha256:a4952899b4931a6ba12951f9a141ef3e74ff8a6ec9aa2dc602afa40f63595e33 \
-    --hash=sha256:a96c3c7f564b263c5d7c0e49a337166c8611e89c4c919f66dba7b9a84abad137 \
-    --hash=sha256:aef7d30242409c3aa5839b501e877e453a2c8d3759ca8230dd5a21cda029f046 \
-    --hash=sha256:b5bd026ac928c96cc23149e6ef79183125542062eb6d1ccec34c0a37e02255e7 \
-    --hash=sha256:b6a2ead3de3b2d53119d473aa2f224030257ef33af1e4ddabd4afee1dea5f04c \
-    --hash=sha256:ba074af9ca268ad7b05d3fc2b920b5fb3c083da94ab63637aaf67f4f71ecb755 \
-    --hash=sha256:c5fb6f3d7824696c1c9f2ad36ddb080ba5a86f2d929ef712d511b4d9972d3d27 \
-    --hash=sha256:c705e0c21acb0e8478a00e7e773ad0ecdb34bd0e4adc282d3d2f51ba3961aac7 \
-    --hash=sha256:c7ad9fbedb93f331c2e9054e202e95cf825b885811f1bcbbdfdc301e451442db \
-    --hash=sha256:da95778d37be8e4e9afca771a83424f892296f5dfb2a100eda2571a1d8bbc0dc \
-    --hash=sha256:dad5b302a4c21c604d88a5d441973f320134e6ff6a84ecef9c1139e5ffd466f6 \
-    --hash=sha256:dbc1ba968639c1d23476f75c356e549e7bbf2d8d6688717dcab5290e88e8482b \
-    --hash=sha256:ddb2511fbbb440ed9e5c9a4b9b870f2ed649b7715859fd6f2ebc585ee85c0364 \
-    --hash=sha256:df9ba1183b3f649210788cf80c239041dddcb375d6142d8bccafcfdf549522cd \
-    --hash=sha256:e4f513d63df6336fd84b74b701f17d1bb3b64e9d78a6ed5b5e8a198bbbe8bbfa \
-    --hash=sha256:e6f90698b5d1c5dd7b3236cd1fa959d7b80e17923f918d5be020b65f1c78b173 \
-    --hash=sha256:eaf8e3b97caaf9415227a3c6ca5aa8d800fecadd526538d2bf8f11af783f1550 \
-    --hash=sha256:ee81349411648d1abc94095c68cd25e3c2812e4e0367f9a9355be1e804a5135c \
-    --hash=sha256:f144a790f14c51b8a8e591eb5af40507ffee45ea6b818c2482f0457fec2e1a2e \
-    --hash=sha256:f3e837d29f0e1b9d6e7b29d569e2e9b0da61889e41879832ea15569c251c303a \
-    --hash=sha256:fa8eaac75d3107e3f5465f2c9e3bbd13db21790c6e45b7de1756eba16b050aca \
-    --hash=sha256:fdc6191587de410a184550d4143e2b24a14df495c86ca15e59508710681690ac
+grpc-interceptor==0.15.4 \
+    --hash=sha256:0035f33228693ed3767ee49d937bac424318db173fef4d2d0170b3215f254d9d \
+    --hash=sha256:1f45c0bcb58b6f332f37c637632247c9b02bc6af0fdceb7ba7ce8d2ebbfb0926
+    # via google-cloud-spanner
+grpcio==1.67.0 \
+    --hash=sha256:014dfc020e28a0d9be7e93a91f85ff9f4a87158b7df9952fe23cc42d29d31e1e \
+    --hash=sha256:0892dd200ece4822d72dd0952f7112c542a487fc48fe77568deaaa399c1e717d \
+    --hash=sha256:0bb94e66cd8f0baf29bd3184b6aa09aeb1a660f9ec3d85da615c5003154bc2bf \
+    --hash=sha256:0c69bf11894cad9da00047f46584d5758d6ebc9b5950c0dc96fec7e0bce5cde9 \
+    --hash=sha256:15c05a26a0f7047f720da41dc49406b395c1470eef44ff7e2c506a47ac2c0591 \
+    --hash=sha256:16724ffc956ea42967f5758c2f043faef43cb7e48a51948ab593570570d1e68b \
+    --hash=sha256:227316b5631260e0bef8a3ce04fa7db4cc81756fea1258b007950b6efc90c05d \
+    --hash=sha256:2b7183c80b602b0ad816315d66f2fb7887614ead950416d60913a9a71c12560d \
+    --hash=sha256:2f55c1e0e2ae9bdd23b3c63459ee4c06d223b68aeb1961d83c48fb63dc29bc03 \
+    --hash=sha256:30d47dbacfd20cbd0c8be9bfa52fdb833b395d4ec32fe5cff7220afc05d08571 \
+    --hash=sha256:323741b6699cd2b04a71cb38f502db98f90532e8a40cb675393d248126a268af \
+    --hash=sha256:3840994689cc8cbb73d60485c594424ad8adb56c71a30d8948d6453083624b52 \
+    --hash=sha256:391df8b0faac84d42f5b8dfc65f5152c48ed914e13c522fd05f2aca211f8bfad \
+    --hash=sha256:42199e704095b62688998c2d84c89e59a26a7d5d32eed86d43dc90e7a3bd04aa \
+    --hash=sha256:54d16383044e681f8beb50f905249e4e7261dd169d4aaf6e52eab67b01cbbbe2 \
+    --hash=sha256:5a1e03c3102b6451028d5dc9f8591131d6ab3c8a0e023d94c28cb930ed4b5f81 \
+    --hash=sha256:62492bd534979e6d7127b8a6b29093161a742dee3875873e01964049d5250a74 \
+    --hash=sha256:662c8e105c5e5cee0317d500eb186ed7a93229586e431c1bf0c9236c2407352c \
+    --hash=sha256:682968427a63d898759474e3b3178d42546e878fdce034fd7474ef75143b64e3 \
+    --hash=sha256:74b900566bdf68241118f2918d312d3bf554b2ce0b12b90178091ea7d0a17b3d \
+    --hash=sha256:77196216d5dd6f99af1c51e235af2dd339159f657280e65ce7e12c1a8feffd1d \
+    --hash=sha256:7f200aca719c1c5dc72ab68be3479b9dafccdf03df530d137632c534bb6f1ee3 \
+    --hash=sha256:7fc1d2b9fd549264ae585026b266ac2db53735510a207381be509c315b4af4e8 \
+    --hash=sha256:82e5bd4b67b17c8c597273663794a6a46a45e44165b960517fe6d8a2f7f16d23 \
+    --hash=sha256:8c9a35b8bc50db35ab8e3e02a4f2a35cfba46c8705c3911c34ce343bd777813a \
+    --hash=sha256:985b2686f786f3e20326c4367eebdaed3e7aa65848260ff0c6644f817042cb15 \
+    --hash=sha256:9d75641a2fca9ae1ae86454fd25d4c298ea8cc195dbc962852234d54a07060ad \
+    --hash=sha256:a4e95e43447a02aa603abcc6b5e727d093d161a869c83b073f50b9390ecf0fa8 \
+    --hash=sha256:a6b9a5c18863fd4b6624a42e2712103fb0f57799a3b29651c0e5b8119a519d65 \
+    --hash=sha256:aa8d025fae1595a207b4e47c2e087cb88d47008494db258ac561c00877d4c8f8 \
+    --hash=sha256:ac11ecb34a86b831239cc38245403a8de25037b448464f95c3315819e7519772 \
+    --hash=sha256:ae6de510f670137e755eb2a74b04d1041e7210af2444103c8c95f193340d17ee \
+    --hash=sha256:b2a44e572fb762c668e4812156b81835f7aba8a721b027e2d4bb29fb50ff4d33 \
+    --hash=sha256:b6eb68493a05d38b426604e1dc93bfc0137c4157f7ab4fac5771fd9a104bbaa6 \
+    --hash=sha256:b9bca3ca0c5e74dea44bf57d27e15a3a3996ce7e5780d61b7c72386356d231db \
+    --hash=sha256:bd79929b3bb96b54df1296cd3bf4d2b770bd1df6c2bdf549b49bab286b925cdc \
+    --hash=sha256:c4c425f440fb81f8d0237c07b9322fc0fb6ee2b29fbef5f62a322ff8fcce240d \
+    --hash=sha256:cb204a742997277da678611a809a8409657b1398aaeebf73b3d9563b7d154c13 \
+    --hash=sha256:cf51d28063338608cd8d3cd64677e922134837902b70ce00dad7f116e3998210 \
+    --hash=sha256:cfd9306511fdfc623a1ba1dc3bc07fbd24e6cfbe3c28b4d1e05177baa2f99617 \
+    --hash=sha256:cff8e54d6a463883cda2fab94d2062aad2f5edd7f06ae3ed030f2a74756db365 \
+    --hash=sha256:d01793653248f49cf47e5695e0a79805b1d9d4eacef85b310118ba1dfcd1b955 \
+    --hash=sha256:d4ea4509d42c6797539e9ec7496c15473177ce9abc89bc5c71e7abe50fc25737 \
+    --hash=sha256:d90cfdafcf4b45a7a076e3e2a58e7bc3d59c698c4f6470b0bb13a4d869cf2273 \
+    --hash=sha256:e090b2553e0da1c875449c8e75073dd4415dd71c9bde6a406240fdf4c0ee467c \
+    --hash=sha256:e91d154689639932305b6ea6f45c6e46bb51ecc8ea77c10ef25aa77f75443ad4 \
+    --hash=sha256:eef1dce9d1a46119fd09f9a992cf6ab9d9178b696382439446ca5f399d7b96fe \
+    --hash=sha256:efe32b45dd6d118f5ea2e5deaed417d8a14976325c93812dd831908522b402c9 \
+    --hash=sha256:f4d613fbf868b2e2444f490d18af472ccb47660ea3df52f068c9c8801e1f3e85 \
+    --hash=sha256:f55f077685f61f0fbd06ea355142b71e47e4a26d2d678b3ba27248abfe67163a \
+    --hash=sha256:f623c57a5321461c84498a99dddf9d13dac0e40ee056d884d6ec4ebcab647a78 \
+    --hash=sha256:f6bd2ab135c64a4d1e9e44679a616c9bc944547357c830fafea5c3caa3de5153 \
+    --hash=sha256:f95e15db43e75a534420e04822df91f645664bf4ad21dfaad7d51773c80e6bb4 \
+    --hash=sha256:fd6bc27861e460fe28e94226e3673d46e294ca4673d46b224428d197c5935e69 \
+    --hash=sha256:fe89295219b9c9e47780a0f1c75ca44211e706d1c598242249fe717af3385ec8
     # via
     #   google-api-core
     #   googleapis-common-protos
     #   grpc-google-iam-v1
+    #   grpc-interceptor
     #   grpcio-status
-grpcio-status==1.50.0 \
-    --hash=sha256:69be81c4317ec77983fb0eab80221a01e86e833e0fcf2f6acea0a62597c84b93 \
-    --hash=sha256:6bcf86b1cb1a8929c9cb75c8593ea001a667f5167cf692627f4b3fc1ae0eded4
+grpcio-status==1.67.0 \
+    --hash=sha256:0e79e2e01ba41a6ca6ed9d7a825323c511fe1653a646f8014c7e3c8132527acc \
+    --hash=sha256:c3e5a86fa007e9e263cd5f988a8a907484da4caab582874ea2a4a6092734046b
     # via google-api-core
-idna==3.4 \
-    --hash=sha256:814f528e8dead7d329833b91c5faa87d60bf71824cd12a7530b5526063d02cb4 \
-    --hash=sha256:90b77e79eaa3eba6de819a0c442c0b4ceefc341a7a2ab77d7562bf49f425c5c2
+idna==3.10 \
+    --hash=sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9 \
+    --hash=sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3
     # via requests
-importlib-metadata==6.8.0 \
-    --hash=sha256:3ebb78df84a805d7698245025b975d9d67053cd94c79245ba4b3eb694abe68bb \
-    --hash=sha256:dbace7892d8c0c4ac1ad096662232f831d4e64f4c4545bd53016a3e9d4654743
-    # via alembic
-importlib-resources==6.1.0 \
-    --hash=sha256:9d48dcccc213325e810fd723e7fbb45ccb39f6cf5c31f00cf2b965f5f10f3cb9 \
-    --hash=sha256:aa50258bbfa56d4e33fbd8aa3ef48ded10d1735f11532b8df95388cc6bdb7e83
-    # via alembic
-Mako==1.2.4 \
-    --hash=sha256:c97c79c018b9165ac9922ae4f32da095ffd3c4e6872b45eded42926deea46818 \
-    --hash=sha256:d60a3903dc3bb01a18ad6a89cdbe2e4eadc69c0bc8ef1e3773ba53d44c3f7a34
+importlib-metadata==8.4.0 \
+    --hash=sha256:66f342cc6ac9818fc6ff340576acd24d65ba0b3efabb2b4ac08b598965a4a2f1 \
+    --hash=sha256:9a547d3bc3608b025f93d403fdd1aae741c24fbb8314df4b155675742ce303c5
+    # via opentelemetry-api
+mako==1.3.6 \
+    --hash=sha256:9ec3a1583713479fae654f83ed9fa8c9a4c16b7bb0daba0e6bbebff50c0d983d \
+    --hash=sha256:a91198468092a2f1a0de86ca92690fb0cfc43ca90ee17e15d93662b4c04b241a
     # via alembic
-MarkupSafe==2.1.3 \
-    --hash=sha256:05fb21170423db021895e1ea1e1f3ab3adb85d1c2333cbc2310f2a26bc77272e \
-    --hash=sha256:0a4e4a1aff6c7ac4cd55792abf96c915634c2b97e3cc1c7129578aa68ebd754e \
-    --hash=sha256:10bbfe99883db80bdbaff2dcf681dfc6533a614f700da1287707e8a5d78a8431 \
-    --hash=sha256:134da1eca9ec0ae528110ccc9e48041e0828d79f24121a1a146161103c76e686 \
-    --hash=sha256:14ff806850827afd6b07a5f32bd917fb7f45b046ba40c57abdb636674a8b559c \
-    --hash=sha256:1577735524cdad32f9f694208aa75e422adba74f1baee7551620e43a3141f559 \
-    --hash=sha256:1b40069d487e7edb2676d3fbdb2b0829ffa2cd63a2ec26c4938b2d34391b4ecc \
-    --hash=sha256:1b8dd8c3fd14349433c79fa8abeb573a55fc0fdd769133baac1f5e07abf54aeb \
-    --hash=sha256:1f67c7038d560d92149c060157d623c542173016c4babc0c1913cca0564b9939 \
-    --hash=sha256:282c2cb35b5b673bbcadb33a585408104df04f14b2d9b01d4c345a3b92861c2c \
-    --hash=sha256:2c1b19b3aaacc6e57b7e25710ff571c24d6c3613a45e905b1fde04d691b98ee0 \
-    --hash=sha256:2ef12179d3a291be237280175b542c07a36e7f60718296278d8593d21ca937d4 \
-    --hash=sha256:338ae27d6b8745585f87218a3f23f1512dbf52c26c28e322dbe54bcede54ccb9 \
-    --hash=sha256:3c0fae6c3be832a0a0473ac912810b2877c8cb9d76ca48de1ed31e1c68386575 \
-    --hash=sha256:3fd4abcb888d15a94f32b75d8fd18ee162ca0c064f35b11134be77050296d6ba \
-    --hash=sha256:42de32b22b6b804f42c5d98be4f7e5e977ecdd9ee9b660fda1a3edf03b11792d \
-    --hash=sha256:47d4f1c5f80fc62fdd7777d0d40a2e9dda0a05883ab11374334f6c4de38adffd \
-    --hash=sha256:504b320cd4b7eff6f968eddf81127112db685e81f7e36e75f9f84f0df46041c3 \
-    --hash=sha256:525808b8019e36eb524b8c68acdd63a37e75714eac50e988180b169d64480a00 \
-    --hash=sha256:56d9f2ecac662ca1611d183feb03a3fa4406469dafe241673d521dd5ae92a155 \
-    --hash=sha256:5bbe06f8eeafd38e5d0a4894ffec89378b6c6a625ff57e3028921f8ff59318ac \
-    --hash=sha256:65c1a9bcdadc6c28eecee2c119465aebff8f7a584dd719facdd9e825ec61ab52 \
-    --hash=sha256:68e78619a61ecf91e76aa3e6e8e33fc4894a2bebe93410754bd28fce0a8a4f9f \
-    --hash=sha256:69c0f17e9f5a7afdf2cc9fb2d1ce6aabdb3bafb7f38017c0b77862bcec2bbad8 \
-    --hash=sha256:6b2b56950d93e41f33b4223ead100ea0fe11f8e6ee5f641eb753ce4b77a7042b \
-    --hash=sha256:715d3562f79d540f251b99ebd6d8baa547118974341db04f5ad06d5ea3eb8007 \
-    --hash=sha256:787003c0ddb00500e49a10f2844fac87aa6ce977b90b0feaaf9de23c22508b24 \
-    --hash=sha256:7ef3cb2ebbf91e330e3bb937efada0edd9003683db6b57bb108c4001f37a02ea \
-    --hash=sha256:8023faf4e01efadfa183e863fefde0046de576c6f14659e8782065bcece22198 \
-    --hash=sha256:8758846a7e80910096950b67071243da3e5a20ed2546e6392603c096778d48e0 \
-    --hash=sha256:8afafd99945ead6e075b973fefa56379c5b5c53fd8937dad92c662da5d8fd5ee \
-    --hash=sha256:8c41976a29d078bb235fea9b2ecd3da465df42a562910f9022f1a03107bd02be \
-    --hash=sha256:8e254ae696c88d98da6555f5ace2279cf7cd5b3f52be2b5cf97feafe883b58d2 \
-    --hash=sha256:8f9293864fe09b8149f0cc42ce56e3f0e54de883a9de90cd427f191c346eb2e1 \
-    --hash=sha256:9402b03f1a1b4dc4c19845e5c749e3ab82d5078d16a2a4c2cd2df62d57bb0707 \
-    --hash=sha256:962f82a3086483f5e5f64dbad880d31038b698494799b097bc59c2edf392fce6 \
-    --hash=sha256:9aad3c1755095ce347e26488214ef77e0485a3c34a50c5a5e2471dff60b9dd9c \
-    --hash=sha256:9dcdfd0eaf283af041973bff14a2e143b8bd64e069f4c383416ecd79a81aab58 \
-    --hash=sha256:aa57bd9cf8ae831a362185ee444e15a93ecb2e344c8e52e4d721ea3ab6ef1823 \
-    --hash=sha256:aa7bd130efab1c280bed0f45501b7c8795f9fdbeb02e965371bbef3523627779 \
-    --hash=sha256:ab4a0df41e7c16a1392727727e7998a467472d0ad65f3ad5e6e765015df08636 \
-    --hash=sha256:ad9e82fb8f09ade1c3e1b996a6337afac2b8b9e365f926f5a61aacc71adc5b3c \
-    --hash=sha256:af598ed32d6ae86f1b747b82783958b1a4ab8f617b06fe68795c7f026abbdcad \
-    --hash=sha256:b076b6226fb84157e3f7c971a47ff3a679d837cf338547532ab866c57930dbee \
-    --hash=sha256:b7ff0f54cb4ff66dd38bebd335a38e2c22c41a8ee45aa608efc890ac3e3931bc \
-    --hash=sha256:bfce63a9e7834b12b87c64d6b155fdd9b3b96191b6bd334bf37db7ff1fe457f2 \
-    --hash=sha256:c011a4149cfbcf9f03994ec2edffcb8b1dc2d2aede7ca243746df97a5d41ce48 \
-    --hash=sha256:c9c804664ebe8f83a211cace637506669e7890fec1b4195b505c214e50dd4eb7 \
-    --hash=sha256:ca379055a47383d02a5400cb0d110cef0a776fc644cda797db0c5696cfd7e18e \
-    --hash=sha256:cb0932dc158471523c9637e807d9bfb93e06a95cbf010f1a38b98623b929ef2b \
-    --hash=sha256:cd0f502fe016460680cd20aaa5a76d241d6f35a1c3350c474bac1273803893fa \
-    --hash=sha256:ceb01949af7121f9fc39f7d27f91be8546f3fb112c608bc4029aef0bab86a2a5 \
-    --hash=sha256:d080e0a5eb2529460b30190fcfcc4199bd7f827663f858a226a81bc27beaa97e \
-    --hash=sha256:dd15ff04ffd7e05ffcb7fe79f1b98041b8ea30ae9234aed2a9168b5797c3effb \
-    --hash=sha256:df0be2b576a7abbf737b1575f048c23fb1d769f267ec4358296f31c2479db8f9 \
-    --hash=sha256:e09031c87a1e51556fdcb46e5bd4f59dfb743061cf93c4d6831bf894f125eb57 \
-    --hash=sha256:e4dd52d80b8c83fdce44e12478ad2e85c64ea965e75d66dbeafb0a3e77308fcc \
-    --hash=sha256:f698de3fd0c4e6972b92290a45bd9b1536bffe8c6759c62471efaa8acb4c37bc \
-    --hash=sha256:fec21693218efe39aa7f8599346e90c705afa52c5b31ae019b2e57e8f6542bb2 \
-    --hash=sha256:ffcc3f7c66b5f5b7931a5aa68fc9cecc51e685ef90282f4a82f0f5e9b704ad11
+markupsafe==3.0.2 \
+    --hash=sha256:0bff5e0ae4ef2e1ae4fdf2dfd5b76c75e5c2fa4132d05fc1b0dabcd20c7e28c4 \
+    --hash=sha256:0f4ca02bea9a23221c0182836703cbf8930c5e9454bacce27e767509fa286a30 \
+    --hash=sha256:1225beacc926f536dc82e45f8a4d68502949dc67eea90eab715dea3a21c1b5f0 \
+    --hash=sha256:131a3c7689c85f5ad20f9f6fb1b866f402c445b220c19fe4308c0b147ccd2ad9 \
+    --hash=sha256:15ab75ef81add55874e7ab7055e9c397312385bd9ced94920f2802310c930396 \
+    --hash=sha256:1a9d3f5f0901fdec14d8d2f66ef7d035f2157240a433441719ac9a3fba440b13 \
+    --hash=sha256:1c99d261bd2d5f6b59325c92c73df481e05e57f19837bdca8413b9eac4bd8028 \
+    --hash=sha256:1e084f686b92e5b83186b07e8a17fc09e38fff551f3602b249881fec658d3eca \
+    --hash=sha256:2181e67807fc2fa785d0592dc2d6206c019b9502410671cc905d132a92866557 \
+    --hash=sha256:2cb8438c3cbb25e220c2ab33bb226559e7afb3baec11c4f218ffa7308603c832 \
+    --hash=sha256:3169b1eefae027567d1ce6ee7cae382c57fe26e82775f460f0b2778beaad66c0 \
+    --hash=sha256:3809ede931876f5b2ec92eef964286840ed3540dadf803dd570c3b7e13141a3b \
+    --hash=sha256:38a9ef736c01fccdd6600705b09dc574584b89bea478200c5fbf112a6b0d5579 \
+    --hash=sha256:3d79d162e7be8f996986c064d1c7c817f6df3a77fe3d6859f6f9e7be4b8c213a \
+    --hash=sha256:444dcda765c8a838eaae23112db52f1efaf750daddb2d9ca300bcae1039adc5c \
+    --hash=sha256:48032821bbdf20f5799ff537c7ac3d1fba0ba032cfc06194faffa8cda8b560ff \
+    --hash=sha256:4aa4e5faecf353ed117801a068ebab7b7e09ffb6e1d5e412dc852e0da018126c \
+    --hash=sha256:52305740fe773d09cffb16f8ed0427942901f00adedac82ec8b67752f58a1b22 \
+    --hash=sha256:569511d3b58c8791ab4c2e1285575265991e6d8f8700c7be0e88f86cb0672094 \
+    --hash=sha256:57cb5a3cf367aeb1d316576250f65edec5bb3be939e9247ae594b4bcbc317dfb \
+    --hash=sha256:5b02fb34468b6aaa40dfc198d813a641e3a63b98c2b05a16b9f80b7ec314185e \
+    --hash=sha256:6381026f158fdb7c72a168278597a5e3a5222e83ea18f543112b2662a9b699c5 \
+    --hash=sha256:6af100e168aa82a50e186c82875a5893c5597a0c1ccdb0d8b40240b1f28b969a \
+    --hash=sha256:6c89876f41da747c8d3677a2b540fb32ef5715f97b66eeb0c6b66f5e3ef6f59d \
+    --hash=sha256:6e296a513ca3d94054c2c881cc913116e90fd030ad1c656b3869762b754f5f8a \
+    --hash=sha256:70a87b411535ccad5ef2f1df5136506a10775d267e197e4cf531ced10537bd6b \
+    --hash=sha256:7e94c425039cde14257288fd61dcfb01963e658efbc0ff54f5306b06054700f8 \
+    --hash=sha256:846ade7b71e3536c4e56b386c2a47adf5741d2d8b94ec9dc3e92e5e1ee1e2225 \
+    --hash=sha256:88416bd1e65dcea10bc7569faacb2c20ce071dd1f87539ca2ab364bf6231393c \
+    --hash=sha256:88b49a3b9ff31e19998750c38e030fc7bb937398b1f78cfa599aaef92d693144 \
+    --hash=sha256:8c4e8c3ce11e1f92f6536ff07154f9d49677ebaaafc32db9db4620bc11ed480f \
+    --hash=sha256:8e06879fc22a25ca47312fbe7c8264eb0b662f6db27cb2d3bbbc74b1df4b9b87 \
+    --hash=sha256:9025b4018f3a1314059769c7bf15441064b2207cb3f065e6ea1e7359cb46db9d \
+    --hash=sha256:93335ca3812df2f366e80509ae119189886b0f3c2b81325d39efdb84a1e2ae93 \
+    --hash=sha256:9778bd8ab0a994ebf6f84c2b949e65736d5575320a17ae8984a77fab08db94cf \
+    --hash=sha256:9e2d922824181480953426608b81967de705c3cef4d1af983af849d7bd619158 \
+    --hash=sha256:a123e330ef0853c6e822384873bef7507557d8e4a082961e1defa947aa59ba84 \
+    --hash=sha256:a904af0a6162c73e3edcb969eeeb53a63ceeb5d8cf642fade7d39e7963a22ddb \
+    --hash=sha256:ad10d3ded218f1039f11a75f8091880239651b52e9bb592ca27de44eed242a48 \
+    --hash=sha256:b424c77b206d63d500bcb69fa55ed8d0e6a3774056bdc4839fc9298a7edca171 \
+    --hash=sha256:b5a6b3ada725cea8a5e634536b1b01c30bcdcd7f9c6fff4151548d5bf6b3a36c \
+    --hash=sha256:ba8062ed2cf21c07a9e295d5b8a2a5ce678b913b45fdf68c32d95d6c1291e0b6 \
+    --hash=sha256:ba9527cdd4c926ed0760bc301f6728ef34d841f405abf9d4f959c478421e4efd \
+    --hash=sha256:bbcb445fa71794da8f178f0f6d66789a28d7319071af7a496d4d507ed566270d \
+    --hash=sha256:bcf3e58998965654fdaff38e58584d8937aa3096ab5354d493c77d1fdd66d7a1 \
+    --hash=sha256:c0ef13eaeee5b615fb07c9a7dadb38eac06a0608b41570d8ade51c56539e509d \
+    --hash=sha256:cabc348d87e913db6ab4aa100f01b08f481097838bdddf7c7a84b7575b7309ca \
+    --hash=sha256:cdb82a876c47801bb54a690c5ae105a46b392ac6099881cdfb9f6e95e4014c6a \
+    --hash=sha256:cfad01eed2c2e0c01fd0ecd2ef42c492f7f93902e39a42fc9ee1692961443a29 \
+    --hash=sha256:d16a81a06776313e817c951135cf7340a3e91e8c1ff2fac444cfd75fffa04afe \
+    --hash=sha256:d8213e09c917a951de9d09ecee036d5c7d36cb6cb7dbaece4c71a60d79fb9798 \
+    --hash=sha256:e07c3764494e3776c602c1e78e298937c3315ccc9043ead7e685b7f2b8d47b3c \
+    --hash=sha256:e17c96c14e19278594aa4841ec148115f9c7615a47382ecb6b82bd8fea3ab0c8 \
+    --hash=sha256:e444a31f8db13eb18ada366ab3cf45fd4b31e4db1236a4448f68778c1d1a5a2f \
+    --hash=sha256:e6a2a455bd412959b57a172ce6328d2dd1f01cb2135efda2e4576e8a23fa3b0f \
+    --hash=sha256:eaa0a10b7f72326f1372a713e73c3f739b524b3af41feb43e4921cb529f5929a \
+    --hash=sha256:eb7972a85c54febfb25b5c4b4f3af4dcc731994c7da0d8a0b4a6eb0640e1d178 \
+    --hash=sha256:ee55d3edf80167e48ea11a923c7386f4669df67d7994554387f84e7d8b0a2bf0 \
+    --hash=sha256:f3818cb119498c0678015754eba762e0d61e5b52d34c8b13d770f0719f7b1d79 \
+    --hash=sha256:f8b3d067f2e40fe93e1ccdd6b2e1d16c43140e76f02fb1319a05cf2b79d99430 \
+    --hash=sha256:fcabf5ff6eea076f859677f5f0b6b5c1a51e70a376b0579e0eadef8db48c6b50
     # via mako
-opentelemetry-api==1.13.0 \
-    --hash=sha256:2db1e8713f48a119bae457cd22304a7919d5e57190a380485c442c4f731a46dd \
-    --hash=sha256:e683e869471b99e77238c8739d6ee2f368803329f3b808dfa86a02d0b519c682
+opentelemetry-api==1.27.0 \
+    --hash=sha256:953d5871815e7c30c81b56d910c707588000fff7a3ca1c73e6531911d53065e7 \
+    --hash=sha256:ed673583eaa5f81b5ce5e86ef7cdaf622f88ef65f0b9aab40b843dcae5bef342
     # via
     #   -r requirements.in
     #   opentelemetry-instrumentation
     #   opentelemetry-sdk
-opentelemetry-instrumentation==0.41b0 \
-    --hash=sha256:0ef9e5705ceca0205992a4a845ae4251ce6ec15a1206ca07c2b00afb0c5bd386 \
-    --hash=sha256:214382ba10dfd29d4e24898a4c7ef18b7368178a6277a1aec95cdb75cabf4612
+    #   opentelemetry-semantic-conventions
+opentelemetry-instrumentation==0.48b0 \
+    --hash=sha256:94929685d906380743a71c3970f76b5f07476eea1834abd5dd9d17abfe23cc35 \
+    --hash=sha256:a69750dc4ba6a5c3eb67986a337185a25b739966d80479befe37b546fc870b44
     # via -r requirements.in
-opentelemetry-sdk==1.13.0 \
-    --hash=sha256:0eddcacd5a484fe2918116b9a4e31867e3d10322ff8392b1c7b0dae1ac724d48 \
-    --hash=sha256:c7b88e06ebedd22c226b374c207792d30b3f34074a6b8ad8c6dad04a8d16326b
+opentelemetry-sdk==1.27.0 \
+    --hash=sha256:365f5e32f920faf0fd9e14fdfd92c086e317eaa5f860edba9cdc17a380d9197d \
+    --hash=sha256:d525017dea0ccce9ba4e0245100ec46ecdc043f2d7b8315d56b19aff0904fa6f
     # via -r requirements.in
-opentelemetry-semantic-conventions==0.34b0 \
-    --hash=sha256:0c88a5d1f45b820272e0c421fd52ff2188b74582b1bab7ba0f57891dc2f31edf \
-    --hash=sha256:b236bd027d2d470c5f7f7a466676182c7e02f486db8296caca25fae0649c3fa3
+opentelemetry-semantic-conventions==0.48b0 \
+    --hash=sha256:12d74983783b6878162208be57c9effcb89dc88691c64992d70bb89dc00daa1a \
+    --hash=sha256:a0de9f45c413a8669788a38569c7e0a11ce6ce97861a628cca785deecdc32a1f
     # via opentelemetry-sdk
-packaging==21.3 \
-    --hash=sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb \
-    --hash=sha256:ef103e05f519cdc783ae24ea4e2e0f508a9c99b2d4969652eed6a2e1ea5bd522
-    # via
-    #   -r requirements.in
-    #   build
-    #   google-cloud-spanner
-pep517==0.13.0 \
-    --hash=sha256:4ba4446d80aed5b5eac6509ade100bff3e7943a8489de249654a5ae9b33ee35b \
-    --hash=sha256:ae69927c5c172be1add9203726d4b84cf3ebad1edcd5f71fcdc746e66e829f59
+packaging==24.1 \
+    --hash=sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002 \
+    --hash=sha256:5b8f2217dbdbd2f7f384c41c628544e6d52f2d0f53c6d0c3ea61aa5d1d7ff124
     # via
     #   -r requirements.in
     #   build
-pip-tools==6.12.0 \
-    --hash=sha256:8e22fbc84ede7ca522ba4b033c4fcf6a6419adabc75d24747be3d8262504489a \
-    --hash=sha256:f441603c63b16f4af0dd5026f7522a49eddec2bc8a4a4979af44e1f6b0a1c13e
+pep517==0.13.1 \
+    --hash=sha256:1b2fa2ffd3938bb4beffe5d6146cbcb2bda996a5a4da9f31abffd8b24e07b317 \
+    --hash=sha256:31b206f67165b3536dd577c5c3f1518e8fbaf38cbc57efff8369a392feff1721
     # via -r requirements.in
-proto-plus==1.22.3 \
-    --hash=sha256:a49cd903bc0b6ab41f76bf65510439d56ca76f868adf0274e738bfdd096894df \
-    --hash=sha256:fdcd09713cbd42480740d2fe29c990f7fbd885a67efc328aa8be6ee3e9f76a6b
-    # via google-cloud-spanner
-protobuf==4.21.6 \
-    --hash=sha256:07a0bb9cc6114f16a39c866dc28b6e3d96fa4ffb9cc1033057412547e6e75cb9 \
-    --hash=sha256:308173d3e5a3528787bb8c93abea81d5a950bdce62840d9760effc84127fb39c \
-    --hash=sha256:4143513c766db85b9d7c18dbf8339673c8a290131b2a0fe73855ab20770f72b0 \
-    --hash=sha256:49f88d56a9180dbb7f6199c920f5bb5c1dd0172f672983bb281298d57c2ac8eb \
-    --hash=sha256:6b1040a5661cd5f6e610cbca9cfaa2a17d60e2bb545309bc1b278bb05be44bdd \
-    --hash=sha256:77b355c8604fe285536155286b28b0c4cbc57cf81b08d8357bf34829ea982860 \
-    --hash=sha256:7a6cc8842257265bdfd6b74d088b829e44bcac3cca234c5fdd6052730017b9ea \
-    --hash=sha256:80e6540381080715fddac12690ee42d087d0d17395f8d0078dfd6f1181e7be4c \
-    --hash=sha256:8f9e60f7d44592c66e7b332b6a7b4b6e8d8b889393c79dbc3a91f815118f8eac \
-    --hash=sha256:9666da97129138585b26afcb63ad4887f602e169cafe754a8258541c553b8b5d \
-    --hash=sha256:aa29113ec901281f29d9d27b01193407a98aa9658b8a777b0325e6d97149f5ce \
-    --hash=sha256:b6cea204865595a92a7b240e4b65bcaaca3ad5d2ce25d9db3756eba06041138e \
-    --hash=sha256:ba596b9ffb85c909fcfe1b1a23136224ed678af3faf9912d3fa483d5f9813c4e \
-    --hash=sha256:c7c864148a237f058c739ae7a05a2b403c0dfa4ce7d1f3e5213f352ad52d57c6
+pip-tools==7.4.1 \
+    --hash=sha256:4c690e5fbae2f21e87843e89c26191f0d9454f362d8acdbd695716493ec8b3a9 \
+    --hash=sha256:864826f5073864450e24dbeeb85ce3920cdfb09848a3d69ebf537b521f14bcc9
+    # via -r requirements.in
+proto-plus==1.25.0 \
+    --hash=sha256:c91fc4a65074ade8e458e95ef8bac34d4008daa7cce4a12d6707066fca648961 \
+    --hash=sha256:fbb17f57f7bd05a68b7707e745e26528b0b3c34e378db91eef93912c54982d91
+    # via
+    #   google-api-core
+    #   google-cloud-spanner
+protobuf==5.28.3 \
+    --hash=sha256:0c4eec6f987338617072592b97943fdbe30d019c56126493111cf24344c1cc24 \
+    --hash=sha256:135658402f71bbd49500322c0f736145731b16fc79dc8f367ab544a17eab4535 \
+    --hash=sha256:27b246b3723692bf1068d5734ddaf2fccc2cdd6e0c9b47fe099244d80200593b \
+    --hash=sha256:3e6101d095dfd119513cde7259aa703d16c6bbdfae2554dfe5cfdbe94e32d548 \
+    --hash=sha256:3fa2de6b8b29d12c61911505d893afe7320ce7ccba4df913e2971461fa36d584 \
+    --hash=sha256:64badbc49180a5e401f373f9ce7ab1d18b63f7dd4a9cdc43c92b9f0b481cef7b \
+    --hash=sha256:70585a70fc2dd4818c51287ceef5bdba6387f88a578c86d47bb34669b5552c36 \
+    --hash=sha256:712319fbdddb46f21abb66cd33cb9e491a5763b2febd8f228251add221981135 \
+    --hash=sha256:91fba8f445723fcf400fdbe9ca796b19d3b1242cd873907979b9ed71e4afe868 \
+    --hash=sha256:a3f6857551e53ce35e60b403b8a27b0295f7d6eb63d10484f12bc6879c715687 \
+    --hash=sha256:cee1757663fa32a1ee673434fcf3bf24dd54763c79690201208bafec62f19eed
     # via
     #   google-api-core
     #   google-cloud-spanner
     #   googleapis-common-protos
+    #   grpc-google-iam-v1
     #   grpcio-status
     #   proto-plus
-pyasn1==0.4.8 \
-    --hash=sha256:39c7e2ec30515947ff4e87fb6f456dfc6e84857d34be479c9d4a4ba4bf46aa5d \
-    --hash=sha256:aef77c9fb94a3ac588e87841208bdec464471d9871bd5050a287cc9a475cd0ba
+pyasn1==0.6.1 \
+    --hash=sha256:0d632f46f2ba09143da3a8afe9e33fb6f92fa2320ab7e886e2d0f7672af84629 \
+    --hash=sha256:6f580d2bdd84365380830acf45550f2511469f673cb4a5ae3857a3170128b034
     # via
     #   pyasn1-modules
     #   rsa
-pyasn1-modules==0.2.8 \
-    --hash=sha256:905f84c712230b2c592c19470d3ca8d552de726050d1d1716282a1f6146be65e \
-    --hash=sha256:a50b808ffeb97cb3601dd25981f6b016cbb3d31fbf57a8b8a87428e6158d0c74
+pyasn1-modules==0.4.1 \
+    --hash=sha256:49bfa96b45a292b711e986f222502c1c9a5e1f4e568fc30e2574a6c7d07838fd \
+    --hash=sha256:c28e2dbf9c06ad61c71a075c7e0f9fd0f1b0bb2d2ad4377f240d33ac2ab60a7c
     # via google-auth
-pyparsing==3.0.9 \
-    --hash=sha256:2b020ecf7d21b687f219b71ecad3631f644a47f01403fa1d1036b0c6416d70fb \
-    --hash=sha256:5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc
+pyparsing==3.2.0 \
+    --hash=sha256:93d9577b88da0bbea8cc8334ee8b918ed014968fd2ec383e868fb8afb1ccef84 \
+    --hash=sha256:cbf74e27246d595d9a74b186b810f6fbb86726dbf3b9532efb343f6d7294fe9c
+    # via -r requirements.in
+pyproject-hooks==1.2.0 \
+    --hash=sha256:1e859bd5c40fae9448642dd871adf459e5e2084186e8d2c2a79a824c970da1f8 \
+    --hash=sha256:9e5c6bfa8dcc30091c74b0cf803c81fdd29d94f01992a7707bc97babb1141913
     # via
-    #   -r requirements.in
-    #   packaging
-requests==2.31.0 \
-    --hash=sha256:58cd2187c01e70e6e26505bca751777aa9f2ee0b7f4300988b709f44e013003f \
-    --hash=sha256:942c5a758f98d790eaed1a29cb6eefc7ffb0d1cf7af05c3d2791656dbd6ad1e1
+    #   build
+    #   pip-tools
+requests==2.32.3 \
+    --hash=sha256:55365417734eb18255590a9ff9eb97e9e1da868d4ccd6402399eaf68af20a760 \
+    --hash=sha256:70761cfe03c773ceb22aa2f671b4757976145175cdfca038c02654d061d6dcc6
     # via google-api-core
 rsa==4.9 \
     --hash=sha256:90260d9058e514786967344d0ef75fa8727eed8a7d2e43ce9f4bcf1b536174f7 \
     --hash=sha256:e38464a49c6c85d7f1351b0126661487a7e0a14a50f1675ec50eb34d4f20ef21
     # via google-auth
-six==1.16.0 \
-    --hash=sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926 \
-    --hash=sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254
-    # via google-auth
-sqlalchemy==1.4.42 \
-    --hash=sha256:04f2598c70ea4a29b12d429a80fad3a5202d56dce19dd4916cc46a965a5ca2e9 \
-    --hash=sha256:0501f74dd2745ec38f44c3a3900fb38b9db1ce21586b691482a19134062bf049 \
-    --hash=sha256:0ee377eb5c878f7cefd633ab23c09e99d97c449dd999df639600f49b74725b80 \
-    --hash=sha256:11b2ec26c5d2eefbc3e6dca4ec3d3d95028be62320b96d687b6e740424f83b7d \
-    --hash=sha256:15d878929c30e41fb3d757a5853b680a561974a0168cd33a750be4ab93181628 \
-    --hash=sha256:177e41914c476ed1e1b77fd05966ea88c094053e17a85303c4ce007f88eff363 \
-    --hash=sha256:1811a0b19a08af7750c0b69e38dec3d46e47c4ec1d74b6184d69f12e1c99a5e0 \
-    --hash=sha256:1d0c23ecf7b3bc81e29459c34a3f4c68ca538de01254e24718a7926810dc39a6 \
-    --hash=sha256:22459fc1718785d8a86171bbe7f01b5c9d7297301ac150f508d06e62a2b4e8d2 \
-    --hash=sha256:28e881266a172a4d3c5929182fde6bb6fba22ac93f137d5380cc78a11a9dd124 \
-    --hash=sha256:2e56dfed0cc3e57b2f5c35719d64f4682ef26836b81067ee6cfad062290fd9e2 \
-    --hash=sha256:2fd49af453e590884d9cdad3586415922a8e9bb669d874ee1dc55d2bc425aacd \
-    --hash=sha256:3ab7c158f98de6cb4f1faab2d12973b330c2878d0c6b689a8ca424c02d66e1b3 \
-    --hash=sha256:4948b6c5f4e56693bbeff52f574279e4ff972ea3353f45967a14c30fb7ae2beb \
-    --hash=sha256:4e1c5f8182b4f89628d782a183d44db51b5af84abd6ce17ebb9804355c88a7b5 \
-    --hash=sha256:5ce6929417d5dce5ad1d3f147db81735a4a0573b8fb36e3f95500a06eaddd93e \
-    --hash=sha256:5ede1495174e69e273fad68ad45b6d25c135c1ce67723e40f6cf536cb515e20b \
-    --hash=sha256:5f966b64c852592469a7eb759615bbd351571340b8b344f1d3fa2478b5a4c934 \
-    --hash=sha256:6045b3089195bc008aee5c273ec3ba9a93f6a55bc1b288841bd4cfac729b6516 \
-    --hash=sha256:6c9d004eb78c71dd4d3ce625b80c96a827d2e67af9c0d32b1c1e75992a7916cc \
-    --hash=sha256:6e39e97102f8e26c6c8550cb368c724028c575ec8bc71afbbf8faaffe2b2092a \
-    --hash=sha256:723e3b9374c1ce1b53564c863d1a6b2f1dc4e97b1c178d9b643b191d8b1be738 \
-    --hash=sha256:876eb185911c8b95342b50a8c4435e1c625944b698a5b4a978ad2ffe74502908 \
-    --hash=sha256:9256563506e040daddccaa948d055e006e971771768df3bb01feeb4386c242b0 \
-    --hash=sha256:934472bb7d8666727746a75670a1f8d91a9cae8c464bba79da30a0f6faccd9e1 \
-    --hash=sha256:97ff50cd85bb907c2a14afb50157d0d5486a4b4639976b4a3346f34b6d1b5272 \
-    --hash=sha256:9b01d9cd2f9096f688c71a3d0f33f3cd0af8549014e66a7a7dee6fc214a7277d \
-    --hash=sha256:9e3a65ce9ed250b2f096f7b559fe3ee92e6605fab3099b661f0397a9ac7c8d95 \
-    --hash=sha256:a7dd5b7b34a8ba8d181402d824b87c5cee8963cb2e23aa03dbfe8b1f1e417cde \
-    --hash=sha256:a85723c00a636eed863adb11f1e8aaa36ad1c10089537823b4540948a8429798 \
-    --hash=sha256:b42c59ffd2d625b28cdb2ae4cde8488543d428cba17ff672a543062f7caee525 \
-    --hash=sha256:bd448b262544b47a2766c34c0364de830f7fb0772d9959c1c42ad61d91ab6565 \
-    --hash=sha256:ca9389a00f639383c93ed00333ed763812f80b5ae9e772ea32f627043f8c9c88 \
-    --hash=sha256:df76e9c60879fdc785a34a82bf1e8691716ffac32e7790d31a98d7dec6e81545 \
-    --hash=sha256:e12c6949bae10f1012ab5c0ea52ab8db99adcb8c7b717938252137cdf694c775 \
-    --hash=sha256:e4ef8cb3c5b326f839bfeb6af5f406ba02ad69a78c7aac0fbeeba994ad9bb48a \
-    --hash=sha256:e7e740453f0149437c101ea4fdc7eea2689938c5760d7dcc436c863a12f1f565 \
-    --hash=sha256:effc89e606165ca55f04f3f24b86d3e1c605e534bf1a96e4e077ce1b027d0b71 \
-    --hash=sha256:f0f574465b78f29f533976c06b913e54ab4980b9931b69aa9d306afff13a9471 \
-    --hash=sha256:fa5b7eb2051e857bf83bade0641628efe5a88de189390725d3e6033a1fff4257 \
-    --hash=sha256:fdb94a3d1ba77ff2ef11912192c066f01e68416f554c194d769391638c8ad09a
+sqlalchemy==2.0.36 \
+    --hash=sha256:03e08af7a5f9386a43919eda9de33ffda16b44eb11f3b313e6822243770e9763 \
+    --hash=sha256:0572f4bd6f94752167adfd7c1bed84f4b240ee6203a95e05d1e208d488d0d436 \
+    --hash=sha256:07b441f7d03b9a66299ce7ccf3ef2900abc81c0db434f42a5694a37bd73870f2 \
+    --hash=sha256:1bc330d9d29c7f06f003ab10e1eaced295e87940405afe1b110f2eb93a233588 \
+    --hash=sha256:1e0d612a17581b6616ff03c8e3d5eff7452f34655c901f75d62bd86449d9750e \
+    --hash=sha256:23623166bfefe1487d81b698c423f8678e80df8b54614c2bf4b4cfcd7c711959 \
+    --hash=sha256:2519f3a5d0517fc159afab1015e54bb81b4406c278749779be57a569d8d1bb0d \
+    --hash=sha256:28120ef39c92c2dd60f2721af9328479516844c6b550b077ca450c7d7dc68575 \
+    --hash=sha256:37350015056a553e442ff672c2d20e6f4b6d0b2495691fa239d8aa18bb3bc908 \
+    --hash=sha256:39769a115f730d683b0eb7b694db9789267bcd027326cccc3125e862eb03bfd8 \
+    --hash=sha256:3c01117dd36800f2ecaa238c65365b7b16497adc1522bf84906e5710ee9ba0e8 \
+    --hash=sha256:3d6718667da04294d7df1670d70eeddd414f313738d20a6f1d1f379e3139a545 \
+    --hash=sha256:3dbb986bad3ed5ceaf090200eba750b5245150bd97d3e67343a3cfed06feecf7 \
+    --hash=sha256:4557e1f11c5f653ebfdd924f3f9d5ebfc718283b0b9beebaa5dd6b77ec290971 \
+    --hash=sha256:46331b00096a6db1fdc052d55b101dbbfc99155a548e20a0e4a8e5e4d1362855 \
+    --hash=sha256:4a121d62ebe7d26fec9155f83f8be5189ef1405f5973ea4874a26fab9f1e262c \
+    --hash=sha256:4f5e9cd989b45b73bd359f693b935364f7e1f79486e29015813c338450aa5a71 \
+    --hash=sha256:50aae840ebbd6cdd41af1c14590e5741665e5272d2fee999306673a1bb1fdb4d \
+    --hash=sha256:59b1ee96617135f6e1d6f275bbe988f419c5178016f3d41d3c0abb0c819f75bb \
+    --hash=sha256:59b8f3adb3971929a3e660337f5dacc5942c2cdb760afcabb2614ffbda9f9f72 \
+    --hash=sha256:66bffbad8d6271bb1cc2f9a4ea4f86f80fe5e2e3e501a5ae2a3dc6a76e604e6f \
+    --hash=sha256:69f93723edbca7342624d09f6704e7126b152eaed3cdbb634cb657a54332a3c5 \
+    --hash=sha256:6a440293d802d3011028e14e4226da1434b373cbaf4a4bbb63f845761a708346 \
+    --hash=sha256:72c28b84b174ce8af8504ca28ae9347d317f9dba3999e5981a3cd441f3712e24 \
+    --hash=sha256:79d2e78abc26d871875b419e1fd3c0bca31a1cb0043277d0d850014599626c2e \
+    --hash=sha256:7f2767680b6d2398aea7082e45a774b2b0767b5c8d8ffb9c8b683088ea9b29c5 \
+    --hash=sha256:8318f4776c85abc3f40ab185e388bee7a6ea99e7fa3a30686580b209eaa35c08 \
+    --hash=sha256:8958b10490125124463095bbdadda5aa22ec799f91958e410438ad6c97a7b793 \
+    --hash=sha256:8c78ac40bde930c60e0f78b3cd184c580f89456dd87fc08f9e3ee3ce8765ce88 \
+    --hash=sha256:90812a8933df713fdf748b355527e3af257a11e415b613dd794512461eb8a686 \
+    --hash=sha256:9bc633f4ee4b4c46e7adcb3a9b5ec083bf1d9a97c1d3854b92749d935de40b9b \
+    --hash=sha256:9e46ed38affdfc95d2c958de328d037d87801cfcbea6d421000859e9789e61c2 \
+    --hash=sha256:9fe53b404f24789b5ea9003fc25b9a3988feddebd7e7b369c8fac27ad6f52f28 \
+    --hash=sha256:a4e46a888b54be23d03a89be510f24a7652fe6ff660787b96cd0e57a4ebcb46d \
+    --hash=sha256:a86bfab2ef46d63300c0f06936bd6e6c0105faa11d509083ba8f2f9d237fb5b5 \
+    --hash=sha256:ac9dfa18ff2a67b09b372d5db8743c27966abf0e5344c555d86cc7199f7ad83a \
+    --hash=sha256:af148a33ff0349f53512a049c6406923e4e02bf2f26c5fb285f143faf4f0e46a \
+    --hash=sha256:b11d0cfdd2b095e7b0686cf5fabeb9c67fae5b06d265d8180715b8cfa86522e3 \
+    --hash=sha256:b2985c0b06e989c043f1dc09d4fe89e1616aadd35392aea2844f0458a989eacf \
+    --hash=sha256:b544ad1935a8541d177cb402948b94e871067656b3a0b9e91dbec136b06a2ff5 \
+    --hash=sha256:b5cc79df7f4bc3d11e4b542596c03826063092611e481fcf1c9dfee3c94355ef \
+    --hash=sha256:b817d41d692bf286abc181f8af476c4fbef3fd05e798777492618378448ee689 \
+    --hash=sha256:b81ee3d84803fd42d0b154cb6892ae57ea6b7c55d8359a02379965706c7efe6c \
+    --hash=sha256:be9812b766cad94a25bc63bec11f88c4ad3629a0cec1cd5d4ba48dc23860486b \
+    --hash=sha256:c245b1fbade9c35e5bd3b64270ab49ce990369018289ecfde3f9c318411aaa07 \
+    --hash=sha256:c3f3631693003d8e585d4200730616b78fafd5a01ef8b698f6967da5c605b3fa \
+    --hash=sha256:c4ae3005ed83f5967f961fd091f2f8c5329161f69ce8480aa8168b2d7fe37f06 \
+    --hash=sha256:c54a1e53a0c308a8e8a7dffb59097bff7facda27c70c286f005327f21b2bd6b1 \
+    --hash=sha256:d0ddd9db6e59c44875211bc4c7953a9f6638b937b0a88ae6d09eb46cced54eff \
+    --hash=sha256:dc022184d3e5cacc9579e41805a681187650e170eb2fd70e28b86192a479dcaa \
+    --hash=sha256:e32092c47011d113dc01ab3e1d3ce9f006a47223b18422c5c0d150af13a00687 \
+    --hash=sha256:f7b64e6ec3f02c35647be6b4851008b26cff592a95ecb13b6788a54ef80bbdd4 \
+    --hash=sha256:f942a799516184c855e1a32fbc7b29d7e571b52612647866d4ec1c3242578fcb \
+    --hash=sha256:f9511d8dd4a6e9271d07d150fb2f81874a3c8c95e11ff9af3a2dfc35fe42ee44 \
+    --hash=sha256:fd3a55deef00f689ce931d4d1b23fa9f04c880a48ee97af488fd215cf24e2a6c \
+    --hash=sha256:fddbe92b4760c6f5d48162aef14824add991aeda8ddadb3c31d56eb15ca69f8e \
+    --hash=sha256:fdf3386a801ea5aba17c6410dd1dc8d39cf454ca2565541b5ac42a84e1e28f53
     # via
     #   -r requirements.in
     #   alembic
-sqlparse==0.4.4 \
-    --hash=sha256:5430a4fe2ac7d0f93e66f1efc6e1338a41884b7ddf2a350cedd20ccc4d9d28f3 \
-    --hash=sha256:d446183e84b8349fa3061f0fe7f06ca94ba65b426946ffebe6e3e8295332420c
+sqlparse==0.5.1 \
+    --hash=sha256:773dcbf9a5ab44a090f3441e2180efe2560220203dc2f8c0b0fa141e18b505e4 \
+    --hash=sha256:bb6b4df465655ef332548e24f08e205afc81b9ab86cb1c45657a7ff173a3a00e
     # via google-cloud-spanner
-tomli==2.0.1 \
-    --hash=sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc \
-    --hash=sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f
+tomli==2.0.2 \
+    --hash=sha256:2ebe24485c53d303f690b0ec092806a085f07af5a5aa1464f3931eec36caaa38 \
+    --hash=sha256:d46d457a85337051c36524bc5349dd91b1877838e2979ac5ced3e710ed8a60ed
+    # via -r requirements.in
+typing-extensions==4.12.2 \
+    --hash=sha256:04e5ca0351e0f3f85c6853954072df659d0d13fac324d0072316b67d7794700d \
+    --hash=sha256:1a7ead55c7e559dd4dee8856e3a88b41225abfe1ce8df57b7c13915fe121ffb8
     # via
-    #   -r requirements.in
-    #   build
-    #   pep517
-typing-extensions==4.8.0 \
-    --hash=sha256:8f92fc8806f9a6b641eaa5318da32b44d401efaac0f6678c9bc448ba3605faa0 \
-    --hash=sha256:df8e4339e9cb77357558cbdbceca33c303714cf861d1eef15e1070055ae8b7ef
-    # via opentelemetry-sdk
-urllib3==1.26.18 \
-    --hash=sha256:34b97092d7e0a3a8cf7cd10e386f401b3737364026c45e622aa02903dffe0f07 \
-    --hash=sha256:f8ecc1bba5667413457c529ab955bf8c67b45db799d159066261719e328580a0
+    #   alembic
+    #   opentelemetry-sdk
+    #   sqlalchemy
+urllib3==2.2.3 \
+    --hash=sha256:ca899ca043dcb1bafa3e262d73aa25c465bfb49e0bd9dd5d59f1d0acba2f8fac \
+    --hash=sha256:e7d814a81dad81e6caf2ec9fdedb284ecc9c73076b62654547cc64ccdcae26e9
     # via requests
-wheel==0.38.1 \
-    --hash=sha256:7a95f9a8dc0924ef318bd55b616112c70903192f524d120acc614f59547a9e1f \
-    --hash=sha256:ea041edf63f4ccba53ad6e035427997b3bb10ee88a4cd014ae82aeb9eea77bb9
+wheel==0.44.0 \
+    --hash=sha256:2376a90c98cc337d18623527a97c31797bd02bad0033d41547043a1cbfbe448f \
+    --hash=sha256:a29c3f2817e95ab89aa4660681ad547c0e9547f20e75b0562fe7723c9a2a9d49
     # via pip-tools
-wrapt==1.14.1 \
-    --hash=sha256:00b6d4ea20a906c0ca56d84f93065b398ab74b927a7a3dbd470f6fc503f95dc3 \
-    --hash=sha256:01c205616a89d09827986bc4e859bcabd64f5a0662a7fe95e0d359424e0e071b \
-    --hash=sha256:02b41b633c6261feff8ddd8d11c711df6842aba629fdd3da10249a53211a72c4 \
-    --hash=sha256:07f7a7d0f388028b2df1d916e94bbb40624c59b48ecc6cbc232546706fac74c2 \
-    --hash=sha256:11871514607b15cfeb87c547a49bca19fde402f32e2b1c24a632506c0a756656 \
-    --hash=sha256:1b376b3f4896e7930f1f772ac4b064ac12598d1c38d04907e696cc4d794b43d3 \
-    --hash=sha256:21ac0156c4b089b330b7666db40feee30a5d52634cc4560e1905d6529a3897ff \
-    --hash=sha256:257fd78c513e0fb5cdbe058c27a0624c9884e735bbd131935fd49e9fe719d310 \
-    --hash=sha256:2b39d38039a1fdad98c87279b48bc5dce2c0ca0d73483b12cb72aa9609278e8a \
-    --hash=sha256:2cf71233a0ed05ccdabe209c606fe0bac7379fdcf687f39b944420d2a09fdb57 \
-    --hash=sha256:2fe803deacd09a233e4762a1adcea5db5d31e6be577a43352936179d14d90069 \
-    --hash=sha256:3232822c7d98d23895ccc443bbdf57c7412c5a65996c30442ebe6ed3df335383 \
-    --hash=sha256:34aa51c45f28ba7f12accd624225e2b1e5a3a45206aa191f6f9aac931d9d56fe \
-    --hash=sha256:36f582d0c6bc99d5f39cd3ac2a9062e57f3cf606ade29a0a0d6b323462f4dd87 \
-    --hash=sha256:380a85cf89e0e69b7cfbe2ea9f765f004ff419f34194018a6827ac0e3edfed4d \
-    --hash=sha256:40e7bc81c9e2b2734ea4bc1aceb8a8f0ceaac7c5299bc5d69e37c44d9081d43b \
-    --hash=sha256:43ca3bbbe97af00f49efb06e352eae40434ca9d915906f77def219b88e85d907 \
-    --hash=sha256:4fcc4649dc762cddacd193e6b55bc02edca674067f5f98166d7713b193932b7f \
-    --hash=sha256:5a0f54ce2c092aaf439813735584b9537cad479575a09892b8352fea5e988dc0 \
-    --hash=sha256:5a9a0d155deafd9448baff28c08e150d9b24ff010e899311ddd63c45c2445e28 \
-    --hash=sha256:5b02d65b9ccf0ef6c34cba6cf5bf2aab1bb2f49c6090bafeecc9cd81ad4ea1c1 \
-    --hash=sha256:60db23fa423575eeb65ea430cee741acb7c26a1365d103f7b0f6ec412b893853 \
-    --hash=sha256:642c2e7a804fcf18c222e1060df25fc210b9c58db7c91416fb055897fc27e8cc \
-    --hash=sha256:6a9a25751acb379b466ff6be78a315e2b439d4c94c1e99cb7266d40a537995d3 \
-    --hash=sha256:6b1a564e6cb69922c7fe3a678b9f9a3c54e72b469875aa8018f18b4d1dd1adf3 \
-    --hash=sha256:6d323e1554b3d22cfc03cd3243b5bb815a51f5249fdcbb86fda4bf62bab9e164 \
-    --hash=sha256:6e743de5e9c3d1b7185870f480587b75b1cb604832e380d64f9504a0535912d1 \
-    --hash=sha256:709fe01086a55cf79d20f741f39325018f4df051ef39fe921b1ebe780a66184c \
-    --hash=sha256:7b7c050ae976e286906dd3f26009e117eb000fb2cf3533398c5ad9ccc86867b1 \
-    --hash=sha256:7d2872609603cb35ca513d7404a94d6d608fc13211563571117046c9d2bcc3d7 \
-    --hash=sha256:7ef58fb89674095bfc57c4069e95d7a31cfdc0939e2a579882ac7d55aadfd2a1 \
-    --hash=sha256:80bb5c256f1415f747011dc3604b59bc1f91c6e7150bd7db03b19170ee06b320 \
-    --hash=sha256:81b19725065dcb43df02b37e03278c011a09e49757287dca60c5aecdd5a0b8ed \
-    --hash=sha256:833b58d5d0b7e5b9832869f039203389ac7cbf01765639c7309fd50ef619e0b1 \
-    --hash=sha256:88bd7b6bd70a5b6803c1abf6bca012f7ed963e58c68d76ee20b9d751c74a3248 \
-    --hash=sha256:8ad85f7f4e20964db4daadcab70b47ab05c7c1cf2a7c1e51087bfaa83831854c \
-    --hash=sha256:8c0ce1e99116d5ab21355d8ebe53d9460366704ea38ae4d9f6933188f327b456 \
-    --hash=sha256:8d649d616e5c6a678b26d15ece345354f7c2286acd6db868e65fcc5ff7c24a77 \
-    --hash=sha256:903500616422a40a98a5a3c4ff4ed9d0066f3b4c951fa286018ecdf0750194ef \
-    --hash=sha256:9736af4641846491aedb3c3f56b9bc5568d92b0692303b5a305301a95dfd38b1 \
-    --hash=sha256:988635d122aaf2bdcef9e795435662bcd65b02f4f4c1ae37fbee7401c440b3a7 \
-    --hash=sha256:9cca3c2cdadb362116235fdbd411735de4328c61425b0aa9f872fd76d02c4e86 \
-    --hash=sha256:9e0fd32e0148dd5dea6af5fee42beb949098564cc23211a88d799e434255a1f4 \
-    --hash=sha256:9f3e6f9e05148ff90002b884fbc2a86bd303ae847e472f44ecc06c2cd2fcdb2d \
-    --hash=sha256:a85d2b46be66a71bedde836d9e41859879cc54a2a04fad1191eb50c2066f6e9d \
-    --hash=sha256:a9a52172be0b5aae932bef82a79ec0a0ce87288c7d132946d645eba03f0ad8a8 \
-    --hash=sha256:aa31fdcc33fef9eb2552cbcbfee7773d5a6792c137b359e82879c101e98584c5 \
-    --hash=sha256:b014c23646a467558be7da3d6b9fa409b2c567d2110599b7cf9a0c5992b3b471 \
-    --hash=sha256:b21bb4c09ffabfa0e85e3a6b623e19b80e7acd709b9f91452b8297ace2a8ab00 \
-    --hash=sha256:b5901a312f4d14c59918c221323068fad0540e34324925c8475263841dbdfe68 \
-    --hash=sha256:b9b7a708dd92306328117d8c4b62e2194d00c365f18eff11a9b53c6f923b01e3 \
-    --hash=sha256:d1967f46ea8f2db647c786e78d8cc7e4313dbd1b0aca360592d8027b8508e24d \
-    --hash=sha256:d52a25136894c63de15a35bc0bdc5adb4b0e173b9c0d07a2be9d3ca64a332735 \
-    --hash=sha256:d77c85fedff92cf788face9bfa3ebaa364448ebb1d765302e9af11bf449ca36d \
-    --hash=sha256:d79d7d5dc8a32b7093e81e97dad755127ff77bcc899e845f41bf71747af0c569 \
-    --hash=sha256:dbcda74c67263139358f4d188ae5faae95c30929281bc6866d00573783c422b7 \
-    --hash=sha256:ddaea91abf8b0d13443f6dac52e89051a5063c7d014710dcb4d4abb2ff811a59 \
-    --hash=sha256:dee0ce50c6a2dd9056c20db781e9c1cfd33e77d2d569f5d1d9321c641bb903d5 \
-    --hash=sha256:dee60e1de1898bde3b238f18340eec6148986da0455d8ba7848d50470a7a32fb \
-    --hash=sha256:e2f83e18fe2f4c9e7db597e988f72712c0c3676d337d8b101f6758107c42425b \
-    --hash=sha256:e3fb1677c720409d5f671e39bac6c9e0e422584e5f518bfd50aa4cbbea02433f \
-    --hash=sha256:ee2b1b1769f6707a8a445162ea16dddf74285c3964f605877a20e38545c3c462 \
-    --hash=sha256:ee6acae74a2b91865910eef5e7de37dc6895ad96fa23603d1d27ea69df545015 \
-    --hash=sha256:ef3f72c9666bba2bab70d2a8b79f2c6d2c1a42a7f7e2b0ec83bb2f9e383950af
+wrapt==1.16.0 \
+    --hash=sha256:0d2691979e93d06a95a26257adb7bfd0c93818e89b1406f5a28f36e0d8c1e1fc \
+    --hash=sha256:14d7dc606219cdd7405133c713f2c218d4252f2a469003f8c46bb92d5d095d81 \
+    --hash=sha256:1a5db485fe2de4403f13fafdc231b0dbae5eca4359232d2efc79025527375b09 \
+    --hash=sha256:1acd723ee2a8826f3d53910255643e33673e1d11db84ce5880675954183ec47e \
+    --hash=sha256:1ca9b6085e4f866bd584fb135a041bfc32cab916e69f714a7d1d397f8c4891ca \
+    --hash=sha256:1dd50a2696ff89f57bd8847647a1c363b687d3d796dc30d4dd4a9d1689a706f0 \
+    --hash=sha256:2076fad65c6736184e77d7d4729b63a6d1ae0b70da4868adeec40989858eb3fb \
+    --hash=sha256:2a88e6010048489cda82b1326889ec075a8c856c2e6a256072b28eaee3ccf487 \
+    --hash=sha256:3ebf019be5c09d400cf7b024aa52b1f3aeebeff51550d007e92c3c1c4afc2a40 \
+    --hash=sha256:418abb18146475c310d7a6dc71143d6f7adec5b004ac9ce08dc7a34e2babdc5c \
+    --hash=sha256:43aa59eadec7890d9958748db829df269f0368521ba6dc68cc172d5d03ed8060 \
+    --hash=sha256:44a2754372e32ab315734c6c73b24351d06e77ffff6ae27d2ecf14cf3d229202 \
+    --hash=sha256:490b0ee15c1a55be9c1bd8609b8cecd60e325f0575fc98f50058eae366e01f41 \
+    --hash=sha256:49aac49dc4782cb04f58986e81ea0b4768e4ff197b57324dcbd7699c5dfb40b9 \
+    --hash=sha256:5eb404d89131ec9b4f748fa5cfb5346802e5ee8836f57d516576e61f304f3b7b \
+    --hash=sha256:5f15814a33e42b04e3de432e573aa557f9f0f56458745c2074952f564c50e664 \
+    --hash=sha256:5f370f952971e7d17c7d1ead40e49f32345a7f7a5373571ef44d800d06b1899d \
+    --hash=sha256:66027d667efe95cc4fa945af59f92c5a02c6f5bb6012bff9e60542c74c75c362 \
+    --hash=sha256:66dfbaa7cfa3eb707bbfcd46dab2bc6207b005cbc9caa2199bcbc81d95071a00 \
+    --hash=sha256:685f568fa5e627e93f3b52fda002c7ed2fa1800b50ce51f6ed1d572d8ab3e7fc \
+    --hash=sha256:6906c4100a8fcbf2fa735f6059214bb13b97f75b1a61777fcf6432121ef12ef1 \
+    --hash=sha256:6a42cd0cfa8ffc1915aef79cb4284f6383d8a3e9dcca70c445dcfdd639d51267 \
+    --hash=sha256:6dcfcffe73710be01d90cae08c3e548d90932d37b39ef83969ae135d36ef3956 \
+    --hash=sha256:6f6eac2360f2d543cc875a0e5efd413b6cbd483cb3ad7ebf888884a6e0d2e966 \
+    --hash=sha256:72554a23c78a8e7aa02abbd699d129eead8b147a23c56e08d08dfc29cfdddca1 \
+    --hash=sha256:73870c364c11f03ed072dda68ff7aea6d2a3a5c3fe250d917a429c7432e15228 \
+    --hash=sha256:73aa7d98215d39b8455f103de64391cb79dfcad601701a3aa0dddacf74911d72 \
+    --hash=sha256:75ea7d0ee2a15733684badb16de6794894ed9c55aa5e9903260922f0482e687d \
+    --hash=sha256:7bd2d7ff69a2cac767fbf7a2b206add2e9a210e57947dd7ce03e25d03d2de292 \
+    --hash=sha256:807cc8543a477ab7422f1120a217054f958a66ef7314f76dd9e77d3f02cdccd0 \
+    --hash=sha256:8e9723528b9f787dc59168369e42ae1c3b0d3fadb2f1a71de14531d321ee05b0 \
+    --hash=sha256:9090c9e676d5236a6948330e83cb89969f433b1943a558968f659ead07cb3b36 \
+    --hash=sha256:9153ed35fc5e4fa3b2fe97bddaa7cbec0ed22412b85bcdaf54aeba92ea37428c \
+    --hash=sha256:9159485323798c8dc530a224bd3ffcf76659319ccc7bbd52e01e73bd0241a0c5 \
+    --hash=sha256:941988b89b4fd6b41c3f0bfb20e92bd23746579736b7343283297c4c8cbae68f \
+    --hash=sha256:94265b00870aa407bd0cbcfd536f17ecde43b94fb8d228560a1e9d3041462d73 \
+    --hash=sha256:98b5e1f498a8ca1858a1cdbffb023bfd954da4e3fa2c0cb5853d40014557248b \
+    --hash=sha256:9b201ae332c3637a42f02d1045e1d0cccfdc41f1f2f801dafbaa7e9b4797bfc2 \
+    --hash=sha256:a0ea261ce52b5952bf669684a251a66df239ec6d441ccb59ec7afa882265d593 \
+    --hash=sha256:a33a747400b94b6d6b8a165e4480264a64a78c8a4c734b62136062e9a248dd39 \
+    --hash=sha256:a452f9ca3e3267cd4d0fcf2edd0d035b1934ac2bd7e0e57ac91ad6b95c0c6389 \
+    --hash=sha256:a86373cf37cd7764f2201b76496aba58a52e76dedfaa698ef9e9688bfd9e41cf \
+    --hash=sha256:ac83a914ebaf589b69f7d0a1277602ff494e21f4c2f743313414378f8f50a4cf \
+    --hash=sha256:aefbc4cb0a54f91af643660a0a150ce2c090d3652cf4052a5397fb2de549cd89 \
+    --hash=sha256:b3646eefa23daeba62643a58aac816945cadc0afaf21800a1421eeba5f6cfb9c \
+    --hash=sha256:b47cfad9e9bbbed2339081f4e346c93ecd7ab504299403320bf85f7f85c7d46c \
+    --hash=sha256:b935ae30c6e7400022b50f8d359c03ed233d45b725cfdd299462f41ee5ffba6f \
+    --hash=sha256:bb2dee3874a500de01c93d5c71415fcaef1d858370d405824783e7a8ef5db440 \
+    --hash=sha256:bc57efac2da352a51cc4658878a68d2b1b67dbe9d33c36cb826ca449d80a8465 \
+    --hash=sha256:bf5703fdeb350e36885f2875d853ce13172ae281c56e509f4e6eca049bdfb136 \
+    --hash=sha256:c31f72b1b6624c9d863fc095da460802f43a7c6868c5dda140f51da24fd47d7b \
+    --hash=sha256:c5cd603b575ebceca7da5a3a251e69561bec509e0b46e4993e1cac402b7247b8 \
+    --hash=sha256:d2efee35b4b0a347e0d99d28e884dfd82797852d62fcd7ebdeee26f3ceb72cf3 \
+    --hash=sha256:d462f28826f4657968ae51d2181a074dfe03c200d6131690b7d65d55b0f360f8 \
+    --hash=sha256:d5e49454f19ef621089e204f862388d29e6e8d8b162efce05208913dde5b9ad6 \
+    --hash=sha256:da4813f751142436b075ed7aa012a8778aa43a99f7b36afe9b742d3ed8bdc95e \
+    --hash=sha256:db2e408d983b0e61e238cf579c09ef7020560441906ca990fe8412153e3b291f \
+    --hash=sha256:db98ad84a55eb09b3c32a96c576476777e87c520a34e2519d3e59c44710c002c \
+    --hash=sha256:dbed418ba5c3dce92619656802cc5355cb679e58d0d89b50f116e4a9d5a9603e \
+    --hash=sha256:dcdba5c86e368442528f7060039eda390cc4091bfd1dca41e8046af7c910dda8 \
+    --hash=sha256:decbfa2f618fa8ed81c95ee18a387ff973143c656ef800c9f24fb7e9c16054e2 \
+    --hash=sha256:e4fdb9275308292e880dcbeb12546df7f3e0f96c6b41197e0cf37d2826359020 \
+    --hash=sha256:eb1b046be06b0fce7249f1d025cd359b4b80fc1c3e24ad9eca33e0dcdb2e4a35 \
+    --hash=sha256:eb6e651000a19c96f452c85132811d25e9264d836951022d6e81df2fff38337d \
+    --hash=sha256:ed867c42c268f876097248e05b6117a65bcd1e63b779e916fe2e33cd6fd0d3c3 \
+    --hash=sha256:edfad1d29c73f9b863ebe7082ae9321374ccb10879eeabc84ba3b69f2579d537 \
+    --hash=sha256:f2058f813d4f2b5e3a9eb2eb3faf8f1d99b81c3e51aeda4b168406443e8ba809 \
+    --hash=sha256:f6b2d0c6703c988d334f297aa5df18c45e97b0af3679bb75059e0e0bd8b1069d \
+    --hash=sha256:f8212564d49c50eb4565e502814f694e240c55551a5f1bc841d4fcaabb0a9b8a \
+    --hash=sha256:ffa565331890b90056c01db69c0fe634a776f8019c143a5ae265f9c6bc4bd6d4
     # via
     #   deprecated
     #   opentelemetry-instrumentation
-zipp==3.17.0 \
-    --hash=sha256:0e923e726174922dce09c53c59ad483ff7bbb8e572e00c7f7c46b88556409f31 \
-    --hash=sha256:84e64a1c28cf7e91ed2078bb8cc8c259cb19b76942096c8d7b84947690cabaf0
-    # via
-    #   importlib-metadata
-    #   importlib-resources
+zipp==3.20.2 \
+    --hash=sha256:a817ac80d6cf4b23bf7f2828b7cabf326f15a001bea8b1f9b49631780ba28350 \
+    --hash=sha256:bc9eb26f4506fda01b81bcde0ca78103b6e62f991b381fec825435c836edbc29
+    # via importlib-metadata
 
 # WARNING: The following packages were not pinned, but pip requires them to be
 # pinned when the requirements file includes hashes and the requirement is not
diff --git a/setup.py b/setup.py
index 72fa5653..d3d0f8c4 100644
--- a/setup.py
+++ b/setup.py
@@ -14,6 +14,8 @@
 
 import io
 import os
+import warnings
+
 import setuptools
 
 
@@ -59,24 +61,26 @@
 if "google.cloud" in packages:
     namespaces.append("google.cloud")
 
-setuptools.setup(
-    author="Google LLC",
-    author_email="cloud-spanner-developers@googlegroups.com",
-    classifiers=["Intended Audience :: Developers"],
-    description=description,
-    long_description=readme,
-    entry_points={
-        "sqlalchemy.dialects": [
-            "spanner.spanner = google.cloud.sqlalchemy_spanner:SpannerDialect"
-        ]
-    },
-    install_requires=dependencies,
-    extras_require=extras,
-    name=name,
-    namespace_packages=namespaces,
-    packages=packages,
-    url="https://github.com/cloudspannerecosystem/python-spanner-sqlalchemy",
-    version=version,
-    include_package_data=True,
-    zip_safe=False,
-)
+with warnings.catch_warnings():
+    warnings.simplefilter("ignore")
+    setuptools.setup(
+        author="Google LLC",
+        author_email="cloud-spanner-developers@googlegroups.com",
+        classifiers=["Intended Audience :: Developers"],
+        description=description,
+        long_description=readme,
+        entry_points={
+            "sqlalchemy.dialects": [
+                "spanner.spanner = google.cloud.sqlalchemy_spanner:SpannerDialect"
+            ]
+        },
+        install_requires=dependencies,
+        extras_require=extras,
+        name=name,
+        namespace_packages=namespaces,
+        packages=packages,
+        url="https://github.com/cloudspannerecosystem/python-spanner-sqlalchemy",
+        version=version,
+        include_package_data=True,
+        zip_safe=False,
+    )
diff --git a/test/_helpers.py b/test/_helpers.py
index 2aae11c7..3dd57fd5 100644
--- a/test/_helpers.py
+++ b/test/_helpers.py
@@ -82,7 +82,7 @@ def setup_class(cls):
             use_test_ot_exporter()
             cls.ot_exporter = get_test_ot_exporter()
 
-    def teardown(self):
+    def teardown_method(self):
         if HAS_OPENTELEMETRY_INSTALLED:
             self.ot_exporter.clear()
 
diff --git a/test/test_suite_20.py b/test/test_suite_20.py
index 8d6d8113..cff1a30d 100644
--- a/test/test_suite_20.py
+++ b/test/test_suite_20.py
@@ -80,7 +80,9 @@
 from sqlalchemy.testing.suite.test_reflection import *  # noqa: F401, F403
 from sqlalchemy.testing.suite.test_deprecations import *  # noqa: F401, F403
 from sqlalchemy.testing.suite.test_results import *  # noqa: F401, F403
-from sqlalchemy.testing.suite.test_select import *  # noqa: F401, F403
+from sqlalchemy.testing.suite.test_select import (
+    BitwiseTest as _BitwiseTest,
+)  # noqa: F401, F403
 from sqlalchemy.testing.suite.test_sequence import (
     SequenceTest as _SequenceTest,
     HasSequenceTest as _HasSequenceTest,
@@ -192,6 +194,12 @@ def test_whereclause(self):
         pass
 
 
+class BitwiseTest(_BitwiseTest):
+    @pytest.mark.skip("Causes too many problems with other tests")
+    def test_bitwise(self, case, expected, connection):
+        pass
+
+
 class ComponentReflectionTestExtra(_ComponentReflectionTestExtra):
     @testing.requires.table_reflection
     def test_nullable_reflection(self, connection, metadata):
@@ -1018,6 +1026,10 @@ def test_get_multi_columns(
         tables to be read, and in Spanner all the tables are real,
         expected results override is required.
         """
+        _ignore_tables = [
+            "bitwise",
+        ]
+
         insp, kws, exp = get_multi_exp(
             schema,
             scope,
@@ -1030,6 +1042,8 @@ def test_get_multi_columns(
         for kw in kws:
             insp.clear_cache()
             result = insp.get_multi_columns(**kw)
+            for t in _ignore_tables:
+                result.pop((schema, t), None)
             self._check_table_dict(result, exp, self._required_column_keys)
 
     @pytest.mark.skip(
@@ -1097,6 +1111,7 @@ def test_get_table_names(self, connection, order_by, use_schema):
         _ignore_tables = [
             "account",
             "alembic_version",
+            "bitwise",
             "bytes_table",
             "comment_test",
             "date_table",
@@ -1306,6 +1321,7 @@ def _test_get_table_names(self, schema=None, table_type="table", order_by=None):
         expected results override is required.
         """
         _ignore_tables = [
+            "bitwise",
             "comment_test",
             "noncol_idx_test_pk",
             "noncol_idx_test_nopk",
@@ -1688,7 +1704,7 @@ def test_round_trip(self):
             connection.execute(date_table.insert(), {"date_data": self.data, "id": 250})
             row = connection.execute(select(date_table.c.date_data)).first()
 
-        compare = self.compare or self.data
+        compare = self.compare or self.data.astimezone(timezone.utc)
         compare = compare.strftime("%Y-%m-%dT%H:%M:%S.%fZ")
         eq_(row[0].rfc3339(), compare)
         assert isinstance(row[0], DatetimeWithNanoseconds)
@@ -1708,7 +1724,7 @@ def test_round_trip_decorated(self, connection):
 
         row = connection.execute(select(date_table.c.decorated_date_data)).first()
 
-        compare = self.compare or self.data
+        compare = self.compare or self.data.astimezone(timezone.utc)
         compare = compare.strftime("%Y-%m-%dT%H:%M:%S.%fZ")
         eq_(row[0].rfc3339(), compare)
         assert isinstance(row[0], DatetimeWithNanoseconds)
@@ -2105,7 +2121,7 @@ def test_row_w_scalar_select(self, connection):
 
         eq_(
             row.somelabel,
-            DatetimeWithNanoseconds(2006, 5, 12, 12, 0, 0, tzinfo=timezone.utc),
+            DatetimeWithNanoseconds(2006, 5, 12, 12, 0, 0).astimezone(timezone.utc),
         )
 
 
diff --git a/test/unit/test_opentelemetry_tracing.py b/test/unit/test_opentelemetry_tracing.py
index a8af61c6..21ea1bb7 100644
--- a/test/unit/test_opentelemetry_tracing.py
+++ b/test/unit/test_opentelemetry_tracing.py
@@ -33,13 +33,14 @@ def _make_rpc_error(error_cls, trailing_metadata=None):
 if HAS_OPENTELEMETRY_INSTALLED:
 
     class NoTracingTest(OpenTelemetryBase):
-        def setup(self):
+        def setup_method(self):
             self._temp_opentelemetry = sys.modules["opentelemetry"]
 
             sys.modules["opentelemetry"] = None
             importlib.reload(_opentelemetry_tracing)
 
-        def teardown(self):
+        def teardown_method(self):
+            super(NoTracingTest, self).teardown_method()
             sys.modules["opentelemetry"] = self._temp_opentelemetry
             importlib.reload(_opentelemetry_tracing)
 

From 12d18f062f9d38a750d2b14cf685a2f51f01387c Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 09:27:35 +0100
Subject: [PATCH 002/133] chore(deps): update dependency requests to v2.32.2
 [security] (#412)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 3322b956..2de75aa8 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -531,9 +531,9 @@ readme-renderer==37.2 \
     --hash=sha256:d3f06a69e8c40fca9ab3174eca48f96d9771eddb43517b17d96583418427b106 \
     --hash=sha256:e8ad25293c98f781dbc2c5a36a309929390009f902f99e1798c761aaf04a7923
     # via twine
-requests==2.31.0 \
-    --hash=sha256:58cd2187c01e70e6e26505bca751777aa9f2ee0b7f4300988b709f44e013003f \
-    --hash=sha256:942c5a758f98d790eaed1a29cb6eefc7ffb0d1cf7af05c3d2791656dbd6ad1e1
+requests==2.32.2 \
+    --hash=sha256:dd951ff5ecf3e3b3aa26b40703ba77495dab41da839ae72ef3c8e5d8e2433289 \
+    --hash=sha256:fc06670dd0ed212426dfeb94fc1b983d917c4f9847c863f313c9dfaaffb7c23c
     # via
     #   gcp-releasetool
     #   google-api-core

From c679b9c2bdeedc5912d0020ac944aff67991b423 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 31 Oct 2024 09:46:43 +0100
Subject: [PATCH 003/133] build(deps): bump cryptography from 41.0.5 to 43.0.1
 in /.kokoro (#410)

Bumps [cryptography](https://github.com/pyca/cryptography) from 41.0.5 to 43.0.1.
- [Changelog](https://github.com/pyca/cryptography/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/cryptography/compare/41.0.5...43.0.1)

---
updated-dependencies:
- dependency-name: cryptography
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .kokoro/requirements.txt | 71 ++++++++++++++++++++--------------------
 1 file changed, 36 insertions(+), 35 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 2de75aa8..9b7161d8 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -198,30 +198,34 @@ commonmark==0.9.1 \
     --hash=sha256:452f9dc859be7f06631ddcb328b6919c67984aca654e5fefb3914d54691aed60 \
     --hash=sha256:da2f38c92590f83de410ba1a3cbceafbc74fee9def35f9251ba9a971d6d66fd9
     # via rich
-cryptography==41.0.5 \
-    --hash=sha256:0c327cac00f082013c7c9fb6c46b7cc9fa3c288ca702c74773968173bda421bf \
-    --hash=sha256:0d2a6a598847c46e3e321a7aef8af1436f11c27f1254933746304ff014664d84 \
-    --hash=sha256:227ec057cd32a41c6651701abc0328135e472ed450f47c2766f23267b792a88e \
-    --hash=sha256:22892cc830d8b2c89ea60148227631bb96a7da0c1b722f2aac8824b1b7c0b6b8 \
-    --hash=sha256:392cb88b597247177172e02da6b7a63deeff1937fa6fec3bbf902ebd75d97ec7 \
-    --hash=sha256:3be3ca726e1572517d2bef99a818378bbcf7d7799d5372a46c79c29eb8d166c1 \
-    --hash=sha256:573eb7128cbca75f9157dcde974781209463ce56b5804983e11a1c462f0f4e88 \
-    --hash=sha256:580afc7b7216deeb87a098ef0674d6ee34ab55993140838b14c9b83312b37b86 \
-    --hash=sha256:5a70187954ba7292c7876734183e810b728b4f3965fbe571421cb2434d279179 \
-    --hash=sha256:73801ac9736741f220e20435f84ecec75ed70eda90f781a148f1bad546963d81 \
-    --hash=sha256:7d208c21e47940369accfc9e85f0de7693d9a5d843c2509b3846b2db170dfd20 \
-    --hash=sha256:8254962e6ba1f4d2090c44daf50a547cd5f0bf446dc658a8e5f8156cae0d8548 \
-    --hash=sha256:88417bff20162f635f24f849ab182b092697922088b477a7abd6664ddd82291d \
-    --hash=sha256:a48e74dad1fb349f3dc1d449ed88e0017d792997a7ad2ec9587ed17405667e6d \
-    --hash=sha256:b948e09fe5fb18517d99994184854ebd50b57248736fd4c720ad540560174ec5 \
-    --hash=sha256:c707f7afd813478e2019ae32a7c49cd932dd60ab2d2a93e796f68236b7e1fbf1 \
-    --hash=sha256:d38e6031e113b7421db1de0c1b1f7739564a88f1684c6b89234fbf6c11b75147 \
-    --hash=sha256:d3977f0e276f6f5bf245c403156673db103283266601405376f075c849a0b936 \
-    --hash=sha256:da6a0ff8f1016ccc7477e6339e1d50ce5f59b88905585f77193ebd5068f1e797 \
-    --hash=sha256:e270c04f4d9b5671ebcc792b3ba5d4488bf7c42c3c241a3748e2599776f29696 \
-    --hash=sha256:e886098619d3815e0ad5790c973afeee2c0e6e04b4da90b88e6bd06e2a0b1b72 \
-    --hash=sha256:ec3b055ff8f1dce8e6ef28f626e0972981475173d7973d63f271b29c8a2897da \
-    --hash=sha256:fba1e91467c65fe64a82c689dc6cf58151158993b13eb7a7f3f4b7f395636723
+cryptography==43.0.1 \
+    --hash=sha256:014f58110f53237ace6a408b5beb6c427b64e084eb451ef25a28308270086494 \
+    --hash=sha256:1bbcce1a551e262dfbafb6e6252f1ae36a248e615ca44ba302df077a846a8806 \
+    --hash=sha256:203e92a75716d8cfb491dc47c79e17d0d9207ccffcbcb35f598fbe463ae3444d \
+    --hash=sha256:27e613d7077ac613e399270253259d9d53872aaf657471473ebfc9a52935c062 \
+    --hash=sha256:2bd51274dcd59f09dd952afb696bf9c61a7a49dfc764c04dd33ef7a6b502a1e2 \
+    --hash=sha256:38926c50cff6f533f8a2dae3d7f19541432610d114a70808f0926d5aaa7121e4 \
+    --hash=sha256:511f4273808ab590912a93ddb4e3914dfd8a388fed883361b02dea3791f292e1 \
+    --hash=sha256:58d4e9129985185a06d849aa6df265bdd5a74ca6e1b736a77959b498e0505b85 \
+    --hash=sha256:5b43d1ea6b378b54a1dc99dd8a2b5be47658fe9a7ce0a58ff0b55f4b43ef2b84 \
+    --hash=sha256:61ec41068b7b74268fa86e3e9e12b9f0c21fcf65434571dbb13d954bceb08042 \
+    --hash=sha256:666ae11966643886c2987b3b721899d250855718d6d9ce41b521252a17985f4d \
+    --hash=sha256:68aaecc4178e90719e95298515979814bda0cbada1256a4485414860bd7ab962 \
+    --hash=sha256:7c05650fe8023c5ed0d46793d4b7d7e6cd9c04e68eabe5b0aeea836e37bdcec2 \
+    --hash=sha256:80eda8b3e173f0f247f711eef62be51b599b5d425c429b5d4ca6a05e9e856baa \
+    --hash=sha256:8385d98f6a3bf8bb2d65a73e17ed87a3ba84f6991c155691c51112075f9ffc5d \
+    --hash=sha256:88cce104c36870d70c49c7c8fd22885875d950d9ee6ab54df2745f83ba0dc365 \
+    --hash=sha256:9d3cdb25fa98afdd3d0892d132b8d7139e2c087da1712041f6b762e4f807cc96 \
+    --hash=sha256:a575913fb06e05e6b4b814d7f7468c2c660e8bb16d8d5a1faf9b33ccc569dd47 \
+    --hash=sha256:ac119bb76b9faa00f48128b7f5679e1d8d437365c5d26f1c2c3f0da4ce1b553d \
+    --hash=sha256:c1332724be35d23a854994ff0b66530119500b6053d0bd3363265f7e5e77288d \
+    --hash=sha256:d03a475165f3134f773d1388aeb19c2d25ba88b6a9733c5c590b9ff7bbfa2e0c \
+    --hash=sha256:d75601ad10b059ec832e78823b348bfa1a59f6b8d545db3a24fd44362a1564cb \
+    --hash=sha256:de41fd81a41e53267cb020bb3a7212861da53a7d39f863585d13ea11049cf277 \
+    --hash=sha256:e710bf40870f4db63c3d7d929aa9e09e4e7ee219e703f949ec4073b4294f6172 \
+    --hash=sha256:ea25acb556320250756e53f9e20a4177515f012c9eaea17eb7587a8c4d8ae034 \
+    --hash=sha256:f98bf604c82c416bc829e490c700ca1553eafdf2912a91e23a79d97d9801372a \
+    --hash=sha256:fba1007b3ef89946dbbb515aeeb41e30203b004f0b4b00e5e16078b518563289
     # via
     #   gcp-releasetool
     #   secretstorage
@@ -240,11 +244,11 @@ filelock==3.8.0 \
 gcp-docuploader==0.6.4 \
     --hash=sha256:01486419e24633af78fd0167db74a2763974765ee8078ca6eb6964d0ebd388af \
     --hash=sha256:70861190c123d907b3b067da896265ead2eeb9263969d6955c9e0bb091b5ccbf
-    # via -r .kokoro/requirements.in
+    # via -r requirements.in
 gcp-releasetool==1.16.0 \
     --hash=sha256:27bf19d2e87aaa884096ff941aa3c592c482be3d6a2bfe6f06afafa6af2353e3 \
     --hash=sha256:a316b197a543fd036209d0caba7a8eb4d236d8e65381c80cbc6d7efaa7606d63
-    # via -r .kokoro/requirements.in
+    # via -r requirements.in
 google-api-core==2.10.2 \
     --hash=sha256:10c06f7739fe57781f87523375e8e1a3a4674bf6392cd6131a3222182b971320 \
     --hash=sha256:34f24bd1d5f72a8c4519773d99ca6bf080a6c4e041b4e9f024fe230191dda62e
@@ -353,8 +357,7 @@ importlib-metadata==5.0.0 \
     --hash=sha256:da31db32b304314d044d3c12c79bd59e307889b287ad12ff387b3500835fc2ab \
     --hash=sha256:ddb0e35065e8938f867ed4928d0ae5bf2a53b7773871bfe6bcc7e4fcdc7dea43
     # via
-    #   -r .kokoro/requirements.in
-    #   keyring
+    #   -r requirements.in
     #   twine
 jaraco-classes==3.2.3 \
     --hash=sha256:2353de3288bc6b82120752201c6b1c1a14b058267fa424ed5ce5984e3b922158 \
@@ -376,7 +379,7 @@ keyring==23.9.3 \
     # via
     #   gcp-releasetool
     #   twine
-MarkupSafe==2.1.3 \
+markupsafe==2.1.3 \
     --hash=sha256:05fb21170423db021895e1ea1e1f3ab3adb85d1c2333cbc2310f2a26bc77272e \
     --hash=sha256:0a4e4a1aff6c7ac4cd55792abf96c915634c2b97e3cc1c7129578aa68ebd754e \
     --hash=sha256:10bbfe99883db80bdbaff2dcf681dfc6533a614f700da1287707e8a5d78a8431 \
@@ -445,7 +448,7 @@ more-itertools==8.14.0 \
 nox==2022.8.7 \
     --hash=sha256:1b894940551dc5c389f9271d197ca5d655d40bdc6ccf93ed6880e4042760a34b \
     --hash=sha256:96cca88779e08282a699d672258ec01eb7c792d35bbbf538c723172bce23212c
-    # via -r .kokoro/requirements.in
+    # via -r requirements.in
 packaging==21.3 \
     --hash=sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb \
     --hash=sha256:ef103e05f519cdc783ae24ea4e2e0f508a9c99b2d4969652eed6a2e1ea5bd522
@@ -571,13 +574,11 @@ six==1.16.0 \
 twine==4.0.1 \
     --hash=sha256:42026c18e394eac3e06693ee52010baa5313e4811d5a11050e7d48436cf41b9e \
     --hash=sha256:96b1cf12f7ae611a4a40b6ae8e9570215daff0611828f5fe1f37a16255ab24a0
-    # via -r .kokoro/requirements.in
+    # via -r requirements.in
 typing-extensions==4.8.0 \
     --hash=sha256:8f92fc8806f9a6b641eaa5318da32b44d401efaac0f6678c9bc448ba3605faa0 \
     --hash=sha256:df8e4339e9cb77357558cbdbceca33c303714cf861d1eef15e1070055ae8b7ef
-    # via
-    #   -r .kokoro/requirements.in
-    #   rich
+    # via -r requirements.in
 urllib3==1.26.18 \
     --hash=sha256:34b97092d7e0a3a8cf7cd10e386f401b3737364026c45e622aa02903dffe0f07 \
     --hash=sha256:f8ecc1bba5667413457c529ab955bf8c67b45db799d159066261719e328580a0
@@ -595,7 +596,7 @@ webencodings==0.5.1 \
 wheel==0.38.1 \
     --hash=sha256:7a95f9a8dc0924ef318bd55b616112c70903192f524d120acc614f59547a9e1f \
     --hash=sha256:ea041edf63f4ccba53ad6e035427997b3bb10ee88a4cd014ae82aeb9eea77bb9
-    # via -r .kokoro/requirements.in
+    # via -r requirements.in
 zipp==3.8.1 \
     --hash=sha256:05b45f1ee8f807d0cc928485ca40a07cb491cf092ff587c0df9cb1fd154848d2 \
     --hash=sha256:47c40d7fe183a6f21403a199b3e4192cca5774656965b0a4988ad2f8feb5f009

From 8081be74d5f46b0f64d021c68617a87412e4a049 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 10:20:09 +0100
Subject: [PATCH 004/133] chore(deps): update dependency zipp to v3.19.1
 [security] (#408)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 9b7161d8..c689c802 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -597,9 +597,9 @@ wheel==0.38.1 \
     --hash=sha256:7a95f9a8dc0924ef318bd55b616112c70903192f524d120acc614f59547a9e1f \
     --hash=sha256:ea041edf63f4ccba53ad6e035427997b3bb10ee88a4cd014ae82aeb9eea77bb9
     # via -r requirements.in
-zipp==3.8.1 \
-    --hash=sha256:05b45f1ee8f807d0cc928485ca40a07cb491cf092ff587c0df9cb1fd154848d2 \
-    --hash=sha256:47c40d7fe183a6f21403a199b3e4192cca5774656965b0a4988ad2f8feb5f009
+zipp==3.19.1 \
+    --hash=sha256:2828e64edb5386ea6a52e7ba7cdb17bb30a73a858f5eb6eb93d8d36f5ea26091 \
+    --hash=sha256:35427f6d5594f4acf82d25541438348c26736fa9b3afa2754bcd63cdb99d8e8f
     # via importlib-metadata
 
 # WARNING: The following packages were not pinned, but pip requires them to be

From b60f5143fe5050d48e2c8fc4667eae1c854a4b13 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 11:03:33 +0100
Subject: [PATCH 005/133] chore(deps): update dependency certifi to v2024
 [security] (#406)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index c689c802..3e8023f4 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -20,9 +20,9 @@ cachetools==5.2.0 \
     --hash=sha256:6a94c6402995a99c3970cc7e4884bb60b4a8639938157eeed436098bf9831757 \
     --hash=sha256:f9f17d2aec496a9aa6b76f53e3b614c965223c061982d434d160f930c698a9db
     # via google-auth
-certifi==2023.7.22 \
-    --hash=sha256:539cc1d13202e33ca466e88b2807e29f4c13049d6d87031a3c110744495cb082 \
-    --hash=sha256:92d6037539857d8206b8f6ae472e8b77db8058fec5937a1ef3f54304089edbb9
+certifi==2024.7.4 \
+    --hash=sha256:5a1e7645bc0ec61a09e26c36f6106dd4cf40c6db3a1fb6352b0244e7fb057c7b \
+    --hash=sha256:c198e21b1289c2ab85ee4e67bb4b4ef3ead0892059901a8d5b622f24a1101e90
     # via requests
 cffi==1.15.1 \
     --hash=sha256:00a9ed42e88df81ffae7a8ab6d9356b371399b91dbdf0c3cb1e84c03a13aceb5 \

From 65ca047e61964957082d7de8043b1464940f1c71 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Thu, 31 Oct 2024 11:25:51 +0100
Subject: [PATCH 006/133] test: add tests with mock server (#414)

* deps: update all deps

* chore: update tests

* chore: run code formatter

* chore: ignore warning

* chore: make script work on Python 3.8

* chore: install setuptools

* test: add tests with mock server

* test: add more tests

* fix: use base64 encoding for transaction id

* fix: create mock server db config

* fix: replace double with single quotes
---
 .github/workflows/test_suite.yml              |   15 +
 create_test_config.py                         |   29 +-
 .../sqlalchemy_spanner/sqlalchemy_spanner.py  |   25 +-
 noxfile.py                                    |   24 +
 test/mockserver_tests/__init__.py             |    0
 test/mockserver_tests/mock_database_admin.py  |   38 +
 .../mockserver_tests/mock_server_test_base.py |  125 ++
 test/mockserver_tests/mock_spanner.py         |  217 +++
 test/mockserver_tests/quickstart_model.py     |   50 +
 .../spanner_database_admin_pb2_grpc.py        | 1269 +++++++++++++++++
 test/mockserver_tests/spanner_pb2_grpc.py     |  884 ++++++++++++
 test/mockserver_tests/test_basics.py          |  129 ++
 test/mockserver_tests/test_quickstart.py      |  125 ++
 13 files changed, 2923 insertions(+), 7 deletions(-)
 create mode 100644 test/mockserver_tests/__init__.py
 create mode 100644 test/mockserver_tests/mock_database_admin.py
 create mode 100644 test/mockserver_tests/mock_server_test_base.py
 create mode 100644 test/mockserver_tests/mock_spanner.py
 create mode 100644 test/mockserver_tests/quickstart_model.py
 create mode 100644 test/mockserver_tests/spanner_database_admin_pb2_grpc.py
 create mode 100644 test/mockserver_tests/spanner_pb2_grpc.py
 create mode 100644 test/mockserver_tests/test_basics.py
 create mode 100644 test/mockserver_tests/test_quickstart.py

diff --git a/.github/workflows/test_suite.yml b/.github/workflows/test_suite.yml
index 518325f0..d79b89dd 100644
--- a/.github/workflows/test_suite.yml
+++ b/.github/workflows/test_suite.yml
@@ -38,6 +38,21 @@ jobs:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: appdev-soda-spanner-staging
 
+  mockserver:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.12
+      - name: Install nox
+        run: python -m pip install nox
+      - name: Run mockserver tests
+        run: nox -s mockserver
+
   compliance_tests_13:
     runs-on: ubuntu-latest
 
diff --git a/create_test_config.py b/create_test_config.py
index 19b46d49..7ef6f255 100644
--- a/create_test_config.py
+++ b/create_test_config.py
@@ -18,12 +18,19 @@
 import sys
 
 
-def set_test_config(project, instance):
+def set_test_config(project, instance, user=None, password=None, host=None, port=None):
     config = configparser.ConfigParser()
-    url = (
-        f"spanner+spanner:///projects/{project}/instances/{instance}/"
-        "databases/compliance-test"
-    )
+    if user is not None and password is not None and host is not None and port is not None:
+        url = (
+            f"spanner+spanner://{user}:{password}@{host}:{port}"
+            f"/projects/{project}/instances/{instance}/"
+            "databases/compliance-test"
+        )
+    else:
+        url = (
+            f"spanner+spanner:///projects/{project}/instances/{instance}/"
+            "databases/compliance-test"
+        )
     config.add_section("db")
     config["db"]["default"] = url
 
@@ -34,7 +41,17 @@ def set_test_config(project, instance):
 def main(argv):
     project = argv[0]
     instance = argv[1]
-    set_test_config(project, instance)
+    if len(argv) == 6:
+        user = argv[2]
+        password = argv[3]
+        host = argv[4]
+        port = argv[5]
+    else:
+        user = None
+        password = None
+        host = None
+        port = None
+    set_test_config(project, instance, user, password, host, port)
 
 
 if __name__ == "__main__":
diff --git a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
index 168de44d..6754931a 100644
--- a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
+++ b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
@@ -22,6 +22,9 @@
     alter_table,
     format_type,
 )
+from google.api_core.client_options import ClientOptions
+from google.auth.credentials import AnonymousCredentials
+from google.cloud.spanner_v1 import Client
 from sqlalchemy.exc import NoSuchTableError
 from sqlalchemy.sql import elements
 from sqlalchemy import ForeignKeyConstraint, types
@@ -709,9 +712,29 @@ def create_connect_args(self, url):
             url.database,
         )
         dist = pkg_resources.get_distribution("sqlalchemy-spanner")
+        options = {"user_agent": f"gl-{dist.project_name}/{dist.version}"}
+        connect_opts = url.translate_connect_args()
+        if (
+            "host" in connect_opts
+            and "port" in connect_opts
+            and "password" in connect_opts
+        ):
+            # Create a test client that connects to a local Spanner (mock) server.
+            if (
+                connect_opts["host"] == "localhost"
+                and connect_opts["password"] == "AnonymousCredentials"
+            ):
+                client = Client(
+                    project=match.group("project"),
+                    credentials=AnonymousCredentials(),
+                    client_options=ClientOptions(
+                        api_endpoint=f"{connect_opts['host']}:{connect_opts['port']}",
+                    ),
+                )
+                options["client"] = client
         return (
             [match.group("instance"), match.group("database"), match.group("project")],
-            {"user_agent": f"gl-{dist.project_name}/{dist.version}"},
+            options,
         )
 
     @engine_to_connection
diff --git a/noxfile.py b/noxfile.py
index 80713b16..eff6bfc9 100644
--- a/noxfile.py
+++ b/noxfile.py
@@ -267,6 +267,30 @@ def unit(session):
     session.run("py.test", "--quiet", os.path.join("test/unit"), *session.posargs)
 
 
+@nox.session(python=DEFAULT_PYTHON_VERSION_FOR_SQLALCHEMY_20)
+def mockserver(session):
+    """Run mockserver tests."""
+    # Run SQLAlchemy dialect tests using an in-mem mocked Spanner server.
+    session.install("setuptools")
+    session.install("pytest")
+    session.install("mock")
+    session.install(".")
+    session.install("sqlalchemy>=2.0")
+    session.run(
+        "python",
+        "create_test_config.py",
+        "my-project",
+        "my-instance",
+        "none",
+        "AnonymousCredentials",
+        "localhost",
+        "9999",
+    )
+    session.run(
+        "py.test", "--quiet", os.path.join("test/mockserver_tests"), *session.posargs
+    )
+
+
 @nox.session(python=DEFAULT_PYTHON_VERSION)
 def migration_test(session):
     """Test migrations with SQLAlchemy v1.3.11+ and Alembic"""
diff --git a/test/mockserver_tests/__init__.py b/test/mockserver_tests/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/test/mockserver_tests/mock_database_admin.py b/test/mockserver_tests/mock_database_admin.py
new file mode 100644
index 00000000..acd739c8
--- /dev/null
+++ b/test/mockserver_tests/mock_database_admin.py
@@ -0,0 +1,38 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 google.protobuf import empty_pb2
+import test.mockserver_tests.spanner_database_admin_pb2_grpc as database_admin_grpc
+from google.longrunning import operations_pb2 as operations_pb2
+
+
+# An in-memory mock DatabaseAdmin server that can be used for testing.
+class DatabaseAdminServicer(database_admin_grpc.DatabaseAdminServicer):
+    def __init__(self):
+        self._requests = []
+
+    @property
+    def requests(self):
+        return self._requests
+
+    def clear_requests(self):
+        self._requests = []
+
+    def UpdateDatabaseDdl(self, request, context):
+        self._requests.append(request)
+        operation = operations_pb2.Operation()
+        operation.done = True
+        operation.name = "projects/test-project/operations/test-operation"
+        operation.response.Pack(empty_pb2.Empty())
+        return operation
diff --git a/test/mockserver_tests/mock_server_test_base.py b/test/mockserver_tests/mock_server_test_base.py
new file mode 100644
index 00000000..71e1bf1f
--- /dev/null
+++ b/test/mockserver_tests/mock_server_test_base.py
@@ -0,0 +1,125 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import Engine, create_engine
+from sqlalchemy.testing.plugin.plugin_base import fixtures
+import google.cloud.spanner_v1.types.type as spanner_type
+import google.cloud.spanner_v1.types.result_set as result_set
+from google.api_core.client_options import ClientOptions
+from google.auth.credentials import AnonymousCredentials
+from google.cloud.spanner_v1 import (
+    Client,
+    ResultSet,
+    PingingPool,
+)
+from google.cloud.spanner_v1.database import Database
+from google.cloud.spanner_v1.instance import Instance
+import grpc
+
+# TODO: Replace this with the mock server in the Spanner client lib
+from test.mockserver_tests.mock_spanner import SpannerServicer, start_mock_server
+from test.mockserver_tests.mock_database_admin import DatabaseAdminServicer
+
+
+def add_result(sql: str, result: ResultSet):
+    MockServerTestBase.spanner_service.mock_spanner.add_result(sql, result)
+
+
+def add_select1_result():
+    result = result_set.ResultSet(
+        dict(
+            metadata=result_set.ResultSetMetadata(
+                dict(
+                    row_type=spanner_type.StructType(
+                        dict(
+                            fields=[
+                                spanner_type.StructType.Field(
+                                    dict(
+                                        name="c",
+                                        type=spanner_type.Type(
+                                            dict(code=spanner_type.TypeCode.INT64)
+                                        ),
+                                    )
+                                )
+                            ]
+                        )
+                    )
+                )
+            ),
+        )
+    )
+    result.rows.extend(["1"])
+    MockServerTestBase.spanner_service.mock_spanner.add_result("select 1", result)
+
+
+class MockServerTestBase(fixtures.TestBase):
+    server: grpc.Server = None
+    spanner_service: SpannerServicer = None
+    database_admin_service: DatabaseAdminServicer = None
+    port: int = None
+
+    @classmethod
+    def setup_class(cls):
+        (
+            MockServerTestBase.server,
+            MockServerTestBase.spanner_service,
+            MockServerTestBase.database_admin_service,
+            MockServerTestBase.port,
+        ) = start_mock_server()
+
+    @classmethod
+    def teardown_class(cls):
+        if MockServerTestBase.server is not None:
+            MockServerTestBase.server.stop(grace=None)
+            MockServerTestBase.server = None
+
+    def setup_method(self):
+        self._client = None
+        self._instance = None
+        self._database = None
+
+    def teardown_method(self):
+        MockServerTestBase.spanner_service.clear_requests()
+        MockServerTestBase.database_admin_service.clear_requests()
+
+    def create_engine(self) -> Engine:
+        return create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": PingingPool(size=10)},
+        )
+
+    @property
+    def client(self) -> Client:
+        if self._client is None:
+            self._client = Client(
+                project="p",
+                credentials=AnonymousCredentials(),
+                client_options=ClientOptions(
+                    api_endpoint="localhost:" + str(MockServerTestBase.port),
+                ),
+            )
+        return self._client
+
+    @property
+    def instance(self) -> Instance:
+        if self._instance is None:
+            self._instance = self.client.instance("test-instance")
+        return self._instance
+
+    @property
+    def database(self) -> Database:
+        if self._database is None:
+            self._database = self.instance.database(
+                "test-database", pool=PingingPool(size=10)
+            )
+        return self._database
diff --git a/test/mockserver_tests/mock_spanner.py b/test/mockserver_tests/mock_spanner.py
new file mode 100644
index 00000000..db189144
--- /dev/null
+++ b/test/mockserver_tests/mock_spanner.py
@@ -0,0 +1,217 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 google.cloud.spanner_v1 import TransactionOptions, ResultSetMetadata
+from google.protobuf import empty_pb2
+import test.mockserver_tests.spanner_pb2_grpc as spanner_grpc
+import test.mockserver_tests.spanner_database_admin_pb2_grpc as database_admin_grpc
+from test.mockserver_tests.mock_database_admin import DatabaseAdminServicer
+import google.cloud.spanner_v1.types.result_set as result_set
+import google.cloud.spanner_v1.types.transaction as transaction
+import google.cloud.spanner_v1.types.commit_response as commit
+import google.cloud.spanner_v1.types.spanner as spanner
+from concurrent import futures
+import grpc
+import base64
+
+
+class MockSpanner:
+    def __init__(self):
+        self.results = {}
+
+    def add_result(self, sql: str, result: result_set.ResultSet):
+        self.results[sql.lower().strip()] = result
+
+    def get_result(self, sql: str) -> result_set.ResultSet:
+        result = self.results.get(sql.lower().strip())
+        if result is None:
+            raise ValueError(f"No result found for {sql}")
+        return result
+
+    def get_result_as_partial_result_sets(
+        self, sql: str
+    ) -> [result_set.PartialResultSet]:
+        result: result_set.ResultSet = self.get_result(sql)
+        partials = []
+        first = True
+        if len(result.rows) == 0:
+            partial = result_set.PartialResultSet()
+            partial.metadata = result.metadata
+            partials.append(partial)
+        else:
+            for row in result.rows:
+                partial = result_set.PartialResultSet()
+                if first:
+                    partial.metadata = result.metadata
+                partial.values.extend(row)
+                partials.append(partial)
+        partials[len(partials) - 1].stats = result.stats
+        return partials
+
+
+# An in-memory mock Spanner server that can be used for testing.
+class SpannerServicer(spanner_grpc.SpannerServicer):
+    def __init__(self):
+        self._requests = []
+        self.session_counter = 0
+        self.sessions = {}
+        self.transaction_counter = 0
+        self.transactions = {}
+        self._mock_spanner = MockSpanner()
+
+    @property
+    def mock_spanner(self):
+        return self._mock_spanner
+
+    @property
+    def requests(self):
+        return self._requests
+
+    def clear_requests(self):
+        self._requests = []
+
+    def CreateSession(self, request, context):
+        self._requests.append(request)
+        return self.__create_session(request.database, request.session)
+
+    def BatchCreateSessions(self, request, context):
+        self._requests.append(request)
+        sessions = []
+        for i in range(request.session_count):
+            sessions.append(
+                self.__create_session(request.database, request.session_template)
+            )
+        return spanner.BatchCreateSessionsResponse(dict(session=sessions))
+
+    def __create_session(self, database: str, session_template: spanner.Session):
+        self.session_counter += 1
+        session = spanner.Session()
+        session.name = database + "/sessions/" + str(self.session_counter)
+        session.multiplexed = session_template.multiplexed
+        session.labels.MergeFrom(session_template.labels)
+        session.creator_role = session_template.creator_role
+        self.sessions[session.name] = session
+        return session
+
+    def GetSession(self, request, context):
+        self._requests.append(request)
+        return spanner.Session()
+
+    def ListSessions(self, request, context):
+        self._requests.append(request)
+        return [spanner.Session()]
+
+    def DeleteSession(self, request, context):
+        self._requests.append(request)
+        return empty_pb2.Empty()
+
+    def ExecuteSql(self, request, context):
+        self._requests.append(request)
+        return result_set.ResultSet()
+
+    def ExecuteStreamingSql(self, request, context):
+        self._requests.append(request)
+        partials = self.mock_spanner.get_result_as_partial_result_sets(request.sql)
+        for result in partials:
+            yield result
+
+    def ExecuteBatchDml(self, request, context):
+        self._requests.append(request)
+        response = spanner.ExecuteBatchDmlResponse()
+        started_transaction = None
+        if not request.transaction.begin == TransactionOptions():
+            started_transaction = self.__create_transaction(
+                request.session, request.transaction.begin
+            )
+        first = True
+        for statement in request.statements:
+            result = self.mock_spanner.get_result(statement.sql)
+            if first and started_transaction is not None:
+                result = result_set.ResultSet(
+                    self.mock_spanner.get_result(statement.sql)
+                )
+                result.metadata = ResultSetMetadata(result.metadata)
+                result.metadata.transaction = started_transaction
+            response.result_sets.append(result)
+        return response
+
+    def Read(self, request, context):
+        self._requests.append(request)
+        return result_set.ResultSet()
+
+    def StreamingRead(self, request, context):
+        self._requests.append(request)
+        for result in [result_set.PartialResultSet(), result_set.PartialResultSet()]:
+            yield result
+
+    def BeginTransaction(self, request, context):
+        self._requests.append(request)
+        return self.__create_transaction(request.session, request.options)
+
+    def __create_transaction(
+        self, session: str, options: TransactionOptions
+    ) -> transaction.Transaction:
+        session = self.sessions[session]
+        if session is None:
+            raise ValueError(f"Session not found: {session}")
+        self.transaction_counter += 1
+        id_bytes = bytes(
+            f"{session.name}/transactions/{self.transaction_counter}", "UTF-8"
+        )
+        transaction_id = base64.urlsafe_b64encode(id_bytes)
+        self.transactions[transaction_id] = options
+        return transaction.Transaction(dict(id=transaction_id))
+
+    def Commit(self, request, context):
+        self._requests.append(request)
+        tx = self.transactions[request.transaction_id]
+        if tx is None:
+            raise ValueError(f"Transaction not found: {request.transaction_id}")
+        del self.transactions[request.transaction_id]
+        return commit.CommitResponse()
+
+    def Rollback(self, request, context):
+        self._requests.append(request)
+        return empty_pb2.Empty()
+
+    def PartitionQuery(self, request, context):
+        self._requests.append(request)
+        return spanner.PartitionResponse()
+
+    def PartitionRead(self, request, context):
+        self._requests.append(request)
+        return spanner.PartitionResponse()
+
+    def BatchWrite(self, request, context):
+        self._requests.append(request)
+        for result in [spanner.BatchWriteResponse(), spanner.BatchWriteResponse()]:
+            yield result
+
+
+def start_mock_server() -> (grpc.Server, SpannerServicer, DatabaseAdminServicer, int):
+    # Create a gRPC server.
+    spanner_server = grpc.server(futures.ThreadPoolExecutor(max_workers=10))
+
+    # Add the Spanner services to the gRPC server.
+    spanner_servicer = SpannerServicer()
+    spanner_grpc.add_SpannerServicer_to_server(spanner_servicer, spanner_server)
+    database_admin_servicer = DatabaseAdminServicer()
+    database_admin_grpc.add_DatabaseAdminServicer_to_server(
+        database_admin_servicer, spanner_server
+    )
+
+    # Start the server on a random port.
+    port = spanner_server.add_insecure_port("[::]:0")
+    spanner_server.start()
+    return spanner_server, spanner_servicer, database_admin_servicer, port
diff --git a/test/mockserver_tests/quickstart_model.py b/test/mockserver_tests/quickstart_model.py
new file mode 100644
index 00000000..ccfa22d7
--- /dev/null
+++ b/test/mockserver_tests/quickstart_model.py
@@ -0,0 +1,50 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 typing import List
+from typing import Optional
+from sqlalchemy import ForeignKey
+from sqlalchemy import String
+from sqlalchemy.orm import DeclarativeBase
+from sqlalchemy.orm import Mapped
+from sqlalchemy.orm import mapped_column
+from sqlalchemy.orm import relationship
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class User(Base):
+    __tablename__ = "user_account"
+    id: Mapped[int] = mapped_column(primary_key=True)
+    name: Mapped[str] = mapped_column(String(30))
+    fullname: Mapped[Optional[str]]
+    addresses: Mapped[List["Address"]] = relationship(
+        back_populates="user", cascade="all, delete-orphan"
+    )
+
+    def __repr__(self) -> str:
+        return f"User(id={self.id!r}, name={self.name!r}, fullname={self.fullname!r})"
+
+
+class Address(Base):
+    __tablename__ = "address"
+    id: Mapped[int] = mapped_column(primary_key=True)
+    email_address: Mapped[str]
+    user_id: Mapped[int] = mapped_column(ForeignKey("user_account.id"))
+    user: Mapped["User"] = relationship(back_populates="addresses")
+
+    def __repr__(self) -> str:
+        return f"Address(id={self.id!r}, email_address={self.email_address!r})"
diff --git a/test/mockserver_tests/spanner_database_admin_pb2_grpc.py b/test/mockserver_tests/spanner_database_admin_pb2_grpc.py
new file mode 100644
index 00000000..6798f8d9
--- /dev/null
+++ b/test/mockserver_tests/spanner_database_admin_pb2_grpc.py
@@ -0,0 +1,1269 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+
+
+# Generated with the following commands:
+#
+# pip install grpcio-tools
+# git clone git@github.com:googleapis/googleapis.git
+# cd googleapis
+# python -m grpc_tools.protoc \
+#     -I . \
+#     --python_out=. --pyi_out=. --grpc_python_out=. \
+#     ./google/spanner/admin/database/v1/*.proto
+
+# flake8: noqa
+
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.cloud.spanner_admin_database_v1.types import (
+    backup as google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2,
+)
+from google.cloud.spanner_admin_database_v1.types import (
+    backup_schedule as google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2,
+)
+from google.cloud.spanner_admin_database_v1.types import (
+    spanner_database_admin as google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2,
+)
+
+GRPC_GENERATED_VERSION = "1.67.0"
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+
+    _version_not_supported = first_version_is_lower(
+        GRPC_VERSION, GRPC_GENERATED_VERSION
+    )
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f"The grpc package installed is at version {GRPC_VERSION},"
+        + f" but the generated code in google/spanner/admin/database/v1/spanner_database_admin_pb2_grpc.py depends on"
+        + f" grpcio>={GRPC_GENERATED_VERSION}."
+        + f" Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}"
+        + f" or downgrade your generated code using grpcio-tools<={GRPC_VERSION}."
+    )
+
+
+class DatabaseAdminServicer(object):
+    """Cloud Spanner Database Admin API
+
+    The Cloud Spanner Database Admin API can be used to:
+    * create, drop, and list databases
+    * update the schema of pre-existing databases
+    * create, delete, copy and list backups for a database
+    * restore a database from an existing backup
+    """
+
+    def ListDatabases(self, request, context):
+        """Lists Cloud Spanner databases."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateDatabase(self, request, context):
+        """Creates a new Cloud Spanner database and starts to prepare it for serving.
+        The returned [long-running operation][google.longrunning.Operation] will
+        have a name of the format `<database_name>/operations/<operation_id>` and
+        can be used to track preparation of the database. The
+        [metadata][google.longrunning.Operation.metadata] field type is
+        [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
+        The [response][google.longrunning.Operation.response] field type is
+        [Database][google.spanner.admin.database.v1.Database], if successful.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDatabase(self, request, context):
+        """Gets the state of a Cloud Spanner database."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDatabase(self, request, context):
+        """Updates a Cloud Spanner database. The returned
+        [long-running operation][google.longrunning.Operation] can be used to track
+        the progress of updating the database. If the named database does not
+        exist, returns `NOT_FOUND`.
+
+        While the operation is pending:
+
+        * The database's
+        [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+        field is set to true.
+        * Cancelling the operation is best-effort. If the cancellation succeeds,
+        the operation metadata's
+        [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
+        is set, the updates are reverted, and the operation terminates with a
+        `CANCELLED` status.
+        * New UpdateDatabase requests will return a `FAILED_PRECONDITION` error
+        until the pending operation is done (returns successfully or with
+        error).
+        * Reading the database via the API continues to give the pre-request
+        values.
+
+        Upon completion of the returned operation:
+
+        * The new values are in effect and readable via the API.
+        * The database's
+        [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+        field becomes false.
+
+        The returned [long-running operation][google.longrunning.Operation] will
+        have a name of the format
+        `projects/<project>/instances/<instance>/databases/<database>/operations/<operation_id>`
+        and can be used to track the database modification. The
+        [metadata][google.longrunning.Operation.metadata] field type is
+        [UpdateDatabaseMetadata][google.spanner.admin.database.v1.UpdateDatabaseMetadata].
+        The [response][google.longrunning.Operation.response] field type is
+        [Database][google.spanner.admin.database.v1.Database], if successful.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDatabaseDdl(self, request, context):
+        """Updates the schema of a Cloud Spanner database by
+        creating/altering/dropping tables, columns, indexes, etc. The returned
+        [long-running operation][google.longrunning.Operation] will have a name of
+        the format `<database_name>/operations/<operation_id>` and can be used to
+        track execution of the schema change(s). The
+        [metadata][google.longrunning.Operation.metadata] field type is
+        [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
+        The operation has no response.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DropDatabase(self, request, context):
+        """Drops (aka deletes) a Cloud Spanner database.
+        Completed backups for the database will be retained according to their
+        `expire_time`.
+        Note: Cloud Spanner might continue to accept requests for a few seconds
+        after the database has been deleted.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDatabaseDdl(self, request, context):
+        """Returns the schema of a Cloud Spanner database as a list of formatted
+        DDL statements. This method does not show pending schema updates, those may
+        be queried using the [Operations][google.longrunning.Operations] API.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """Sets the access control policy on a database or backup resource.
+        Replaces any existing policy.
+
+        Authorization requires `spanner.databases.setIamPolicy`
+        permission on [resource][google.iam.v1.SetIamPolicyRequest.resource].
+        For backups, authorization requires `spanner.backups.setIamPolicy`
+        permission on [resource][google.iam.v1.SetIamPolicyRequest.resource].
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """Gets the access control policy for a database or backup resource.
+        Returns an empty policy if a database or backup exists but does not have a
+        policy set.
+
+        Authorization requires `spanner.databases.getIamPolicy` permission on
+        [resource][google.iam.v1.GetIamPolicyRequest.resource].
+        For backups, authorization requires `spanner.backups.getIamPolicy`
+        permission on [resource][google.iam.v1.GetIamPolicyRequest.resource].
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """Returns permissions that the caller has on the specified database or backup
+        resource.
+
+        Attempting this RPC on a non-existent Cloud Spanner database will
+        result in a NOT_FOUND error if the user has
+        `spanner.databases.list` permission on the containing Cloud
+        Spanner instance. Otherwise returns an empty set of permissions.
+        Calling this method on a backup that does not exist will
+        result in a NOT_FOUND error if the user has
+        `spanner.backups.list` permission on the containing instance.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateBackup(self, request, context):
+        """Starts creating a new Cloud Spanner Backup.
+        The returned backup [long-running operation][google.longrunning.Operation]
+        will have a name of the format
+        `projects/<project>/instances/<instance>/backups/<backup>/operations/<operation_id>`
+        and can be used to track creation of the backup. The
+        [metadata][google.longrunning.Operation.metadata] field type is
+        [CreateBackupMetadata][google.spanner.admin.database.v1.CreateBackupMetadata].
+        The [response][google.longrunning.Operation.response] field type is
+        [Backup][google.spanner.admin.database.v1.Backup], if successful.
+        Cancelling the returned operation will stop the creation and delete the
+        backup. There can be only one pending backup creation per database. Backup
+        creation of different databases can run concurrently.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CopyBackup(self, request, context):
+        """Starts copying a Cloud Spanner Backup.
+        The returned backup [long-running operation][google.longrunning.Operation]
+        will have a name of the format
+        `projects/<project>/instances/<instance>/backups/<backup>/operations/<operation_id>`
+        and can be used to track copying of the backup. The operation is associated
+        with the destination backup.
+        The [metadata][google.longrunning.Operation.metadata] field type is
+        [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata].
+        The [response][google.longrunning.Operation.response] field type is
+        [Backup][google.spanner.admin.database.v1.Backup], if successful.
+        Cancelling the returned operation will stop the copying and delete the
+        destination backup. Concurrent CopyBackup requests can run on the same
+        source backup.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetBackup(self, request, context):
+        """Gets metadata on a pending or completed
+        [Backup][google.spanner.admin.database.v1.Backup].
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateBackup(self, request, context):
+        """Updates a pending or completed
+        [Backup][google.spanner.admin.database.v1.Backup].
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteBackup(self, request, context):
+        """Deletes a pending or completed
+        [Backup][google.spanner.admin.database.v1.Backup].
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListBackups(self, request, context):
+        """Lists completed and pending backups.
+        Backups returned are ordered by `create_time` in descending order,
+        starting from the most recent `create_time`.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RestoreDatabase(self, request, context):
+        """Create a new database by restoring from a completed backup. The new
+        database must be in the same project and in an instance with the same
+        instance configuration as the instance containing
+        the backup. The returned database [long-running
+        operation][google.longrunning.Operation] has a name of the format
+        `projects/<project>/instances/<instance>/databases/<database>/operations/<operation_id>`,
+        and can be used to track the progress of the operation, and to cancel it.
+        The [metadata][google.longrunning.Operation.metadata] field type is
+        [RestoreDatabaseMetadata][google.spanner.admin.database.v1.RestoreDatabaseMetadata].
+        The [response][google.longrunning.Operation.response] type
+        is [Database][google.spanner.admin.database.v1.Database], if
+        successful. Cancelling the returned operation will stop the restore and
+        delete the database.
+        There can be only one database being restored into an instance at a time.
+        Once the restore operation completes, a new restore operation can be
+        initiated, without waiting for the optimize operation associated with the
+        first restore to complete.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDatabaseOperations(self, request, context):
+        """Lists database [longrunning-operations][google.longrunning.Operation].
+        A database operation has a name of the form
+        `projects/<project>/instances/<instance>/databases/<database>/operations/<operation>`.
+        The long-running operation
+        [metadata][google.longrunning.Operation.metadata] field type
+        `metadata.type_url` describes the type of the metadata. Operations returned
+        include those that have completed/failed/canceled within the last 7 days,
+        and pending operations.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListBackupOperations(self, request, context):
+        """Lists the backup [long-running operations][google.longrunning.Operation] in
+        the given instance. A backup operation has a name of the form
+        `projects/<project>/instances/<instance>/backups/<backup>/operations/<operation>`.
+        The long-running operation
+        [metadata][google.longrunning.Operation.metadata] field type
+        `metadata.type_url` describes the type of the metadata. Operations returned
+        include those that have completed/failed/canceled within the last 7 days,
+        and pending operations. Operations returned are ordered by
+        `operation.metadata.value.progress.start_time` in descending order starting
+        from the most recently started operation.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDatabaseRoles(self, request, context):
+        """Lists Cloud Spanner database roles."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateBackupSchedule(self, request, context):
+        """Creates a new backup schedule."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetBackupSchedule(self, request, context):
+        """Gets backup schedule for the input schedule name."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateBackupSchedule(self, request, context):
+        """Updates a backup schedule."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteBackupSchedule(self, request, context):
+        """Deletes a backup schedule."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListBackupSchedules(self, request, context):
+        """Lists all the backup schedules for the database."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_DatabaseAdminServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListDatabases": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDatabases,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabasesRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabasesResponse.serialize,
+        ),
+        "CreateDatabase": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDatabase,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.CreateDatabaseRequest.deserialize,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetDatabase": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDatabase,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.GetDatabaseRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.Database.serialize,
+        ),
+        "UpdateDatabase": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDatabase,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.UpdateDatabaseRequest.deserialize,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "UpdateDatabaseDdl": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDatabaseDdl,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.UpdateDatabaseDdlRequest.deserialize,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DropDatabase": grpc.unary_unary_rpc_method_handler(
+            servicer.DropDatabase,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.DropDatabaseRequest.deserialize,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetDatabaseDdl": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDatabaseDdl,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.GetDatabaseDdlRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.GetDatabaseDdlResponse.serialize,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+        "CreateBackup": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateBackup,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.CreateBackupRequest.deserialize,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "CopyBackup": grpc.unary_unary_rpc_method_handler(
+            servicer.CopyBackup,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.CopyBackupRequest.deserialize,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetBackup": grpc.unary_unary_rpc_method_handler(
+            servicer.GetBackup,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.GetBackupRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.Backup.serialize,
+        ),
+        "UpdateBackup": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateBackup,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.UpdateBackupRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.Backup.serialize,
+        ),
+        "DeleteBackup": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteBackup,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.DeleteBackupRequest.deserialize,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListBackups": grpc.unary_unary_rpc_method_handler(
+            servicer.ListBackups,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.ListBackupsRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.ListBackupsResponse.serialize,
+        ),
+        "RestoreDatabase": grpc.unary_unary_rpc_method_handler(
+            servicer.RestoreDatabase,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.RestoreDatabaseRequest.deserialize,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ListDatabaseOperations": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDatabaseOperations,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabaseOperationsRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabaseOperationsResponse.serialize,
+        ),
+        "ListBackupOperations": grpc.unary_unary_rpc_method_handler(
+            servicer.ListBackupOperations,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.ListBackupOperationsRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.ListBackupOperationsResponse.serialize,
+        ),
+        "ListDatabaseRoles": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDatabaseRoles,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabaseRolesRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabaseRolesResponse.serialize,
+        ),
+        "CreateBackupSchedule": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateBackupSchedule,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.CreateBackupScheduleRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.BackupSchedule.serialize,
+        ),
+        "GetBackupSchedule": grpc.unary_unary_rpc_method_handler(
+            servicer.GetBackupSchedule,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.GetBackupScheduleRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.BackupSchedule.serialize,
+        ),
+        "UpdateBackupSchedule": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateBackupSchedule,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.UpdateBackupScheduleRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.BackupSchedule.serialize,
+        ),
+        "DeleteBackupSchedule": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteBackupSchedule,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.DeleteBackupScheduleRequest.deserialize,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListBackupSchedules": grpc.unary_unary_rpc_method_handler(
+            servicer.ListBackupSchedules,
+            request_deserializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.ListBackupSchedulesRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.ListBackupSchedulesResponse.serialize,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.spanner.admin.database.v1.DatabaseAdmin", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers(
+        "google.spanner.admin.database.v1.DatabaseAdmin", rpc_method_handlers
+    )
+
+
+# This class is part of an EXPERIMENTAL API.
+class DatabaseAdmin(object):
+    """Cloud Spanner Database Admin API
+
+    The Cloud Spanner Database Admin API can be used to:
+    * create, drop, and list databases
+    * update the schema of pre-existing databases
+    * create, delete, copy and list backups for a database
+    * restore a database from an existing backup
+    """
+
+    @staticmethod
+    def ListDatabases(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/ListDatabases",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabasesRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabasesResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def CreateDatabase(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/CreateDatabase",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.CreateDatabaseRequest.SerializeToString,
+            google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def GetDatabase(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/GetDatabase",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.GetDatabaseRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.Database.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def UpdateDatabase(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/UpdateDatabase",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.UpdateDatabaseRequest.SerializeToString,
+            google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def UpdateDatabaseDdl(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/UpdateDatabaseDdl",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.UpdateDatabaseDdlRequest.SerializeToString,
+            google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def DropDatabase(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/DropDatabase",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.DropDatabaseRequest.SerializeToString,
+            google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def GetDatabaseDdl(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/GetDatabaseDdl",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.GetDatabaseDdlRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.GetDatabaseDdlResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def SetIamPolicy(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/SetIamPolicy",
+            google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def GetIamPolicy(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/GetIamPolicy",
+            google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def TestIamPermissions(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/TestIamPermissions",
+            google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def CreateBackup(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/CreateBackup",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.CreateBackupRequest.SerializeToString,
+            google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def CopyBackup(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/CopyBackup",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.CopyBackupRequest.SerializeToString,
+            google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def GetBackup(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/GetBackup",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.GetBackupRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.Backup.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def UpdateBackup(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/UpdateBackup",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.UpdateBackupRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.Backup.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def DeleteBackup(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/DeleteBackup",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.DeleteBackupRequest.SerializeToString,
+            google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def ListBackups(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/ListBackups",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.ListBackupsRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.ListBackupsResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def RestoreDatabase(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/RestoreDatabase",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.RestoreDatabaseRequest.SerializeToString,
+            google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def ListDatabaseOperations(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/ListDatabaseOperations",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabaseOperationsRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabaseOperationsResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def ListBackupOperations(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/ListBackupOperations",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.ListBackupOperationsRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__pb2.ListBackupOperationsResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def ListDatabaseRoles(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/ListDatabaseRoles",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabaseRolesRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_spanner__database__admin__pb2.ListDatabaseRolesResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def CreateBackupSchedule(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/CreateBackupSchedule",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.CreateBackupScheduleRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.BackupSchedule.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def GetBackupSchedule(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/GetBackupSchedule",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.GetBackupScheduleRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.BackupSchedule.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def UpdateBackupSchedule(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/UpdateBackupSchedule",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.UpdateBackupScheduleRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.BackupSchedule.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def DeleteBackupSchedule(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/DeleteBackupSchedule",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.DeleteBackupScheduleRequest.SerializeToString,
+            google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def ListBackupSchedules(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.admin.database.v1.DatabaseAdmin/ListBackupSchedules",
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.ListBackupSchedulesRequest.SerializeToString,
+            google_dot_spanner_dot_admin_dot_database_dot_v1_dot_backup__schedule__pb2.ListBackupSchedulesResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
diff --git a/test/mockserver_tests/spanner_pb2_grpc.py b/test/mockserver_tests/spanner_pb2_grpc.py
new file mode 100644
index 00000000..da86ba18
--- /dev/null
+++ b/test/mockserver_tests/spanner_pb2_grpc.py
@@ -0,0 +1,884 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+
+# Generated with the following commands:
+#
+# pip install grpcio-tools
+# git clone git@github.com:googleapis/googleapis.git
+# cd googleapis
+# python -m grpc_tools.protoc \
+#     -I . \
+#     --python_out=. --pyi_out=. --grpc_python_out=. \
+#     ./google/spanner/v1/*.proto
+
+# flake8: noqa
+
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.cloud.spanner_v1.types import (
+    commit_response as google_dot_spanner_dot_v1_dot_commit__response__pb2,
+)
+from google.cloud.spanner_v1.types import (
+    result_set as google_dot_spanner_dot_v1_dot_result__set__pb2,
+)
+from google.cloud.spanner_v1.types import (
+    spanner as google_dot_spanner_dot_v1_dot_spanner__pb2,
+)
+from google.cloud.spanner_v1.types import (
+    transaction as google_dot_spanner_dot_v1_dot_transaction__pb2,
+)
+
+GRPC_GENERATED_VERSION = "1.67.0"
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+
+    _version_not_supported = first_version_is_lower(
+        GRPC_VERSION, GRPC_GENERATED_VERSION
+    )
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f"The grpc package installed is at version {GRPC_VERSION},"
+        + f" but the generated code in google/spanner/v1/spanner_pb2_grpc.py depends on"
+        + f" grpcio>={GRPC_GENERATED_VERSION}."
+        + f" Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}"
+        + f" or downgrade your generated code using grpcio-tools<={GRPC_VERSION}."
+    )
+
+
+class SpannerServicer(object):
+    """Cloud Spanner API
+
+    The Cloud Spanner API can be used to manage sessions and execute
+    transactions on data stored in Cloud Spanner databases.
+    """
+
+    def CreateSession(self, request, context):
+        """Creates a new session. A session can be used to perform
+        transactions that read and/or modify data in a Cloud Spanner database.
+        Sessions are meant to be reused for many consecutive
+        transactions.
+
+        Sessions can only execute one transaction at a time. To execute
+        multiple concurrent read-write/write-only transactions, create
+        multiple sessions. Note that standalone reads and queries use a
+        transaction internally, and count toward the one transaction
+        limit.
+
+        Active sessions use additional server resources, so it is a good idea to
+        delete idle and unneeded sessions.
+        Aside from explicit deletes, Cloud Spanner may delete sessions for which no
+        operations are sent for more than an hour. If a session is deleted,
+        requests to it return `NOT_FOUND`.
+
+        Idle sessions can be kept alive by sending a trivial SQL query
+        periodically, e.g., `"SELECT 1"`.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchCreateSessions(self, request, context):
+        """Creates multiple new sessions.
+
+        This API can be used to initialize a session cache on the clients.
+        See https://goo.gl/TgSFN2 for best practices on session cache management.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSession(self, request, context):
+        """Gets a session. Returns `NOT_FOUND` if the session does not exist.
+        This is mainly useful for determining whether a session is still
+        alive.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListSessions(self, request, context):
+        """Lists all sessions in a given database."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteSession(self, request, context):
+        """Ends a session, releasing server resources associated with it. This will
+        asynchronously trigger cancellation of any operations that are running with
+        this session.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExecuteSql(self, request, context):
+        """Executes an SQL statement, returning all results in a single reply. This
+        method cannot be used to return a result set larger than 10 MiB;
+        if the query yields more data than that, the query fails with
+        a `FAILED_PRECONDITION` error.
+
+        Operations inside read-write transactions might return `ABORTED`. If
+        this occurs, the application should restart the transaction from
+        the beginning. See [Transaction][google.spanner.v1.Transaction] for more
+        details.
+
+        Larger result sets can be fetched in streaming fashion by calling
+        [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
+        instead.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExecuteStreamingSql(self, request, context):
+        """Like [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], except returns the
+        result set as a stream. Unlike
+        [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], there is no limit on
+        the size of the returned result set. However, no individual row in the
+        result set can exceed 100 MiB, and no column value can exceed 10 MiB.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExecuteBatchDml(self, request, context):
+        """Executes a batch of SQL DML statements. This method allows many statements
+        to be run with lower latency than submitting them sequentially with
+        [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].
+
+        Statements are executed in sequential order. A request can succeed even if
+        a statement fails. The
+        [ExecuteBatchDmlResponse.status][google.spanner.v1.ExecuteBatchDmlResponse.status]
+        field in the response provides information about the statement that failed.
+        Clients must inspect this field to determine whether an error occurred.
+
+        Execution stops after the first failed statement; the remaining statements
+        are not executed.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Read(self, request, context):
+        """Reads rows from the database using key lookups and scans, as a
+        simple key/value style alternative to
+        [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].  This method cannot be
+        used to return a result set larger than 10 MiB; if the read matches more
+        data than that, the read fails with a `FAILED_PRECONDITION`
+        error.
+
+        Reads inside read-write transactions might return `ABORTED`. If
+        this occurs, the application should restart the transaction from
+        the beginning. See [Transaction][google.spanner.v1.Transaction] for more
+        details.
+
+        Larger result sets can be yielded in streaming fashion by calling
+        [StreamingRead][google.spanner.v1.Spanner.StreamingRead] instead.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StreamingRead(self, request, context):
+        """Like [Read][google.spanner.v1.Spanner.Read], except returns the result set
+        as a stream. Unlike [Read][google.spanner.v1.Spanner.Read], there is no
+        limit on the size of the returned result set. However, no individual row in
+        the result set can exceed 100 MiB, and no column value can exceed
+        10 MiB.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BeginTransaction(self, request, context):
+        """Begins a new transaction. This step can often be skipped:
+        [Read][google.spanner.v1.Spanner.Read],
+        [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
+        [Commit][google.spanner.v1.Spanner.Commit] can begin a new transaction as a
+        side-effect.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Commit(self, request, context):
+        """Commits a transaction. The request includes the mutations to be
+        applied to rows in the database.
+
+        `Commit` might return an `ABORTED` error. This can occur at any time;
+        commonly, the cause is conflicts with concurrent
+        transactions. However, it can also happen for a variety of other
+        reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
+        the transaction from the beginning, re-using the same session.
+
+        On very rare occasions, `Commit` might return `UNKNOWN`. This can happen,
+        for example, if the client job experiences a 1+ hour networking failure.
+        At that point, Cloud Spanner has lost track of the transaction outcome and
+        we recommend that you perform another read from the database to see the
+        state of things as they are now.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Rollback(self, request, context):
+        """Rolls back a transaction, releasing any locks it holds. It is a good
+        idea to call this for any transaction that includes one or more
+        [Read][google.spanner.v1.Spanner.Read] or
+        [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] requests and ultimately
+        decides not to commit.
+
+        `Rollback` returns `OK` if it successfully aborts the transaction, the
+        transaction was already aborted, or the transaction is not
+        found. `Rollback` never returns `ABORTED`.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PartitionQuery(self, request, context):
+        """Creates a set of partition tokens that can be used to execute a query
+        operation in parallel.  Each of the returned partition tokens can be used
+        by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to
+        specify a subset of the query result to read.  The same session and
+        read-only transaction must be used by the PartitionQueryRequest used to
+        create the partition tokens and the ExecuteSqlRequests that use the
+        partition tokens.
+
+        Partition tokens become invalid when the session used to create them
+        is deleted, is idle for too long, begins a new transaction, or becomes too
+        old.  When any of these happen, it is not possible to resume the query, and
+        the whole operation must be restarted from the beginning.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PartitionRead(self, request, context):
+        """Creates a set of partition tokens that can be used to execute a read
+        operation in parallel.  Each of the returned partition tokens can be used
+        by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a
+        subset of the read result to read.  The same session and read-only
+        transaction must be used by the PartitionReadRequest used to create the
+        partition tokens and the ReadRequests that use the partition tokens.  There
+        are no ordering guarantees on rows returned among the returned partition
+        tokens, or even within each individual StreamingRead call issued with a
+        partition_token.
+
+        Partition tokens become invalid when the session used to create them
+        is deleted, is idle for too long, begins a new transaction, or becomes too
+        old.  When any of these happen, it is not possible to resume the read, and
+        the whole operation must be restarted from the beginning.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchWrite(self, request, context):
+        """Batches the supplied mutation groups in a collection of efficient
+        transactions. All mutations in a group are committed atomically. However,
+        mutations across groups can be committed non-atomically in an unspecified
+        order and thus, they must be independent of each other. Partial failure is
+        possible, i.e., some groups may have been committed successfully, while
+        some may have failed. The results of individual batches are streamed into
+        the response as the batches are applied.
+
+        BatchWrite requests are not replay protected, meaning that each mutation
+        group may be applied more than once. Replays of non-idempotent mutations
+        may have undesirable effects. For example, replays of an insert mutation
+        may produce an already exists error or if you use generated or commit
+        timestamp-based keys, it may result in additional rows being added to the
+        mutation's table. We recommend structuring your mutation groups to be
+        idempotent to avoid this issue.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_SpannerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateSession": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSession,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.CreateSessionRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_spanner__pb2.Session.serialize,
+        ),
+        "BatchCreateSessions": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchCreateSessions,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.BatchCreateSessionsRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_spanner__pb2.BatchCreateSessionsResponse.serialize,
+        ),
+        "GetSession": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSession,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.GetSessionRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_spanner__pb2.Session.serialize,
+        ),
+        "ListSessions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListSessions,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.ListSessionsRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_spanner__pb2.ListSessionsResponse.serialize,
+        ),
+        "DeleteSession": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteSession,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.DeleteSessionRequest.deserialize,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ExecuteSql": grpc.unary_unary_rpc_method_handler(
+            servicer.ExecuteSql,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.ExecuteSqlRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_result__set__pb2.ResultSet.serialize,
+        ),
+        "ExecuteStreamingSql": grpc.unary_stream_rpc_method_handler(
+            servicer.ExecuteStreamingSql,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.ExecuteSqlRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_result__set__pb2.PartialResultSet.serialize,
+        ),
+        "ExecuteBatchDml": grpc.unary_unary_rpc_method_handler(
+            servicer.ExecuteBatchDml,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.ExecuteBatchDmlRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_spanner__pb2.ExecuteBatchDmlResponse.serialize,
+        ),
+        "Read": grpc.unary_unary_rpc_method_handler(
+            servicer.Read,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.ReadRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_result__set__pb2.ResultSet.serialize,
+        ),
+        "StreamingRead": grpc.unary_stream_rpc_method_handler(
+            servicer.StreamingRead,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.ReadRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_result__set__pb2.PartialResultSet.serialize,
+        ),
+        "BeginTransaction": grpc.unary_unary_rpc_method_handler(
+            servicer.BeginTransaction,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.BeginTransactionRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_transaction__pb2.Transaction.serialize,
+        ),
+        "Commit": grpc.unary_unary_rpc_method_handler(
+            servicer.Commit,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.CommitRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_commit__response__pb2.CommitResponse.serialize,
+        ),
+        "Rollback": grpc.unary_unary_rpc_method_handler(
+            servicer.Rollback,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.RollbackRequest.deserialize,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "PartitionQuery": grpc.unary_unary_rpc_method_handler(
+            servicer.PartitionQuery,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.PartitionQueryRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_spanner__pb2.PartitionResponse.serialize,
+        ),
+        "PartitionRead": grpc.unary_unary_rpc_method_handler(
+            servicer.PartitionRead,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.PartitionReadRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_spanner__pb2.PartitionResponse.serialize,
+        ),
+        "BatchWrite": grpc.unary_stream_rpc_method_handler(
+            servicer.BatchWrite,
+            request_deserializer=google_dot_spanner_dot_v1_dot_spanner__pb2.BatchWriteRequest.deserialize,
+            response_serializer=google_dot_spanner_dot_v1_dot_spanner__pb2.BatchWriteResponse.serialize,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.spanner.v1.Spanner", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers(
+        "google.spanner.v1.Spanner", rpc_method_handlers
+    )
+
+
+# This class is part of an EXPERIMENTAL API.
+class Spanner(object):
+    """Cloud Spanner API
+
+    The Cloud Spanner API can be used to manage sessions and execute
+    transactions on data stored in Cloud Spanner databases.
+    """
+
+    @staticmethod
+    def CreateSession(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/CreateSession",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.CreateSessionRequest.to_json,
+            google_dot_spanner_dot_v1_dot_spanner__pb2.Session.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def BatchCreateSessions(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/BatchCreateSessions",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.BatchCreateSessionsRequest.to_json,
+            google_dot_spanner_dot_v1_dot_spanner__pb2.BatchCreateSessionsResponse.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def GetSession(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/GetSession",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.GetSessionRequest.to_json,
+            google_dot_spanner_dot_v1_dot_spanner__pb2.Session.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def ListSessions(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/ListSessions",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.ListSessionsRequest.to_json,
+            google_dot_spanner_dot_v1_dot_spanner__pb2.ListSessionsResponse.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def DeleteSession(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/DeleteSession",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.DeleteSessionRequest.to_json,
+            google_dot_protobuf_dot_empty__pb2.Empty.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def ExecuteSql(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/ExecuteSql",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.ExecuteSqlRequest.to_json,
+            google_dot_spanner_dot_v1_dot_result__set__pb2.ResultSet.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def ExecuteStreamingSql(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_stream(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/ExecuteStreamingSql",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.ExecuteSqlRequest.to_json,
+            google_dot_spanner_dot_v1_dot_result__set__pb2.PartialResultSet.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def ExecuteBatchDml(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/ExecuteBatchDml",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.ExecuteBatchDmlRequest.to_json,
+            google_dot_spanner_dot_v1_dot_spanner__pb2.ExecuteBatchDmlResponse.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def Read(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/Read",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.ReadRequest.to_json,
+            google_dot_spanner_dot_v1_dot_result__set__pb2.ResultSet.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def StreamingRead(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_stream(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/StreamingRead",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.ReadRequest.to_json,
+            google_dot_spanner_dot_v1_dot_result__set__pb2.PartialResultSet.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def BeginTransaction(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/BeginTransaction",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.BeginTransactionRequest.to_json,
+            google_dot_spanner_dot_v1_dot_transaction__pb2.Transaction.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def Commit(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/Commit",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.CommitRequest.to_json,
+            google_dot_spanner_dot_v1_dot_commit__response__pb2.CommitResponse.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def Rollback(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/Rollback",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.RollbackRequest.to_json,
+            google_dot_protobuf_dot_empty__pb2.Empty.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def PartitionQuery(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/PartitionQuery",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.PartitionQueryRequest.to_json,
+            google_dot_spanner_dot_v1_dot_spanner__pb2.PartitionResponse.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def PartitionRead(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/PartitionRead",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.PartitionReadRequest.to_json,
+            google_dot_spanner_dot_v1_dot_spanner__pb2.PartitionResponse.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
+
+    @staticmethod
+    def BatchWrite(
+        request,
+        target,
+        options=(),
+        channel_credentials=None,
+        call_credentials=None,
+        insecure=False,
+        compression=None,
+        wait_for_ready=None,
+        timeout=None,
+        metadata=None,
+    ):
+        return grpc.experimental.unary_stream(
+            request,
+            target,
+            "/google.spanner.v1.Spanner/BatchWrite",
+            google_dot_spanner_dot_v1_dot_spanner__pb2.BatchWriteRequest.to_json,
+            google_dot_spanner_dot_v1_dot_spanner__pb2.BatchWriteResponse.from_json,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True,
+        )
diff --git a/test/mockserver_tests/test_basics.py b/test/mockserver_tests/test_basics.py
new file mode 100644
index 00000000..b6c916c4
--- /dev/null
+++ b/test/mockserver_tests/test_basics.py
@@ -0,0 +1,129 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 google.cloud.spanner_admin_database_v1 import UpdateDatabaseDdlRequest
+from sqlalchemy import create_engine, select, MetaData, Table, Column, Integer, String
+from sqlalchemy.testing import eq_, is_instance_of
+from google.cloud.spanner_v1 import (
+    FixedSizePool,
+    BatchCreateSessionsRequest,
+    ExecuteSqlRequest,
+    ResultSet,
+    PingingPool,
+)
+from test.mockserver_tests.mock_server_test_base import (
+    MockServerTestBase,
+    add_select1_result,
+    add_result,
+)
+
+
+class TestBasics(MockServerTestBase):
+    def verify_select1(self, results):
+        result_list = []
+        for row in results:
+            result_list.append(row)
+            eq_(1, row[0])
+        eq_(1, len(result_list))
+        requests = self.spanner_service.requests
+        eq_(2, len(requests))
+        is_instance_of(requests[0], BatchCreateSessionsRequest)
+        is_instance_of(requests[1], ExecuteSqlRequest)
+
+    def test_select1(self):
+        add_select1_result()
+        with self.database.snapshot() as snapshot:
+            results = snapshot.execute_sql("select 1")
+            self.verify_select1(results)
+
+    def test_sqlalchemy_select1(self):
+        add_select1_result()
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": PingingPool(size=10)},
+        )
+        with engine.connect().execution_options(
+            isolation_level="AUTOCOMMIT"
+        ) as connection:
+            results = connection.execute(select(1)).fetchall()
+            self.verify_select1(results)
+
+    def test_create_table(self):
+        add_result(
+            """SELECT true
+FROM INFORMATION_SCHEMA.TABLES
+WHERE TABLE_SCHEMA="" AND TABLE_NAME="users"
+LIMIT 1
+""",
+            ResultSet(),
+        )
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+        metadata = MetaData()
+        Table(
+            "users",
+            metadata,
+            Column("user_id", Integer, primary_key=True),
+            Column("user_name", String(16), nullable=False),
+        )
+        metadata.create_all(engine)
+        requests = self.database_admin_service.requests
+        eq_(1, len(requests))
+        is_instance_of(requests[0], UpdateDatabaseDdlRequest)
+        eq_(1, len(requests[0].statements))
+        eq_(
+            "CREATE TABLE users (\n"
+            "\tuser_id INT64 NOT NULL, \n"
+            "\tuser_name STRING(16) NOT NULL\n"
+            ") PRIMARY KEY (user_id)",
+            requests[0].statements[0],
+        )
+
+    def test_create_multiple_tables(self):
+        for i in range(2):
+            add_result(
+                f"""SELECT true
+FROM INFORMATION_SCHEMA.TABLES
+WHERE TABLE_SCHEMA="" AND TABLE_NAME="table{i}"
+LIMIT 1
+""",
+                ResultSet(),
+            )
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+        metadata = MetaData()
+        for i in range(2):
+            Table(
+                "table" + str(i),
+                metadata,
+                Column("id", Integer, primary_key=True),
+                Column("value", String(16), nullable=False),
+            )
+        metadata.create_all(engine)
+        requests = self.database_admin_service.requests
+        eq_(1, len(requests))
+        is_instance_of(requests[0], UpdateDatabaseDdlRequest)
+        eq_(2, len(requests[0].statements))
+        for i in range(2):
+            eq_(
+                f"CREATE TABLE table{i} (\n"
+                "\tid INT64 NOT NULL, \n"
+                "\tvalue STRING(16) NOT NULL"
+                "\n) PRIMARY KEY (id)",
+                requests[0].statements[i],
+            )
diff --git a/test/mockserver_tests/test_quickstart.py b/test/mockserver_tests/test_quickstart.py
new file mode 100644
index 00000000..ce9711f7
--- /dev/null
+++ b/test/mockserver_tests/test_quickstart.py
@@ -0,0 +1,125 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 google.cloud.spanner_admin_database_v1 import UpdateDatabaseDdlRequest
+from google.cloud.spanner_v1 import (
+    ResultSet,
+    ResultSetStats,
+    BatchCreateSessionsRequest,
+    ExecuteBatchDmlRequest,
+    CommitRequest,
+    BeginTransactionRequest,
+)
+from sqlalchemy.orm import Session
+from sqlalchemy.testing import eq_, is_instance_of, is_not_none
+from test.mockserver_tests.mock_server_test_base import MockServerTestBase, add_result
+
+
+class TestQuickStart(MockServerTestBase):
+    def test_create_tables(self):
+        from test.mockserver_tests.quickstart_model import Base
+
+        # TODO: Fix the double quotes inside these SQL fragments.
+        add_result(
+            """SELECT true
+FROM INFORMATION_SCHEMA.TABLES
+WHERE TABLE_SCHEMA="" AND TABLE_NAME="user_account"
+LIMIT 1""",
+            ResultSet(),
+        )
+        add_result(
+            """SELECT true
+FROM INFORMATION_SCHEMA.TABLES
+WHERE TABLE_SCHEMA="" AND TABLE_NAME="address"
+LIMIT 1""",
+            ResultSet(),
+        )
+
+        engine = self.create_engine()
+        Base.metadata.create_all(engine)
+        requests = self.database_admin_service.requests
+        eq_(1, len(requests))
+        is_instance_of(requests[0], UpdateDatabaseDdlRequest)
+        eq_(2, len(requests[0].statements))
+        eq_(
+            "CREATE TABLE user_account (\n"
+            "\tid INT64 NOT NULL, \n"
+            "\tname STRING(30) NOT NULL, \n"
+            "\tfullname STRING(MAX)\n"
+            ") PRIMARY KEY (id)",
+            requests[0].statements[0],
+        )
+        eq_(
+            "CREATE TABLE address (\n"
+            "\tid INT64 NOT NULL, \n"
+            "\temail_address STRING(MAX) NOT NULL, \n"
+            "\tuser_id INT64 NOT NULL, \n"
+            "\tFOREIGN KEY(user_id) REFERENCES user_account (id)\n"
+            ") PRIMARY KEY (id)",
+            requests[0].statements[1],
+        )
+
+    def test_insert_data(self):
+        from test.mockserver_tests.quickstart_model import User, Address
+
+        # TODO: Use auto-generated primary keys.
+        update_count = ResultSet(
+            dict(
+                stats=ResultSetStats(
+                    dict(
+                        row_count_exact=1,
+                    )
+                )
+            )
+        )
+        add_result(
+            "INSERT INTO user_account (id, name, fullname) VALUES (@a0, @a1, @a2)",
+            update_count,
+        )
+        add_result(
+            "INSERT INTO address (id, email_address, user_id) VALUES (@a0, @a1, @a2)",
+            update_count,
+        )
+
+        engine = self.create_engine()
+        with Session(engine) as session:
+            spongebob = User(
+                id=1,
+                name="spongebob",
+                fullname="Spongebob Squarepants",
+                addresses=[Address(id=1, email_address="spongebob@sqlalchemy.org")],
+            )
+            sandy = User(
+                id=2,
+                name="sandy",
+                fullname="Sandy Cheeks",
+                addresses=[
+                    Address(id=2, email_address="sandy@sqlalchemy.org"),
+                    Address(id=3, email_address="sandy@squirrelpower.org"),
+                ],
+            )
+            patrick = User(id=3, name="patrick", fullname="Patrick Star")
+            session.add_all([spongebob, sandy, patrick])
+            session.commit()
+
+            requests = self.spanner_service.requests
+            eq_(5, len(requests))
+            is_instance_of(requests[0], BatchCreateSessionsRequest)
+            is_instance_of(requests[1], BeginTransactionRequest)
+            is_instance_of(requests[2], ExecuteBatchDmlRequest)
+            is_instance_of(requests[3], ExecuteBatchDmlRequest)
+            is_instance_of(requests[4], CommitRequest)
+            is_not_none(requests[2].transaction.id)
+            eq_(requests[2].transaction.id, requests[3].transaction.id)
+            eq_(requests[2].transaction.id, requests[4].transaction_id)

From ff3e89d5bd2656df0b117c878c6dca040f002a59 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 11:30:53 +0100
Subject: [PATCH 007/133] chore(deps): update dependency cryptography to
 v43.0.3 (#416)

---
 .kokoro/requirements.txt | 56 ++++++++++++++++++++--------------------
 1 file changed, 28 insertions(+), 28 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 3e8023f4..62927e5d 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -198,34 +198,34 @@ commonmark==0.9.1 \
     --hash=sha256:452f9dc859be7f06631ddcb328b6919c67984aca654e5fefb3914d54691aed60 \
     --hash=sha256:da2f38c92590f83de410ba1a3cbceafbc74fee9def35f9251ba9a971d6d66fd9
     # via rich
-cryptography==43.0.1 \
-    --hash=sha256:014f58110f53237ace6a408b5beb6c427b64e084eb451ef25a28308270086494 \
-    --hash=sha256:1bbcce1a551e262dfbafb6e6252f1ae36a248e615ca44ba302df077a846a8806 \
-    --hash=sha256:203e92a75716d8cfb491dc47c79e17d0d9207ccffcbcb35f598fbe463ae3444d \
-    --hash=sha256:27e613d7077ac613e399270253259d9d53872aaf657471473ebfc9a52935c062 \
-    --hash=sha256:2bd51274dcd59f09dd952afb696bf9c61a7a49dfc764c04dd33ef7a6b502a1e2 \
-    --hash=sha256:38926c50cff6f533f8a2dae3d7f19541432610d114a70808f0926d5aaa7121e4 \
-    --hash=sha256:511f4273808ab590912a93ddb4e3914dfd8a388fed883361b02dea3791f292e1 \
-    --hash=sha256:58d4e9129985185a06d849aa6df265bdd5a74ca6e1b736a77959b498e0505b85 \
-    --hash=sha256:5b43d1ea6b378b54a1dc99dd8a2b5be47658fe9a7ce0a58ff0b55f4b43ef2b84 \
-    --hash=sha256:61ec41068b7b74268fa86e3e9e12b9f0c21fcf65434571dbb13d954bceb08042 \
-    --hash=sha256:666ae11966643886c2987b3b721899d250855718d6d9ce41b521252a17985f4d \
-    --hash=sha256:68aaecc4178e90719e95298515979814bda0cbada1256a4485414860bd7ab962 \
-    --hash=sha256:7c05650fe8023c5ed0d46793d4b7d7e6cd9c04e68eabe5b0aeea836e37bdcec2 \
-    --hash=sha256:80eda8b3e173f0f247f711eef62be51b599b5d425c429b5d4ca6a05e9e856baa \
-    --hash=sha256:8385d98f6a3bf8bb2d65a73e17ed87a3ba84f6991c155691c51112075f9ffc5d \
-    --hash=sha256:88cce104c36870d70c49c7c8fd22885875d950d9ee6ab54df2745f83ba0dc365 \
-    --hash=sha256:9d3cdb25fa98afdd3d0892d132b8d7139e2c087da1712041f6b762e4f807cc96 \
-    --hash=sha256:a575913fb06e05e6b4b814d7f7468c2c660e8bb16d8d5a1faf9b33ccc569dd47 \
-    --hash=sha256:ac119bb76b9faa00f48128b7f5679e1d8d437365c5d26f1c2c3f0da4ce1b553d \
-    --hash=sha256:c1332724be35d23a854994ff0b66530119500b6053d0bd3363265f7e5e77288d \
-    --hash=sha256:d03a475165f3134f773d1388aeb19c2d25ba88b6a9733c5c590b9ff7bbfa2e0c \
-    --hash=sha256:d75601ad10b059ec832e78823b348bfa1a59f6b8d545db3a24fd44362a1564cb \
-    --hash=sha256:de41fd81a41e53267cb020bb3a7212861da53a7d39f863585d13ea11049cf277 \
-    --hash=sha256:e710bf40870f4db63c3d7d929aa9e09e4e7ee219e703f949ec4073b4294f6172 \
-    --hash=sha256:ea25acb556320250756e53f9e20a4177515f012c9eaea17eb7587a8c4d8ae034 \
-    --hash=sha256:f98bf604c82c416bc829e490c700ca1553eafdf2912a91e23a79d97d9801372a \
-    --hash=sha256:fba1007b3ef89946dbbb515aeeb41e30203b004f0b4b00e5e16078b518563289
+cryptography==43.0.3 \
+    --hash=sha256:0c580952eef9bf68c4747774cde7ec1d85a6e61de97281f2dba83c7d2c806362 \
+    --hash=sha256:0f996e7268af62598f2fc1204afa98a3b5712313a55c4c9d434aef49cadc91d4 \
+    --hash=sha256:1ec0bcf7e17c0c5669d881b1cd38c4972fade441b27bda1051665faaa89bdcaa \
+    --hash=sha256:281c945d0e28c92ca5e5930664c1cefd85efe80e5c0d2bc58dd63383fda29f83 \
+    --hash=sha256:2ce6fae5bdad59577b44e4dfed356944fbf1d925269114c28be377692643b4ff \
+    --hash=sha256:315b9001266a492a6ff443b61238f956b214dbec9910a081ba5b6646a055a805 \
+    --hash=sha256:443c4a81bb10daed9a8f334365fe52542771f25aedaf889fd323a853ce7377d6 \
+    --hash=sha256:4a02ded6cd4f0a5562a8887df8b3bd14e822a90f97ac5e544c162899bc467664 \
+    --hash=sha256:53a583b6637ab4c4e3591a15bc9db855b8d9dee9a669b550f311480acab6eb08 \
+    --hash=sha256:63efa177ff54aec6e1c0aefaa1a241232dcd37413835a9b674b6e3f0ae2bfd3e \
+    --hash=sha256:74f57f24754fe349223792466a709f8e0c093205ff0dca557af51072ff47ab18 \
+    --hash=sha256:7e1ce50266f4f70bf41a2c6dc4358afadae90e2a1e5342d3c08883df1675374f \
+    --hash=sha256:81ef806b1fef6b06dcebad789f988d3b37ccaee225695cf3e07648eee0fc6b73 \
+    --hash=sha256:846da004a5804145a5f441b8530b4bf35afbf7da70f82409f151695b127213d5 \
+    --hash=sha256:8ac43ae87929a5982f5948ceda07001ee5e83227fd69cf55b109144938d96984 \
+    --hash=sha256:9762ea51a8fc2a88b70cf2995e5675b38d93bf36bd67d91721c309df184f49bd \
+    --hash=sha256:a2a431ee15799d6db9fe80c82b055bae5a752bef645bba795e8e52687c69efe3 \
+    --hash=sha256:bf7a1932ac4176486eab36a19ed4c0492da5d97123f1406cf15e41b05e787d2e \
+    --hash=sha256:c2e6fc39c4ab499049df3bdf567f768a723a5e8464816e8f009f121a5a9f4405 \
+    --hash=sha256:cbeb489927bd7af4aa98d4b261af9a5bc025bd87f0e3547e11584be9e9427be2 \
+    --hash=sha256:d03b5621a135bffecad2c73e9f4deb1a0f977b9a8ffe6f8e002bf6c9d07b918c \
+    --hash=sha256:d56e96520b1020449bbace2b78b603442e7e378a9b3bd68de65c782db1507995 \
+    --hash=sha256:df6b6c6d742395dd77a23ea3728ab62f98379eff8fb61be2744d4679ab678f73 \
+    --hash=sha256:e1be4655c7ef6e1bbe6b5d0403526601323420bcf414598955968c9ef3eb7d16 \
+    --hash=sha256:f18c716be16bc1fea8e95def49edf46b82fccaa88587a45f8dc0ff6ab5d8e0a7 \
+    --hash=sha256:f46304d6f0c6ab8e52770addfa2fc41e6629495548862279641972b6215451cd \
+    --hash=sha256:f7b178f11ed3664fd0e995a47ed2b5ff0a12d893e41dd0494f406d1cf555cab7
     # via
     #   gcp-releasetool
     #   secretstorage

From 1aeade1b113ce2e23ffabe46acf288f8d00970ae Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 12:04:03 +0100
Subject: [PATCH 008/133] chore(deps): update dependency urllib3 to v1.26.19
 [security] (#403)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 62927e5d..390e2be3 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -579,9 +579,9 @@ typing-extensions==4.8.0 \
     --hash=sha256:8f92fc8806f9a6b641eaa5318da32b44d401efaac0f6678c9bc448ba3605faa0 \
     --hash=sha256:df8e4339e9cb77357558cbdbceca33c303714cf861d1eef15e1070055ae8b7ef
     # via -r requirements.in
-urllib3==1.26.18 \
-    --hash=sha256:34b97092d7e0a3a8cf7cd10e386f401b3737364026c45e622aa02903dffe0f07 \
-    --hash=sha256:f8ecc1bba5667413457c529ab955bf8c67b45db799d159066261719e328580a0
+urllib3==1.26.19 \
+    --hash=sha256:37a0344459b199fce0e80b0d3569837ec6b6937435c5244e7fd73fa6006830f3 \
+    --hash=sha256:3e3d753a8618b86d7de333b4223005f68720bcd6a7d2bcb9fbd2229ec7c1e429
     # via
     #   requests
     #   twine

From 804a23d74023fb1cb3e227ba88bcb57e310515cd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 31 Oct 2024 12:05:08 +0100
Subject: [PATCH 009/133] build(deps): bump jinja2 from 3.1.2 to 3.1.4 in
 /.kokoro (#396)

Bumps [jinja2](https://github.com/pallets/jinja) from 3.1.2 to 3.1.4.
- [Release notes](https://github.com/pallets/jinja/releases)
- [Changelog](https://github.com/pallets/jinja/blob/main/CHANGES.rst)
- [Commits](https://github.com/pallets/jinja/compare/3.1.2...3.1.4)

---
updated-dependencies:
- dependency-name: jinja2
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 390e2be3..916f3d9e 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -369,9 +369,9 @@ jeepney==0.8.0 \
     # via
     #   keyring
     #   secretstorage
-jinja2==3.1.2 \
-    --hash=sha256:31351a702a408a9e7595a8fc6150fc3f43bb6bf7e319770cbc0db9df9437e852 \
-    --hash=sha256:6088930bfe239f0e6710546ab9c19c9ef35e29792895fed6e6e31a023a182a61
+jinja2==3.1.4 \
+    --hash=sha256:4a3aee7acbbe7303aede8e9648d13b8bf88a429282aa6122a993f0ac800cb369 \
+    --hash=sha256:bc5dd2abb727a5319567b7a813e6a2e7318c39f4f487cfe6c89c6f9c7d25197d
     # via gcp-releasetool
 keyring==23.9.3 \
     --hash=sha256:69732a15cb1433bdfbc3b980a8a36a04878a6cfd7cb99f497b573f31618001c0 \

From 26f6e01aacdfc6e99ab51dd4ed48e4ba1a3caaa2 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 12:05:50 +0100
Subject: [PATCH 010/133] chore(deps): update dependency distlib to v0.3.9
 (#417)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 916f3d9e..ddac7cc4 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -229,9 +229,9 @@ cryptography==43.0.3 \
     # via
     #   gcp-releasetool
     #   secretstorage
-distlib==0.3.7 \
-    --hash=sha256:2e24928bc811348f0feb63014e97aaae3037f2cf48712d51ae61df7fd6075057 \
-    --hash=sha256:9dafe54b34a028eafd95039d5e5d4851a13734540f1331060d31c9916e7147a8
+distlib==0.3.9 \
+    --hash=sha256:47f8c22fd27c27e25a65601af709b38e4f0a45ea4fc2e710f65755fa8caaaf87 \
+    --hash=sha256:a60f20dea646b8a33f3e7772f74dc0b2d0772d2837ee1342a00645c81edf9403
     # via virtualenv
 docutils==0.19 \
     --hash=sha256:33995a6753c30b7f577febfc2c50411fec6aac7f7ffeb7c4cfe5991072dcf9e6 \

From f59ef849fe943b09679b6f946548fe07e3828a14 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 12:17:19 +0100
Subject: [PATCH 011/133] chore(deps): update dependency grpcio-status to
 v1.67.1 (#419)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 04fea757..0fb17ef0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -238,9 +238,9 @@ grpcio==1.67.0 \
     #   grpc-google-iam-v1
     #   grpc-interceptor
     #   grpcio-status
-grpcio-status==1.67.0 \
-    --hash=sha256:0e79e2e01ba41a6ca6ed9d7a825323c511fe1653a646f8014c7e3c8132527acc \
-    --hash=sha256:c3e5a86fa007e9e263cd5f988a8a907484da4caab582874ea2a4a6092734046b
+grpcio-status==1.67.1 \
+    --hash=sha256:16e6c085950bdacac97c779e6a502ea671232385e6e37f258884d6883392c2bd \
+    --hash=sha256:2bf38395e028ceeecfd8866b081f61628114b384da7d51ae064ddc8d766a5d11
     # via google-api-core
 idna==3.10 \
     --hash=sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9 \

From d117b912b917de9db19822c408ef74f997669f7f Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 12:28:49 +0100
Subject: [PATCH 012/133] chore(deps): update dependency grpcio to v1.67.1
 (#418)

---
 requirements.txt | 112 +++++++++++++++++++++++------------------------
 1 file changed, 56 insertions(+), 56 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 0fb17ef0..ddcfad4e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -176,62 +176,62 @@ grpc-interceptor==0.15.4 \
     --hash=sha256:0035f33228693ed3767ee49d937bac424318db173fef4d2d0170b3215f254d9d \
     --hash=sha256:1f45c0bcb58b6f332f37c637632247c9b02bc6af0fdceb7ba7ce8d2ebbfb0926
     # via google-cloud-spanner
-grpcio==1.67.0 \
-    --hash=sha256:014dfc020e28a0d9be7e93a91f85ff9f4a87158b7df9952fe23cc42d29d31e1e \
-    --hash=sha256:0892dd200ece4822d72dd0952f7112c542a487fc48fe77568deaaa399c1e717d \
-    --hash=sha256:0bb94e66cd8f0baf29bd3184b6aa09aeb1a660f9ec3d85da615c5003154bc2bf \
-    --hash=sha256:0c69bf11894cad9da00047f46584d5758d6ebc9b5950c0dc96fec7e0bce5cde9 \
-    --hash=sha256:15c05a26a0f7047f720da41dc49406b395c1470eef44ff7e2c506a47ac2c0591 \
-    --hash=sha256:16724ffc956ea42967f5758c2f043faef43cb7e48a51948ab593570570d1e68b \
-    --hash=sha256:227316b5631260e0bef8a3ce04fa7db4cc81756fea1258b007950b6efc90c05d \
-    --hash=sha256:2b7183c80b602b0ad816315d66f2fb7887614ead950416d60913a9a71c12560d \
-    --hash=sha256:2f55c1e0e2ae9bdd23b3c63459ee4c06d223b68aeb1961d83c48fb63dc29bc03 \
-    --hash=sha256:30d47dbacfd20cbd0c8be9bfa52fdb833b395d4ec32fe5cff7220afc05d08571 \
-    --hash=sha256:323741b6699cd2b04a71cb38f502db98f90532e8a40cb675393d248126a268af \
-    --hash=sha256:3840994689cc8cbb73d60485c594424ad8adb56c71a30d8948d6453083624b52 \
-    --hash=sha256:391df8b0faac84d42f5b8dfc65f5152c48ed914e13c522fd05f2aca211f8bfad \
-    --hash=sha256:42199e704095b62688998c2d84c89e59a26a7d5d32eed86d43dc90e7a3bd04aa \
-    --hash=sha256:54d16383044e681f8beb50f905249e4e7261dd169d4aaf6e52eab67b01cbbbe2 \
-    --hash=sha256:5a1e03c3102b6451028d5dc9f8591131d6ab3c8a0e023d94c28cb930ed4b5f81 \
-    --hash=sha256:62492bd534979e6d7127b8a6b29093161a742dee3875873e01964049d5250a74 \
-    --hash=sha256:662c8e105c5e5cee0317d500eb186ed7a93229586e431c1bf0c9236c2407352c \
-    --hash=sha256:682968427a63d898759474e3b3178d42546e878fdce034fd7474ef75143b64e3 \
-    --hash=sha256:74b900566bdf68241118f2918d312d3bf554b2ce0b12b90178091ea7d0a17b3d \
-    --hash=sha256:77196216d5dd6f99af1c51e235af2dd339159f657280e65ce7e12c1a8feffd1d \
-    --hash=sha256:7f200aca719c1c5dc72ab68be3479b9dafccdf03df530d137632c534bb6f1ee3 \
-    --hash=sha256:7fc1d2b9fd549264ae585026b266ac2db53735510a207381be509c315b4af4e8 \
-    --hash=sha256:82e5bd4b67b17c8c597273663794a6a46a45e44165b960517fe6d8a2f7f16d23 \
-    --hash=sha256:8c9a35b8bc50db35ab8e3e02a4f2a35cfba46c8705c3911c34ce343bd777813a \
-    --hash=sha256:985b2686f786f3e20326c4367eebdaed3e7aa65848260ff0c6644f817042cb15 \
-    --hash=sha256:9d75641a2fca9ae1ae86454fd25d4c298ea8cc195dbc962852234d54a07060ad \
-    --hash=sha256:a4e95e43447a02aa603abcc6b5e727d093d161a869c83b073f50b9390ecf0fa8 \
-    --hash=sha256:a6b9a5c18863fd4b6624a42e2712103fb0f57799a3b29651c0e5b8119a519d65 \
-    --hash=sha256:aa8d025fae1595a207b4e47c2e087cb88d47008494db258ac561c00877d4c8f8 \
-    --hash=sha256:ac11ecb34a86b831239cc38245403a8de25037b448464f95c3315819e7519772 \
-    --hash=sha256:ae6de510f670137e755eb2a74b04d1041e7210af2444103c8c95f193340d17ee \
-    --hash=sha256:b2a44e572fb762c668e4812156b81835f7aba8a721b027e2d4bb29fb50ff4d33 \
-    --hash=sha256:b6eb68493a05d38b426604e1dc93bfc0137c4157f7ab4fac5771fd9a104bbaa6 \
-    --hash=sha256:b9bca3ca0c5e74dea44bf57d27e15a3a3996ce7e5780d61b7c72386356d231db \
-    --hash=sha256:bd79929b3bb96b54df1296cd3bf4d2b770bd1df6c2bdf549b49bab286b925cdc \
-    --hash=sha256:c4c425f440fb81f8d0237c07b9322fc0fb6ee2b29fbef5f62a322ff8fcce240d \
-    --hash=sha256:cb204a742997277da678611a809a8409657b1398aaeebf73b3d9563b7d154c13 \
-    --hash=sha256:cf51d28063338608cd8d3cd64677e922134837902b70ce00dad7f116e3998210 \
-    --hash=sha256:cfd9306511fdfc623a1ba1dc3bc07fbd24e6cfbe3c28b4d1e05177baa2f99617 \
-    --hash=sha256:cff8e54d6a463883cda2fab94d2062aad2f5edd7f06ae3ed030f2a74756db365 \
-    --hash=sha256:d01793653248f49cf47e5695e0a79805b1d9d4eacef85b310118ba1dfcd1b955 \
-    --hash=sha256:d4ea4509d42c6797539e9ec7496c15473177ce9abc89bc5c71e7abe50fc25737 \
-    --hash=sha256:d90cfdafcf4b45a7a076e3e2a58e7bc3d59c698c4f6470b0bb13a4d869cf2273 \
-    --hash=sha256:e090b2553e0da1c875449c8e75073dd4415dd71c9bde6a406240fdf4c0ee467c \
-    --hash=sha256:e91d154689639932305b6ea6f45c6e46bb51ecc8ea77c10ef25aa77f75443ad4 \
-    --hash=sha256:eef1dce9d1a46119fd09f9a992cf6ab9d9178b696382439446ca5f399d7b96fe \
-    --hash=sha256:efe32b45dd6d118f5ea2e5deaed417d8a14976325c93812dd831908522b402c9 \
-    --hash=sha256:f4d613fbf868b2e2444f490d18af472ccb47660ea3df52f068c9c8801e1f3e85 \
-    --hash=sha256:f55f077685f61f0fbd06ea355142b71e47e4a26d2d678b3ba27248abfe67163a \
-    --hash=sha256:f623c57a5321461c84498a99dddf9d13dac0e40ee056d884d6ec4ebcab647a78 \
-    --hash=sha256:f6bd2ab135c64a4d1e9e44679a616c9bc944547357c830fafea5c3caa3de5153 \
-    --hash=sha256:f95e15db43e75a534420e04822df91f645664bf4ad21dfaad7d51773c80e6bb4 \
-    --hash=sha256:fd6bc27861e460fe28e94226e3673d46e294ca4673d46b224428d197c5935e69 \
-    --hash=sha256:fe89295219b9c9e47780a0f1c75ca44211e706d1c598242249fe717af3385ec8
+grpcio==1.67.1 \
+    --hash=sha256:01f616a964e540638af5130469451cf580ba8c7329f45ca998ab66e0c7dcdb04 \
+    --hash=sha256:0489063974d1452436139501bf6b180f63d4977223ee87488fe36858c5725292 \
+    --hash=sha256:0e6f255980afef598a9e64a24efce87b625e3e3c80a45162d111a461a9f92955 \
+    --hash=sha256:0f3e49c738396e93b7ba9016e153eb09e0778e776df6090c1b8c91877cc1c426 \
+    --hash=sha256:178f5db771c4f9a9facb2ab37a434c46cb9be1a75e820f187ee3d1e7805c4f65 \
+    --hash=sha256:1a65b503d008f066e994f34f456e0647e5ceb34cfcec5ad180b1b44020ad4970 \
+    --hash=sha256:1d7616d2ded471231c701489190379e0c311ee0a6c756f3c03e6a62b95a7146e \
+    --hash=sha256:24e8a26dbfc5274d7474c27759b54486b8de23c709d76695237515bc8b5baeab \
+    --hash=sha256:267d1745894200e4c604958da5f856da6293f063327cb049a51fe67348e4f953 \
+    --hash=sha256:299b3d8c4f790c6bcca485f9963b4846dd92cf6f1b65d3697145d005c80f9fe8 \
+    --hash=sha256:3b6c16489326d79ead41689c4b84bc40d522c9a7617219f4ad94bc7f448c5085 \
+    --hash=sha256:3dc2ed4cabea4dc14d5e708c2b426205956077cc5de419b4d4079315017e9732 \
+    --hash=sha256:43112046864317498a33bdc4797ae6a268c36345a910de9b9c17159d8346602f \
+    --hash=sha256:4422581cdc628f77302270ff839a44f4c24fdc57887dc2a45b7e53d8fc2376af \
+    --hash=sha256:4e7b904484a634a0fff132958dabdb10d63e0927398273917da3ee103e8d1f78 \
+    --hash=sha256:5721e66a594a6c4204458004852719b38f3d5522082be9061d6510b455c90afc \
+    --hash=sha256:5db70d32d6703b89912af16d6d45d78406374a8b8ef0d28140351dd0ec610e98 \
+    --hash=sha256:5ed601c4c6008429e3d247ddb367fe8c7259c355757448d7c1ef7bd4a6739e8e \
+    --hash=sha256:60336bff760fbb47d7e86165408126f1dded184448e9a4c892189eb7c9d3f90f \
+    --hash=sha256:608d87d1bdabf9e2868b12338cd38a79969eaf920c89d698ead08f48de9c0f9e \
+    --hash=sha256:60e6a4dcf5af7bbc36fd9f81c9f372e8ae580870a9e4b6eafe948cd334b81cf3 \
+    --hash=sha256:638354e698fd0c6c76b04540a850bf1db27b4d2515a19fcd5cf645c48d3eb1ed \
+    --hash=sha256:699e964923b70f3101393710793289e42845791ea07565654ada0969522d0a38 \
+    --hash=sha256:7818c0454027ae3384235a65210bbf5464bd715450e30a3d40385453a85a70cb \
+    --hash=sha256:786a5b18544622bfb1e25cc08402bd44ea83edfb04b93798d85dca4d1a0b5be5 \
+    --hash=sha256:804c6457c3cd3ec04fe6006c739579b8d35c86ae3298ffca8de57b493524b771 \
+    --hash=sha256:80b866f73224b0634f4312a4674c1be21b2b4afa73cb20953cbbb73a6b36c3cc \
+    --hash=sha256:85f69fdc1d28ce7cff8de3f9c67db2b0ca9ba4449644488c1e0303c146135ddb \
+    --hash=sha256:85f862069b86a305497e74d0dc43c02de3d1d184fc2c180993aa8aa86fbd19b8 \
+    --hash=sha256:8a00efecde9d6fcc3ab00c13f816313c040a28450e5e25739c24f432fc6d3c75 \
+    --hash=sha256:8a23cbcc5bb11ea7dc6163078be36c065db68d915c24f5faa4f872c573bb400f \
+    --hash=sha256:8b0341d66a57f8a3119b77ab32207072be60c9bf79760fa609c5609f2deb1f3f \
+    --hash=sha256:917e8d8994eed1d86b907ba2a61b9f0aef27a2155bca6cbb322430fc7135b7bb \
+    --hash=sha256:95b5f2b857856ed78d72da93cd7d09b6db8ef30102e5e7fe0961fe4d9f7d48e8 \
+    --hash=sha256:9e838cad2176ebd5d4a8bb03955138d6589ce9e2ce5d51c3ada34396dbd2dba8 \
+    --hash=sha256:9fd042de4a82e3e7aca44008ee2fb5da01b3e5adb316348c21980f7f58adc311 \
+    --hash=sha256:a25bdea92b13ff4d7790962190bf6bf5c4639876e01c0f3dda70fc2769616335 \
+    --hash=sha256:a6703916c43b1d468d0756c8077b12017a9fcb6a1ef13faf49e67d20d7ebda62 \
+    --hash=sha256:a93deda571a1bf94ec1f6fcda2872dad3ae538700d94dc283c672a3b508ba3af \
+    --hash=sha256:aa0162e56fd10a5547fac8774c4899fc3e18c1aa4a4759d0ce2cd00d3696ea6b \
+    --hash=sha256:b49359977c6ec9f5d0573ea4e0071ad278ef905aa74e420acc73fd28ce39e9ce \
+    --hash=sha256:beee96c8c0b1a75d556fe57b92b58b4347c77a65781ee2ac749d550f2a365dc1 \
+    --hash=sha256:c7a01337407dd89005527623a4a72c5c8e2894d22bead0895306b23c6695698f \
+    --hash=sha256:c9b929f13677b10f63124c1a410994a401cdd85214ad83ab67cc077fc7e480f0 \
+    --hash=sha256:cdc491ae35a13535fd9196acb5afe1af37c8237df2e54427be3eecda3653127e \
+    --hash=sha256:e279330bef1744040db8fc432becc8a727b84f456ab62b744d3fdb83f327e121 \
+    --hash=sha256:e29ca27bec8e163dca0c98084040edec3bc49afd10f18b412f483cc68c712744 \
+    --hash=sha256:e7d1797a8a3845437d327145959a2c0c47c05947c9eef5ff1a4c80e499dcc6fa \
+    --hash=sha256:ea33986b70f83844cd00814cee4451055cd8cab36f00ac64a31f5bb09b31919e \
+    --hash=sha256:ec74ef02010186185de82cc594058a3ccd8d86821842bbac9873fd4a2cf8be8d \
+    --hash=sha256:f26b0b547eb8d00e195274cdfc63ce64c8fc2d3e2d00b12bf468ece41a0423a0 \
+    --hash=sha256:f5a27dddefe0e2357d3e617b9079b4bfdc91341a91565111a21ed6ebbc51b22d \
+    --hash=sha256:f5b76ff64aaac53fede0cc93abf57894ab2a7362986ba22243d06218b93efe46 \
+    --hash=sha256:f9fff78ba10d4250bfc07a01bd6254a6d87dc67f9627adece85c0b2ed754fa96 \
+    --hash=sha256:fa0c739ad8b1996bd24823950e3cb5152ae91fca1c09cc791190bf1627ffefba
     # via
     #   google-api-core
     #   googleapis-common-protos

From 221d301569d579699dcc0cff3ad1bc605f1ab7ea Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 31 Oct 2024 12:29:35 +0100
Subject: [PATCH 013/133] build(deps): bump idna from 3.4 to 3.7 in /.kokoro
 (#392)

Bumps [idna](https://github.com/kjd/idna) from 3.4 to 3.7.
- [Release notes](https://github.com/kjd/idna/releases)
- [Changelog](https://github.com/kjd/idna/blob/master/HISTORY.rst)
- [Commits](https://github.com/kjd/idna/compare/v3.4...v3.7)

---
updated-dependencies:
- dependency-name: idna
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index ddac7cc4..adc292a8 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -349,9 +349,9 @@ googleapis-common-protos==1.56.4 \
     --hash=sha256:8eb2cbc91b69feaf23e32452a7ae60e791e09967d81d4fcc7fc388182d1bd394 \
     --hash=sha256:c25873c47279387cfdcbdafa36149887901d36202cb645a0e4f29686bf6e4417
     # via google-api-core
-idna==3.4 \
-    --hash=sha256:814f528e8dead7d329833b91c5faa87d60bf71824cd12a7530b5526063d02cb4 \
-    --hash=sha256:90b77e79eaa3eba6de819a0c442c0b4ceefc341a7a2ab77d7562bf49f425c5c2
+idna==3.7 \
+    --hash=sha256:028ff3aadf0609c1fd278d8ea3089299412a7a8b9bd005dd08b9f8285bcb5cfc \
+    --hash=sha256:82fee1fc78add43492d3a1898bfa6d8a904cc97d8427f683ed8e798d07761aa0
     # via requests
 importlib-metadata==5.0.0 \
     --hash=sha256:da31db32b304314d044d3c12c79bd59e307889b287ad12ff387b3500835fc2ab \

From 27bfecd5770b53a689ed37b09998d2c530206d4f Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 12:41:46 +0100
Subject: [PATCH 014/133] chore(deps): update dependency twine to v4.0.2 (#372)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index adc292a8..fee641e8 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -571,9 +571,9 @@ six==1.16.0 \
     #   gcp-docuploader
     #   google-auth
     #   python-dateutil
-twine==4.0.1 \
-    --hash=sha256:42026c18e394eac3e06693ee52010baa5313e4811d5a11050e7d48436cf41b9e \
-    --hash=sha256:96b1cf12f7ae611a4a40b6ae8e9570215daff0611828f5fe1f37a16255ab24a0
+twine==4.0.2 \
+    --hash=sha256:929bc3c280033347a00f847236564d1c52a3e61b1ac2516c97c48f3ceab756d8 \
+    --hash=sha256:9e102ef5fdd5a20661eb88fad46338806c3bd32cf1db729603fe3697b1bc83c8
     # via -r requirements.in
 typing-extensions==4.8.0 \
     --hash=sha256:8f92fc8806f9a6b641eaa5318da32b44d401efaac0f6678c9bc448ba3605faa0 \

From cd5eebde507b95be715845b8246604e46eb642af Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 12:42:00 +0100
Subject: [PATCH 015/133] chore(deps): update dependency gcp-docuploader to
 v0.6.5 (#359)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index fee641e8..d73b16d5 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -241,9 +241,9 @@ filelock==3.8.0 \
     --hash=sha256:55447caa666f2198c5b6b13a26d2084d26fa5b115c00d065664b2124680c4edc \
     --hash=sha256:617eb4e5eedc82fc5f47b6d61e4d11cb837c56cb4544e39081099fa17ad109d4
     # via virtualenv
-gcp-docuploader==0.6.4 \
-    --hash=sha256:01486419e24633af78fd0167db74a2763974765ee8078ca6eb6964d0ebd388af \
-    --hash=sha256:70861190c123d907b3b067da896265ead2eeb9263969d6955c9e0bb091b5ccbf
+gcp-docuploader==0.6.5 \
+    --hash=sha256:30221d4ac3e5a2b9c69aa52fdbef68cc3f27d0e6d0d90e220fc024584b8d2318 \
+    --hash=sha256:b7458ef93f605b9d46a4bf3a8dc1755dad1f31d030c8679edf304e343b347eea
     # via -r requirements.in
 gcp-releasetool==1.16.0 \
     --hash=sha256:27bf19d2e87aaa884096ff941aa3c592c482be3d6a2bfe6f06afafa6af2353e3 \

From 9130b8d111e3439388dd1329963e3a2e74f46dfd Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 12:53:47 +0100
Subject: [PATCH 016/133] chore(deps): update dependency importlib-metadata to
 v5.2.0 (#298)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index d73b16d5..38cfb477 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -353,9 +353,9 @@ idna==3.7 \
     --hash=sha256:028ff3aadf0609c1fd278d8ea3089299412a7a8b9bd005dd08b9f8285bcb5cfc \
     --hash=sha256:82fee1fc78add43492d3a1898bfa6d8a904cc97d8427f683ed8e798d07761aa0
     # via requests
-importlib-metadata==5.0.0 \
-    --hash=sha256:da31db32b304314d044d3c12c79bd59e307889b287ad12ff387b3500835fc2ab \
-    --hash=sha256:ddb0e35065e8938f867ed4928d0ae5bf2a53b7773871bfe6bcc7e4fcdc7dea43
+importlib-metadata==5.2.0 \
+    --hash=sha256:0eafa39ba42bf225fc00e67f701d71f85aead9f878569caf13c3724f704b970f \
+    --hash=sha256:404d48d62bba0b7a77ff9d405efd91501bef2e67ff4ace0bed40a0cf28c3c7cd
     # via
     #   -r requirements.in
     #   twine

From 87c6dbc5e9eedff2e8a74677014cf314fde3461d Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 14:36:38 +0100
Subject: [PATCH 017/133] chore(deps): update dependency markupsafe to v2.1.5
 (#421)

---
 .kokoro/requirements.txt | 122 +++++++++++++++++++--------------------
 1 file changed, 61 insertions(+), 61 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 38cfb477..912a6b02 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -379,67 +379,67 @@ keyring==23.9.3 \
     # via
     #   gcp-releasetool
     #   twine
-markupsafe==2.1.3 \
-    --hash=sha256:05fb21170423db021895e1ea1e1f3ab3adb85d1c2333cbc2310f2a26bc77272e \
-    --hash=sha256:0a4e4a1aff6c7ac4cd55792abf96c915634c2b97e3cc1c7129578aa68ebd754e \
-    --hash=sha256:10bbfe99883db80bdbaff2dcf681dfc6533a614f700da1287707e8a5d78a8431 \
-    --hash=sha256:134da1eca9ec0ae528110ccc9e48041e0828d79f24121a1a146161103c76e686 \
-    --hash=sha256:14ff806850827afd6b07a5f32bd917fb7f45b046ba40c57abdb636674a8b559c \
-    --hash=sha256:1577735524cdad32f9f694208aa75e422adba74f1baee7551620e43a3141f559 \
-    --hash=sha256:1b40069d487e7edb2676d3fbdb2b0829ffa2cd63a2ec26c4938b2d34391b4ecc \
-    --hash=sha256:1b8dd8c3fd14349433c79fa8abeb573a55fc0fdd769133baac1f5e07abf54aeb \
-    --hash=sha256:1f67c7038d560d92149c060157d623c542173016c4babc0c1913cca0564b9939 \
-    --hash=sha256:282c2cb35b5b673bbcadb33a585408104df04f14b2d9b01d4c345a3b92861c2c \
-    --hash=sha256:2c1b19b3aaacc6e57b7e25710ff571c24d6c3613a45e905b1fde04d691b98ee0 \
-    --hash=sha256:2ef12179d3a291be237280175b542c07a36e7f60718296278d8593d21ca937d4 \
-    --hash=sha256:338ae27d6b8745585f87218a3f23f1512dbf52c26c28e322dbe54bcede54ccb9 \
-    --hash=sha256:3c0fae6c3be832a0a0473ac912810b2877c8cb9d76ca48de1ed31e1c68386575 \
-    --hash=sha256:3fd4abcb888d15a94f32b75d8fd18ee162ca0c064f35b11134be77050296d6ba \
-    --hash=sha256:42de32b22b6b804f42c5d98be4f7e5e977ecdd9ee9b660fda1a3edf03b11792d \
-    --hash=sha256:47d4f1c5f80fc62fdd7777d0d40a2e9dda0a05883ab11374334f6c4de38adffd \
-    --hash=sha256:504b320cd4b7eff6f968eddf81127112db685e81f7e36e75f9f84f0df46041c3 \
-    --hash=sha256:525808b8019e36eb524b8c68acdd63a37e75714eac50e988180b169d64480a00 \
-    --hash=sha256:56d9f2ecac662ca1611d183feb03a3fa4406469dafe241673d521dd5ae92a155 \
-    --hash=sha256:5bbe06f8eeafd38e5d0a4894ffec89378b6c6a625ff57e3028921f8ff59318ac \
-    --hash=sha256:65c1a9bcdadc6c28eecee2c119465aebff8f7a584dd719facdd9e825ec61ab52 \
-    --hash=sha256:68e78619a61ecf91e76aa3e6e8e33fc4894a2bebe93410754bd28fce0a8a4f9f \
-    --hash=sha256:69c0f17e9f5a7afdf2cc9fb2d1ce6aabdb3bafb7f38017c0b77862bcec2bbad8 \
-    --hash=sha256:6b2b56950d93e41f33b4223ead100ea0fe11f8e6ee5f641eb753ce4b77a7042b \
-    --hash=sha256:715d3562f79d540f251b99ebd6d8baa547118974341db04f5ad06d5ea3eb8007 \
-    --hash=sha256:787003c0ddb00500e49a10f2844fac87aa6ce977b90b0feaaf9de23c22508b24 \
-    --hash=sha256:7ef3cb2ebbf91e330e3bb937efada0edd9003683db6b57bb108c4001f37a02ea \
-    --hash=sha256:8023faf4e01efadfa183e863fefde0046de576c6f14659e8782065bcece22198 \
-    --hash=sha256:8758846a7e80910096950b67071243da3e5a20ed2546e6392603c096778d48e0 \
-    --hash=sha256:8afafd99945ead6e075b973fefa56379c5b5c53fd8937dad92c662da5d8fd5ee \
-    --hash=sha256:8c41976a29d078bb235fea9b2ecd3da465df42a562910f9022f1a03107bd02be \
-    --hash=sha256:8e254ae696c88d98da6555f5ace2279cf7cd5b3f52be2b5cf97feafe883b58d2 \
-    --hash=sha256:8f9293864fe09b8149f0cc42ce56e3f0e54de883a9de90cd427f191c346eb2e1 \
-    --hash=sha256:9402b03f1a1b4dc4c19845e5c749e3ab82d5078d16a2a4c2cd2df62d57bb0707 \
-    --hash=sha256:962f82a3086483f5e5f64dbad880d31038b698494799b097bc59c2edf392fce6 \
-    --hash=sha256:9aad3c1755095ce347e26488214ef77e0485a3c34a50c5a5e2471dff60b9dd9c \
-    --hash=sha256:9dcdfd0eaf283af041973bff14a2e143b8bd64e069f4c383416ecd79a81aab58 \
-    --hash=sha256:aa57bd9cf8ae831a362185ee444e15a93ecb2e344c8e52e4d721ea3ab6ef1823 \
-    --hash=sha256:aa7bd130efab1c280bed0f45501b7c8795f9fdbeb02e965371bbef3523627779 \
-    --hash=sha256:ab4a0df41e7c16a1392727727e7998a467472d0ad65f3ad5e6e765015df08636 \
-    --hash=sha256:ad9e82fb8f09ade1c3e1b996a6337afac2b8b9e365f926f5a61aacc71adc5b3c \
-    --hash=sha256:af598ed32d6ae86f1b747b82783958b1a4ab8f617b06fe68795c7f026abbdcad \
-    --hash=sha256:b076b6226fb84157e3f7c971a47ff3a679d837cf338547532ab866c57930dbee \
-    --hash=sha256:b7ff0f54cb4ff66dd38bebd335a38e2c22c41a8ee45aa608efc890ac3e3931bc \
-    --hash=sha256:bfce63a9e7834b12b87c64d6b155fdd9b3b96191b6bd334bf37db7ff1fe457f2 \
-    --hash=sha256:c011a4149cfbcf9f03994ec2edffcb8b1dc2d2aede7ca243746df97a5d41ce48 \
-    --hash=sha256:c9c804664ebe8f83a211cace637506669e7890fec1b4195b505c214e50dd4eb7 \
-    --hash=sha256:ca379055a47383d02a5400cb0d110cef0a776fc644cda797db0c5696cfd7e18e \
-    --hash=sha256:cb0932dc158471523c9637e807d9bfb93e06a95cbf010f1a38b98623b929ef2b \
-    --hash=sha256:cd0f502fe016460680cd20aaa5a76d241d6f35a1c3350c474bac1273803893fa \
-    --hash=sha256:ceb01949af7121f9fc39f7d27f91be8546f3fb112c608bc4029aef0bab86a2a5 \
-    --hash=sha256:d080e0a5eb2529460b30190fcfcc4199bd7f827663f858a226a81bc27beaa97e \
-    --hash=sha256:dd15ff04ffd7e05ffcb7fe79f1b98041b8ea30ae9234aed2a9168b5797c3effb \
-    --hash=sha256:df0be2b576a7abbf737b1575f048c23fb1d769f267ec4358296f31c2479db8f9 \
-    --hash=sha256:e09031c87a1e51556fdcb46e5bd4f59dfb743061cf93c4d6831bf894f125eb57 \
-    --hash=sha256:e4dd52d80b8c83fdce44e12478ad2e85c64ea965e75d66dbeafb0a3e77308fcc \
-    --hash=sha256:f698de3fd0c4e6972b92290a45bd9b1536bffe8c6759c62471efaa8acb4c37bc \
-    --hash=sha256:fec21693218efe39aa7f8599346e90c705afa52c5b31ae019b2e57e8f6542bb2 \
-    --hash=sha256:ffcc3f7c66b5f5b7931a5aa68fc9cecc51e685ef90282f4a82f0f5e9b704ad11
+MarkupSafe==2.1.5 \
+    --hash=sha256:00e046b6dd71aa03a41079792f8473dc494d564611a8f89bbbd7cb93295ebdcf \
+    --hash=sha256:075202fa5b72c86ad32dc7d0b56024ebdbcf2048c0ba09f1cde31bfdd57bcfff \
+    --hash=sha256:0e397ac966fdf721b2c528cf028494e86172b4feba51d65f81ffd65c63798f3f \
+    --hash=sha256:17b950fccb810b3293638215058e432159d2b71005c74371d784862b7e4683f3 \
+    --hash=sha256:1f3fbcb7ef1f16e48246f704ab79d79da8a46891e2da03f8783a5b6fa41a9532 \
+    --hash=sha256:2174c595a0d73a3080ca3257b40096db99799265e1c27cc5a610743acd86d62f \
+    --hash=sha256:2b7c57a4dfc4f16f7142221afe5ba4e093e09e728ca65c51f5620c9aaeb9a617 \
+    --hash=sha256:2d2d793e36e230fd32babe143b04cec8a8b3eb8a3122d2aceb4a371e6b09b8df \
+    --hash=sha256:30b600cf0a7ac9234b2638fbc0fb6158ba5bdcdf46aeb631ead21248b9affbc4 \
+    --hash=sha256:397081c1a0bfb5124355710fe79478cdbeb39626492b15d399526ae53422b906 \
+    --hash=sha256:3a57fdd7ce31c7ff06cdfbf31dafa96cc533c21e443d57f5b1ecc6cdc668ec7f \
+    --hash=sha256:3c6b973f22eb18a789b1460b4b91bf04ae3f0c4234a0a6aa6b0a92f6f7b951d4 \
+    --hash=sha256:3e53af139f8579a6d5f7b76549125f0d94d7e630761a2111bc431fd820e163b8 \
+    --hash=sha256:4096e9de5c6fdf43fb4f04c26fb114f61ef0bf2e5604b6ee3019d51b69e8c371 \
+    --hash=sha256:4275d846e41ecefa46e2015117a9f491e57a71ddd59bbead77e904dc02b1bed2 \
+    --hash=sha256:4c31f53cdae6ecfa91a77820e8b151dba54ab528ba65dfd235c80b086d68a465 \
+    --hash=sha256:4f11aa001c540f62c6166c7726f71f7573b52c68c31f014c25cc7901deea0b52 \
+    --hash=sha256:5049256f536511ee3f7e1b3f87d1d1209d327e818e6ae1365e8653d7e3abb6a6 \
+    --hash=sha256:58c98fee265677f63a4385256a6d7683ab1832f3ddd1e66fe948d5880c21a169 \
+    --hash=sha256:598e3276b64aff0e7b3451b72e94fa3c238d452e7ddcd893c3ab324717456bad \
+    --hash=sha256:5b7b716f97b52c5a14bffdf688f971b2d5ef4029127f1ad7a513973cfd818df2 \
+    --hash=sha256:5dedb4db619ba5a2787a94d877bc8ffc0566f92a01c0ef214865e54ecc9ee5e0 \
+    --hash=sha256:619bc166c4f2de5caa5a633b8b7326fbe98e0ccbfacabd87268a2b15ff73a029 \
+    --hash=sha256:629ddd2ca402ae6dbedfceeba9c46d5f7b2a61d9749597d4307f943ef198fc1f \
+    --hash=sha256:656f7526c69fac7f600bd1f400991cc282b417d17539a1b228617081106feb4a \
+    --hash=sha256:6ec585f69cec0aa07d945b20805be741395e28ac1627333b1c5b0105962ffced \
+    --hash=sha256:72b6be590cc35924b02c78ef34b467da4ba07e4e0f0454a2c5907f473fc50ce5 \
+    --hash=sha256:7502934a33b54030eaf1194c21c692a534196063db72176b0c4028e140f8f32c \
+    --hash=sha256:7a68b554d356a91cce1236aa7682dc01df0edba8d043fd1ce607c49dd3c1edcf \
+    --hash=sha256:7b2e5a267c855eea6b4283940daa6e88a285f5f2a67f2220203786dfa59b37e9 \
+    --hash=sha256:823b65d8706e32ad2df51ed89496147a42a2a6e01c13cfb6ffb8b1e92bc910bb \
+    --hash=sha256:8590b4ae07a35970728874632fed7bd57b26b0102df2d2b233b6d9d82f6c62ad \
+    --hash=sha256:8dd717634f5a044f860435c1d8c16a270ddf0ef8588d4887037c5028b859b0c3 \
+    --hash=sha256:8dec4936e9c3100156f8a2dc89c4b88d5c435175ff03413b443469c7c8c5f4d1 \
+    --hash=sha256:97cafb1f3cbcd3fd2b6fbfb99ae11cdb14deea0736fc2b0952ee177f2b813a46 \
+    --hash=sha256:a17a92de5231666cfbe003f0e4b9b3a7ae3afb1ec2845aadc2bacc93ff85febc \
+    --hash=sha256:a549b9c31bec33820e885335b451286e2969a2d9e24879f83fe904a5ce59d70a \
+    --hash=sha256:ac07bad82163452a6884fe8fa0963fb98c2346ba78d779ec06bd7a6262132aee \
+    --hash=sha256:ae2ad8ae6ebee9d2d94b17fb62763125f3f374c25618198f40cbb8b525411900 \
+    --hash=sha256:b91c037585eba9095565a3556f611e3cbfaa42ca1e865f7b8015fe5c7336d5a5 \
+    --hash=sha256:bc1667f8b83f48511b94671e0e441401371dfd0f0a795c7daa4a3cd1dde55bea \
+    --hash=sha256:bec0a414d016ac1a18862a519e54b2fd0fc8bbfd6890376898a6c0891dd82e9f \
+    --hash=sha256:bf50cd79a75d181c9181df03572cdce0fbb75cc353bc350712073108cba98de5 \
+    --hash=sha256:bff1b4290a66b490a2f4719358c0cdcd9bafb6b8f061e45c7a2460866bf50c2e \
+    --hash=sha256:c061bb86a71b42465156a3ee7bd58c8c2ceacdbeb95d05a99893e08b8467359a \
+    --hash=sha256:c8b29db45f8fe46ad280a7294f5c3ec36dbac9491f2d1c17345be8e69cc5928f \
+    --hash=sha256:ce409136744f6521e39fd8e2a24c53fa18ad67aa5bc7c2cf83645cce5b5c4e50 \
+    --hash=sha256:d050b3361367a06d752db6ead6e7edeb0009be66bc3bae0ee9d97fb326badc2a \
+    --hash=sha256:d283d37a890ba4c1ae73ffadf8046435c76e7bc2247bbb63c00bd1a709c6544b \
+    --hash=sha256:d9fad5155d72433c921b782e58892377c44bd6252b5af2f67f16b194987338a4 \
+    --hash=sha256:daa4ee5a243f0f20d528d939d06670a298dd39b1ad5f8a72a4275124a7819eff \
+    --hash=sha256:db0b55e0f3cc0be60c1f19efdde9a637c32740486004f20d1cff53c3c0ece4d2 \
+    --hash=sha256:e61659ba32cf2cf1481e575d0462554625196a1f2fc06a1c777d3f48e8865d46 \
+    --hash=sha256:ea3d8a3d18833cf4304cd2fc9cbb1efe188ca9b5efef2bdac7adc20594a0e46b \
+    --hash=sha256:ec6a563cff360b50eed26f13adc43e61bc0c04d94b8be985e6fb24b81f6dcfdf \
+    --hash=sha256:f5dfb42c4604dddc8e4305050aa6deb084540643ed5804d7455b5df8fe16f5e5 \
+    --hash=sha256:fa173ec60341d6bb97a89f5ea19c85c5643c1e7dedebc22f5181eb73573142c5 \
+    --hash=sha256:fa9db3f79de01457b03d4f01b34cf91bc0048eb2c3846ff26f66687c2f6d16ab \
+    --hash=sha256:fce659a462a1be54d2ffcacea5e3ba2d74daa74f30f5f143fe0c58636e355fdd \
+    --hash=sha256:ffee1f21e5ef0d712f9033568f8344d5da8cc2869dbd08d87c84656e6a2d2f68
     # via jinja2
 more-itertools==8.14.0 \
     --hash=sha256:1bc4f91ee5b1b31ac7ceacc17c09befe6a40a503907baf9c839c229b5095cfd2 \

From cf35ba1478d714f61f8ffdf8382f8ac0cfbde063 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 14:36:50 +0100
Subject: [PATCH 018/133] chore(deps): update dependency requests to v2.32.3
 (#422)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 912a6b02..3e7adf4c 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -534,9 +534,9 @@ readme-renderer==37.2 \
     --hash=sha256:d3f06a69e8c40fca9ab3174eca48f96d9771eddb43517b17d96583418427b106 \
     --hash=sha256:e8ad25293c98f781dbc2c5a36a309929390009f902f99e1798c761aaf04a7923
     # via twine
-requests==2.32.2 \
-    --hash=sha256:dd951ff5ecf3e3b3aa26b40703ba77495dab41da839ae72ef3c8e5d8e2433289 \
-    --hash=sha256:fc06670dd0ed212426dfeb94fc1b983d917c4f9847c863f313c9dfaaffb7c23c
+requests==2.32.3 \
+    --hash=sha256:55365417734eb18255590a9ff9eb97e9e1da868d4ccd6402399eaf68af20a760 \
+    --hash=sha256:70761cfe03c773ceb22aa2f671b4757976145175cdfca038c02654d061d6dcc6
     # via
     #   gcp-releasetool
     #   google-api-core

From f7e0380002838224493f4969f134742ce553a2ea Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 15:40:51 +0100
Subject: [PATCH 019/133] chore(deps): update dependency urllib3 to v1.26.20
 (#424)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 3e7adf4c..61992e09 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -579,9 +579,9 @@ typing-extensions==4.8.0 \
     --hash=sha256:8f92fc8806f9a6b641eaa5318da32b44d401efaac0f6678c9bc448ba3605faa0 \
     --hash=sha256:df8e4339e9cb77357558cbdbceca33c303714cf861d1eef15e1070055ae8b7ef
     # via -r requirements.in
-urllib3==1.26.19 \
-    --hash=sha256:37a0344459b199fce0e80b0d3569837ec6b6937435c5244e7fd73fa6006830f3 \
-    --hash=sha256:3e3d753a8618b86d7de333b4223005f68720bcd6a7d2bcb9fbd2229ec7c1e429
+urllib3==1.26.20 \
+    --hash=sha256:0ed14ccfbf1c30a9072c7ca157e4319b70d65f623e91e7b32fadb2853431016e \
+    --hash=sha256:40c2dc0c681e47eb8f90e7e27bf6ff7df2e677421fd46756da1161c39ca70d32
     # via
     #   requests
     #   twine

From 26f04c173fc775b81bc84832380972485bb30203 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 15:57:53 +0100
Subject: [PATCH 020/133] chore(deps): update dependency argcomplete to v2.1.2
 (#426)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 61992e09..b4772a2b 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -4,9 +4,9 @@
 #
 #    pip-compile --generate-hashes requirements.in
 #
-argcomplete==2.0.0 \
-    --hash=sha256:6372ad78c89d662035101418ae253668445b391755cfe94ea52f1b9d22425b20 \
-    --hash=sha256:cffa11ea77999bb0dd27bb25ff6dc142a6796142f68d45b1a26b11f58724561e
+argcomplete==2.1.2 \
+    --hash=sha256:4ba9cdaa28c361d251edce884cd50b4b1215d65cdc881bd204426cdde9f52731 \
+    --hash=sha256:fc82ef070c607b1559b5c720529d63b54d9dcf2dcfc2632b10e6372314a34457
     # via nox
 attrs==22.1.0 \
     --hash=sha256:29adc2665447e5191d0e7c568fde78b21f9672d344281d0c6e1ab085429b22b6 \

From c16b4c3de8e237f4e1b87ab515341b24170aa06a Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 15:58:05 +0100
Subject: [PATCH 021/133] chore(deps): update dependency attrs to v22.2.0
 (#427)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index b4772a2b..f7c7ce10 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -8,9 +8,9 @@ argcomplete==2.1.2 \
     --hash=sha256:4ba9cdaa28c361d251edce884cd50b4b1215d65cdc881bd204426cdde9f52731 \
     --hash=sha256:fc82ef070c607b1559b5c720529d63b54d9dcf2dcfc2632b10e6372314a34457
     # via nox
-attrs==22.1.0 \
-    --hash=sha256:29adc2665447e5191d0e7c568fde78b21f9672d344281d0c6e1ab085429b22b6 \
-    --hash=sha256:86efa402f67bf2df34f51a335487cf46b1ec130d02b8d39fd248abfd30da551c
+attrs==22.2.0 \
+    --hash=sha256:29e95c7f6778868dbd49170f98f8818f78f3dc5e0e37c0b1f474e3561b240836 \
+    --hash=sha256:c9227bfc2f01993c03f68db37d1d15c9690188323c067c641f1a35ca58185f99
     # via gcp-releasetool
 bleach==5.0.1 \
     --hash=sha256:085f7f33c15bd408dd9b17a4ad77c577db66d76203e5984b1bd59baeee948b2a \

From ca93b988be1a800d491799444aa1833359264ae9 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 19:07:40 +0100
Subject: [PATCH 022/133] chore(deps): update dependency cachetools to v5.5.0
 (#428)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index f7c7ce10..90ea71b8 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -16,9 +16,9 @@ bleach==5.0.1 \
     --hash=sha256:085f7f33c15bd408dd9b17a4ad77c577db66d76203e5984b1bd59baeee948b2a \
     --hash=sha256:0d03255c47eb9bd2f26aa9bb7f2107732e7e8fe195ca2f64709fcf3b0a4a085c
     # via readme-renderer
-cachetools==5.2.0 \
-    --hash=sha256:6a94c6402995a99c3970cc7e4884bb60b4a8639938157eeed436098bf9831757 \
-    --hash=sha256:f9f17d2aec496a9aa6b76f53e3b614c965223c061982d434d160f930c698a9db
+cachetools==5.5.0 \
+    --hash=sha256:02134e8439cdc2ffb62023ce1debca2944c3f289d66bb17ead3ab3dede74b292 \
+    --hash=sha256:2cc24fb4cbe39633fb7badd9db9ca6295d766d9c2995f245725a46715d050f2a
     # via google-auth
 certifi==2024.7.4 \
     --hash=sha256:5a1e7645bc0ec61a09e26c36f6106dd4cf40c6db3a1fb6352b0244e7fb057c7b \

From 4477541da3bcc09adc121cafa77c842fc6e9f459 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 19:07:52 +0100
Subject: [PATCH 023/133] chore(deps): update dependency certifi to v2024.8.30
 (#429)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 90ea71b8..686c7714 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -20,9 +20,9 @@ cachetools==5.5.0 \
     --hash=sha256:02134e8439cdc2ffb62023ce1debca2944c3f289d66bb17ead3ab3dede74b292 \
     --hash=sha256:2cc24fb4cbe39633fb7badd9db9ca6295d766d9c2995f245725a46715d050f2a
     # via google-auth
-certifi==2024.7.4 \
-    --hash=sha256:5a1e7645bc0ec61a09e26c36f6106dd4cf40c6db3a1fb6352b0244e7fb057c7b \
-    --hash=sha256:c198e21b1289c2ab85ee4e67bb4b4ef3ead0892059901a8d5b622f24a1101e90
+certifi==2024.8.30 \
+    --hash=sha256:922820b53db7a7257ffbda3f597266d435245903d80737e34f8a45ff3e3230d8 \
+    --hash=sha256:bec941d2aa8195e248a60b31ff9f0558284cf01a52591ceda73ea9afffd69fd9
     # via requests
 cffi==1.15.1 \
     --hash=sha256:00a9ed42e88df81ffae7a8ab6d9356b371399b91dbdf0c3cb1e84c03a13aceb5 \

From 421ecdc31603f5aea50c7372c59547934d1d068b Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 19:14:36 +0100
Subject: [PATCH 024/133] chore(deps): update dependency charset-normalizer to
 v3.4.0 (#431)

---
 .kokoro/requirements.txt | 197 +++++++++++++++++++++------------------
 1 file changed, 106 insertions(+), 91 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 686c7714..e4c3632b 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -90,97 +90,112 @@ cffi==1.15.1 \
     --hash=sha256:fa6693661a4c91757f4412306191b6dc88c1703f780c8234035eac011922bc01 \
     --hash=sha256:fcd131dd944808b5bdb38e6f5b53013c5aa4f334c5cad0c72742f6eba4b73db0
     # via cryptography
-charset-normalizer==3.3.2 \
-    --hash=sha256:06435b539f889b1f6f4ac1758871aae42dc3a8c0e24ac9e60c2384973ad73027 \
-    --hash=sha256:06a81e93cd441c56a9b65d8e1d043daeb97a3d0856d177d5c90ba85acb3db087 \
-    --hash=sha256:0a55554a2fa0d408816b3b5cedf0045f4b8e1a6065aec45849de2d6f3f8e9786 \
-    --hash=sha256:0b2b64d2bb6d3fb9112bafa732def486049e63de9618b5843bcdd081d8144cd8 \
-    --hash=sha256:10955842570876604d404661fbccbc9c7e684caf432c09c715ec38fbae45ae09 \
-    --hash=sha256:122c7fa62b130ed55f8f285bfd56d5f4b4a5b503609d181f9ad85e55c89f4185 \
-    --hash=sha256:1ceae2f17a9c33cb48e3263960dc5fc8005351ee19db217e9b1bb15d28c02574 \
-    --hash=sha256:1d3193f4a680c64b4b6a9115943538edb896edc190f0b222e73761716519268e \
-    --hash=sha256:1f79682fbe303db92bc2b1136016a38a42e835d932bab5b3b1bfcfbf0640e519 \
-    --hash=sha256:2127566c664442652f024c837091890cb1942c30937add288223dc895793f898 \
-    --hash=sha256:22afcb9f253dac0696b5a4be4a1c0f8762f8239e21b99680099abd9b2b1b2269 \
-    --hash=sha256:25baf083bf6f6b341f4121c2f3c548875ee6f5339300e08be3f2b2ba1721cdd3 \
-    --hash=sha256:2e81c7b9c8979ce92ed306c249d46894776a909505d8f5a4ba55b14206e3222f \
-    --hash=sha256:3287761bc4ee9e33561a7e058c72ac0938c4f57fe49a09eae428fd88aafe7bb6 \
-    --hash=sha256:34d1c8da1e78d2e001f363791c98a272bb734000fcef47a491c1e3b0505657a8 \
-    --hash=sha256:37e55c8e51c236f95b033f6fb391d7d7970ba5fe7ff453dad675e88cf303377a \
-    --hash=sha256:3d47fa203a7bd9c5b6cee4736ee84ca03b8ef23193c0d1ca99b5089f72645c73 \
-    --hash=sha256:3e4d1f6587322d2788836a99c69062fbb091331ec940e02d12d179c1d53e25fc \
-    --hash=sha256:42cb296636fcc8b0644486d15c12376cb9fa75443e00fb25de0b8602e64c1714 \
-    --hash=sha256:45485e01ff4d3630ec0d9617310448a8702f70e9c01906b0d0118bdf9d124cf2 \
-    --hash=sha256:4a78b2b446bd7c934f5dcedc588903fb2f5eec172f3d29e52a9096a43722adfc \
-    --hash=sha256:4ab2fe47fae9e0f9dee8c04187ce5d09f48eabe611be8259444906793ab7cbce \
-    --hash=sha256:4d0d1650369165a14e14e1e47b372cfcb31d6ab44e6e33cb2d4e57265290044d \
-    --hash=sha256:549a3a73da901d5bc3ce8d24e0600d1fa85524c10287f6004fbab87672bf3e1e \
-    --hash=sha256:55086ee1064215781fff39a1af09518bc9255b50d6333f2e4c74ca09fac6a8f6 \
-    --hash=sha256:572c3763a264ba47b3cf708a44ce965d98555f618ca42c926a9c1616d8f34269 \
-    --hash=sha256:573f6eac48f4769d667c4442081b1794f52919e7edada77495aaed9236d13a96 \
-    --hash=sha256:5b4c145409bef602a690e7cfad0a15a55c13320ff7a3ad7ca59c13bb8ba4d45d \
-    --hash=sha256:6463effa3186ea09411d50efc7d85360b38d5f09b870c48e4600f63af490e56a \
-    --hash=sha256:65f6f63034100ead094b8744b3b97965785388f308a64cf8d7c34f2f2e5be0c4 \
-    --hash=sha256:663946639d296df6a2bb2aa51b60a2454ca1cb29835324c640dafb5ff2131a77 \
-    --hash=sha256:6897af51655e3691ff853668779c7bad41579facacf5fd7253b0133308cf000d \
-    --hash=sha256:68d1f8a9e9e37c1223b656399be5d6b448dea850bed7d0f87a8311f1ff3dabb0 \
-    --hash=sha256:6ac7ffc7ad6d040517be39eb591cac5ff87416c2537df6ba3cba3bae290c0fed \
-    --hash=sha256:6b3251890fff30ee142c44144871185dbe13b11bab478a88887a639655be1068 \
-    --hash=sha256:6c4caeef8fa63d06bd437cd4bdcf3ffefe6738fb1b25951440d80dc7df8c03ac \
-    --hash=sha256:6ef1d82a3af9d3eecdba2321dc1b3c238245d890843e040e41e470ffa64c3e25 \
-    --hash=sha256:753f10e867343b4511128c6ed8c82f7bec3bd026875576dfd88483c5c73b2fd8 \
-    --hash=sha256:7cd13a2e3ddeed6913a65e66e94b51d80a041145a026c27e6bb76c31a853c6ab \
-    --hash=sha256:7ed9e526742851e8d5cc9e6cf41427dfc6068d4f5a3bb03659444b4cabf6bc26 \
-    --hash=sha256:7f04c839ed0b6b98b1a7501a002144b76c18fb1c1850c8b98d458ac269e26ed2 \
-    --hash=sha256:802fe99cca7457642125a8a88a084cef28ff0cf9407060f7b93dca5aa25480db \
-    --hash=sha256:80402cd6ee291dcb72644d6eac93785fe2c8b9cb30893c1af5b8fdd753b9d40f \
-    --hash=sha256:8465322196c8b4d7ab6d1e049e4c5cb460d0394da4a27d23cc242fbf0034b6b5 \
-    --hash=sha256:86216b5cee4b06df986d214f664305142d9c76df9b6512be2738aa72a2048f99 \
-    --hash=sha256:87d1351268731db79e0f8e745d92493ee2841c974128ef629dc518b937d9194c \
-    --hash=sha256:8bdb58ff7ba23002a4c5808d608e4e6c687175724f54a5dade5fa8c67b604e4d \
-    --hash=sha256:8c622a5fe39a48f78944a87d4fb8a53ee07344641b0562c540d840748571b811 \
-    --hash=sha256:8d756e44e94489e49571086ef83b2bb8ce311e730092d2c34ca8f7d925cb20aa \
-    --hash=sha256:8f4a014bc36d3c57402e2977dada34f9c12300af536839dc38c0beab8878f38a \
-    --hash=sha256:9063e24fdb1e498ab71cb7419e24622516c4a04476b17a2dab57e8baa30d6e03 \
-    --hash=sha256:90d558489962fd4918143277a773316e56c72da56ec7aa3dc3dbbe20fdfed15b \
-    --hash=sha256:923c0c831b7cfcb071580d3f46c4baf50f174be571576556269530f4bbd79d04 \
-    --hash=sha256:95f2a5796329323b8f0512e09dbb7a1860c46a39da62ecb2324f116fa8fdc85c \
-    --hash=sha256:96b02a3dc4381e5494fad39be677abcb5e6634bf7b4fa83a6dd3112607547001 \
-    --hash=sha256:9f96df6923e21816da7e0ad3fd47dd8f94b2a5ce594e00677c0013018b813458 \
-    --hash=sha256:a10af20b82360ab00827f916a6058451b723b4e65030c5a18577c8b2de5b3389 \
-    --hash=sha256:a50aebfa173e157099939b17f18600f72f84eed3049e743b68ad15bd69b6bf99 \
-    --hash=sha256:a981a536974bbc7a512cf44ed14938cf01030a99e9b3a06dd59578882f06f985 \
-    --hash=sha256:a9a8e9031d613fd2009c182b69c7b2c1ef8239a0efb1df3f7c8da66d5dd3d537 \
-    --hash=sha256:ae5f4161f18c61806f411a13b0310bea87f987c7d2ecdbdaad0e94eb2e404238 \
-    --hash=sha256:aed38f6e4fb3f5d6bf81bfa990a07806be9d83cf7bacef998ab1a9bd660a581f \
-    --hash=sha256:b01b88d45a6fcb69667cd6d2f7a9aeb4bf53760d7fc536bf679ec94fe9f3ff3d \
-    --hash=sha256:b261ccdec7821281dade748d088bb6e9b69e6d15b30652b74cbbac25e280b796 \
-    --hash=sha256:b2b0a0c0517616b6869869f8c581d4eb2dd83a4d79e0ebcb7d373ef9956aeb0a \
-    --hash=sha256:b4a23f61ce87adf89be746c8a8974fe1c823c891d8f86eb218bb957c924bb143 \
-    --hash=sha256:bd8f7df7d12c2db9fab40bdd87a7c09b1530128315d047a086fa3ae3435cb3a8 \
-    --hash=sha256:beb58fe5cdb101e3a055192ac291b7a21e3b7ef4f67fa1d74e331a7f2124341c \
-    --hash=sha256:c002b4ffc0be611f0d9da932eb0f704fe2602a9a949d1f738e4c34c75b0863d5 \
-    --hash=sha256:c083af607d2515612056a31f0a8d9e0fcb5876b7bfc0abad3ecd275bc4ebc2d5 \
-    --hash=sha256:c180f51afb394e165eafe4ac2936a14bee3eb10debc9d9e4db8958fe36afe711 \
-    --hash=sha256:c235ebd9baae02f1b77bcea61bce332cb4331dc3617d254df3323aa01ab47bd4 \
-    --hash=sha256:cd70574b12bb8a4d2aaa0094515df2463cb429d8536cfb6c7ce983246983e5a6 \
-    --hash=sha256:d0eccceffcb53201b5bfebb52600a5fb483a20b61da9dbc885f8b103cbe7598c \
-    --hash=sha256:d965bba47ddeec8cd560687584e88cf699fd28f192ceb452d1d7ee807c5597b7 \
-    --hash=sha256:db364eca23f876da6f9e16c9da0df51aa4f104a972735574842618b8c6d999d4 \
-    --hash=sha256:ddbb2551d7e0102e7252db79ba445cdab71b26640817ab1e3e3648dad515003b \
-    --hash=sha256:deb6be0ac38ece9ba87dea880e438f25ca3eddfac8b002a2ec3d9183a454e8ae \
-    --hash=sha256:e06ed3eb3218bc64786f7db41917d4e686cc4856944f53d5bdf83a6884432e12 \
-    --hash=sha256:e27ad930a842b4c5eb8ac0016b0a54f5aebbe679340c26101df33424142c143c \
-    --hash=sha256:e537484df0d8f426ce2afb2d0f8e1c3d0b114b83f8850e5f2fbea0e797bd82ae \
-    --hash=sha256:eb00ed941194665c332bf8e078baf037d6c35d7c4f3102ea2d4f16ca94a26dc8 \
-    --hash=sha256:eb6904c354526e758fda7167b33005998fb68c46fbc10e013ca97f21ca5c8887 \
-    --hash=sha256:eb8821e09e916165e160797a6c17edda0679379a4be5c716c260e836e122f54b \
-    --hash=sha256:efcb3f6676480691518c177e3b465bcddf57cea040302f9f4e6e191af91174d4 \
-    --hash=sha256:f27273b60488abe721a075bcca6d7f3964f9f6f067c8c4c605743023d7d3944f \
-    --hash=sha256:f30c3cb33b24454a82faecaf01b19c18562b1e89558fb6c56de4d9118a032fd5 \
-    --hash=sha256:fb69256e180cb6c8a894fee62b3afebae785babc1ee98b81cdf68bbca1987f33 \
-    --hash=sha256:fd1abc0d89e30cc4e02e4064dc67fcc51bd941eb395c502aac3ec19fab46b519 \
-    --hash=sha256:ff8fa367d09b717b2a17a052544193ad76cd49979c805768879cb63d9ca50561
+charset-normalizer==3.4.0 \
+    --hash=sha256:0099d79bdfcf5c1f0c2c72f91516702ebf8b0b8ddd8905f97a8aecf49712c621 \
+    --hash=sha256:0713f3adb9d03d49d365b70b84775d0a0d18e4ab08d12bc46baa6132ba78aaf6 \
+    --hash=sha256:07afec21bbbbf8a5cc3651aa96b980afe2526e7f048fdfb7f1014d84acc8b6d8 \
+    --hash=sha256:0b309d1747110feb25d7ed6b01afdec269c647d382c857ef4663bbe6ad95a912 \
+    --hash=sha256:0d99dd8ff461990f12d6e42c7347fd9ab2532fb70e9621ba520f9e8637161d7c \
+    --hash=sha256:0de7b687289d3c1b3e8660d0741874abe7888100efe14bd0f9fd7141bcbda92b \
+    --hash=sha256:1110e22af8ca26b90bd6364fe4c763329b0ebf1ee213ba32b68c73de5752323d \
+    --hash=sha256:130272c698667a982a5d0e626851ceff662565379baf0ff2cc58067b81d4f11d \
+    --hash=sha256:136815f06a3ae311fae551c3df1f998a1ebd01ddd424aa5603a4336997629e95 \
+    --hash=sha256:14215b71a762336254351b00ec720a8e85cada43b987da5a042e4ce3e82bd68e \
+    --hash=sha256:1db4e7fefefd0f548d73e2e2e041f9df5c59e178b4c72fbac4cc6f535cfb1565 \
+    --hash=sha256:1ffd9493de4c922f2a38c2bf62b831dcec90ac673ed1ca182fe11b4d8e9f2a64 \
+    --hash=sha256:2006769bd1640bdf4d5641c69a3d63b71b81445473cac5ded39740a226fa88ab \
+    --hash=sha256:20587d20f557fe189b7947d8e7ec5afa110ccf72a3128d61a2a387c3313f46be \
+    --hash=sha256:223217c3d4f82c3ac5e29032b3f1c2eb0fb591b72161f86d93f5719079dae93e \
+    --hash=sha256:27623ba66c183eca01bf9ff833875b459cad267aeeb044477fedac35e19ba907 \
+    --hash=sha256:285e96d9d53422efc0d7a17c60e59f37fbf3dfa942073f666db4ac71e8d726d0 \
+    --hash=sha256:2de62e8801ddfff069cd5c504ce3bc9672b23266597d4e4f50eda28846c322f2 \
+    --hash=sha256:2f6c34da58ea9c1a9515621f4d9ac379871a8f21168ba1b5e09d74250de5ad62 \
+    --hash=sha256:309a7de0a0ff3040acaebb35ec45d18db4b28232f21998851cfa709eeff49d62 \
+    --hash=sha256:35c404d74c2926d0287fbd63ed5d27eb911eb9e4a3bb2c6d294f3cfd4a9e0c23 \
+    --hash=sha256:3710a9751938947e6327ea9f3ea6332a09bf0ba0c09cae9cb1f250bd1f1549bc \
+    --hash=sha256:3d59d125ffbd6d552765510e3f31ed75ebac2c7470c7274195b9161a32350284 \
+    --hash=sha256:40d3ff7fc90b98c637bda91c89d51264a3dcf210cade3a2c6f838c7268d7a4ca \
+    --hash=sha256:425c5f215d0eecee9a56cdb703203dda90423247421bf0d67125add85d0c4455 \
+    --hash=sha256:43193c5cda5d612f247172016c4bb71251c784d7a4d9314677186a838ad34858 \
+    --hash=sha256:44aeb140295a2f0659e113b31cfe92c9061622cadbc9e2a2f7b8ef6b1e29ef4b \
+    --hash=sha256:47334db71978b23ebcf3c0f9f5ee98b8d65992b65c9c4f2d34c2eaf5bcaf0594 \
+    --hash=sha256:4796efc4faf6b53a18e3d46343535caed491776a22af773f366534056c4e1fbc \
+    --hash=sha256:4a51b48f42d9358460b78725283f04bddaf44a9358197b889657deba38f329db \
+    --hash=sha256:4b67fdab07fdd3c10bb21edab3cbfe8cf5696f453afce75d815d9d7223fbe88b \
+    --hash=sha256:4ec9dd88a5b71abfc74e9df5ebe7921c35cbb3b641181a531ca65cdb5e8e4dea \
+    --hash=sha256:4f9fc98dad6c2eaa32fc3af1417d95b5e3d08aff968df0cd320066def971f9a6 \
+    --hash=sha256:54b6a92d009cbe2fb11054ba694bc9e284dad30a26757b1e372a1fdddaf21920 \
+    --hash=sha256:55f56e2ebd4e3bc50442fbc0888c9d8c94e4e06a933804e2af3e89e2f9c1c749 \
+    --hash=sha256:5726cf76c982532c1863fb64d8c6dd0e4c90b6ece9feb06c9f202417a31f7dd7 \
+    --hash=sha256:5d447056e2ca60382d460a604b6302d8db69476fd2015c81e7c35417cfabe4cd \
+    --hash=sha256:5ed2e36c3e9b4f21dd9422f6893dec0abf2cca553af509b10cd630f878d3eb99 \
+    --hash=sha256:5ff2ed8194587faf56555927b3aa10e6fb69d931e33953943bc4f837dfee2242 \
+    --hash=sha256:62f60aebecfc7f4b82e3f639a7d1433a20ec32824db2199a11ad4f5e146ef5ee \
+    --hash=sha256:63bc5c4ae26e4bc6be6469943b8253c0fd4e4186c43ad46e713ea61a0ba49129 \
+    --hash=sha256:6b40e8d38afe634559e398cc32b1472f376a4099c75fe6299ae607e404c033b2 \
+    --hash=sha256:6b493a043635eb376e50eedf7818f2f322eabbaa974e948bd8bdd29eb7ef2a51 \
+    --hash=sha256:6dba5d19c4dfab08e58d5b36304b3f92f3bd5d42c1a3fa37b5ba5cdf6dfcbcee \
+    --hash=sha256:6fd30dc99682dc2c603c2b315bded2799019cea829f8bf57dc6b61efde6611c8 \
+    --hash=sha256:707b82d19e65c9bd28b81dde95249b07bf9f5b90ebe1ef17d9b57473f8a64b7b \
+    --hash=sha256:7706f5850360ac01d80c89bcef1640683cc12ed87f42579dab6c5d3ed6888613 \
+    --hash=sha256:7782afc9b6b42200f7362858f9e73b1f8316afb276d316336c0ec3bd73312742 \
+    --hash=sha256:79983512b108e4a164b9c8d34de3992f76d48cadc9554c9e60b43f308988aabe \
+    --hash=sha256:7f683ddc7eedd742e2889d2bfb96d69573fde1d92fcb811979cdb7165bb9c7d3 \
+    --hash=sha256:82357d85de703176b5587dbe6ade8ff67f9f69a41c0733cf2425378b49954de5 \
+    --hash=sha256:84450ba661fb96e9fd67629b93d2941c871ca86fc38d835d19d4225ff946a631 \
+    --hash=sha256:86f4e8cca779080f66ff4f191a685ced73d2f72d50216f7112185dc02b90b9b7 \
+    --hash=sha256:8cda06946eac330cbe6598f77bb54e690b4ca93f593dee1568ad22b04f347c15 \
+    --hash=sha256:8ce7fd6767a1cc5a92a639b391891bf1c268b03ec7e021c7d6d902285259685c \
+    --hash=sha256:8ff4e7cdfdb1ab5698e675ca622e72d58a6fa2a8aa58195de0c0061288e6e3ea \
+    --hash=sha256:9289fd5dddcf57bab41d044f1756550f9e7cf0c8e373b8cdf0ce8773dc4bd417 \
+    --hash=sha256:92a7e36b000bf022ef3dbb9c46bfe2d52c047d5e3f3343f43204263c5addc250 \
+    --hash=sha256:92db3c28b5b2a273346bebb24857fda45601aef6ae1c011c0a997106581e8a88 \
+    --hash=sha256:95c3c157765b031331dd4db3c775e58deaee050a3042fcad72cbc4189d7c8dca \
+    --hash=sha256:980b4f289d1d90ca5efcf07958d3eb38ed9c0b7676bf2831a54d4f66f9c27dfa \
+    --hash=sha256:9ae4ef0b3f6b41bad6366fb0ea4fc1d7ed051528e113a60fa2a65a9abb5b1d99 \
+    --hash=sha256:9c98230f5042f4945f957d006edccc2af1e03ed5e37ce7c373f00a5a4daa6149 \
+    --hash=sha256:9fa2566ca27d67c86569e8c85297aaf413ffab85a8960500f12ea34ff98e4c41 \
+    --hash=sha256:a14969b8691f7998e74663b77b4c36c0337cb1df552da83d5c9004a93afdb574 \
+    --hash=sha256:a8aacce6e2e1edcb6ac625fb0f8c3a9570ccc7bfba1f63419b3769ccf6a00ed0 \
+    --hash=sha256:a8e538f46104c815be19c975572d74afb53f29650ea2025bbfaef359d2de2f7f \
+    --hash=sha256:aa41e526a5d4a9dfcfbab0716c7e8a1b215abd3f3df5a45cf18a12721d31cb5d \
+    --hash=sha256:aa693779a8b50cd97570e5a0f343538a8dbd3e496fa5dcb87e29406ad0299654 \
+    --hash=sha256:ab22fbd9765e6954bc0bcff24c25ff71dcbfdb185fcdaca49e81bac68fe724d3 \
+    --hash=sha256:ab2e5bef076f5a235c3774b4f4028a680432cded7cad37bba0fd90d64b187d19 \
+    --hash=sha256:ab973df98fc99ab39080bfb0eb3a925181454d7c3ac8a1e695fddfae696d9e90 \
+    --hash=sha256:af73657b7a68211996527dbfeffbb0864e043d270580c5aef06dc4b659a4b578 \
+    --hash=sha256:b197e7094f232959f8f20541ead1d9862ac5ebea1d58e9849c1bf979255dfac9 \
+    --hash=sha256:b295729485b06c1a0683af02a9e42d2caa9db04a373dc38a6a58cdd1e8abddf1 \
+    --hash=sha256:b8831399554b92b72af5932cdbbd4ddc55c55f631bb13ff8fe4e6536a06c5c51 \
+    --hash=sha256:b8dcd239c743aa2f9c22ce674a145e0a25cb1566c495928440a181ca1ccf6719 \
+    --hash=sha256:bcb4f8ea87d03bc51ad04add8ceaf9b0f085ac045ab4d74e73bbc2dc033f0236 \
+    --hash=sha256:bd7af3717683bea4c87acd8c0d3d5b44d56120b26fd3f8a692bdd2d5260c620a \
+    --hash=sha256:bf4475b82be41b07cc5e5ff94810e6a01f276e37c2d55571e3fe175e467a1a1c \
+    --hash=sha256:c3e446d253bd88f6377260d07c895816ebf33ffffd56c1c792b13bff9c3e1ade \
+    --hash=sha256:c57516e58fd17d03ebe67e181a4e4e2ccab1168f8c2976c6a334d4f819fe5944 \
+    --hash=sha256:c94057af19bc953643a33581844649a7fdab902624d2eb739738a30e2b3e60fc \
+    --hash=sha256:cab5d0b79d987c67f3b9e9c53f54a61360422a5a0bc075f43cab5621d530c3b6 \
+    --hash=sha256:ce031db0408e487fd2775d745ce30a7cd2923667cf3b69d48d219f1d8f5ddeb6 \
+    --hash=sha256:cee4373f4d3ad28f1ab6290684d8e2ebdb9e7a1b74fdc39e4c211995f77bec27 \
+    --hash=sha256:d5b054862739d276e09928de37c79ddeec42a6e1bfc55863be96a36ba22926f6 \
+    --hash=sha256:dbe03226baf438ac4fda9e2d0715022fd579cb641c4cf639fa40d53b2fe6f3e2 \
+    --hash=sha256:dc15e99b2d8a656f8e666854404f1ba54765871104e50c8e9813af8a7db07f12 \
+    --hash=sha256:dcaf7c1524c0542ee2fc82cc8ec337f7a9f7edee2532421ab200d2b920fc97cf \
+    --hash=sha256:dd4eda173a9fcccb5f2e2bd2a9f423d180194b1bf17cf59e3269899235b2a114 \
+    --hash=sha256:dd9a8bd8900e65504a305bf8ae6fa9fbc66de94178c420791d0293702fce2df7 \
+    --hash=sha256:de7376c29d95d6719048c194a9cf1a1b0393fbe8488a22008610b0361d834ecf \
+    --hash=sha256:e7fdd52961feb4c96507aa649550ec2a0d527c086d284749b2f582f2d40a2e0d \
+    --hash=sha256:e91f541a85298cf35433bf66f3fab2a4a2cff05c127eeca4af174f6d497f0d4b \
+    --hash=sha256:e9e3c4c9e1ed40ea53acf11e2a386383c3304212c965773704e4603d589343ed \
+    --hash=sha256:ee803480535c44e7f5ad00788526da7d85525cfefaf8acf8ab9a310000be4b03 \
+    --hash=sha256:f09cb5a7bbe1ecae6e87901a2eb23e0256bb524a79ccc53eb0b7629fbe7677c4 \
+    --hash=sha256:f19c1585933c82098c2a520f8ec1227f20e339e33aca8fa6f956f6691b784e67 \
+    --hash=sha256:f1a2f519ae173b5b6a2c9d5fa3116ce16e48b3462c8b96dfdded11055e3d6365 \
+    --hash=sha256:f28f891ccd15c514a0981f3b9db9aa23d62fe1a99997512b0491d2ed323d229a \
+    --hash=sha256:f3e73a4255342d4eb26ef6df01e3962e73aa29baa3124a8e824c5d3364a65748 \
+    --hash=sha256:f606a1881d2663630ea5b8ce2efe2111740df4b687bd78b34a8131baa007f79b \
+    --hash=sha256:fe9f97feb71aa9896b81973a7bbada8c49501dc73e58a10fcef6663af95e5079 \
+    --hash=sha256:ffc519621dce0c767e96b9c53f09c5d215578e10b02c285809f76509a3931482
     # via requests
 click==8.0.4 \
     --hash=sha256:6a7a62563bbfabfda3a38f3023a1db4a35978c0abd76f6c9605ecd6554d6d9b1 \

From 90e1260b431dd3e64c23bd3fe2820af4c7c9816c Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 19:14:48 +0100
Subject: [PATCH 025/133] chore(deps): update dependency cffi to v1.17.1 (#430)

---
 .kokoro/requirements.txt | 133 ++++++++++++++++++++-------------------
 1 file changed, 68 insertions(+), 65 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index e4c3632b..d5d459ff 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -24,71 +24,74 @@ certifi==2024.8.30 \
     --hash=sha256:922820b53db7a7257ffbda3f597266d435245903d80737e34f8a45ff3e3230d8 \
     --hash=sha256:bec941d2aa8195e248a60b31ff9f0558284cf01a52591ceda73ea9afffd69fd9
     # via requests
-cffi==1.15.1 \
-    --hash=sha256:00a9ed42e88df81ffae7a8ab6d9356b371399b91dbdf0c3cb1e84c03a13aceb5 \
-    --hash=sha256:03425bdae262c76aad70202debd780501fabeaca237cdfddc008987c0e0f59ef \
-    --hash=sha256:04ed324bda3cda42b9b695d51bb7d54b680b9719cfab04227cdd1e04e5de3104 \
-    --hash=sha256:0e2642fe3142e4cc4af0799748233ad6da94c62a8bec3a6648bf8ee68b1c7426 \
-    --hash=sha256:173379135477dc8cac4bc58f45db08ab45d228b3363adb7af79436135d028405 \
-    --hash=sha256:198caafb44239b60e252492445da556afafc7d1e3ab7a1fb3f0584ef6d742375 \
-    --hash=sha256:1e74c6b51a9ed6589199c787bf5f9875612ca4a8a0785fb2d4a84429badaf22a \
-    --hash=sha256:2012c72d854c2d03e45d06ae57f40d78e5770d252f195b93f581acf3ba44496e \
-    --hash=sha256:21157295583fe8943475029ed5abdcf71eb3911894724e360acff1d61c1d54bc \
-    --hash=sha256:2470043b93ff09bf8fb1d46d1cb756ce6132c54826661a32d4e4d132e1977adf \
-    --hash=sha256:285d29981935eb726a4399badae8f0ffdff4f5050eaa6d0cfc3f64b857b77185 \
-    --hash=sha256:30d78fbc8ebf9c92c9b7823ee18eb92f2e6ef79b45ac84db507f52fbe3ec4497 \
-    --hash=sha256:320dab6e7cb2eacdf0e658569d2575c4dad258c0fcc794f46215e1e39f90f2c3 \
-    --hash=sha256:33ab79603146aace82c2427da5ca6e58f2b3f2fb5da893ceac0c42218a40be35 \
-    --hash=sha256:3548db281cd7d2561c9ad9984681c95f7b0e38881201e157833a2342c30d5e8c \
-    --hash=sha256:3799aecf2e17cf585d977b780ce79ff0dc9b78d799fc694221ce814c2c19db83 \
-    --hash=sha256:39d39875251ca8f612b6f33e6b1195af86d1b3e60086068be9cc053aa4376e21 \
-    --hash=sha256:3b926aa83d1edb5aa5b427b4053dc420ec295a08e40911296b9eb1b6170f6cca \
-    --hash=sha256:3bcde07039e586f91b45c88f8583ea7cf7a0770df3a1649627bf598332cb6984 \
-    --hash=sha256:3d08afd128ddaa624a48cf2b859afef385b720bb4b43df214f85616922e6a5ac \
-    --hash=sha256:3eb6971dcff08619f8d91607cfc726518b6fa2a9eba42856be181c6d0d9515fd \
-    --hash=sha256:40f4774f5a9d4f5e344f31a32b5096977b5d48560c5592e2f3d2c4374bd543ee \
-    --hash=sha256:4289fc34b2f5316fbb762d75362931e351941fa95fa18789191b33fc4cf9504a \
-    --hash=sha256:470c103ae716238bbe698d67ad020e1db9d9dba34fa5a899b5e21577e6d52ed2 \
-    --hash=sha256:4f2c9f67e9821cad2e5f480bc8d83b8742896f1242dba247911072d4fa94c192 \
-    --hash=sha256:50a74364d85fd319352182ef59c5c790484a336f6db772c1a9231f1c3ed0cbd7 \
-    --hash=sha256:54a2db7b78338edd780e7ef7f9f6c442500fb0d41a5a4ea24fff1c929d5af585 \
-    --hash=sha256:5635bd9cb9731e6d4a1132a498dd34f764034a8ce60cef4f5319c0541159392f \
-    --hash=sha256:59c0b02d0a6c384d453fece7566d1c7e6b7bae4fc5874ef2ef46d56776d61c9e \
-    --hash=sha256:5d598b938678ebf3c67377cdd45e09d431369c3b1a5b331058c338e201f12b27 \
-    --hash=sha256:5df2768244d19ab7f60546d0c7c63ce1581f7af8b5de3eb3004b9b6fc8a9f84b \
-    --hash=sha256:5ef34d190326c3b1f822a5b7a45f6c4535e2f47ed06fec77d3d799c450b2651e \
-    --hash=sha256:6975a3fac6bc83c4a65c9f9fcab9e47019a11d3d2cf7f3c0d03431bf145a941e \
-    --hash=sha256:6c9a799e985904922a4d207a94eae35c78ebae90e128f0c4e521ce339396be9d \
-    --hash=sha256:70df4e3b545a17496c9b3f41f5115e69a4f2e77e94e1d2a8e1070bc0c38c8a3c \
-    --hash=sha256:7473e861101c9e72452f9bf8acb984947aa1661a7704553a9f6e4baa5ba64415 \
-    --hash=sha256:8102eaf27e1e448db915d08afa8b41d6c7ca7a04b7d73af6514df10a3e74bd82 \
-    --hash=sha256:87c450779d0914f2861b8526e035c5e6da0a3199d8f1add1a665e1cbc6fc6d02 \
-    --hash=sha256:8b7ee99e510d7b66cdb6c593f21c043c248537a32e0bedf02e01e9553a172314 \
-    --hash=sha256:91fc98adde3d7881af9b59ed0294046f3806221863722ba7d8d120c575314325 \
-    --hash=sha256:94411f22c3985acaec6f83c6df553f2dbe17b698cc7f8ae751ff2237d96b9e3c \
-    --hash=sha256:98d85c6a2bef81588d9227dde12db8a7f47f639f4a17c9ae08e773aa9c697bf3 \
-    --hash=sha256:9ad5db27f9cabae298d151c85cf2bad1d359a1b9c686a275df03385758e2f914 \
-    --hash=sha256:a0b71b1b8fbf2b96e41c4d990244165e2c9be83d54962a9a1d118fd8657d2045 \
-    --hash=sha256:a0f100c8912c114ff53e1202d0078b425bee3649ae34d7b070e9697f93c5d52d \
-    --hash=sha256:a591fe9e525846e4d154205572a029f653ada1a78b93697f3b5a8f1f2bc055b9 \
-    --hash=sha256:a5c84c68147988265e60416b57fc83425a78058853509c1b0629c180094904a5 \
-    --hash=sha256:a66d3508133af6e8548451b25058d5812812ec3798c886bf38ed24a98216fab2 \
-    --hash=sha256:a8c4917bd7ad33e8eb21e9a5bbba979b49d9a97acb3a803092cbc1133e20343c \
-    --hash=sha256:b3bbeb01c2b273cca1e1e0c5df57f12dce9a4dd331b4fa1635b8bec26350bde3 \
-    --hash=sha256:cba9d6b9a7d64d4bd46167096fc9d2f835e25d7e4c121fb2ddfc6528fb0413b2 \
-    --hash=sha256:cc4d65aeeaa04136a12677d3dd0b1c0c94dc43abac5860ab33cceb42b801c1e8 \
-    --hash=sha256:ce4bcc037df4fc5e3d184794f27bdaab018943698f4ca31630bc7f84a7b69c6d \
-    --hash=sha256:cec7d9412a9102bdc577382c3929b337320c4c4c4849f2c5cdd14d7368c5562d \
-    --hash=sha256:d400bfb9a37b1351253cb402671cea7e89bdecc294e8016a707f6d1d8ac934f9 \
-    --hash=sha256:d61f4695e6c866a23a21acab0509af1cdfd2c013cf256bbf5b6b5e2695827162 \
-    --hash=sha256:db0fbb9c62743ce59a9ff687eb5f4afbe77e5e8403d6697f7446e5f609976f76 \
-    --hash=sha256:dd86c085fae2efd48ac91dd7ccffcfc0571387fe1193d33b6394db7ef31fe2a4 \
-    --hash=sha256:e00b098126fd45523dd056d2efba6c5a63b71ffe9f2bbe1a4fe1716e1d0c331e \
-    --hash=sha256:e229a521186c75c8ad9490854fd8bbdd9a0c9aa3a524326b55be83b54d4e0ad9 \
-    --hash=sha256:e263d77ee3dd201c3a142934a086a4450861778baaeeb45db4591ef65550b0a6 \
-    --hash=sha256:ed9cb427ba5504c1dc15ede7d516b84757c3e3d7868ccc85121d9310d27eed0b \
-    --hash=sha256:fa6693661a4c91757f4412306191b6dc88c1703f780c8234035eac011922bc01 \
-    --hash=sha256:fcd131dd944808b5bdb38e6f5b53013c5aa4f334c5cad0c72742f6eba4b73db0
+cffi==1.17.1 \
+    --hash=sha256:045d61c734659cc045141be4bae381a41d89b741f795af1dd018bfb532fd0df8 \
+    --hash=sha256:0984a4925a435b1da406122d4d7968dd861c1385afe3b45ba82b750f229811e2 \
+    --hash=sha256:0e2b1fac190ae3ebfe37b979cc1ce69c81f4e4fe5746bb401dca63a9062cdaf1 \
+    --hash=sha256:0f048dcf80db46f0098ccac01132761580d28e28bc0f78ae0d58048063317e15 \
+    --hash=sha256:1257bdabf294dceb59f5e70c64a3e2f462c30c7ad68092d01bbbfb1c16b1ba36 \
+    --hash=sha256:1c39c6016c32bc48dd54561950ebd6836e1670f2ae46128f67cf49e789c52824 \
+    --hash=sha256:1d599671f396c4723d016dbddb72fe8e0397082b0a77a4fab8028923bec050e8 \
+    --hash=sha256:28b16024becceed8c6dfbc75629e27788d8a3f9030691a1dbf9821a128b22c36 \
+    --hash=sha256:2bb1a08b8008b281856e5971307cc386a8e9c5b625ac297e853d36da6efe9c17 \
+    --hash=sha256:30c5e0cb5ae493c04c8b42916e52ca38079f1b235c2f8ae5f4527b963c401caf \
+    --hash=sha256:31000ec67d4221a71bd3f67df918b1f88f676f1c3b535a7eb473255fdc0b83fc \
+    --hash=sha256:386c8bf53c502fff58903061338ce4f4950cbdcb23e2902d86c0f722b786bbe3 \
+    --hash=sha256:3edc8d958eb099c634dace3c7e16560ae474aa3803a5df240542b305d14e14ed \
+    --hash=sha256:45398b671ac6d70e67da8e4224a065cec6a93541bb7aebe1b198a61b58c7b702 \
+    --hash=sha256:46bf43160c1a35f7ec506d254e5c890f3c03648a4dbac12d624e4490a7046cd1 \
+    --hash=sha256:4ceb10419a9adf4460ea14cfd6bc43d08701f0835e979bf821052f1805850fe8 \
+    --hash=sha256:51392eae71afec0d0c8fb1a53b204dbb3bcabcb3c9b807eedf3e1e6ccf2de903 \
+    --hash=sha256:5da5719280082ac6bd9aa7becb3938dc9f9cbd57fac7d2871717b1feb0902ab6 \
+    --hash=sha256:610faea79c43e44c71e1ec53a554553fa22321b65fae24889706c0a84d4ad86d \
+    --hash=sha256:636062ea65bd0195bc012fea9321aca499c0504409f413dc88af450b57ffd03b \
+    --hash=sha256:6883e737d7d9e4899a8a695e00ec36bd4e5e4f18fabe0aca0efe0a4b44cdb13e \
+    --hash=sha256:6b8b4a92e1c65048ff98cfe1f735ef8f1ceb72e3d5f0c25fdb12087a23da22be \
+    --hash=sha256:6f17be4345073b0a7b8ea599688f692ac3ef23ce28e5df79c04de519dbc4912c \
+    --hash=sha256:706510fe141c86a69c8ddc029c7910003a17353970cff3b904ff0686a5927683 \
+    --hash=sha256:72e72408cad3d5419375fc87d289076ee319835bdfa2caad331e377589aebba9 \
+    --hash=sha256:733e99bc2df47476e3848417c5a4540522f234dfd4ef3ab7fafdf555b082ec0c \
+    --hash=sha256:7596d6620d3fa590f677e9ee430df2958d2d6d6de2feeae5b20e82c00b76fbf8 \
+    --hash=sha256:78122be759c3f8a014ce010908ae03364d00a1f81ab5c7f4a7a5120607ea56e1 \
+    --hash=sha256:805b4371bf7197c329fcb3ead37e710d1bca9da5d583f5073b799d5c5bd1eee4 \
+    --hash=sha256:85a950a4ac9c359340d5963966e3e0a94a676bd6245a4b55bc43949eee26a655 \
+    --hash=sha256:8f2cdc858323644ab277e9bb925ad72ae0e67f69e804f4898c070998d50b1a67 \
+    --hash=sha256:9755e4345d1ec879e3849e62222a18c7174d65a6a92d5b346b1863912168b595 \
+    --hash=sha256:98e3969bcff97cae1b2def8ba499ea3d6f31ddfdb7635374834cf89a1a08ecf0 \
+    --hash=sha256:a08d7e755f8ed21095a310a693525137cfe756ce62d066e53f502a83dc550f65 \
+    --hash=sha256:a1ed2dd2972641495a3ec98445e09766f077aee98a1c896dcb4ad0d303628e41 \
+    --hash=sha256:a24ed04c8ffd54b0729c07cee15a81d964e6fee0e3d4d342a27b020d22959dc6 \
+    --hash=sha256:a45e3c6913c5b87b3ff120dcdc03f6131fa0065027d0ed7ee6190736a74cd401 \
+    --hash=sha256:a9b15d491f3ad5d692e11f6b71f7857e7835eb677955c00cc0aefcd0669adaf6 \
+    --hash=sha256:ad9413ccdeda48c5afdae7e4fa2192157e991ff761e7ab8fdd8926f40b160cc3 \
+    --hash=sha256:b2ab587605f4ba0bf81dc0cb08a41bd1c0a5906bd59243d56bad7668a6fc6c16 \
+    --hash=sha256:b62ce867176a75d03a665bad002af8e6d54644fad99a3c70905c543130e39d93 \
+    --hash=sha256:c03e868a0b3bc35839ba98e74211ed2b05d2119be4e8a0f224fba9384f1fe02e \
+    --hash=sha256:c59d6e989d07460165cc5ad3c61f9fd8f1b4796eacbd81cee78957842b834af4 \
+    --hash=sha256:c7eac2ef9b63c79431bc4b25f1cd649d7f061a28808cbc6c47b534bd789ef964 \
+    --hash=sha256:c9c3d058ebabb74db66e431095118094d06abf53284d9c81f27300d0e0d8bc7c \
+    --hash=sha256:ca74b8dbe6e8e8263c0ffd60277de77dcee6c837a3d0881d8c1ead7268c9e576 \
+    --hash=sha256:caaf0640ef5f5517f49bc275eca1406b0ffa6aa184892812030f04c2abf589a0 \
+    --hash=sha256:cdf5ce3acdfd1661132f2a9c19cac174758dc2352bfe37d98aa7512c6b7178b3 \
+    --hash=sha256:d016c76bdd850f3c626af19b0542c9677ba156e4ee4fccfdd7848803533ef662 \
+    --hash=sha256:d01b12eeeb4427d3110de311e1774046ad344f5b1a7403101878976ecd7a10f3 \
+    --hash=sha256:d63afe322132c194cf832bfec0dc69a99fb9bb6bbd550f161a49e9e855cc78ff \
+    --hash=sha256:da95af8214998d77a98cc14e3a3bd00aa191526343078b530ceb0bd710fb48a5 \
+    --hash=sha256:dd398dbc6773384a17fe0d3e7eeb8d1a21c2200473ee6806bb5e6a8e62bb73dd \
+    --hash=sha256:de2ea4b5833625383e464549fec1bc395c1bdeeb5f25c4a3a82b5a8c756ec22f \
+    --hash=sha256:de55b766c7aa2e2a3092c51e0483d700341182f08e67c63630d5b6f200bb28e5 \
+    --hash=sha256:df8b1c11f177bc2313ec4b2d46baec87a5f3e71fc8b45dab2ee7cae86d9aba14 \
+    --hash=sha256:e03eab0a8677fa80d646b5ddece1cbeaf556c313dcfac435ba11f107ba117b5d \
+    --hash=sha256:e221cf152cff04059d011ee126477f0d9588303eb57e88923578ace7baad17f9 \
+    --hash=sha256:e31ae45bc2e29f6b2abd0de1cc3b9d5205aa847cafaecb8af1476a609a2f6eb7 \
+    --hash=sha256:edae79245293e15384b51f88b00613ba9f7198016a5948b5dddf4917d4d26382 \
+    --hash=sha256:f1e22e8c4419538cb197e4dd60acc919d7696e5ef98ee4da4e01d3f8cfa4cc5a \
+    --hash=sha256:f3a2b4222ce6b60e2e8b337bb9596923045681d71e5a082783484d845390938e \
+    --hash=sha256:f6a16c31041f09ead72d69f583767292f750d24913dadacf5756b966aacb3f1a \
+    --hash=sha256:f75c7ab1f9e4aca5414ed4d8e5c0e303a34f4421f8a0d47a4d019ceff0ab6af4 \
+    --hash=sha256:f79fc4fc25f1c8698ff97788206bb3c2598949bfe0fef03d299eb1b5356ada99 \
+    --hash=sha256:f7f5baafcc48261359e14bcd6d9bff6d4b28d9103847c9e136694cb0501aef87 \
+    --hash=sha256:fc48c783f9c87e60831201f2cce7f3b2e4846bf4d8728eabe54d60700b318a0b
     # via cryptography
 charset-normalizer==3.4.0 \
     --hash=sha256:0099d79bdfcf5c1f0c2c72f91516702ebf8b0b8ddd8905f97a8aecf49712c621 \

From 7db3f374510673d6521b16ca44d21043069d6ee7 Mon Sep 17 00:00:00 2001
From: Sri Harsha CH <57220027+harshachinta@users.noreply.github.com>
Date: Thu, 31 Oct 2024 23:48:06 +0530
Subject: [PATCH 026/133] feat: support dml returning (#335)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat: support dml returning

* feat: add tests for dml returning

* feat: update tests

* feat: support dml returning

* feat: add test in sqlalchemy 2.0

* feat: add returning support for sqlalchemy 2.0

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>
---
 test/test_suite_13.py | 43 +++++++++++++++++++++++++++++++++++++++++++
 test/test_suite_14.py | 43 +++++++++++++++++++++++++++++++++++++++++++
 test/test_suite_20.py | 43 +++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 129 insertions(+)

diff --git a/test/test_suite_13.py b/test/test_suite_13.py
index ca11979b..b0cddf59 100644
--- a/test/test_suite_13.py
+++ b/test/test_suite_13.py
@@ -2065,6 +2065,49 @@ def test_create_engine_wo_database(self):
             assert connection.connection.database is None
 
 
+class ReturningTest(fixtures.TestBase):
+    def setUp(self):
+        self._engine = create_engine(get_db_url())
+        metadata = MetaData()
+
+        self._table = Table(
+            "returning_test",
+            metadata,
+            Column("id", Integer, primary_key=True),
+            Column("data", String(16), nullable=False),
+        )
+
+        metadata.create_all(self._engine)
+
+    def test_returning_for_insert_and_update(self):
+        random_id = random.randint(1, 1000)
+        with self._engine.begin() as connection:
+            stmt = (
+                self._table.insert()
+                .values(id=random_id, data="some % value")
+                .returning(self._table.c.id)
+            )
+            row = connection.execute(stmt).fetchall()
+            eq_(
+                row,
+                [(random_id,)],
+            )
+
+        with self._engine.begin() as connection:
+            update_text = "some + value"
+            stmt = (
+                self._table.update()
+                .values(data=update_text)
+                .where(self._table.c.id == random_id)
+                .returning(self._table.c.data)
+            )
+            row = connection.execute(stmt).fetchall()
+            eq_(
+                row,
+                [(update_text,)],
+            )
+
+
 @pytest.mark.skipif(
     bool(os.environ.get("SPANNER_EMULATOR_HOST")), reason="Skipped on emulator"
 )
diff --git a/test/test_suite_14.py b/test/test_suite_14.py
index 87437b83..e4183821 100644
--- a/test/test_suite_14.py
+++ b/test/test_suite_14.py
@@ -2399,6 +2399,49 @@ def test_create_engine_wo_database(self):
             assert connection.connection.database is None
 
 
+class ReturningTest(fixtures.TestBase):
+    def setUp(self):
+        self._engine = create_engine(get_db_url())
+        metadata = MetaData()
+
+        self._table = Table(
+            "returning_test",
+            metadata,
+            Column("id", Integer, primary_key=True),
+            Column("data", String(16), nullable=False),
+        )
+
+        metadata.create_all(self._engine)
+
+    def test_returning_for_insert_and_update(self):
+        random_id = random.randint(1, 1000)
+        with self._engine.begin() as connection:
+            stmt = (
+                self._table.insert()
+                .values(id=random_id, data="some % value")
+                .returning(self._table.c.id)
+            )
+            row = connection.execute(stmt).fetchall()
+            eq_(
+                row,
+                [(random_id,)],
+            )
+
+        with self._engine.begin() as connection:
+            update_text = "some + value"
+            stmt = (
+                self._table.update()
+                .values(data=update_text)
+                .where(self._table.c.id == random_id)
+                .returning(self._table.c.data)
+            )
+            row = connection.execute(stmt).fetchall()
+            eq_(
+                row,
+                [(update_text,)],
+            )
+
+
 @pytest.mark.skipif(
     bool(os.environ.get("SPANNER_EMULATOR_HOST")), reason="Skipped on emulator"
 )
diff --git a/test/test_suite_20.py b/test/test_suite_20.py
index cff1a30d..4902b3ab 100644
--- a/test/test_suite_20.py
+++ b/test/test_suite_20.py
@@ -3113,6 +3113,49 @@ def test_create_engine_wo_database(self):
             assert connection.connection.database is None
 
 
+class ReturningTest(fixtures.TestBase):
+    def setUp(self):
+        self._engine = create_engine(get_db_url())
+        metadata = MetaData()
+
+        self._table = Table(
+            "returning_test",
+            metadata,
+            Column("id", Integer, primary_key=True),
+            Column("data", String(16), nullable=False),
+        )
+
+        metadata.create_all(self._engine)
+
+    def test_returning_for_insert_and_update(self):
+        random_id = random.randint(1, 1000)
+        with self._engine.begin() as connection:
+            stmt = (
+                self._table.insert()
+                .values(id=random_id, data="some % value")
+                .returning(self._table.c.id)
+            )
+            row = connection.execute(stmt).fetchall()
+            eq_(
+                row,
+                [(random_id,)],
+            )
+
+        with self._engine.begin() as connection:
+            update_text = "some + value"
+            stmt = (
+                self._table.update()
+                .values(data=update_text)
+                .where(self._table.c.id == random_id)
+                .returning(self._table.c.data)
+            )
+            row = connection.execute(stmt).fetchall()
+            eq_(
+                row,
+                [(update_text,)],
+            )
+
+
 @pytest.mark.skipif(
     bool(os.environ.get("SPANNER_EMULATOR_HOST")), reason="Skipped on emulator"
 )

From a30f5436ae95d2d215953cfde3d2fc8aa733272b Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 20:08:16 +0100
Subject: [PATCH 027/133] chore(deps): update dependency colorlog to v6.9.0
 (#432)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index d5d459ff..dedc8191 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -206,9 +206,9 @@ click==8.0.4 \
     # via
     #   gcp-docuploader
     #   gcp-releasetool
-colorlog==6.7.0 \
-    --hash=sha256:0d33ca236784a1ba3ff9c532d4964126d8a2c44f1f0cb1d2b0728196f512f662 \
-    --hash=sha256:bd94bd21c1e13fac7bd3153f4bc3a7dc0eb0974b8bc2fdf1a989e474f6e582e5
+colorlog==6.9.0 \
+    --hash=sha256:5906e71acd67cb07a71e779c47c4bcb45fb8c2993eebe9e5adcd6a6f1b283eff \
+    --hash=sha256:bfba54a1b93b94f54e1f4fe48395725a3d92fd2a4af702f6bd70946bdc0c6ac2
     # via
     #   gcp-docuploader
     #   nox

From 673aa828c0af8b5ff33171e0a7a62713dc1f150c Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 31 Oct 2024 20:08:28 +0100
Subject: [PATCH 028/133] chore(deps): update dependency docutils to v0.21.2
 (#433)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index dedc8191..563837a8 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -251,9 +251,9 @@ distlib==0.3.9 \
     --hash=sha256:47f8c22fd27c27e25a65601af709b38e4f0a45ea4fc2e710f65755fa8caaaf87 \
     --hash=sha256:a60f20dea646b8a33f3e7772f74dc0b2d0772d2837ee1342a00645c81edf9403
     # via virtualenv
-docutils==0.19 \
-    --hash=sha256:33995a6753c30b7f577febfc2c50411fec6aac7f7ffeb7c4cfe5991072dcf9e6 \
-    --hash=sha256:5e1de4d849fee02c63b040a4a3fd567f4ab104defd8a5511fbbc24a8a017efbc
+docutils==0.21.2 \
+    --hash=sha256:3a6b18732edf182daa3cd12775bbb338cf5691468f91eeeb109deff6ebfa986f \
+    --hash=sha256:dafca5b9e384f0e419294eb4d2ff9fa826435bf15f15b7bd45723e8ad76811b2
     # via readme-renderer
 filelock==3.8.0 \
     --hash=sha256:55447caa666f2198c5b6b13a26d2084d26fa5b115c00d065664b2124680c4edc \

From 9ada0c5ec5940cf3ed471b7a1483a98ab5568954 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 06:46:19 +0100
Subject: [PATCH 029/133] chore(deps): update dependency filelock to v3.16.1
 (#434)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [filelock](https://redirect.github.com/tox-dev/py-filelock) | `==3.8.0` -> `==3.16.1` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/filelock/3.16.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/filelock/3.16.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/filelock/3.8.0/3.16.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/filelock/3.8.0/3.16.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>tox-dev/py-filelock (filelock)</summary>

### [`v3.16.1`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.16.1)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.16.0...3.16.1)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   CI improvements by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/filelock/pull/362](https://redirect.github.com/tox-dev/filelock/pull/362)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.16.0...3.16.1

### [`v3.16.0`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.16.0)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.15.4...3.16.0)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   Test Python 3.13 by [@&#8203;hugovk](https://redirect.github.com/hugovk) in [https://togithub.com/tox-dev/filelock/pull/352](https://redirect.github.com/tox-dev/filelock/pull/352)
-   Add 3.13 to CI by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/filelock/pull/359](https://redirect.github.com/tox-dev/filelock/pull/359)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.15.4...3.16.0

### [`v3.15.4`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.15.4)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.15.3...3.15.4)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   Pass `file_lock` as positional argument by [@&#8203;kwist-sgr](https://redirect.github.com/kwist-sgr) in [https://togithub.com/tox-dev/filelock/pull/347](https://redirect.github.com/tox-dev/filelock/pull/347)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.15.3...3.15.4

### [`v3.15.3`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.15.3)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.15.2...3.15.3)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   Add test for virtualenv stability by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/filelock/pull/344](https://redirect.github.com/tox-dev/filelock/pull/344)
-   Fix `TypeError: _CountedFileLock.__init__() got an unexpected keyword argument 'timeout'` by [@&#8203;kwist-sgr](https://redirect.github.com/kwist-sgr) in [https://togithub.com/tox-dev/filelock/pull/345](https://redirect.github.com/tox-dev/filelock/pull/345)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.15.2...3.15.3

### [`v3.15.2`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.15.2)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.15.1...3.15.2)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   Use a metaclass to implement the singleton pattern by [@&#8203;kwist-sgr](https://redirect.github.com/kwist-sgr) in [https://togithub.com/tox-dev/filelock/pull/340](https://redirect.github.com/tox-dev/filelock/pull/340)

#### New Contributors

-   [@&#8203;kwist-sgr](https://redirect.github.com/kwist-sgr) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/340](https://redirect.github.com/tox-dev/filelock/pull/340)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.15.1...3.15.2

### [`v3.15.1`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.15.1)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.15.0...3.15.1)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   Hotfix: Restore **init** method; more robust initialization for singleton locks by [@&#8203;ethanbb](https://redirect.github.com/ethanbb) in [https://togithub.com/tox-dev/filelock/pull/338](https://redirect.github.com/tox-dev/filelock/pull/338)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.15.0...3.15.1

### [`v3.15.0`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.15.0)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.14.0...3.15.0)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   asyncio support by [@&#8203;Ovizro](https://redirect.github.com/Ovizro) in [https://togithub.com/tox-dev/filelock/pull/332](https://redirect.github.com/tox-dev/filelock/pull/332)
-   Don't initialize BaseFileLock when just returning existing instance by [@&#8203;ethanbb](https://redirect.github.com/ethanbb) in [https://togithub.com/tox-dev/filelock/pull/334](https://redirect.github.com/tox-dev/filelock/pull/334)

#### New Contributors

-   [@&#8203;Ovizro](https://redirect.github.com/Ovizro) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/332](https://redirect.github.com/tox-dev/filelock/pull/332)
-   [@&#8203;ethanbb](https://redirect.github.com/ethanbb) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/334](https://redirect.github.com/tox-dev/filelock/pull/334)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.14.0...3.15.0

### [`v3.14.0`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.14.0)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.13.4...3.14.0)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   feat: `blocking` parameter on lock constructor with tests and docs by [@&#8203;iamkhav](https://redirect.github.com/iamkhav) in [https://togithub.com/tox-dev/filelock/pull/325](https://redirect.github.com/tox-dev/filelock/pull/325)

#### New Contributors

-   [@&#8203;iamkhav](https://redirect.github.com/iamkhav) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/325](https://redirect.github.com/tox-dev/filelock/pull/325)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.13.4...3.14.0

### [`v3.13.4`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.13.4)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.13.3...3.13.4)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   Raise error on incompatible singleton timeout and mode args by [@&#8203;nefrob](https://redirect.github.com/nefrob) in [https://togithub.com/tox-dev/filelock/pull/320](https://redirect.github.com/tox-dev/filelock/pull/320)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.13.3...3.13.4

### [`v3.13.3`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.13.3)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.13.2...3.13.3)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   Make singleton class instance dict unique per subclass by [@&#8203;nefrob](https://redirect.github.com/nefrob) in [https://togithub.com/tox-dev/filelock/pull/318](https://redirect.github.com/tox-dev/filelock/pull/318)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.13.2...3.13.3

### [`v3.13.2`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.13.2)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.13.1...3.13.2)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   Fixed small typo in \_unix.py by [@&#8203;snemes](https://redirect.github.com/snemes) in [https://togithub.com/tox-dev/filelock/pull/302](https://redirect.github.com/tox-dev/filelock/pull/302)
-   Update SECURITY.md to reflect Python 3.7 support dropoff by [@&#8203;kemzeb](https://redirect.github.com/kemzeb) in [https://togithub.com/tox-dev/filelock/pull/304](https://redirect.github.com/tox-dev/filelock/pull/304)
-   Update index.rst to improve the demo usage by [@&#8203;youkaichao](https://redirect.github.com/youkaichao) in [https://togithub.com/tox-dev/filelock/pull/314](https://redirect.github.com/tox-dev/filelock/pull/314)
-   \[BugFix] fix permission denied error when lock file is placed in `/tmp` by [@&#8203;kota-iizuka](https://redirect.github.com/kota-iizuka) in [https://togithub.com/tox-dev/filelock/pull/317](https://redirect.github.com/tox-dev/filelock/pull/317)

#### New Contributors

-   [@&#8203;snemes](https://redirect.github.com/snemes) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/302](https://redirect.github.com/tox-dev/filelock/pull/302)
-   [@&#8203;kemzeb](https://redirect.github.com/kemzeb) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/304](https://redirect.github.com/tox-dev/filelock/pull/304)
-   [@&#8203;youkaichao](https://redirect.github.com/youkaichao) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/314](https://redirect.github.com/tox-dev/filelock/pull/314)
-   [@&#8203;kota-iizuka](https://redirect.github.com/kota-iizuka) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/317](https://redirect.github.com/tox-dev/filelock/pull/317)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.13.1...3.13.2

### [`v3.13.1`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.13.1)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.13.0...3.13.1)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   Allow users to subclass FileLock with custom keyword arguments by [@&#8203;hmaarrfk](https://redirect.github.com/hmaarrfk) in [https://togithub.com/tox-dev/filelock/pull/284](https://redirect.github.com/tox-dev/filelock/pull/284)

#### New Contributors

-   [@&#8203;hmaarrfk](https://redirect.github.com/hmaarrfk) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/284](https://redirect.github.com/tox-dev/filelock/pull/284)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.13.0...3.13.1

### [`v3.13.0`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.13.0)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.12.4...3.13.0)

<!-- Release notes generated using configuration in .github/release.yml at 3.13.0 -->

#### What's Changed

-   Support reentrant locking on lock file path via optional singleton instance by [@&#8203;nefrob](https://redirect.github.com/nefrob) in [https://togithub.com/tox-dev/filelock/pull/283](https://redirect.github.com/tox-dev/filelock/pull/283)

#### New Contributors

-   [@&#8203;nefrob](https://redirect.github.com/nefrob) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/283](https://redirect.github.com/tox-dev/filelock/pull/283)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.12.4...3.13.0

### [`v3.12.4`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.12.4)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.12.3...3.12.4)

<!-- Release notes generated using configuration in .github/release.yml at main -->

#### What's Changed

-   change typing-extensions to be installed only with the \[typing] extra by [@&#8203;asottile](https://redirect.github.com/asottile) in [https://togithub.com/tox-dev/filelock/pull/276](https://redirect.github.com/tox-dev/filelock/pull/276)

#### New Contributors

-   [@&#8203;asottile](https://redirect.github.com/asottile) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/276](https://redirect.github.com/tox-dev/filelock/pull/276)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.12.3...3.12.4

### [`v3.12.3`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.12.3)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.12.2...3.12.3)

<!-- Release notes generated using configuration in .github/release.yml at main -->

##### What's Changed

-   Fix import ordering by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/filelock/pull/246](https://redirect.github.com/tox-dev/filelock/pull/246)
-   Exclude dependabot and pre-commit ci from release notes by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/filelock/pull/251](https://redirect.github.com/tox-dev/filelock/pull/251)
-   Create parent directories if necessary by [@&#8203;gerlero](https://redirect.github.com/gerlero) in [https://togithub.com/tox-dev/filelock/pull/254](https://redirect.github.com/tox-dev/filelock/pull/254)
-   fix ci 08 21 by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/filelock/pull/263](https://redirect.github.com/tox-dev/filelock/pull/263)
-   lock_file type-hint by [@&#8203;keller00](https://redirect.github.com/keller00) in [https://togithub.com/tox-dev/filelock/pull/267](https://redirect.github.com/tox-dev/filelock/pull/267)
-   adding tox.ini to sdist by [@&#8203;keller00](https://redirect.github.com/keller00) in [https://togithub.com/tox-dev/filelock/pull/265](https://redirect.github.com/tox-dev/filelock/pull/265)

##### New Contributors

-   [@&#8203;gerlero](https://redirect.github.com/gerlero) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/254](https://redirect.github.com/tox-dev/filelock/pull/254)
-   [@&#8203;keller00](https://redirect.github.com/keller00) made their first contribution in [https://togithub.com/tox-dev/filelock/pull/267](https://redirect.github.com/tox-dev/filelock/pull/267)

**Full Changelog**: https://togithub.com/tox-dev/filelock/compare/3.12.2...3.12.3

### [`v3.12.2`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.12.2)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.12.1...3.12.2)

#### What's Changed

-   Restore 'if TYPE_CHECKING' syntax for FileLock definition by [@&#8203;dlax](https://redirect.github.com/dlax) in [https://togithub.com/tox-dev/py-filelock/pull/245](https://redirect.github.com/tox-dev/py-filelock/pull/245)

#### New Contributors

-   [@&#8203;dlax](https://redirect.github.com/dlax) made their first contribution in [https://togithub.com/tox-dev/py-filelock/pull/245](https://redirect.github.com/tox-dev/py-filelock/pull/245)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.12.1...3.12.2

### [`v3.12.1`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.12.1)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.12.0...3.12.1)

##### What's Changed

-   Add trusted-publish by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/236](https://redirect.github.com/tox-dev/py-filelock/pull/236)
-   Add 3.12 support by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/237](https://redirect.github.com/tox-dev/py-filelock/pull/237)
-   Bump pypa/gh-action-pypi-publish from 1.8.5 to 1.8.6 by [@&#8203;dependabot](https://redirect.github.com/dependabot) in [https://togithub.com/tox-dev/py-filelock/pull/239](https://redirect.github.com/tox-dev/py-filelock/pull/239)
-   git ls-files -z -- .github/workflows/check.yml | xargs -0 sed -i 's|3.12.0-alpha.7|3.12.0-beta.1|g' by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/243](https://redirect.github.com/tox-dev/py-filelock/pull/243)
-   Use ruff by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/244](https://redirect.github.com/tox-dev/py-filelock/pull/244)
-   Fix test_bad_lock_file for other OSes by [@&#8203;TheMatt2](https://redirect.github.com/TheMatt2) in [https://togithub.com/tox-dev/py-filelock/pull/242](https://redirect.github.com/tox-dev/py-filelock/pull/242)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.12.0...3.12.1

### [`v3.12.0`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.12.0)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.11.0...3.12.0)

#### What's Changed

-   Fix: [#&#8203;225](https://redirect.github.com/tox-dev/py-filelock/issues/225) :Get rid of warning about inability to link to \_thread.\_local. by [@&#8203;csm10495](https://redirect.github.com/csm10495) in [https://togithub.com/tox-dev/py-filelock/pull/226](https://redirect.github.com/tox-dev/py-filelock/pull/226)
-   Bump deps and tools by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/228](https://redirect.github.com/tox-dev/py-filelock/pull/228)
-   Add umask check to tests so umask 002 is valid by [@&#8203;TheMatt2](https://redirect.github.com/TheMatt2) in [https://togithub.com/tox-dev/py-filelock/pull/227](https://redirect.github.com/tox-dev/py-filelock/pull/227)
-   Fix lock hang on Windows by [@&#8203;TheMatt2](https://redirect.github.com/TheMatt2) in [https://togithub.com/tox-dev/py-filelock/pull/231](https://redirect.github.com/tox-dev/py-filelock/pull/231)
-   Conditionally disable/enable thread-local lock behavior. by [@&#8203;csm10495](https://redirect.github.com/csm10495) in [https://togithub.com/tox-dev/py-filelock/pull/232](https://redirect.github.com/tox-dev/py-filelock/pull/232)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.11.0...3.12.0

### [`v3.11.0`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.11.0)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.10.7...3.11.0)

#### What's Changed

-   Bump pypa/gh-action-pypi-publish from 1.8.3 to 1.8.5 by [@&#8203;dependabot](https://redirect.github.com/dependabot) in [https://togithub.com/tox-dev/py-filelock/pull/218](https://redirect.github.com/tox-dev/py-filelock/pull/218)
-   Fix [#&#8203;220](https://redirect.github.com/tox-dev/py-filelock/issues/220): Allow filelock test thread to catch any exceptions by [@&#8203;TheMatt2](https://redirect.github.com/TheMatt2) in [https://togithub.com/tox-dev/py-filelock/pull/221](https://redirect.github.com/tox-dev/py-filelock/pull/221)
-   Bump deps and tools by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/222](https://redirect.github.com/tox-dev/py-filelock/pull/222)
-   Run more pypy versions in CI but without coverage by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/224](https://redirect.github.com/tox-dev/py-filelock/pull/224)
-   Make the lock a thread local variable by [@&#8203;csm10495](https://redirect.github.com/csm10495) in [https://togithub.com/tox-dev/py-filelock/pull/219](https://redirect.github.com/tox-dev/py-filelock/pull/219)

#### New Contributors

-   [@&#8203;csm10495](https://redirect.github.com/csm10495) made their first contribution in [https://togithub.com/tox-dev/py-filelock/pull/219](https://redirect.github.com/tox-dev/py-filelock/pull/219)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.10.7...3.11.0

### [`v3.10.7`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.10.7)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.10.6...3.10.7)

#### What's Changed

-   use fchmod by [@&#8203;jfennick](https://redirect.github.com/jfennick) in [https://togithub.com/tox-dev/py-filelock/pull/214](https://redirect.github.com/tox-dev/py-filelock/pull/214)

#### New Contributors

-   [@&#8203;jfennick](https://redirect.github.com/jfennick) made their first contribution in [https://togithub.com/tox-dev/py-filelock/pull/214](https://redirect.github.com/tox-dev/py-filelock/pull/214)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.10.6...3.10.7

### [`v3.10.6`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.10.6)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.10.5...3.10.6)

#### What's Changed

-   Bugfix/147 by [@&#8203;jahrules](https://redirect.github.com/jahrules) in [https://togithub.com/tox-dev/py-filelock/pull/213](https://redirect.github.com/tox-dev/py-filelock/pull/213)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.10.5...3.10.6

### [`v3.10.5`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.10.5)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.10.4...3.10.5)

#### What's Changed

-   proposed fix for issue [#&#8203;67](https://redirect.github.com/tox-dev/py-filelock/issues/67) by [@&#8203;jahrules](https://redirect.github.com/jahrules) in [https://togithub.com/tox-dev/py-filelock/pull/212](https://redirect.github.com/tox-dev/py-filelock/pull/212)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.10.4...3.10.5

### [`v3.10.4`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.10.4)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.10.3...3.10.4)

#### What's Changed

-   updated os.open to preserve mode by [@&#8203;jahrules](https://redirect.github.com/jahrules) in [https://togithub.com/tox-dev/py-filelock/pull/211](https://redirect.github.com/tox-dev/py-filelock/pull/211)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.10.3...3.10.4

### [`v3.10.3`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.10.3)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.10.2...3.10.3)

#### What's Changed

-   Bump pypa/gh-action-pypi-publish from 1.8.1 to 1.8.3 by [@&#8203;dependabot](https://redirect.github.com/dependabot) in [https://togithub.com/tox-dev/py-filelock/pull/207](https://redirect.github.com/tox-dev/py-filelock/pull/207)
-   bug fix by [@&#8203;jahrules](https://redirect.github.com/jahrules) in [https://togithub.com/tox-dev/py-filelock/pull/209](https://redirect.github.com/tox-dev/py-filelock/pull/209)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.10.2...3.10.3

### [`v3.10.2`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.10.2)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.10.1...3.10.2)

##### What's Changed

-   changed from os.umask to os.chmod by [@&#8203;jahrules](https://redirect.github.com/jahrules) in [https://togithub.com/tox-dev/py-filelock/pull/206](https://redirect.github.com/tox-dev/py-filelock/pull/206)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.10.1...3.10.2

### [`v3.10.1`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.10.1)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.10.0...3.10.1)

#### What's Changed

-   Bump pypa/gh-action-pypi-publish from 1.7.1 to 1.8.1 by [@&#8203;dependabot](https://redirect.github.com/dependabot) in [https://togithub.com/tox-dev/py-filelock/pull/200](https://redirect.github.com/tox-dev/py-filelock/pull/200)
-   Bump deps and tools by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/201](https://redirect.github.com/tox-dev/py-filelock/pull/201)
-   Properly pickle of Timeout objects + test cases by [@&#8203;TheMatt2](https://redirect.github.com/TheMatt2) in [https://togithub.com/tox-dev/py-filelock/pull/203](https://redirect.github.com/tox-dev/py-filelock/pull/203)

#### New Contributors

-   [@&#8203;TheMatt2](https://redirect.github.com/TheMatt2) made their first contribution in [https://togithub.com/tox-dev/py-filelock/pull/203](https://redirect.github.com/tox-dev/py-filelock/pull/203)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.10.0...3.10.1

### [`v3.10.0`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.10.0)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.9.1...3.10.0)

#### What's Changed

-   added multiuser support and associated tests by [@&#8203;jahrules](https://redirect.github.com/jahrules) in [https://togithub.com/tox-dev/py-filelock/pull/192](https://redirect.github.com/tox-dev/py-filelock/pull/192)

#### New Contributors

-   [@&#8203;jahrules](https://redirect.github.com/jahrules) made their first contribution in [https://togithub.com/tox-dev/py-filelock/pull/192](https://redirect.github.com/tox-dev/py-filelock/pull/192)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.9.1...3.10.0

### [`v3.9.1`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.9.1)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.9.0...3.9.1)

#### What's Changed

-   \[pre-commit.ci] pre-commit autoupdate by [@&#8203;pre-commit-ci](https://redirect.github.com/pre-commit-ci) in [https://togithub.com/tox-dev/py-filelock/pull/188](https://redirect.github.com/tox-dev/py-filelock/pull/188)
-   Bump deps and tools by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/193](https://redirect.github.com/tox-dev/py-filelock/pull/193)
-   Bump deps and tools by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/197](https://redirect.github.com/tox-dev/py-filelock/pull/197)
-   Bump pypa/gh-action-pypi-publish from 1.6.4 to 1.7.1 by [@&#8203;dependabot](https://redirect.github.com/dependabot) in [https://togithub.com/tox-dev/py-filelock/pull/198](https://redirect.github.com/tox-dev/py-filelock/pull/198)
-   use time.perf_counter instead of time.monotonic by [@&#8203;zpz](https://redirect.github.com/zpz) in [https://togithub.com/tox-dev/py-filelock/pull/194](https://redirect.github.com/tox-dev/py-filelock/pull/194)

#### New Contributors

-   [@&#8203;zpz](https://redirect.github.com/zpz) made their first contribution in [https://togithub.com/tox-dev/py-filelock/pull/194](https://redirect.github.com/tox-dev/py-filelock/pull/194)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.9.0...3.9.1

### [`v3.9.0`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.9.0)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.8.2...3.9.0)

##### What's Changed

-   Move to hatchling build backend by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/185](https://redirect.github.com/tox-dev/py-filelock/pull/185)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.8.2...3.9.0

### [`v3.8.2`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.8.2)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.8.1...3.8.2)

##### What's Changed

-   Bump pypa/gh-action-pypi-publish from 1.5.1 to 1.6.1 by [@&#8203;dependabot](https://redirect.github.com/dependabot) in [https://togithub.com/tox-dev/py-filelock/pull/178](https://redirect.github.com/tox-dev/py-filelock/pull/178)
-   Update the license classifier to "Unlicense" by [@&#8203;jond01](https://redirect.github.com/jond01) in [https://togithub.com/tox-dev/py-filelock/pull/180](https://redirect.github.com/tox-dev/py-filelock/pull/180)

##### New Contributors

-   [@&#8203;jond01](https://redirect.github.com/jond01) made their first contribution in [https://togithub.com/tox-dev/py-filelock/pull/180](https://redirect.github.com/tox-dev/py-filelock/pull/180)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.8.1...3.8.2

### [`v3.8.1`](https://redirect.github.com/tox-dev/filelock/releases/tag/3.8.1)

[Compare Source](https://redirect.github.com/tox-dev/py-filelock/compare/3.8.0...3.8.1)

##### What's Changed

-   \[pre-commit.ci] pre-commit autoupdate by [@&#8203;pre-commit-ci](https://redirect.github.com/pre-commit-ci) in [https://togithub.com/tox-dev/py-filelock/pull/166](https://redirect.github.com/tox-dev/py-filelock/pull/166)
-   link to flufl.lock by [@&#8203;dholth](https://redirect.github.com/dholth) in [https://togithub.com/tox-dev/py-filelock/pull/167](https://redirect.github.com/tox-dev/py-filelock/pull/167)
-   \[pre-commit.ci] pre-commit autoupdate by [@&#8203;pre-commit-ci](https://redirect.github.com/pre-commit-ci) in [https://togithub.com/tox-dev/py-filelock/pull/168](https://redirect.github.com/tox-dev/py-filelock/pull/168)
-   \[pre-commit.ci] pre-commit autoupdate by [@&#8203;pre-commit-ci](https://redirect.github.com/pre-commit-ci) in [https://togithub.com/tox-dev/py-filelock/pull/169](https://redirect.github.com/tox-dev/py-filelock/pull/169)
-   \[pre-commit.ci] pre-commit autoupdate by [@&#8203;pre-commit-ci](https://redirect.github.com/pre-commit-ci) in [https://togithub.com/tox-dev/py-filelock/pull/170](https://redirect.github.com/tox-dev/py-filelock/pull/170)
-   fix BaseFileLock.timeout's getter/setter being obscured by itself by [@&#8203;dearfl](https://redirect.github.com/dearfl) in [https://togithub.com/tox-dev/py-filelock/pull/172](https://redirect.github.com/tox-dev/py-filelock/pull/172)
-   Fix mypy fails understanding FileLock by [@&#8203;gaborbernat](https://redirect.github.com/gaborbernat) in [https://togithub.com/tox-dev/py-filelock/pull/177](https://redirect.github.com/tox-dev/py-filelock/pull/177)

##### New Contributors

-   [@&#8203;dholth](https://redirect.github.com/dholth) made their first contribution in [https://togithub.com/tox-dev/py-filelock/pull/167](https://redirect.github.com/tox-dev/py-filelock/pull/167)
-   [@&#8203;dearfl](https://redirect.github.com/dearfl) made their first contribution in [https://togithub.com/tox-dev/py-filelock/pull/172](https://redirect.github.com/tox-dev/py-filelock/pull/172)

**Full Changelog**: https://togithub.com/tox-dev/py-filelock/compare/3.8.0...3.8.1

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 563837a8..f5349c7a 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -255,9 +255,9 @@ docutils==0.21.2 \
     --hash=sha256:3a6b18732edf182daa3cd12775bbb338cf5691468f91eeeb109deff6ebfa986f \
     --hash=sha256:dafca5b9e384f0e419294eb4d2ff9fa826435bf15f15b7bd45723e8ad76811b2
     # via readme-renderer
-filelock==3.8.0 \
-    --hash=sha256:55447caa666f2198c5b6b13a26d2084d26fa5b115c00d065664b2124680c4edc \
-    --hash=sha256:617eb4e5eedc82fc5f47b6d61e4d11cb837c56cb4544e39081099fa17ad109d4
+filelock==3.16.1 \
+    --hash=sha256:2082e5703d51fbf98ea75855d9d5527e33d8ff23099bec374a134febee6946b0 \
+    --hash=sha256:c249fbfcd5db47e5e2d6d62198e565475ee65e4831e2561c8e313fa7eb961435
     # via virtualenv
 gcp-docuploader==0.6.5 \
     --hash=sha256:30221d4ac3e5a2b9c69aa52fdbef68cc3f27d0e6d0d90e220fc024584b8d2318 \

From df4b43576ea88ee5b6ff234d77c634cb88289950 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 07:54:33 +0100
Subject: [PATCH 030/133] chore(deps): update dependency urllib3 to v2 (#479)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index f5349c7a..4a3b5b9a 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -597,9 +597,9 @@ typing-extensions==4.8.0 \
     --hash=sha256:8f92fc8806f9a6b641eaa5318da32b44d401efaac0f6678c9bc448ba3605faa0 \
     --hash=sha256:df8e4339e9cb77357558cbdbceca33c303714cf861d1eef15e1070055ae8b7ef
     # via -r requirements.in
-urllib3==1.26.20 \
-    --hash=sha256:0ed14ccfbf1c30a9072c7ca157e4319b70d65f623e91e7b32fadb2853431016e \
-    --hash=sha256:40c2dc0c681e47eb8f90e7e27bf6ff7df2e677421fd46756da1161c39ca70d32
+urllib3==2.2.3 \
+    --hash=sha256:ca899ca043dcb1bafa3e262d73aa25c465bfb49e0bd9dd5d59f1d0acba2f8fac \
+    --hash=sha256:e7d814a81dad81e6caf2ec9fdedb284ecc9c73076b62654547cc64ccdcae26e9
     # via
     #   requests
     #   twine

From 8c8dc1c90d02895d7d29418bb3ebc3ea3840e215 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 07:57:06 +0100
Subject: [PATCH 031/133] chore(deps): update dependency twine to v5 (#478)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 4a3b5b9a..b82afa85 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -589,9 +589,9 @@ six==1.16.0 \
     #   gcp-docuploader
     #   google-auth
     #   python-dateutil
-twine==4.0.2 \
-    --hash=sha256:929bc3c280033347a00f847236564d1c52a3e61b1ac2516c97c48f3ceab756d8 \
-    --hash=sha256:9e102ef5fdd5a20661eb88fad46338806c3bd32cf1db729603fe3697b1bc83c8
+twine==5.1.1 \
+    --hash=sha256:215dbe7b4b94c2c50a7315c0275d2258399280fbb7d04182c7e55e24b5f93997 \
+    --hash=sha256:9aa0825139c02b3434d913545c7b847a21c835e11597f5255842d457da2322db
     # via -r requirements.in
 typing-extensions==4.8.0 \
     --hash=sha256:8f92fc8806f9a6b641eaa5318da32b44d401efaac0f6678c9bc448ba3605faa0 \

From 357d6757f514c8a854a6a9e9455d04bb42693341 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 07:57:20 +0100
Subject: [PATCH 032/133] chore(deps): update dependency requests-toolbelt to
 v1 (#476)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index b82afa85..ec46784e 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -561,9 +561,9 @@ requests==2.32.3 \
     #   google-cloud-storage
     #   requests-toolbelt
     #   twine
-requests-toolbelt==0.10.1 \
-    --hash=sha256:18565aa58116d9951ac39baa288d3adb5b3ff975c4f25eee78555d89e8f247f7 \
-    --hash=sha256:62e09f7ff5ccbda92772a29f394a49c3ad6cb181d568b1337626b2abb628a63d
+requests-toolbelt==1.0.0 \
+    --hash=sha256:7681a0a3d047012b5bdc0ee37d7f8f07ebe76ab08caeccfc3921ce23c88d5bc6 \
+    --hash=sha256:cccfdd665f0a24fcf4726e690f65639d272bb0637b9b92dfd91a5568ccf6bd06
     # via twine
 rfc3986==2.0.0 \
     --hash=sha256:50b1502b60e289cb37883f3dfd34532b8873c7de9f49bb546641ce9cbd256ebd \

From 5563debec962ddccaf452e5183f6675712eff54c Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 07:57:46 +0100
Subject: [PATCH 033/133] chore(deps): update dependency packaging to v24
 (#472)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index ec46784e..dac0586f 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -467,9 +467,9 @@ nox==2022.8.7 \
     --hash=sha256:1b894940551dc5c389f9271d197ca5d655d40bdc6ccf93ed6880e4042760a34b \
     --hash=sha256:96cca88779e08282a699d672258ec01eb7c792d35bbbf538c723172bce23212c
     # via -r requirements.in
-packaging==21.3 \
-    --hash=sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb \
-    --hash=sha256:ef103e05f519cdc783ae24ea4e2e0f508a9c99b2d4969652eed6a2e1ea5bd522
+packaging==24.1 \
+    --hash=sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002 \
+    --hash=sha256:5b8f2217dbdbd2f7f384c41c628544e6d52f2d0f53c6d0c3ea61aa5d1d7ff124
     # via
     #   gcp-releasetool
     #   nox

From dfebf9658eb150233a57d7b505b95ae5bf978409 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 07:58:19 +0100
Subject: [PATCH 034/133] chore(deps): update dependency bleach to v6 (#465)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [bleach](https://redirect.github.com/mozilla/bleach) | `==5.0.1` -> `==6.2.0` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/bleach/6.2.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/bleach/6.2.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/bleach/5.0.1/6.2.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/bleach/5.0.1/6.2.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>mozilla/bleach (bleach)</summary>

### [`v6.2.0`](https://redirect.github.com/mozilla/bleach/blob/HEAD/CHANGES#Version-620-October-29th-2024)

[Compare Source](https://redirect.github.com/mozilla/bleach/compare/v6.1.0...v6.2.0)

**Backwards incompatible changes**

-   Dropped support for Python 3.8. ([#&#8203;737](https://redirect.github.com/mozilla/bleach/issues/737))

**Security fixes**

None

**Bug fixes**

-   Add support for Python 3.13. ([#&#8203;736](https://redirect.github.com/mozilla/bleach/issues/736))
-   Remove six depdenncy. ([#&#8203;618](https://redirect.github.com/mozilla/bleach/issues/618))
-   Update known-good versions for tinycss2. ([#&#8203;732](https://redirect.github.com/mozilla/bleach/issues/732))
-   Fix additional < followed by characters and EOF issues. ([#&#8203;728](https://redirect.github.com/mozilla/bleach/issues/728))

### [`v6.1.0`](https://redirect.github.com/mozilla/bleach/blob/HEAD/CHANGES#Version-610-October-6th-2023)

[Compare Source](https://redirect.github.com/mozilla/bleach/compare/v6.0.0...v6.1.0)

**Backwards incompatible changes**

-   Dropped support for Python 3.7. ([#&#8203;709](https://redirect.github.com/mozilla/bleach/issues/709))

**Security fixes**

None

**Bug fixes**

-   Add support for Python 3.12. ([#&#8203;710](https://redirect.github.com/mozilla/bleach/issues/710))
-   Fix linkify with arrays in querystring ([#&#8203;436](https://redirect.github.com/mozilla/bleach/issues/436))
-   Handle more cases with < followed by character data ([#&#8203;705](https://redirect.github.com/mozilla/bleach/issues/705))
-   Fix entities inside a tags in linkification ([#&#8203;704](https://redirect.github.com/mozilla/bleach/issues/704))
-   Update cap for tinycss2 to <1.3 ([#&#8203;702](https://redirect.github.com/mozilla/bleach/issues/702))
-   Updated Sphinx requirement
-   Add dependabot for github actions and update github actions

### [`v6.0.0`](https://redirect.github.com/mozilla/bleach/blob/HEAD/CHANGES#Version-600-January-23rd-2023)

[Compare Source](https://redirect.github.com/mozilla/bleach/compare/v5.0.1...v6.0.0)

**Backwards incompatible changes**

-   `bleach.clean`, `bleach.sanitizer.Cleaner`,
    `bleach.html5lib_shim.BleachHTMLParser`: the `tags` and `protocols`
    arguments were changed from lists to sets.

    Old pre-6.0.0:

    .. code-block:: python

    bleach.clean(
    "some text",
    tags=\["a", "p", "img"],

### ^               ^ list

         protocols=["http", "https"],

### ^               ^ list

     )

New 6.0.0 and later:

.. code-block:: python

     bleach.clean(
         "some text",
         tags={"a", "p", "img"},

### ^               ^ set

         protocols={"http", "https"},

### ^               ^ set

     )

-   `bleach.linkify`, `bleach.linkifier.Linker`: the `skip_tags` and
    `recognized_tags` arguments were changed from lists to sets.

    Old pre-6.0.0:

    .. code-block:: python

    bleach.linkify(
    "some text",
    skip_tags=\["pre"],

### ^     ^ list

     )

     linker = Linker(
         skip_tags=["pre"],

### ^     ^ list

         recognized_tags=html5lib_shim.HTML_TAGS + ["custom-element"],

### ^ ^                ^ list

### |

### | list concatenation

     )

New 6.0.0 and later:

.. code-block:: python

     bleach.linkify(
         "some text",
         skip_tags={"pre"},

### ^     ^ set

     )

     linker = Linker(
         skip_tags={"pre"},

### ^     ^ set

         recognized_tags=html5lib_shim.HTML_TAGS | {"custom-element"},

### ^ ^                ^ set

### |

### | union operator

     )

-   `bleach.sanitizer.BleachSanitizerFilter`: `strip_allowed_elements` is now
    `strip_allowed_tags`. We now use "tags" everywhere rather than a mishmash
    of "tags" in some places and "elements" in others.

**Security fixes**

None

**Bug fixes**

-   Add support for Python 3.11. ([#&#8203;675](https://redirect.github.com/mozilla/bleach/issues/675))

-   Fix API weirness in `BleachSanitizerFilter`. ([#&#8203;649](https://redirect.github.com/mozilla/bleach/issues/649))

    We're using "tags" instead of "elements" everywhere--no more weird
    overloading of "elements" anymore.

    Also, it no longer calls the superclass constructor.

-   Add warning when `css_sanitizer` isn't set, but the `style`
    attribute is allowed. ([#&#8203;676](https://redirect.github.com/mozilla/bleach/issues/676))

-   Fix linkify handling of character entities. ([#&#8203;501](https://redirect.github.com/mozilla/bleach/issues/501))

-   Rework dev dependencies to use `requirements-dev.txt` and
    `requirements-flake8.txt` instead of extras.

-   Fix project infrastructure to be tox-based so it's easier to have CI
    run the same things we're running in development and with flake8
    in an isolated environment.

-   Update action versions in CI.

-   Switch to f-strings where possible. Make tests parametrized to be
    easier to read/maintain.

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index dac0586f..b9331662 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -12,9 +12,9 @@ attrs==22.2.0 \
     --hash=sha256:29e95c7f6778868dbd49170f98f8818f78f3dc5e0e37c0b1f474e3561b240836 \
     --hash=sha256:c9227bfc2f01993c03f68db37d1d15c9690188323c067c641f1a35ca58185f99
     # via gcp-releasetool
-bleach==5.0.1 \
-    --hash=sha256:085f7f33c15bd408dd9b17a4ad77c577db66d76203e5984b1bd59baeee948b2a \
-    --hash=sha256:0d03255c47eb9bd2f26aa9bb7f2107732e7e8fe195ca2f64709fcf3b0a4a085c
+bleach==6.2.0 \
+    --hash=sha256:117d9c6097a7c3d22fd578fcd8d35ff1e125df6736f554da4e432fdd63f31e5e \
+    --hash=sha256:123e894118b8a599fd80d3ec1a6d4cc7ce4e5882b1317a7e1ba69b56e95f991f
     # via readme-renderer
 cachetools==5.5.0 \
     --hash=sha256:02134e8439cdc2ffb62023ce1debca2944c3f289d66bb17ead3ab3dede74b292 \

From a520d155efb5d6e29e6782ed16fe2c5cb68ba1c8 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:00:31 +0100
Subject: [PATCH 035/133] chore(deps): update dependency attrs to v24 (#464)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [attrs](https://redirect.github.com/python-attrs/attrs) ([changelog](https://www.attrs.org/en/stable/changelog.html)) | `==22.2.0` -> `==24.2.0` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/attrs/24.2.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/attrs/24.2.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/attrs/22.2.0/24.2.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/attrs/22.2.0/24.2.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>python-attrs/attrs (attrs)</summary>

### [`v24.2.0`](https://redirect.github.com/python-attrs/attrs/blob/HEAD/CHANGELOG.md#2420---2024-08-06)

[Compare Source](https://redirect.github.com/python-attrs/attrs/compare/24.1.0...24.2.0)

##### Deprecations

-   Given the amount of warnings raised in the broader ecosystem, we've decided to only soft-deprecate the *hash* argument to `@define` / `@attr.s`.
    Please don't use it in new code, but we don't intend to remove it anymore.
    [#&#8203;1330](https://redirect.github.com/python-attrs/attrs/issues/1330)

##### Changes

-   `attrs.converters.pipe()` (and its syntactic sugar of passing a list for `attrs.field()`'s / `attr.ib()`'s *converter* argument) works again when passing `attrs.setters.convert` to *on_setattr* (which is default for `attrs.define`).
    [#&#8203;1328](https://redirect.github.com/python-attrs/attrs/issues/1328)
-   Restored support for PEP [649](https://peps.python.org/pep-0649/) / [749](https://peps.python.org/pep-0749/)-implementing Pythons -- currently 3.14-dev.
    [#&#8203;1329](https://redirect.github.com/python-attrs/attrs/issues/1329)

### [`v24.1.0`](https://redirect.github.com/python-attrs/attrs/blob/HEAD/CHANGELOG.md#2410---2024-08-03)

[Compare Source](https://redirect.github.com/python-attrs/attrs/compare/23.2.0...24.1.0)

##### Backwards-incompatible Changes

-   `attrs.evolve()` doesn't accept the *inst* argument as a keyword argument anymore.
    Pass it as the first positional argument instead.
    [#&#8203;1264](https://redirect.github.com/python-attrs/attrs/issues/1264)
-   `attrs.validators.provides()` has been removed.
    The removed code is available as a [gist](https://gist.github.com/hynek/9eaaaeb659808f3519870dfa16d2b6b2) for convenient copy and pasting.
    [#&#8203;1265](https://redirect.github.com/python-attrs/attrs/issues/1265)
-   All packaging metadata except from `__version__` and `__version_info__` has been removed from the `attr` and `attrs` modules (for example, `attrs.__url__`).

    Please use [`importlib.metadata`](https://docs.python.org/3/library/importlib.metadata.html) or [*importlib-metadata*](https://pypi.org/project/importlib-metadata/) instead.
    [#&#8203;1268](https://redirect.github.com/python-attrs/attrs/issues/1268)
-   The generated `__eq__` methods have been sped up significantly by generating a chain of attribute comparisons instead of constructing and comparing tuples.
    This change arguably makes the behavior more correct,
    but changes it if an attribute compares equal by identity but not value, like `float('nan')`.
    [#&#8203;1310](https://redirect.github.com/python-attrs/attrs/issues/1310)

##### Deprecations

-   The *repr_ns* argument to `attr.s` is now deprecated.
    It was a workaround for nested classes in Python 2 and is pointless in Python 3.
    [#&#8203;1263](https://redirect.github.com/python-attrs/attrs/issues/1263)
-   The *hash* argument to `@attr.s`, `@attrs.define`, and `make_class()` is now deprecated in favor of *unsafe_hash*, as defined by PEP 681.
    [#&#8203;1323](https://redirect.github.com/python-attrs/attrs/issues/1323)

##### Changes

-   Allow original slotted `functools.cached_property` classes to be cleaned by garbage collection.
    Allow `super()` calls in slotted cached properties.
    [#&#8203;1221](https://redirect.github.com/python-attrs/attrs/issues/1221)
-   Our type stubs now use modern type notation and are organized such that VS Code's quick-fix prefers the `attrs` namespace.
    [#&#8203;1234](https://redirect.github.com/python-attrs/attrs/issues/1234)
-   Preserve `AttributeError` raised by properties of slotted classes with `functools.cached_properties`.
    [#&#8203;1253](https://redirect.github.com/python-attrs/attrs/issues/1253)
-   It is now possible to wrap a converter into an `attrs.Converter` and get the current instance and/or the current field definition passed into the converter callable.

    Note that this is not supported by any type checker, yet.
    [#&#8203;1267](https://redirect.github.com/python-attrs/attrs/issues/1267)
-   `attrs.make_class()` now populates the `__annotations__` dict of the generated class, so that `attrs.resolve_types()` can resolve them.
    [#&#8203;1285](https://redirect.github.com/python-attrs/attrs/issues/1285)
-   Added the `attrs.validators.or_()` validator.
    [#&#8203;1303](https://redirect.github.com/python-attrs/attrs/issues/1303)
-   The combination of a `__attrs_pre_init__` that takes arguments, a kw-only field, and a default on that field does not crash anymore.
    [#&#8203;1319](https://redirect.github.com/python-attrs/attrs/issues/1319)
-   `attrs.validators.in_()` now transforms certain unhashable options to tuples to keep the field hashable.

    This allows fields that use this validator to be used with, for example, `attrs.filters.include()`.
    [#&#8203;1320](https://redirect.github.com/python-attrs/attrs/issues/1320)
-   If a class has an *inherited* method called `__attrs_init_subclass__`, it is now called once the class is done assembling.

    This is a replacement for Python's `__init_subclass__` and useful for registering classes, and similar.
    [#&#8203;1321](https://redirect.github.com/python-attrs/attrs/issues/1321)

### [`v23.2.0`](https://redirect.github.com/python-attrs/attrs/blob/HEAD/CHANGELOG.md#2320---2023-12-31)

[Compare Source](https://redirect.github.com/python-attrs/attrs/compare/23.1.0...23.2.0)

##### Changes

-   The type annotation for `attrs.resolve_types()` is now correct.
    [#&#8203;1141](https://redirect.github.com/python-attrs/attrs/issues/1141)
-   Type stubs now use `typing.dataclass_transform` to decorate dataclass-like decorators, instead of the non-standard `__dataclass_transform__` special form, which is only supported by Pyright.
    [#&#8203;1158](https://redirect.github.com/python-attrs/attrs/issues/1158)
-   Fixed serialization of namedtuple fields using `attrs.asdict/astuple()` with `retain_collection_types=True`.
    [#&#8203;1165](https://redirect.github.com/python-attrs/attrs/issues/1165)
-   `attrs.AttrsInstance` is now a `typing.Protocol` in both type hints and code.
    This allows you to subclass it along with another `Protocol`.
    [#&#8203;1172](https://redirect.github.com/python-attrs/attrs/issues/1172)
-   If *attrs* detects that `__attrs_pre_init__` accepts more than just `self`, it will call it with the same arguments as `__init__` was called.
    This allows you to, for example, pass arguments to `super().__init__()`.
    [#&#8203;1187](https://redirect.github.com/python-attrs/attrs/issues/1187)
-   Slotted classes now transform `functools.cached_property` decorated methods to support equivalent semantics.
    [#&#8203;1200](https://redirect.github.com/python-attrs/attrs/issues/1200)
-   Added *class_body* argument to `attrs.make_class()` to provide additional attributes for newly created classes.
    It is, for example, now possible to attach methods.
    [#&#8203;1203](https://redirect.github.com/python-attrs/attrs/issues/1203)

### [`v23.1.0`](https://redirect.github.com/python-attrs/attrs/blob/HEAD/CHANGELOG.md#2310---2023-04-16)

[Compare Source](https://redirect.github.com/python-attrs/attrs/compare/22.2.0...23.1.0)

##### Backwards-incompatible Changes

-   Python 3.6 has been dropped and packaging switched to static package data using [Hatch](https://hatch.pypa.io/latest/).
    [#&#8203;993](https://redirect.github.com/python-attrs/attrs/issues/993)

##### Deprecations

-   The support for *zope-interface* via the `attrs.validators.provides` validator is now deprecated and will be removed in, or after, April 2024.

    The presence of a C-based package in our developement dependencies has caused headaches and we're not under the impression it's used a lot.

    Let us know if you're using it and we might publish it as a separate package.
    [#&#8203;1120](https://redirect.github.com/python-attrs/attrs/issues/1120)

##### Changes

-   `attrs.filters.exclude()` and `attrs.filters.include()` now support the passing of attribute names as strings.
    [#&#8203;1068](https://redirect.github.com/python-attrs/attrs/issues/1068)
-   `attrs.has()` and `attrs.fields()` now handle generic classes correctly.
    [#&#8203;1079](https://redirect.github.com/python-attrs/attrs/issues/1079)
-   Fix frozen exception classes when raised within e.g. `contextlib.contextmanager`, which mutates their `__traceback__` attributes.
    [#&#8203;1081](https://redirect.github.com/python-attrs/attrs/issues/1081)
-   `@frozen` now works with type checkers that implement [PEP-681](https://peps.python.org/pep-0681/) (ex. [pyright](https://redirect.github.com/microsoft/pyright/)).
    [#&#8203;1084](https://redirect.github.com/python-attrs/attrs/issues/1084)
-   Restored ability to unpickle instances pickled before 22.2.0.
    [#&#8203;1085](https://redirect.github.com/python-attrs/attrs/issues/1085)
-   `attrs.asdict()`'s and `attrs.astuple()`'s type stubs now accept the `attrs.AttrsInstance` protocol.
    [#&#8203;1090](https://redirect.github.com/python-attrs/attrs/issues/1090)
-   Fix slots class cellvar updating closure in CPython 3.8+ even when `__code__` introspection is unavailable.
    [#&#8203;1092](https://redirect.github.com/python-attrs/attrs/issues/1092)
-   `attrs.resolve_types()` can now pass `include_extras` to `typing.get_type_hints()` on Python 3.9+, and does so by default.
    [#&#8203;1099](https://redirect.github.com/python-attrs/attrs/issues/1099)
-   Added instructions for pull request workflow to `CONTRIBUTING.md`.
    [#&#8203;1105](https://redirect.github.com/python-attrs/attrs/issues/1105)
-   Added *type* parameter to `attrs.field()` function for use with `attrs.make_class()`.

    Please note that type checkers ignore type metadata passed into `make_class()`, but it can be useful if you're wrapping *attrs*.
    [#&#8203;1107](https://redirect.github.com/python-attrs/attrs/issues/1107)
-   It is now possible for `attrs.evolve()` (and `attr.evolve()`) to change fields named `inst` if the instance is passed as a positional argument.

    Passing the instance using the `inst` keyword argument is now deprecated and will be removed in, or after, April 2024.
    [#&#8203;1117](https://redirect.github.com/python-attrs/attrs/issues/1117)
-   `attrs.validators.optional()` now also accepts a tuple of validators (in addition to lists of validators).
    [#&#8203;1122](https://redirect.github.com/python-attrs/attrs/issues/1122)

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index b9331662..342c6696 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -8,9 +8,9 @@ argcomplete==2.1.2 \
     --hash=sha256:4ba9cdaa28c361d251edce884cd50b4b1215d65cdc881bd204426cdde9f52731 \
     --hash=sha256:fc82ef070c607b1559b5c720529d63b54d9dcf2dcfc2632b10e6372314a34457
     # via nox
-attrs==22.2.0 \
-    --hash=sha256:29e95c7f6778868dbd49170f98f8818f78f3dc5e0e37c0b1f474e3561b240836 \
-    --hash=sha256:c9227bfc2f01993c03f68db37d1d15c9690188323c067c641f1a35ca58185f99
+attrs==24.2.0 \
+    --hash=sha256:5cfb1b9148b5b086569baec03f20d7b6bf3bcacc9a42bebf87ffaaca362f6346 \
+    --hash=sha256:81921eb96de3191c8258c199618104dd27ac608d9366f5e35d011eae1867ede2
     # via gcp-releasetool
 bleach==6.2.0 \
     --hash=sha256:117d9c6097a7c3d22fd578fcd8d35ff1e125df6736f554da4e432fdd63f31e5e \

From 8a7a27990ddff6c083c8bade35c3821fe635e446 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:02:19 +0100
Subject: [PATCH 036/133] chore(deps): update dependency more-itertools to v10
 (#470)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [more-itertools](https://redirect.github.com/more-itertools/more-itertools) | `==8.14.0` -> `==10.5.0` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/more-itertools/10.5.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/more-itertools/10.5.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/more-itertools/8.14.0/10.5.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/more-itertools/8.14.0/10.5.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>more-itertools/more-itertools (more-itertools)</summary>

### [`v10.5.0`](https://redirect.github.com/more-itertools/more-itertools/releases/tag/v10.5.0)

[Compare Source](https://redirect.github.com/more-itertools/more-itertools/compare/v10.4.0...v10.5.0)

##### What's Changed

-   Optimize all_equal recipe by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/899](https://redirect.github.com/more-itertools/more-itertools/pull/899)
-   Reduce groupby.**next** calls in all_equal by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/903](https://redirect.github.com/more-itertools/more-itertools/pull/903)
-   Fix types.UnionType by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/905](https://redirect.github.com/more-itertools/more-itertools/pull/905)
-   Version 10.5.0 by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/906](https://redirect.github.com/more-itertools/more-itertools/pull/906)

**Full Changelog**: https://togithub.com/more-itertools/more-itertools/compare/v10.4.0...v10.5.0

### [`v10.4.0`](https://redirect.github.com/more-itertools/more-itertools/releases/tag/v10.4.0): Version 10.4.0

[Compare Source](https://redirect.github.com/more-itertools/more-itertools/compare/v10.3.0...v10.4.0)

##### What's Changed

-   Issue 854: sample improvements by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/855](https://redirect.github.com/more-itertools/more-itertools/pull/855)
-   Issue 858: Use chain and starmap in run_length.decode by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/861](https://redirect.github.com/more-itertools/more-itertools/pull/861)
-   Issue 859: Update totient recipe by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/860](https://redirect.github.com/more-itertools/more-itertools/pull/860)
-   Distinct permutations of incomparable items by [@&#8203;JamesParrott](https://redirect.github.com/JamesParrott) in [https://togithub.com/more-itertools/more-itertools/pull/834](https://redirect.github.com/more-itertools/more-itertools/pull/834)
-   Clarify seekable.relative_seek behavior by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/863](https://redirect.github.com/more-itertools/more-itertools/pull/863)
-   Issue 864: Improve \_sample_unweighted by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/865](https://redirect.github.com/more-itertools/more-itertools/pull/865)
-   Use log1p for \_sample_unweighted by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/868](https://redirect.github.com/more-itertools/more-itertools/pull/868)
-   Issue 862: change relative_seek() behaviour by [@&#8203;dkrikun](https://redirect.github.com/dkrikun) in [https://togithub.com/more-itertools/more-itertools/pull/866](https://redirect.github.com/more-itertools/more-itertools/pull/866)
-   Issue 876: is_sorted clarifications by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/877](https://redirect.github.com/more-itertools/more-itertools/pull/877)
-   Issue 870: counts parameter for sample by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/875](https://redirect.github.com/more-itertools/more-itertools/pull/875)
-   Issue 869: Add a steps argument to circular_shifts by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/874](https://redirect.github.com/more-itertools/more-itertools/pull/874)
-   Issue 871: Add a fast path for sliding_window by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/873](https://redirect.github.com/more-itertools/more-itertools/pull/873)
-   type annotation of `windowed_complete` corrected by [@&#8203;m472](https://redirect.github.com/m472) in [https://togithub.com/more-itertools/more-itertools/pull/881](https://redirect.github.com/more-itertools/more-itertools/pull/881)
-   \[Docs] Fix strictly_n missing the n parameter by [@&#8203;fakuivan](https://redirect.github.com/fakuivan) in [https://togithub.com/more-itertools/more-itertools/pull/886](https://redirect.github.com/more-itertools/more-itertools/pull/886)
-   Standardize type hints for isinstance's second argument by [@&#8203;jbosboom](https://redirect.github.com/jbosboom) in [https://togithub.com/more-itertools/more-itertools/pull/887](https://redirect.github.com/more-itertools/more-itertools/pull/887)
-   Issue 883: change type hint by [@&#8203;akisatoon1](https://redirect.github.com/akisatoon1) in [https://togithub.com/more-itertools/more-itertools/pull/884](https://redirect.github.com/more-itertools/more-itertools/pull/884)
-   Add type overloads for `zip_broadcast` by [@&#8203;Pandede](https://redirect.github.com/Pandede) in [https://togithub.com/more-itertools/more-itertools/pull/888](https://redirect.github.com/more-itertools/more-itertools/pull/888)
-   Issue 889: Optimize triplewise by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/891](https://redirect.github.com/more-itertools/more-itertools/pull/891)
-   Add option `strict` to `sort_together` by [@&#8203;Pandede](https://redirect.github.com/Pandede) in [https://togithub.com/more-itertools/more-itertools/pull/892](https://redirect.github.com/more-itertools/more-itertools/pull/892)
-   Updates for version 10.4.0 by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/893](https://redirect.github.com/more-itertools/more-itertools/pull/893)

##### New Contributors

-   [@&#8203;JamesParrott](https://redirect.github.com/JamesParrott) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/834](https://redirect.github.com/more-itertools/more-itertools/pull/834)
-   [@&#8203;dkrikun](https://redirect.github.com/dkrikun) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/866](https://redirect.github.com/more-itertools/more-itertools/pull/866)
-   [@&#8203;m472](https://redirect.github.com/m472) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/881](https://redirect.github.com/more-itertools/more-itertools/pull/881)
-   [@&#8203;fakuivan](https://redirect.github.com/fakuivan) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/886](https://redirect.github.com/more-itertools/more-itertools/pull/886)
-   [@&#8203;jbosboom](https://redirect.github.com/jbosboom) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/887](https://redirect.github.com/more-itertools/more-itertools/pull/887)
-   [@&#8203;akisatoon1](https://redirect.github.com/akisatoon1) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/884](https://redirect.github.com/more-itertools/more-itertools/pull/884)
-   [@&#8203;Pandede](https://redirect.github.com/Pandede) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/888](https://redirect.github.com/more-itertools/more-itertools/pull/888)

**Full Changelog**: https://togithub.com/more-itertools/more-itertools/compare/v10.3.0...v10.4.0

### [`v10.3.0`](https://redirect.github.com/more-itertools/more-itertools/releases/tag/v10.3.0): Version 10.3.0

[Compare Source](https://redirect.github.com/more-itertools/more-itertools/compare/v10.2.0...v10.3.0)

#### What's Changed

-   100% Code Coverage by [@&#8203;haukex](https://redirect.github.com/haukex) in [https://togithub.com/more-itertools/more-itertools/pull/792](https://redirect.github.com/more-itertools/more-itertools/pull/792)
-   Remove recursion from `collapse` by [@&#8203;james-wasson](https://redirect.github.com/james-wasson) in [https://togithub.com/more-itertools/more-itertools/pull/796](https://redirect.github.com/more-itertools/more-itertools/pull/796)
-   Closes [#&#8203;780](https://redirect.github.com/more-itertools/more-itertools/issues/780): add pre/postpend examples in value_chain doc by [@&#8203;bjrtx](https://redirect.github.com/bjrtx) in [https://togithub.com/more-itertools/more-itertools/pull/802](https://redirect.github.com/more-itertools/more-itertools/pull/802)
-   Increase performance of `padded` by [@&#8203;james-wasson](https://redirect.github.com/james-wasson) in [https://togithub.com/more-itertools/more-itertools/pull/805](https://redirect.github.com/more-itertools/more-itertools/pull/805)
-   Update table of contents by [@&#8203;bjrtx](https://redirect.github.com/bjrtx) in [https://togithub.com/more-itertools/more-itertools/pull/808](https://redirect.github.com/more-itertools/more-itertools/pull/808)
-   Add exactly size of n doc to padded by [@&#8203;james-wasson](https://redirect.github.com/james-wasson) in [https://togithub.com/more-itertools/more-itertools/pull/807](https://redirect.github.com/more-itertools/more-itertools/pull/807)
-   Speed up `ichunked` by [@&#8203;james-wasson](https://redirect.github.com/james-wasson) in [https://togithub.com/more-itertools/more-itertools/pull/793](https://redirect.github.com/more-itertools/more-itertools/pull/793)
-   Optimize `chunked_even` itertool by [@&#8203;james-wasson](https://redirect.github.com/james-wasson) in [https://togithub.com/more-itertools/more-itertools/pull/816](https://redirect.github.com/more-itertools/more-itertools/pull/816)
-   Optimize windowed itertool by [@&#8203;james-wasson](https://redirect.github.com/james-wasson) in [https://togithub.com/more-itertools/more-itertools/pull/810](https://redirect.github.com/more-itertools/more-itertools/pull/810)
-   Issue 822: update iter_index docs by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/827](https://redirect.github.com/more-itertools/more-itertools/pull/827)
-   Issue 823: improve totient by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/826](https://redirect.github.com/more-itertools/more-itertools/pull/826)
-   Issue 821: key argument for all_equal by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/825](https://redirect.github.com/more-itertools/more-itertools/pull/825)
-   Update roundrobin implementation by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/829](https://redirect.github.com/more-itertools/more-itertools/pull/829)
-   Issue 820: add powerset_of_sets by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/828](https://redirect.github.com/more-itertools/more-itertools/pull/828)
-   Fix a typo found by codespell by [@&#8203;DimitriPapadopoulos](https://redirect.github.com/DimitriPapadopoulos) in [https://togithub.com/more-itertools/more-itertools/pull/830](https://redirect.github.com/more-itertools/more-itertools/pull/830)
-   Add typing for countable.items_seen attribute. by [@&#8203;aidanholm](https://redirect.github.com/aidanholm) in [https://togithub.com/more-itertools/more-itertools/pull/836](https://redirect.github.com/more-itertools/more-itertools/pull/836)
-   Add join_mappings by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/841](https://redirect.github.com/more-itertools/more-itertools/pull/841)
-   Add doublestarmap (closes [#&#8203;679](https://redirect.github.com/more-itertools/more-itertools/issues/679)) by [@&#8203;monk-time](https://redirect.github.com/monk-time) in [https://togithub.com/more-itertools/more-itertools/pull/845](https://redirect.github.com/more-itertools/more-itertools/pull/845)
-   Add dft and idft by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/847](https://redirect.github.com/more-itertools/more-itertools/pull/847)
-   Changes for version 10.3.0 by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/851](https://redirect.github.com/more-itertools/more-itertools/pull/851)
-   Add unique() by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/850](https://redirect.github.com/more-itertools/more-itertools/pull/850)

#### New Contributors

-   [@&#8203;james-wasson](https://redirect.github.com/james-wasson) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/796](https://redirect.github.com/more-itertools/more-itertools/pull/796)
-   [@&#8203;bjrtx](https://redirect.github.com/bjrtx) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/802](https://redirect.github.com/more-itertools/more-itertools/pull/802)
-   [@&#8203;aidanholm](https://redirect.github.com/aidanholm) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/836](https://redirect.github.com/more-itertools/more-itertools/pull/836)
-   [@&#8203;monk-time](https://redirect.github.com/monk-time) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/845](https://redirect.github.com/more-itertools/more-itertools/pull/845)

**Full Changelog**: https://togithub.com/more-itertools/more-itertools/compare/v10.2.0...v10.3.0

### [`v10.2.0`](https://redirect.github.com/more-itertools/more-itertools/releases/tag/v10.2.0): Version 10.2.0

[Compare Source](https://redirect.github.com/more-itertools/more-itertools/compare/v10.1.0...v10.2.0)

-   New functions
    -   `iter_suppress` (thanks to jaraco, pochmann, and rhettinger)
    -   `filter_map` (thanks to struktured)
    -   `classify_unique` (thanks to haukex)
    -   `totient` (from the itertools docs)
    -   `reshape` (from the itertools docs)

-   Changes to existing functions
    -   `factor`, `iter_index`, `sieve`, and `unique_justseen` were updated to match the itertools docs
    -   `first` was was optimized (thanks to pochmann)
    -   `takewhile_inclusive` was was refactored (thanks to eltoder)
    -   `combination_with_replacement_index` was was optimized (thanks to elliotwutingfeng and rhettinger)
    -   `nth_permutation`, `nth_combination_with_replacement`, `combination_index`, and `combination_with_replacement_index` were optimized (thanks to rhettinger)
    -   `batched` now accepts a `strict` argument (adapted from itertools docs)
    -   `time_limited` was improved for Windows (thanks to haukex)

-   Other changes
    -   Several typing updates were made (thanks to obaltian and ilai-deutel)
    -   Some documentation issues were fixed (thanks to F-park, DimitriPapadopoulos, peterbygrave, shuuji3, eltoder, and homeworkprod)

### [`v10.1.0`](https://redirect.github.com/more-itertools/more-itertools/releases/tag/v10.1.0): Version 10.1.0

[Compare Source](https://redirect.github.com/more-itertools/more-itertools/compare/v10.0.0...v10.1.0)

#### What's Changed

-   Add more tests for `zip_broadcast()` by [@&#8203;kalekundert](https://redirect.github.com/kalekundert) in [https://togithub.com/more-itertools/more-itertools/pull/739](https://redirect.github.com/more-itertools/more-itertools/pull/739)
-   Added takewhile_inclusive by [@&#8203;OlegAlexander](https://redirect.github.com/OlegAlexander) in [https://togithub.com/more-itertools/more-itertools/pull/736](https://redirect.github.com/more-itertools/more-itertools/pull/736)
-   Speed up `zip_broadcast()` by pre-filling the scalar elements by [@&#8203;kalekundert](https://redirect.github.com/kalekundert) in [https://togithub.com/more-itertools/more-itertools/pull/740](https://redirect.github.com/more-itertools/more-itertools/pull/740)
-   Added outer_product. by [@&#8203;OlegAlexander](https://redirect.github.com/OlegAlexander) in [https://togithub.com/more-itertools/more-itertools/pull/743](https://redirect.github.com/more-itertools/more-itertools/pull/743)
-   Simplify `zip_broadcast` by [@&#8203;pochmann](https://redirect.github.com/pochmann) in [https://togithub.com/more-itertools/more-itertools/pull/742](https://redirect.github.com/more-itertools/more-itertools/pull/742)
-   Simplify `_zip_equal` by [@&#8203;pochmann](https://redirect.github.com/pochmann) in [https://togithub.com/more-itertools/more-itertools/pull/744](https://redirect.github.com/more-itertools/more-itertools/pull/744)
-   fix consume() type annotation by [@&#8203;obaltian](https://redirect.github.com/obaltian) in [https://togithub.com/more-itertools/more-itertools/pull/746](https://redirect.github.com/more-itertools/more-itertools/pull/746)
-   Version 10.1.0 by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/747](https://redirect.github.com/more-itertools/more-itertools/pull/747)

#### New Contributors

-   [@&#8203;OlegAlexander](https://redirect.github.com/OlegAlexander) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/736](https://redirect.github.com/more-itertools/more-itertools/pull/736)
-   [@&#8203;obaltian](https://redirect.github.com/obaltian) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/746](https://redirect.github.com/more-itertools/more-itertools/pull/746)

**Full Changelog**: https://togithub.com/more-itertools/more-itertools/compare/v10.0.1...v10.1.0

### [`v10.0.0`](https://redirect.github.com/more-itertools/more-itertools/releases/tag/v10.0.0): Version 10.0.0

[Compare Source](https://redirect.github.com/more-itertools/more-itertools/compare/v9.1.0...v10.0.0)

#### What's Changed

-   Update recipes.iter_index to match CPython PR 102360 by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/690](https://redirect.github.com/more-itertools/more-itertools/pull/690)
-   fixup - add missing commas to the readme function table by [@&#8203;lonnen](https://redirect.github.com/lonnen) in [https://togithub.com/more-itertools/more-itertools/pull/692](https://redirect.github.com/more-itertools/more-itertools/pull/692)
-   fixup remove 3.6 from tox by [@&#8203;lonnen](https://redirect.github.com/lonnen) in [https://togithub.com/more-itertools/more-itertools/pull/693](https://redirect.github.com/more-itertools/more-itertools/pull/693)
-   seekable: Add relative_seek by [@&#8203;karlb](https://redirect.github.com/karlb) in [https://togithub.com/more-itertools/more-itertools/pull/694](https://redirect.github.com/more-itertools/more-itertools/pull/694)
-   Optimize \_chunked_even_finite() by [@&#8203;elliotwutingfeng](https://redirect.github.com/elliotwutingfeng) in [https://togithub.com/more-itertools/more-itertools/pull/699](https://redirect.github.com/more-itertools/more-itertools/pull/699)
-   Indexing of combinations with replacement by [@&#8203;Schoyen](https://redirect.github.com/Schoyen) in [https://togithub.com/more-itertools/more-itertools/pull/689](https://redirect.github.com/more-itertools/more-itertools/pull/689)
-   Add notes for transposing empty inputs by [@&#8203;XuehaiPan](https://redirect.github.com/XuehaiPan) in [https://togithub.com/more-itertools/more-itertools/pull/700](https://redirect.github.com/more-itertools/more-itertools/pull/700)
-   Add the polynomial_eval recipe by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/703](https://redirect.github.com/more-itertools/more-itertools/pull/703)
-   Add nth_combination_with_replacement by [@&#8203;Schoyen](https://redirect.github.com/Schoyen) in [https://togithub.com/more-itertools/more-itertools/pull/704](https://redirect.github.com/more-itertools/more-itertools/pull/704)
-   Add sum_of_squares, sync with itertools by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/706](https://redirect.github.com/more-itertools/more-itertools/pull/706)
-   Issue [#&#8203;707](https://redirect.github.com/more-itertools/more-itertools/issues/707): fix `iterate()` to enable `func` to raise StopIteration + 3 unittests by [@&#8203;jrebiffe](https://redirect.github.com/jrebiffe) in [https://togithub.com/more-itertools/more-itertools/pull/708](https://redirect.github.com/more-itertools/more-itertools/pull/708)
-   Update polynomial_from roots and convolve by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/709](https://redirect.github.com/more-itertools/more-itertools/pull/709)
-   Issue [#&#8203;677](https://redirect.github.com/more-itertools/more-itertools/issues/677): Improve `partition` by [@&#8203;pochmann](https://redirect.github.com/pochmann) in [https://togithub.com/more-itertools/more-itertools/pull/710](https://redirect.github.com/more-itertools/more-itertools/pull/710)
-   Issue [#&#8203;713](https://redirect.github.com/more-itertools/more-itertools/issues/713): Fix `partial_product` (also simplify and clean up) by [@&#8203;pochmann](https://redirect.github.com/pochmann) in [https://togithub.com/more-itertools/more-itertools/pull/714](https://redirect.github.com/more-itertools/more-itertools/pull/714)
-   Issue [#&#8203;711](https://redirect.github.com/more-itertools/more-itertools/issues/711): Optimize `pairwise` by [@&#8203;pochmann](https://redirect.github.com/pochmann) in [https://togithub.com/more-itertools/more-itertools/pull/712](https://redirect.github.com/more-itertools/more-itertools/pull/712)
-   Issue [#&#8203;715](https://redirect.github.com/more-itertools/more-itertools/issues/715): Simplify/optimize `partial_product` by [@&#8203;pochmann](https://redirect.github.com/pochmann) in [https://togithub.com/more-itertools/more-itertools/pull/716](https://redirect.github.com/more-itertools/more-itertools/pull/716)
-   Issue [#&#8203;717](https://redirect.github.com/more-itertools/more-itertools/issues/717): Improve `duplicates_justseen` by [@&#8203;pochmann](https://redirect.github.com/pochmann) in [https://togithub.com/more-itertools/more-itertools/pull/718](https://redirect.github.com/more-itertools/more-itertools/pull/718)
-   Fix unique_in_window to match described behavior by [@&#8203;elliotwutingfeng](https://redirect.github.com/elliotwutingfeng) in [https://togithub.com/more-itertools/more-itertools/pull/720](https://redirect.github.com/more-itertools/more-itertools/pull/720)
-   Add polynomial_derivative recipe by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/723](https://redirect.github.com/more-itertools/more-itertools/pull/723)
-   Update recipes with CPython PRs: 105403 and 106371 by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/731](https://redirect.github.com/more-itertools/more-itertools/pull/731)
-   Changes for version 10.0.0 by [@&#8203;bbayles](https://redirect.github.com/bbayles) in [https://togithub.com/more-itertools/more-itertools/pull/734](https://redirect.github.com/more-itertools/more-itertools/pull/734)
-   Delay computation of numeric_range len until needed by [@&#8203;eltoder](https://redirect.github.com/eltoder) in [https://togithub.com/more-itertools/more-itertools/pull/674](https://redirect.github.com/more-itertools/more-itertools/pull/674)

#### New Contributors

-   [@&#8203;karlb](https://redirect.github.com/karlb) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/694](https://redirect.github.com/more-itertools/more-itertools/pull/694)
-   [@&#8203;elliotwutingfeng](https://redirect.github.com/elliotwutingfeng) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/699](https://redirect.github.com/more-itertools/more-itertools/pull/699)
-   [@&#8203;Schoyen](https://redirect.github.com/Schoyen) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/689](https://redirect.github.com/more-itertools/more-itertools/pull/689)
-   [@&#8203;XuehaiPan](https://redirect.github.com/XuehaiPan) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/700](https://redirect.github.com/more-itertools/more-itertools/pull/700)
-   [@&#8203;jrebiffe](https://redirect.github.com/jrebiffe) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/708](https://redirect.github.com/more-itertools/more-itertools/pull/708)
-   [@&#8203;pochmann](https://redirect.github.com/pochmann) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/710](https://redirect.github.com/more-itertools/more-itertools/pull/710)
-   [@&#8203;eltoder](https://redirect.github.com/eltoder) made their first contribution in [https://togithub.com/more-itertools/more-itertools/pull/674](https://redirect.github.com/more-itertools/more-itertools/pull/674)

**Full Changelog**: https://togithub.com/more-itertools/more-itertools/compare/v9.1.1...v10.0.0

### [`v9.1.0`](https://redirect.github.com/more-itertools/more-itertools/releases/tag/v9.1.0): Version 9.1.0

[Compare Source](https://redirect.github.com/more-itertools/more-itertools/compare/v9.0.0...v9.1.0)

See PR [#&#8203;678](https://redirect.github.com/more-itertools/more-itertools/issues/678) for details.

### [`v9.0.0`](https://redirect.github.com/more-itertools/more-itertools/releases/tag/v9.0.0): Version 9.0.0

[Compare Source](https://redirect.github.com/more-itertools/more-itertools/compare/v8.14.0...v9.0.0)

See PR [#&#8203;647](https://redirect.github.com/more-itertools/more-itertools/issues/647) for details

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 342c6696..5a7a096f 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -459,9 +459,9 @@ MarkupSafe==2.1.5 \
     --hash=sha256:fce659a462a1be54d2ffcacea5e3ba2d74daa74f30f5f143fe0c58636e355fdd \
     --hash=sha256:ffee1f21e5ef0d712f9033568f8344d5da8cc2869dbd08d87c84656e6a2d2f68
     # via jinja2
-more-itertools==8.14.0 \
-    --hash=sha256:1bc4f91ee5b1b31ac7ceacc17c09befe6a40a503907baf9c839c229b5095cfd2 \
-    --hash=sha256:c09443cd3d5438b8dafccd867a6bc1cb0894389e90cb53d227456b0b0bccb750
+more-itertools==10.5.0 \
+    --hash=sha256:037b0d3203ce90cca8ab1defbbdac29d5f993fc20131f3664dc8d6acfa872aef \
+    --hash=sha256:5482bfef7849c25dc3c6dd53a6173ae4795da2a41a80faea6700d9f5846c5da6
     # via jaraco-classes
 nox==2022.8.7 \
     --hash=sha256:1b894940551dc5c389f9271d197ca5d655d40bdc6ccf93ed6880e4042760a34b \

From f6bfd17d30914d70b24751ad3652f7c91430f252 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:02:22 +0100
Subject: [PATCH 037/133] chore(deps): update dependency wheel to v0.44.0
 (#459)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [wheel](https://redirect.github.com/pypa/wheel) ([changelog](https://wheel.readthedocs.io/en/stable/news.html)) | `==0.38.1` -> `==0.44.0` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/wheel/0.44.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/wheel/0.44.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/wheel/0.38.1/0.44.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/wheel/0.38.1/0.44.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>pypa/wheel (wheel)</summary>

### [`v0.44.0`](https://redirect.github.com/pypa/wheel/releases/tag/0.44.0)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.43.0...0.44.0)

-   Canonicalized requirements in METADATA file (PR by Wim Jeantine-Glenn)
-   Deprecated the `bdist_wheel` module, as the code was migrated to `setuptools` itself

### [`v0.43.0`](https://redirect.github.com/pypa/wheel/releases/tag/0.43.0)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.42.0...0.43.0)

-   Dropped support for Python 3.7
-   Updated vendored `packaging` to 24.0

### [`v0.42.0`](https://redirect.github.com/pypa/wheel/releases/tag/0.42.0)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.41.3...0.42.0)

-   Allowed removing build tag with `wheel tags --build ""`
-   Fixed `wheel pack` and `wheel tags` writing updated `WHEEL` fields after a blank line, causing other tools to ignore them
-   Fixed `wheel pack` and `wheel tags` writing `WHEEL` with CRLF line endings or a mix of CRLF and LF
-   Fixed `wheel pack --build-number ""` not removing build tag from `WHEEL` (above changes by Benjamin Gilbert)

### [`v0.41.3`](https://redirect.github.com/pypa/wheel/releases/tag/0.41.3)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.41.2...0.41.3)

-   Updated vendored `packaging` to 23.2
-   Fixed ABI tag generation for CPython 3.13a1 on Windows (PR by Sam Gross)

### [`v0.41.2`](https://redirect.github.com/pypa/wheel/compare/0.41.1...0.41.2)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.41.1...0.41.2)

### [`v0.41.1`](https://redirect.github.com/pypa/wheel/compare/0.41.0...0.41.1)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.41.0...0.41.1)

### [`v0.41.0`](https://redirect.github.com/pypa/wheel/compare/0.40.0...0.41.0)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.40.0...0.41.0)

### [`v0.40.0`](https://redirect.github.com/pypa/wheel/compare/0.38.4...0.40.0)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.38.4...0.40.0)

### [`v0.38.4`](https://redirect.github.com/pypa/wheel/compare/0.38.3...0.38.4)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.38.3...0.38.4)

### [`v0.38.3`](https://redirect.github.com/pypa/wheel/compare/0.38.2...0.38.3)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.38.2...0.38.3)

### [`v0.38.2`](https://redirect.github.com/pypa/wheel/compare/0.38.1...0.38.2)

[Compare Source](https://redirect.github.com/pypa/wheel/compare/0.38.1...0.38.2)

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 5a7a096f..fca26ace 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -611,9 +611,9 @@ webencodings==0.5.1 \
     --hash=sha256:a0af1213f3c2226497a97e2b3aa01a7e4bee4f403f95be16fc9acd2947514a78 \
     --hash=sha256:b36a1c245f2d304965eb4e0a82848379241dc04b865afcc4aab16748587e1923
     # via bleach
-wheel==0.38.1 \
-    --hash=sha256:7a95f9a8dc0924ef318bd55b616112c70903192f524d120acc614f59547a9e1f \
-    --hash=sha256:ea041edf63f4ccba53ad6e035427997b3bb10ee88a4cd014ae82aeb9eea77bb9
+wheel==0.44.0 \
+    --hash=sha256:2376a90c98cc337d18623527a97c31797bd02bad0033d41547043a1cbfbe448f \
+    --hash=sha256:a29c3f2817e95ab89aa4660681ad547c0e9547f20e75b0562fe7723c9a2a9d49
     # via -r requirements.in
 zipp==3.19.1 \
     --hash=sha256:2828e64edb5386ea6a52e7ba7cdb17bb30a73a858f5eb6eb93d8d36f5ea26091 \

From d41c93318937748a7dc894442ac0a60da72ac1b9 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:02:25 +0100
Subject: [PATCH 038/133] chore(deps): update dependency python-dateutil to
 v2.9.0.post0 (#455)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [python-dateutil](https://redirect.github.com/dateutil/dateutil) | `==2.8.2` -> `==2.9.0.post0` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/python-dateutil/2.9.0.post0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/python-dateutil/2.9.0.post0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/python-dateutil/2.8.2/2.9.0.post0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/python-dateutil/2.8.2/2.9.0.post0?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>dateutil/dateutil (python-dateutil)</summary>

### [`v2.9.0.post0`](https://redirect.github.com/dateutil/dateutil/releases/tag/2.9.0.post0)

[Compare Source](https://redirect.github.com/dateutil/dateutil/compare/2.9.0...2.9.0.post0)

### Version 2.9.0.post0 (2024-03-01)

#### Bugfixes

-   Pinned `setuptools_scm` to `<8`, which should make the generated `_version.py` file compatible with all supported versions of Python.

### [`v2.9.0`](https://redirect.github.com/dateutil/dateutil/releases/tag/2.9.0)

[Compare Source](https://redirect.github.com/dateutil/dateutil/compare/2.8.2...2.9.0)

### Version 2.9.0 (2024-02-29)

#### Data updates

-   Updated tzdata version to 2024a. (gh pr [#&#8203;1342](https://redirect.github.com/dateutil/dateutil/issues/1342))

#### Features

-   Made all `dateutil` submodules lazily imported using [PEP 562](https://www.python.org/dev/peps/pep-0562/). On Python 3.7+, things like `import dateutil; dateutil.tz.gettz("America/New_York")` will now work without explicitly importing `dateutil.tz`, with the import occurring behind the scenes on first use. The old behavior remains on Python 3.6 and earlier. Fixed by Orson Adams. (gh issue [#&#8203;771](https://redirect.github.com/dateutil/dateutil/issues/771), gh pr [#&#8203;1007](https://redirect.github.com/dateutil/dateutil/issues/1007))

#### Bugfixes

-   Removed a call to `datetime.utcfromtimestamp`, which is deprecated as of Python 3.12. Reported by Hugo van Kemenade (gh pr [#&#8203;1284](https://redirect.github.com/dateutil/dateutil/issues/1284)), fixed by Thomas Grainger (gh pr [#&#8203;1285](https://redirect.github.com/dateutil/dateutil/issues/1285)).

#### Documentation changes

-   Added note into docs and tests where relativedelta would return last day of the month only if the same day on a different month resolves to a date that doesn't exist. Reported by [@&#8203;hawkEye-01](https://redirect.github.com/hawkEye-01) (gh issue [#&#8203;1167](https://redirect.github.com/dateutil/dateutil/issues/1167)). Fixed by [@&#8203;Mifrill](https://redirect.github.com/Mifrill) (gh pr [#&#8203;1168](https://redirect.github.com/dateutil/dateutil/issues/1168))

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index fca26ace..3c749108 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -544,9 +544,9 @@ pyparsing==3.0.9 \
 pyperclip==1.8.2 \
     --hash=sha256:105254a8b04934f0bc84e9c24eb360a591aaf6535c9def5f29d92af107a9bf57
     # via gcp-releasetool
-python-dateutil==2.8.2 \
-    --hash=sha256:0123cacc1627ae19ddf3c27a5de5bd67ee4586fbdd6440d9748f8abb483d3e86 \
-    --hash=sha256:961d03dc3453ebbc59dbdea9e4e11c5651520a876d0f4db161e8674aae935da9
+python-dateutil==2.9.0.post0 \
+    --hash=sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3 \
+    --hash=sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427
     # via gcp-releasetool
 readme-renderer==37.2 \
     --hash=sha256:d3f06a69e8c40fca9ab3174eca48f96d9771eddb43517b17d96583418427b106 \

From cad9fa1046eb1e61c721265595025578b185e226 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:03:07 +0100
Subject: [PATCH 039/133] chore(deps): update dependency markupsafe to v3
 (#469)

---
 .kokoro/requirements.txt | 123 ++++++++++++++++++++-------------------
 1 file changed, 62 insertions(+), 61 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 3c749108..3fbfe292 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -397,67 +397,68 @@ keyring==23.9.3 \
     # via
     #   gcp-releasetool
     #   twine
-MarkupSafe==2.1.5 \
-    --hash=sha256:00e046b6dd71aa03a41079792f8473dc494d564611a8f89bbbd7cb93295ebdcf \
-    --hash=sha256:075202fa5b72c86ad32dc7d0b56024ebdbcf2048c0ba09f1cde31bfdd57bcfff \
-    --hash=sha256:0e397ac966fdf721b2c528cf028494e86172b4feba51d65f81ffd65c63798f3f \
-    --hash=sha256:17b950fccb810b3293638215058e432159d2b71005c74371d784862b7e4683f3 \
-    --hash=sha256:1f3fbcb7ef1f16e48246f704ab79d79da8a46891e2da03f8783a5b6fa41a9532 \
-    --hash=sha256:2174c595a0d73a3080ca3257b40096db99799265e1c27cc5a610743acd86d62f \
-    --hash=sha256:2b7c57a4dfc4f16f7142221afe5ba4e093e09e728ca65c51f5620c9aaeb9a617 \
-    --hash=sha256:2d2d793e36e230fd32babe143b04cec8a8b3eb8a3122d2aceb4a371e6b09b8df \
-    --hash=sha256:30b600cf0a7ac9234b2638fbc0fb6158ba5bdcdf46aeb631ead21248b9affbc4 \
-    --hash=sha256:397081c1a0bfb5124355710fe79478cdbeb39626492b15d399526ae53422b906 \
-    --hash=sha256:3a57fdd7ce31c7ff06cdfbf31dafa96cc533c21e443d57f5b1ecc6cdc668ec7f \
-    --hash=sha256:3c6b973f22eb18a789b1460b4b91bf04ae3f0c4234a0a6aa6b0a92f6f7b951d4 \
-    --hash=sha256:3e53af139f8579a6d5f7b76549125f0d94d7e630761a2111bc431fd820e163b8 \
-    --hash=sha256:4096e9de5c6fdf43fb4f04c26fb114f61ef0bf2e5604b6ee3019d51b69e8c371 \
-    --hash=sha256:4275d846e41ecefa46e2015117a9f491e57a71ddd59bbead77e904dc02b1bed2 \
-    --hash=sha256:4c31f53cdae6ecfa91a77820e8b151dba54ab528ba65dfd235c80b086d68a465 \
-    --hash=sha256:4f11aa001c540f62c6166c7726f71f7573b52c68c31f014c25cc7901deea0b52 \
-    --hash=sha256:5049256f536511ee3f7e1b3f87d1d1209d327e818e6ae1365e8653d7e3abb6a6 \
-    --hash=sha256:58c98fee265677f63a4385256a6d7683ab1832f3ddd1e66fe948d5880c21a169 \
-    --hash=sha256:598e3276b64aff0e7b3451b72e94fa3c238d452e7ddcd893c3ab324717456bad \
-    --hash=sha256:5b7b716f97b52c5a14bffdf688f971b2d5ef4029127f1ad7a513973cfd818df2 \
-    --hash=sha256:5dedb4db619ba5a2787a94d877bc8ffc0566f92a01c0ef214865e54ecc9ee5e0 \
-    --hash=sha256:619bc166c4f2de5caa5a633b8b7326fbe98e0ccbfacabd87268a2b15ff73a029 \
-    --hash=sha256:629ddd2ca402ae6dbedfceeba9c46d5f7b2a61d9749597d4307f943ef198fc1f \
-    --hash=sha256:656f7526c69fac7f600bd1f400991cc282b417d17539a1b228617081106feb4a \
-    --hash=sha256:6ec585f69cec0aa07d945b20805be741395e28ac1627333b1c5b0105962ffced \
-    --hash=sha256:72b6be590cc35924b02c78ef34b467da4ba07e4e0f0454a2c5907f473fc50ce5 \
-    --hash=sha256:7502934a33b54030eaf1194c21c692a534196063db72176b0c4028e140f8f32c \
-    --hash=sha256:7a68b554d356a91cce1236aa7682dc01df0edba8d043fd1ce607c49dd3c1edcf \
-    --hash=sha256:7b2e5a267c855eea6b4283940daa6e88a285f5f2a67f2220203786dfa59b37e9 \
-    --hash=sha256:823b65d8706e32ad2df51ed89496147a42a2a6e01c13cfb6ffb8b1e92bc910bb \
-    --hash=sha256:8590b4ae07a35970728874632fed7bd57b26b0102df2d2b233b6d9d82f6c62ad \
-    --hash=sha256:8dd717634f5a044f860435c1d8c16a270ddf0ef8588d4887037c5028b859b0c3 \
-    --hash=sha256:8dec4936e9c3100156f8a2dc89c4b88d5c435175ff03413b443469c7c8c5f4d1 \
-    --hash=sha256:97cafb1f3cbcd3fd2b6fbfb99ae11cdb14deea0736fc2b0952ee177f2b813a46 \
-    --hash=sha256:a17a92de5231666cfbe003f0e4b9b3a7ae3afb1ec2845aadc2bacc93ff85febc \
-    --hash=sha256:a549b9c31bec33820e885335b451286e2969a2d9e24879f83fe904a5ce59d70a \
-    --hash=sha256:ac07bad82163452a6884fe8fa0963fb98c2346ba78d779ec06bd7a6262132aee \
-    --hash=sha256:ae2ad8ae6ebee9d2d94b17fb62763125f3f374c25618198f40cbb8b525411900 \
-    --hash=sha256:b91c037585eba9095565a3556f611e3cbfaa42ca1e865f7b8015fe5c7336d5a5 \
-    --hash=sha256:bc1667f8b83f48511b94671e0e441401371dfd0f0a795c7daa4a3cd1dde55bea \
-    --hash=sha256:bec0a414d016ac1a18862a519e54b2fd0fc8bbfd6890376898a6c0891dd82e9f \
-    --hash=sha256:bf50cd79a75d181c9181df03572cdce0fbb75cc353bc350712073108cba98de5 \
-    --hash=sha256:bff1b4290a66b490a2f4719358c0cdcd9bafb6b8f061e45c7a2460866bf50c2e \
-    --hash=sha256:c061bb86a71b42465156a3ee7bd58c8c2ceacdbeb95d05a99893e08b8467359a \
-    --hash=sha256:c8b29db45f8fe46ad280a7294f5c3ec36dbac9491f2d1c17345be8e69cc5928f \
-    --hash=sha256:ce409136744f6521e39fd8e2a24c53fa18ad67aa5bc7c2cf83645cce5b5c4e50 \
-    --hash=sha256:d050b3361367a06d752db6ead6e7edeb0009be66bc3bae0ee9d97fb326badc2a \
-    --hash=sha256:d283d37a890ba4c1ae73ffadf8046435c76e7bc2247bbb63c00bd1a709c6544b \
-    --hash=sha256:d9fad5155d72433c921b782e58892377c44bd6252b5af2f67f16b194987338a4 \
-    --hash=sha256:daa4ee5a243f0f20d528d939d06670a298dd39b1ad5f8a72a4275124a7819eff \
-    --hash=sha256:db0b55e0f3cc0be60c1f19efdde9a637c32740486004f20d1cff53c3c0ece4d2 \
-    --hash=sha256:e61659ba32cf2cf1481e575d0462554625196a1f2fc06a1c777d3f48e8865d46 \
-    --hash=sha256:ea3d8a3d18833cf4304cd2fc9cbb1efe188ca9b5efef2bdac7adc20594a0e46b \
-    --hash=sha256:ec6a563cff360b50eed26f13adc43e61bc0c04d94b8be985e6fb24b81f6dcfdf \
-    --hash=sha256:f5dfb42c4604dddc8e4305050aa6deb084540643ed5804d7455b5df8fe16f5e5 \
-    --hash=sha256:fa173ec60341d6bb97a89f5ea19c85c5643c1e7dedebc22f5181eb73573142c5 \
-    --hash=sha256:fa9db3f79de01457b03d4f01b34cf91bc0048eb2c3846ff26f66687c2f6d16ab \
-    --hash=sha256:fce659a462a1be54d2ffcacea5e3ba2d74daa74f30f5f143fe0c58636e355fdd \
-    --hash=sha256:ffee1f21e5ef0d712f9033568f8344d5da8cc2869dbd08d87c84656e6a2d2f68
+MarkupSafe==3.0.2 \
+    --hash=sha256:0bff5e0ae4ef2e1ae4fdf2dfd5b76c75e5c2fa4132d05fc1b0dabcd20c7e28c4 \
+    --hash=sha256:0f4ca02bea9a23221c0182836703cbf8930c5e9454bacce27e767509fa286a30 \
+    --hash=sha256:1225beacc926f536dc82e45f8a4d68502949dc67eea90eab715dea3a21c1b5f0 \
+    --hash=sha256:131a3c7689c85f5ad20f9f6fb1b866f402c445b220c19fe4308c0b147ccd2ad9 \
+    --hash=sha256:15ab75ef81add55874e7ab7055e9c397312385bd9ced94920f2802310c930396 \
+    --hash=sha256:1a9d3f5f0901fdec14d8d2f66ef7d035f2157240a433441719ac9a3fba440b13 \
+    --hash=sha256:1c99d261bd2d5f6b59325c92c73df481e05e57f19837bdca8413b9eac4bd8028 \
+    --hash=sha256:1e084f686b92e5b83186b07e8a17fc09e38fff551f3602b249881fec658d3eca \
+    --hash=sha256:2181e67807fc2fa785d0592dc2d6206c019b9502410671cc905d132a92866557 \
+    --hash=sha256:2cb8438c3cbb25e220c2ab33bb226559e7afb3baec11c4f218ffa7308603c832 \
+    --hash=sha256:3169b1eefae027567d1ce6ee7cae382c57fe26e82775f460f0b2778beaad66c0 \
+    --hash=sha256:3809ede931876f5b2ec92eef964286840ed3540dadf803dd570c3b7e13141a3b \
+    --hash=sha256:38a9ef736c01fccdd6600705b09dc574584b89bea478200c5fbf112a6b0d5579 \
+    --hash=sha256:3d79d162e7be8f996986c064d1c7c817f6df3a77fe3d6859f6f9e7be4b8c213a \
+    --hash=sha256:444dcda765c8a838eaae23112db52f1efaf750daddb2d9ca300bcae1039adc5c \
+    --hash=sha256:48032821bbdf20f5799ff537c7ac3d1fba0ba032cfc06194faffa8cda8b560ff \
+    --hash=sha256:4aa4e5faecf353ed117801a068ebab7b7e09ffb6e1d5e412dc852e0da018126c \
+    --hash=sha256:52305740fe773d09cffb16f8ed0427942901f00adedac82ec8b67752f58a1b22 \
+    --hash=sha256:569511d3b58c8791ab4c2e1285575265991e6d8f8700c7be0e88f86cb0672094 \
+    --hash=sha256:57cb5a3cf367aeb1d316576250f65edec5bb3be939e9247ae594b4bcbc317dfb \
+    --hash=sha256:5b02fb34468b6aaa40dfc198d813a641e3a63b98c2b05a16b9f80b7ec314185e \
+    --hash=sha256:6381026f158fdb7c72a168278597a5e3a5222e83ea18f543112b2662a9b699c5 \
+    --hash=sha256:6af100e168aa82a50e186c82875a5893c5597a0c1ccdb0d8b40240b1f28b969a \
+    --hash=sha256:6c89876f41da747c8d3677a2b540fb32ef5715f97b66eeb0c6b66f5e3ef6f59d \
+    --hash=sha256:6e296a513ca3d94054c2c881cc913116e90fd030ad1c656b3869762b754f5f8a \
+    --hash=sha256:70a87b411535ccad5ef2f1df5136506a10775d267e197e4cf531ced10537bd6b \
+    --hash=sha256:7e94c425039cde14257288fd61dcfb01963e658efbc0ff54f5306b06054700f8 \
+    --hash=sha256:846ade7b71e3536c4e56b386c2a47adf5741d2d8b94ec9dc3e92e5e1ee1e2225 \
+    --hash=sha256:88416bd1e65dcea10bc7569faacb2c20ce071dd1f87539ca2ab364bf6231393c \
+    --hash=sha256:88b49a3b9ff31e19998750c38e030fc7bb937398b1f78cfa599aaef92d693144 \
+    --hash=sha256:8c4e8c3ce11e1f92f6536ff07154f9d49677ebaaafc32db9db4620bc11ed480f \
+    --hash=sha256:8e06879fc22a25ca47312fbe7c8264eb0b662f6db27cb2d3bbbc74b1df4b9b87 \
+    --hash=sha256:9025b4018f3a1314059769c7bf15441064b2207cb3f065e6ea1e7359cb46db9d \
+    --hash=sha256:93335ca3812df2f366e80509ae119189886b0f3c2b81325d39efdb84a1e2ae93 \
+    --hash=sha256:9778bd8ab0a994ebf6f84c2b949e65736d5575320a17ae8984a77fab08db94cf \
+    --hash=sha256:9e2d922824181480953426608b81967de705c3cef4d1af983af849d7bd619158 \
+    --hash=sha256:a123e330ef0853c6e822384873bef7507557d8e4a082961e1defa947aa59ba84 \
+    --hash=sha256:a904af0a6162c73e3edcb969eeeb53a63ceeb5d8cf642fade7d39e7963a22ddb \
+    --hash=sha256:ad10d3ded218f1039f11a75f8091880239651b52e9bb592ca27de44eed242a48 \
+    --hash=sha256:b424c77b206d63d500bcb69fa55ed8d0e6a3774056bdc4839fc9298a7edca171 \
+    --hash=sha256:b5a6b3ada725cea8a5e634536b1b01c30bcdcd7f9c6fff4151548d5bf6b3a36c \
+    --hash=sha256:ba8062ed2cf21c07a9e295d5b8a2a5ce678b913b45fdf68c32d95d6c1291e0b6 \
+    --hash=sha256:ba9527cdd4c926ed0760bc301f6728ef34d841f405abf9d4f959c478421e4efd \
+    --hash=sha256:bbcb445fa71794da8f178f0f6d66789a28d7319071af7a496d4d507ed566270d \
+    --hash=sha256:bcf3e58998965654fdaff38e58584d8937aa3096ab5354d493c77d1fdd66d7a1 \
+    --hash=sha256:c0ef13eaeee5b615fb07c9a7dadb38eac06a0608b41570d8ade51c56539e509d \
+    --hash=sha256:cabc348d87e913db6ab4aa100f01b08f481097838bdddf7c7a84b7575b7309ca \
+    --hash=sha256:cdb82a876c47801bb54a690c5ae105a46b392ac6099881cdfb9f6e95e4014c6a \
+    --hash=sha256:cfad01eed2c2e0c01fd0ecd2ef42c492f7f93902e39a42fc9ee1692961443a29 \
+    --hash=sha256:d16a81a06776313e817c951135cf7340a3e91e8c1ff2fac444cfd75fffa04afe \
+    --hash=sha256:d8213e09c917a951de9d09ecee036d5c7d36cb6cb7dbaece4c71a60d79fb9798 \
+    --hash=sha256:e07c3764494e3776c602c1e78e298937c3315ccc9043ead7e685b7f2b8d47b3c \
+    --hash=sha256:e17c96c14e19278594aa4841ec148115f9c7615a47382ecb6b82bd8fea3ab0c8 \
+    --hash=sha256:e444a31f8db13eb18ada366ab3cf45fd4b31e4db1236a4448f68778c1d1a5a2f \
+    --hash=sha256:e6a2a455bd412959b57a172ce6328d2dd1f01cb2135efda2e4576e8a23fa3b0f \
+    --hash=sha256:eaa0a10b7f72326f1372a713e73c3f739b524b3af41feb43e4921cb529f5929a \
+    --hash=sha256:eb7972a85c54febfb25b5c4b4f3af4dcc731994c7da0d8a0b4a6eb0640e1d178 \
+    --hash=sha256:ee55d3edf80167e48ea11a923c7386f4669df67d7994554387f84e7d8b0a2bf0 \
+    --hash=sha256:f3818cb119498c0678015754eba762e0d61e5b52d34c8b13d770f0719f7b1d79 \
+    --hash=sha256:f8b3d067f2e40fe93e1ccdd6b2e1d16c43140e76f02fb1319a05cf2b79d99430 \
+    --hash=sha256:fcabf5ff6eea076f859677f5f0b6b5c1a51e70a376b0579e0eadef8db48c6b50
     # via jinja2
 more-itertools==10.5.0 \
     --hash=sha256:037b0d3203ce90cca8ab1defbbdac29d5f993fc20131f3664dc8d6acfa872aef \

From 16a59308399aa2e8967b3ab4b99e60c9d5392784 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:03:24 +0100
Subject: [PATCH 040/133] chore(deps): update actions/setup-python action to v5
 (#462)

---
 .github/workflows/test_suite.yml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/test_suite.yml b/.github/workflows/test_suite.yml
index d79b89dd..21606df0 100644
--- a/.github/workflows/test_suite.yml
+++ b/.github/workflows/test_suite.yml
@@ -12,7 +12,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v2
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.12
       - name: Install nox
@@ -27,7 +27,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v2
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.8
       - name: Install nox
@@ -45,7 +45,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v2
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.12
       - name: Install nox
@@ -66,7 +66,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v2
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.8
       - name: Install nox
@@ -90,7 +90,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v2
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.8
       - name: Install nox
@@ -115,7 +115,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v2
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.12
       - name: Install nox
@@ -139,7 +139,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v2
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.8
       - name: Install nox
@@ -163,7 +163,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v2
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.8
       - name: Install nox

From 154aa0f7426a10b14216033bfabb27c2ce81d266 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:03:38 +0100
Subject: [PATCH 041/133] chore(deps): update actions/checkout action to v4
 (#461)

---
 .github/workflows/test_suite.yml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/test_suite.yml b/.github/workflows/test_suite.yml
index 21606df0..748378ab 100644
--- a/.github/workflows/test_suite.yml
+++ b/.github/workflows/test_suite.yml
@@ -10,7 +10,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
@@ -25,7 +25,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
@@ -43,7 +43,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
@@ -64,7 +64,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
@@ -88,7 +88,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
@@ -113,7 +113,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
@@ -137,7 +137,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
@@ -161,7 +161,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Setup Python
         uses: actions/setup-python@v5
         with:

From 6abeb4ea26f8539388321cf7ab4dcd6b03cbbf2e Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:03:51 +0100
Subject: [PATCH 042/133] chore(deps): update dependency zipp to v3.20.2 (#460)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 3fbfe292..3b9cbb7f 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -616,9 +616,9 @@ wheel==0.44.0 \
     --hash=sha256:2376a90c98cc337d18623527a97c31797bd02bad0033d41547043a1cbfbe448f \
     --hash=sha256:a29c3f2817e95ab89aa4660681ad547c0e9547f20e75b0562fe7723c9a2a9d49
     # via -r requirements.in
-zipp==3.19.1 \
-    --hash=sha256:2828e64edb5386ea6a52e7ba7cdb17bb30a73a858f5eb6eb93d8d36f5ea26091 \
-    --hash=sha256:35427f6d5594f4acf82d25541438348c26736fa9b3afa2754bcd63cdb99d8e8f
+zipp==3.20.2 \
+    --hash=sha256:a817ac80d6cf4b23bf7f2828b7cabf326f15a001bea8b1f9b49631780ba28350 \
+    --hash=sha256:bc9eb26f4506fda01b81bcde0ca78103b6e62f991b381fec825435c836edbc29
     # via importlib-metadata
 
 # WARNING: The following packages were not pinned, but pip requires them to be

From ba34f3d6a8904f7275a2ca9069eb15c0f480b98a Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:04:12 +0100
Subject: [PATCH 043/133] chore(deps): update dependency typing-extensions to
 v4.12.2 (#457)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 3b9cbb7f..e5f35457 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -594,9 +594,9 @@ twine==5.1.1 \
     --hash=sha256:215dbe7b4b94c2c50a7315c0275d2258399280fbb7d04182c7e55e24b5f93997 \
     --hash=sha256:9aa0825139c02b3434d913545c7b847a21c835e11597f5255842d457da2322db
     # via -r requirements.in
-typing-extensions==4.8.0 \
-    --hash=sha256:8f92fc8806f9a6b641eaa5318da32b44d401efaac0f6678c9bc448ba3605faa0 \
-    --hash=sha256:df8e4339e9cb77357558cbdbceca33c303714cf861d1eef15e1070055ae8b7ef
+typing-extensions==4.12.2 \
+    --hash=sha256:04e5ca0351e0f3f85c6853954072df659d0d13fac324d0072316b67d7794700d \
+    --hash=sha256:1a7ead55c7e559dd4dee8856e3a88b41225abfe1ce8df57b7c13915fe121ffb8
     # via -r requirements.in
 urllib3==2.2.3 \
     --hash=sha256:ca899ca043dcb1bafa3e262d73aa25c465bfb49e0bd9dd5d59f1d0acba2f8fac \

From 394cd7e6a78cdfe7601bdb7a4218c7b39f4f3a1b Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:04:23 +0100
Subject: [PATCH 044/133] chore(deps): update dependency pyperclip to v1.9.0
 (#454)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [pyperclip](https://redirect.github.com/asweigart/pyperclip) | `==1.8.2` -> `==1.9.0` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/pyperclip/1.9.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/pyperclip/1.9.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/pyperclip/1.8.2/1.9.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/pyperclip/1.8.2/1.9.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index e5f35457..cc6d1840 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -542,8 +542,8 @@ pyparsing==3.0.9 \
     --hash=sha256:2b020ecf7d21b687f219b71ecad3631f644a47f01403fa1d1036b0c6416d70fb \
     --hash=sha256:5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc
     # via packaging
-pyperclip==1.8.2 \
-    --hash=sha256:105254a8b04934f0bc84e9c24eb360a591aaf6535c9def5f29d92af107a9bf57
+pyperclip==1.9.0 \
+    --hash=sha256:b7de0142ddc81bfc5c7507eea19da920b92252b548b96186caf94a5e2527d310
     # via gcp-releasetool
 python-dateutil==2.9.0.post0 \
     --hash=sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3 \

From 90eaaac7520d1f25970f73dee520956dde4d7e7a Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:04:26 +0100
Subject: [PATCH 045/133] chore(deps): update dependency pyjwt to v2.9.0 (#452)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [pyjwt](https://redirect.github.com/jpadilla/pyjwt) | `==2.6.0` -> `==2.9.0` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/pyjwt/2.9.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/pyjwt/2.9.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/pyjwt/2.6.0/2.9.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/pyjwt/2.6.0/2.9.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>jpadilla/pyjwt (pyjwt)</summary>

### [`v2.9.0`](https://redirect.github.com/jpadilla/pyjwt/blob/HEAD/CHANGELOG.rst#Unreleased-httpsgithubcomjpadillapyjwtcompare290HEAD)

[Compare Source](https://redirect.github.com/jpadilla/pyjwt/compare/2.8.0...2.9.0)

Changed

```

Fixed
~~~~~

Added
~~~~~
```

### [`v2.8.0`](https://redirect.github.com/jpadilla/pyjwt/blob/HEAD/CHANGELOG.rst#v280-httpsgithubcomjpadillapyjwtcompare270280)

[Compare Source](https://redirect.github.com/jpadilla/pyjwt/compare/2.7.0...2.8.0)

Changed

```

- Update python version test matrix by @&#8203;auvipy in `#&#8203;895 <https://togithub.com/jpadilla/pyjwt/pull/895>`__

Fixed
~~~~~

Added
~~~~~

- Add ``strict_aud`` as an option to ``jwt.decode`` by @&#8203;woodruffw in `#&#8203;902 <https://togithub.com/jpadilla/pyjwt/pull/902>`__
- Export PyJWKClientConnectionError class by @&#8203;daviddavis in `#&#8203;887 <https://togithub.com/jpadilla/pyjwt/pull/887>`__
- Allows passing of ssl.SSLContext to PyJWKClient by @&#8203;juur in `#&#8203;891 <https://togithub.com/jpadilla/pyjwt/pull/891>`__
```

### [`v2.7.0`](https://redirect.github.com/jpadilla/pyjwt/blob/HEAD/CHANGELOG.rst#Unreleased-httpsgithubcomjpadillapyjwtcompare270HEAD)

[Compare Source](https://redirect.github.com/jpadilla/pyjwt/compare/2.6.0...2.7.0)

Changed

```

Fixed
~~~~~

Added
~~~~~
```

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index cc6d1840..dd586695 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -534,9 +534,9 @@ pygments==2.15.0 \
     # via
     #   readme-renderer
     #   rich
-pyjwt==2.6.0 \
-    --hash=sha256:69285c7e31fc44f68a1feb309e948e0df53259d579295e6cfe2b1792329f05fd \
-    --hash=sha256:d83c3d892a77bbb74d3e1a2cfa90afaadb60945205d1095d9221f04466f64c14
+PyJWT==2.9.0 \
+    --hash=sha256:3b02fb0f44517787776cf48f2ae25d8e14f300e6d7545a4315cee571a415e850 \
+    --hash=sha256:7e1e5b56cc735432a7369cbfa0efe50fa113ebecdc04ae6922deba8b84582d0c
     # via gcp-releasetool
 pyparsing==3.0.9 \
     --hash=sha256:2b020ecf7d21b687f219b71ecad3631f644a47f01403fa1d1036b0c6416d70fb \

From 79af7a78a73a8b61baa45b713b1e5c5f648b3c79 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:04:36 +0100
Subject: [PATCH 046/133] chore(deps): update dependency readme-renderer to
 v37.3 (#456)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index dd586695..3c297c7a 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -549,9 +549,9 @@ python-dateutil==2.9.0.post0 \
     --hash=sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3 \
     --hash=sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427
     # via gcp-releasetool
-readme-renderer==37.2 \
-    --hash=sha256:d3f06a69e8c40fca9ab3174eca48f96d9771eddb43517b17d96583418427b106 \
-    --hash=sha256:e8ad25293c98f781dbc2c5a36a309929390009f902f99e1798c761aaf04a7923
+readme-renderer==37.3 \
+    --hash=sha256:cd653186dfc73055656f090f227f5cb22a046d7f71a841dfa305f55c9a513273 \
+    --hash=sha256:f67a16caedfa71eef48a31b39708637a6f4664c4394801a7b0d6432d13907343
     # via twine
 requests==2.32.3 \
     --hash=sha256:55365417734eb18255590a9ff9eb97e9e1da868d4ccd6402399eaf68af20a760 \

From 81dc375a4865acb1cf85a8a7a790bc2612710b7d Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:04:50 +0100
Subject: [PATCH 047/133] chore(deps): update dependency pyparsing to v3.2.0
 (#453)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 3c297c7a..f5738e0f 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -538,9 +538,9 @@ PyJWT==2.9.0 \
     --hash=sha256:3b02fb0f44517787776cf48f2ae25d8e14f300e6d7545a4315cee571a415e850 \
     --hash=sha256:7e1e5b56cc735432a7369cbfa0efe50fa113ebecdc04ae6922deba8b84582d0c
     # via gcp-releasetool
-pyparsing==3.0.9 \
-    --hash=sha256:2b020ecf7d21b687f219b71ecad3631f644a47f01403fa1d1036b0c6416d70fb \
-    --hash=sha256:5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc
+pyparsing==3.2.0 \
+    --hash=sha256:93d9577b88da0bbea8cc8334ee8b918ed014968fd2ec383e868fb8afb1ccef84 \
+    --hash=sha256:cbf74e27246d595d9a74b186b810f6fbb86726dbf3b9532efb343f6d7294fe9c
     # via packaging
 pyperclip==1.9.0 \
     --hash=sha256:b7de0142ddc81bfc5c7507eea19da920b92252b548b96186caf94a5e2527d310

From dbb3cc5d2c9332a0d8c5b82f8a56b71357927610 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:05:06 +0100
Subject: [PATCH 048/133] chore(deps): update dependency pygments to v2.18.0
 (#451)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index f5738e0f..87a318e3 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -528,9 +528,9 @@ pycparser==2.21 \
     --hash=sha256:8ee45429555515e1f6b185e78100aea234072576aa43ab53aefcae078162fca9 \
     --hash=sha256:e644fdec12f7872f86c58ff790da456218b10f863970249516d60a5eaca77206
     # via cffi
-pygments==2.15.0 \
-    --hash=sha256:77a3299119af881904cd5ecd1ac6a66214b6e9bed1f2db16993b54adede64094 \
-    --hash=sha256:f7e36cffc4c517fbc252861b9a6e4644ca0e5abadf9a113c72d1358ad09b9500
+Pygments==2.18.0 \
+    --hash=sha256:786ff802f32e91311bff3889f6e9a86e81505fe99f2735bb6d60ae0c5004f199 \
+    --hash=sha256:b8e6aca0523f3ab76fee51799c488e38782ac06eafcf95e7ba832985c8e7b13a
     # via
     #   readme-renderer
     #   rich

From 7f13b8852200ed48ddfbefe43e2716042a492bbf Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:05:22 +0100
Subject: [PATCH 049/133] chore(deps): update dependency platformdirs to v2.6.2
 (#447)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 87a318e3..caabaaf0 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -478,9 +478,9 @@ pkginfo==1.8.3 \
     --hash=sha256:848865108ec99d4901b2f7e84058b6e7660aae8ae10164e015a6dcf5b242a594 \
     --hash=sha256:a84da4318dd86f870a9447a8c98340aa06216bfc6f2b7bdc4b8766984ae1867c
     # via twine
-platformdirs==2.5.2 \
-    --hash=sha256:027d8e83a2d7de06bbac4e5ef7e023c02b863d7ea5d079477e722bb41ab25788 \
-    --hash=sha256:58c8abb07dcb441e6ee4b11d8df0ac856038f944ab98b7be6b27b2a3c7feef19
+platformdirs==2.6.2 \
+    --hash=sha256:83c8f6d04389165de7c9b6f0c682439697887bca0aa2f1c87ef1826be3584490 \
+    --hash=sha256:e1fea1fe471b9ff8332e229df3cb7de4f53eeea4998d3b6bfff542115e998bd2
     # via virtualenv
 protobuf==3.20.3 \
     --hash=sha256:03038ac1cfbc41aa21f6afcbcd357281d7521b4157926f30ebecc8d4ea59dcb7 \

From e52922937d44232b464c06b13994bc7c1893b5ed Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:08:24 +0100
Subject: [PATCH 050/133] chore(deps): update dependency pyasn1-modules to
 v0.4.1 (#449)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [pyasn1-modules](https://redirect.github.com/pyasn1/pyasn1-modules) ([changelog](https://redirect.github.com/pyasn1/pyasn1-modules/blob/master/CHANGES.txt)) | `==0.2.8` -> `==0.4.1` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/pyasn1-modules/0.4.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/pyasn1-modules/0.4.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/pyasn1-modules/0.2.8/0.4.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/pyasn1-modules/0.2.8/0.4.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>pyasn1/pyasn1-modules (pyasn1-modules)</summary>

### [`v0.4.1`](https://redirect.github.com/pyasn1/pyasn1-modules/blob/HEAD/CHANGES.txt#Revision-041-released-10-09-2024)

[Compare Source](https://redirect.github.com/pyasn1/pyasn1-modules/compare/v0.4.0...v0.4.1)

-   Added support for Python 3.13

### [`v0.4.0`](https://redirect.github.com/pyasn1/pyasn1-modules/blob/HEAD/CHANGES.txt#Revision-040-released-26-03-2024)

[Compare Source](https://redirect.github.com/pyasn1/pyasn1-modules/compare/v0.3.0...v0.4.0)

-   Added support for Python 3.11, 3.12
-   Removed support for EOL Pythons 2.7, 3.6, 3.7

### [`v0.3.0`](https://redirect.github.com/pyasn1/pyasn1-modules/blob/HEAD/CHANGES.txt#Revision-030-released-19-04-2023)

[Compare Source](https://redirect.github.com/pyasn1/pyasn1-modules/compare/v0.2.8...v0.3.0)

-   Added support for Python 3.8, 3.9, 3.10, 3.11
-   Removed support for EOL Pythons 2.4, 2.5, 2.6, 3.2, 3.3, 3.4, 3.5
-   Added support for PyPy 3.7, 3.8, 3.9
-   Modernized packaging and testing. pyasn1-modules now uses `setup.cfg`,
    `pyproject.toml`, [build](https://pypi.org/project/build/), and
    GitHub Actions.
-   PyPI package ownership for `pyasn1` and `pyasn1-module` has been
    transfered to *Christian Heimes* and *Simon Pichugin* in
    [PyPI support ticket #&#8203;2090](https://redirect.github.com/pypa/pypi-support/issues/2090).
-   The upstream repositories for `pyasn1` and `pyasn1-modules` are now
    in the GitHub organization https://togithub.com/pyasn1/.
-   Added tox runner with a handful of basic jobs
-   Add RFC3125 providing Electronic Signature Policies
-   Add RFC5126 providing CMS Advanced Electronic Signatures (CAdES)
-   Removed support for EOL Pythons 2.4, 2.5, 2.6, 3.2, 3.3 and 3.4.
-   Improve test routines for RFC5126
-   Add RFC4387 providing Certificate Store Access via HTTP
-   Changed assertion in unit tests from Python built-in to `unittest`
    provided
-   Add RFC8692 providing Algorithm Identifiers for RSASSA-PSS and
    ECDSA Using SHAKEs
-   Add RFC5753 providing CMS Elliptic Curve Cryptography Algorithms
-   Add RFC3820 providing Proxy Certificates
-   Add RFC3370 providing Cryptographic Message Syntax (CMS) Algorithms
-   Add RFC3537 providing HMAC Key Wrapping
-   Add RFC3739 providing Qualified Certificates
-   Add RFC2876 providing KEA and SKIPJACK for CMS
-   Add RFC3058 providing IDEA Encryption Algorithm for CMS
-   Add RFC3657 providing Camellia Encryption Algorithm for CMS
-   Add RFC4010 providing SEED Encryption Algorithm for CMS
-   Add RFC4357 providing Additional Cryptographic Algorithms for Use with
    GOST 28147-89, GOST R 34.10-94, GOST R 34.10-2001, and GOST R 34.11-94
-   Add RFC4490 providing GOST 28147-89, GOST R 34.11-94, GOST R 34.10-94,
    and GOST R 34.10-2001 Algorithms for CMS
-   Add RFC4491 providing GOST R 34.10-94, GOST R 34.10-2001, and
    GOST R 34.11-94 Algorithms for certificates and CRLs
-   Add RFC8696 providing using Pre-Shared Key (PSK) in the CMS
-   Add RFC5639 providing identifiers for the Brainpool curves in
    Elliptic Curve Cryptography
-   Add RFC5697 providing Other Certificates Extension
-   Add RFC4683 providing Subject Identification Method (SIM)
-   Add RFC4476 providing Attribute Certificate Policies Extension
-   Add RFC5636 providing Traceable Anonymous Certificate
-   Add RFC5752 providing Multiple Signatures attribute for CMS
-   Add RFC5275 providing CMS Symmetric Key Management and Distribution
-   Add RFC8702 providing SHAKE One-way Hash Functions in the CMS
-   Add RFC8708 providing HSS/LMS Hash-based Signature Algorithm for CMS
-   Advance copyright statement to year 2020
-   Add RFC8769 providing CBOR and CBOR Sequence content types for CMS

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index caabaaf0..6959d916 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -520,9 +520,9 @@ pyasn1==0.4.8 \
     # via
     #   pyasn1-modules
     #   rsa
-pyasn1-modules==0.2.8 \
-    --hash=sha256:905f84c712230b2c592c19470d3ca8d552de726050d1d1716282a1f6146be65e \
-    --hash=sha256:a50b808ffeb97cb3601dd25981f6b016cbb3d31fbf57a8b8a87428e6158d0c74
+pyasn1-modules==0.4.1 \
+    --hash=sha256:49bfa96b45a292b711e986f222502c1c9a5e1f4e568fc30e2574a6c7d07838fd \
+    --hash=sha256:c28e2dbf9c06ad61c71a075c7e0f9fd0f1b0bb2d2ad4377f240d33ac2ab60a7c
     # via google-auth
 pycparser==2.21 \
     --hash=sha256:8ee45429555515e1f6b185e78100aea234072576aa43ab53aefcae078162fca9 \

From 0d654e5910674622aff7299582822e847e170a1a Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:10:01 +0100
Subject: [PATCH 051/133] chore(deps): update dependency google-auth to v2.35.0
 (#436)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 6959d916..d1edafb4 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -273,9 +273,9 @@ google-api-core==2.10.2 \
     # via
     #   google-cloud-core
     #   google-cloud-storage
-google-auth==2.13.0 \
-    --hash=sha256:9352dd6394093169157e6971526bab9a2799244d68a94a4a609f0dd751ef6f5e \
-    --hash=sha256:99510e664155f1a3c0396a076b5deb6367c52ea04d280152c85ac7f51f50eb42
+google-auth==2.35.0 \
+    --hash=sha256:25df55f327ef021de8be50bad0dfd4a916ad0de96da86cd05661c9297723ad3f \
+    --hash=sha256:f4c64ed4e01e8e8b646ef34c018f8bf3338df0c8e37d8b3bba40e7f574a3278a
     # via
     #   gcp-releasetool
     #   google-api-core

From cfaff0901904d809dbe2e60efb8fd58f3c9607d5 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:10:19 +0100
Subject: [PATCH 052/133] chore(deps): update dependency pycparser to v2.22
 (#450)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [pycparser](https://redirect.github.com/eliben/pycparser) | `==2.21` -> `==2.22` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/pycparser/2.22?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/pycparser/2.22?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/pycparser/2.21/2.22?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/pycparser/2.21/2.22?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>eliben/pycparser (pycparser)</summary>

### [`v2.22`](https://redirect.github.com/eliben/pycparser/compare/release_v2.21...release_v2.22)

[Compare Source](https://redirect.github.com/eliben/pycparser/compare/release_v2.21...release_v2.22)

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index d1edafb4..ec41f8e5 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -524,9 +524,9 @@ pyasn1-modules==0.4.1 \
     --hash=sha256:49bfa96b45a292b711e986f222502c1c9a5e1f4e568fc30e2574a6c7d07838fd \
     --hash=sha256:c28e2dbf9c06ad61c71a075c7e0f9fd0f1b0bb2d2ad4377f240d33ac2ab60a7c
     # via google-auth
-pycparser==2.21 \
-    --hash=sha256:8ee45429555515e1f6b185e78100aea234072576aa43ab53aefcae078162fca9 \
-    --hash=sha256:e644fdec12f7872f86c58ff790da456218b10f863970249516d60a5eaca77206
+pycparser==2.22 \
+    --hash=sha256:491c8be9c040f5390f5bf44a5b07752bd07f56edf992381b05c701439eec10f6 \
+    --hash=sha256:c3702b6d3dd8c7abc1afa565d7e63d53a1d0bd86cdc24edd75470f4de499cfcc
     # via cffi
 Pygments==2.18.0 \
     --hash=sha256:786ff802f32e91311bff3889f6e9a86e81505fe99f2735bb6d60ae0c5004f199 \

From 6dfaa1b520bc92a22f8c3ed8b3e22a09c0dab07d Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:10:22 +0100
Subject: [PATCH 053/133] chore(deps): update dependency keyring to v23.13.1
 (#444)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [keyring](https://redirect.github.com/jaraco/keyring) | `==23.9.3` -> `==23.13.1` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/keyring/23.13.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/keyring/23.13.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/keyring/23.9.3/23.13.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/keyring/23.9.3/23.13.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>jaraco/keyring (keyring)</summary>

### [`v23.13.1`](https://redirect.github.com/jaraco/keyring/compare/v23.13.0...v23.13.1)

[Compare Source](https://redirect.github.com/jaraco/keyring/compare/v23.13.0...v23.13.1)

### [`v23.13.0`](https://redirect.github.com/jaraco/keyring/compare/v23.12.1...v23.13.0)

[Compare Source](https://redirect.github.com/jaraco/keyring/compare/v23.12.1...v23.13.0)

### [`v23.12.1`](https://redirect.github.com/jaraco/keyring/compare/v23.11.0...v23.12.1)

[Compare Source](https://redirect.github.com/jaraco/keyring/compare/v23.11.0...v23.12.1)

### [`v23.11.0`](https://redirect.github.com/jaraco/keyring/compare/v23.10.0...v23.11.0)

[Compare Source](https://redirect.github.com/jaraco/keyring/compare/v23.10.0...v23.11.0)

### [`v23.10.0`](https://redirect.github.com/jaraco/keyring/compare/v23.9.3...v23.10.0)

[Compare Source](https://redirect.github.com/jaraco/keyring/compare/v23.9.3...v23.10.0)

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index ec41f8e5..c331d0e5 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -391,9 +391,9 @@ jinja2==3.1.4 \
     --hash=sha256:4a3aee7acbbe7303aede8e9648d13b8bf88a429282aa6122a993f0ac800cb369 \
     --hash=sha256:bc5dd2abb727a5319567b7a813e6a2e7318c39f4f487cfe6c89c6f9c7d25197d
     # via gcp-releasetool
-keyring==23.9.3 \
-    --hash=sha256:69732a15cb1433bdfbc3b980a8a36a04878a6cfd7cb99f497b573f31618001c0 \
-    --hash=sha256:69b01dd83c42f590250fe7a1f503fc229b14de83857314b1933a3ddbf595c4a5
+keyring==23.13.1 \
+    --hash=sha256:771ed2a91909389ed6148631de678f82ddc73737d85a927f382a8a1b157898cd \
+    --hash=sha256:ba2e15a9b35e21908d0aaf4e0a47acc52d6ae33444df0da2b49d41a46ef6d678
     # via
     #   gcp-releasetool
     #   twine

From 86b038c924f3061621c44a6a65171bc1ac8d4ca3 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:10:47 +0100
Subject: [PATCH 054/133] chore(deps): update dependency pkginfo to v1.11.2
 (#446)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index c331d0e5..92c76756 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -474,9 +474,9 @@ packaging==24.1 \
     # via
     #   gcp-releasetool
     #   nox
-pkginfo==1.8.3 \
-    --hash=sha256:848865108ec99d4901b2f7e84058b6e7660aae8ae10164e015a6dcf5b242a594 \
-    --hash=sha256:a84da4318dd86f870a9447a8c98340aa06216bfc6f2b7bdc4b8766984ae1867c
+pkginfo==1.11.2 \
+    --hash=sha256:9ec518eefccd159de7ed45386a6bb4c6ca5fa2cb3bd9b71154fae44f6f1b36a3 \
+    --hash=sha256:c6bc916b8298d159e31f2c216e35ee5b86da7da18874f879798d0a1983537c86
     # via twine
 platformdirs==2.6.2 \
     --hash=sha256:83c8f6d04389165de7c9b6f0c682439697887bca0aa2f1c87ef1826be3584490 \

From c226ccc54f237cb92de3d9385fed5a51484480a5 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:10:59 +0100
Subject: [PATCH 055/133] chore(deps): update dependency nox to v2022.11.21
 (#445)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 92c76756..1cdd41e8 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -464,9 +464,9 @@ more-itertools==10.5.0 \
     --hash=sha256:037b0d3203ce90cca8ab1defbbdac29d5f993fc20131f3664dc8d6acfa872aef \
     --hash=sha256:5482bfef7849c25dc3c6dd53a6173ae4795da2a41a80faea6700d9f5846c5da6
     # via jaraco-classes
-nox==2022.8.7 \
-    --hash=sha256:1b894940551dc5c389f9271d197ca5d655d40bdc6ccf93ed6880e4042760a34b \
-    --hash=sha256:96cca88779e08282a699d672258ec01eb7c792d35bbbf538c723172bce23212c
+nox==2022.11.21 \
+    --hash=sha256:0e41a990e290e274cb205a976c4c97ee3c5234441a8132c8c3fd9ea3c22149eb \
+    --hash=sha256:e21c31de0711d1274ca585a2c5fde36b1aa962005ba8e9322bf5eeed16dcd684
     # via -r requirements.in
 packaging==24.1 \
     --hash=sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002 \

From 25dc600571dd120dbcffad0bab92ec23018af40f Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:11:16 +0100
Subject: [PATCH 056/133] chore(deps): update dependency idna to v3.10 (#442)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 1cdd41e8..a0332cd8 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -367,9 +367,9 @@ googleapis-common-protos==1.56.4 \
     --hash=sha256:8eb2cbc91b69feaf23e32452a7ae60e791e09967d81d4fcc7fc388182d1bd394 \
     --hash=sha256:c25873c47279387cfdcbdafa36149887901d36202cb645a0e4f29686bf6e4417
     # via google-api-core
-idna==3.7 \
-    --hash=sha256:028ff3aadf0609c1fd278d8ea3089299412a7a8b9bd005dd08b9f8285bcb5cfc \
-    --hash=sha256:82fee1fc78add43492d3a1898bfa6d8a904cc97d8427f683ed8e798d07761aa0
+idna==3.10 \
+    --hash=sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9 \
+    --hash=sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3
     # via requests
 importlib-metadata==5.2.0 \
     --hash=sha256:0eafa39ba42bf225fc00e67f701d71f85aead9f878569caf13c3724f704b970f \

From d28cf7899b40d2dfd1bc68b934f53fbed94f43e2 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:11:30 +0100
Subject: [PATCH 057/133] chore(deps): update dependency
 googleapis-common-protos to v1.65.0 (#441)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index a0332cd8..09ef9968 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -363,9 +363,9 @@ google-resumable-media==2.6.0 \
     --hash=sha256:972852f6c65f933e15a4a210c2b96930763b47197cdf4aa5f5bea435efb626e7 \
     --hash=sha256:fc03d344381970f79eebb632a3c18bb1828593a2dc5572b5f90115ef7d11e81b
     # via google-cloud-storage
-googleapis-common-protos==1.56.4 \
-    --hash=sha256:8eb2cbc91b69feaf23e32452a7ae60e791e09967d81d4fcc7fc388182d1bd394 \
-    --hash=sha256:c25873c47279387cfdcbdafa36149887901d36202cb645a0e4f29686bf6e4417
+googleapis-common-protos==1.65.0 \
+    --hash=sha256:2972e6c496f435b92590fd54045060867f3fe9be2c82ab148fc8885035479a63 \
+    --hash=sha256:334a29d07cddc3aa01dee4988f9afd9b2916ee2ff49d6b757155dc0d197852c0
     # via google-api-core
 idna==3.10 \
     --hash=sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9 \

From f5d5b3e65cbfa592e59b5ac48828fad08923e49f Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:11:46 +0100
Subject: [PATCH 058/133] chore(deps): update dependency google-cloud-core to
 v2.4.1 (#437)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 09ef9968..365a76ed 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -281,9 +281,9 @@ google-auth==2.35.0 \
     #   google-api-core
     #   google-cloud-core
     #   google-cloud-storage
-google-cloud-core==2.3.3 \
-    --hash=sha256:37b80273c8d7eee1ae816b3a20ae43585ea50506cb0e60f3cf5be5f87f1373cb \
-    --hash=sha256:fbd11cad3e98a7e5b0343dc07cb1039a5ffd7a5bb96e1f1e27cee4bda4a90863
+google-cloud-core==2.4.1 \
+    --hash=sha256:9b7749272a812bde58fff28868d0c5e2f585b82f37e09a1f6ed2d4d10f134073 \
+    --hash=sha256:a9e6a4422b9ac5c29f79a0ede9485473338e2ce78d91f2370c01e730eab22e61
     # via google-cloud-storage
 google-cloud-storage==2.5.0 \
     --hash=sha256:19a26c66c317ce542cea0830b7e787e8dac2588b6bfa4d3fd3b871ba16305ab0 \

From b630c2cd891eb36d2a51d0a3dbbb7bda3379f34a Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:12:02 +0100
Subject: [PATCH 059/133] chore(deps): update dependency gcp-releasetool to
 v1.17.0 (#435)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 365a76ed..33eac6c3 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -263,9 +263,9 @@ gcp-docuploader==0.6.5 \
     --hash=sha256:30221d4ac3e5a2b9c69aa52fdbef68cc3f27d0e6d0d90e220fc024584b8d2318 \
     --hash=sha256:b7458ef93f605b9d46a4bf3a8dc1755dad1f31d030c8679edf304e343b347eea
     # via -r requirements.in
-gcp-releasetool==1.16.0 \
-    --hash=sha256:27bf19d2e87aaa884096ff941aa3c592c482be3d6a2bfe6f06afafa6af2353e3 \
-    --hash=sha256:a316b197a543fd036209d0caba7a8eb4d236d8e65381c80cbc6d7efaa7606d63
+gcp-releasetool==1.17.0 \
+    --hash=sha256:1a759f4b0906f4ea9dc7db3649aa11a632c72f6dc6a54f10cf57c1925d034a1c \
+    --hash=sha256:f23db51d85484998af5549181be726f177bf90b481de238fe7a99ec970266b6b
     # via -r requirements.in
 google-api-core==2.10.2 \
     --hash=sha256:10c06f7739fe57781f87523375e8e1a3a4674bf6392cd6131a3222182b971320 \

From 0889df841e509e3435c5685a739cb81906b89870 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:14:16 +0100
Subject: [PATCH 060/133] chore(deps): update dependency google-resumable-media
 to v2.7.2 (#440)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 33eac6c3..bd124e98 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -359,9 +359,9 @@ google-crc32c==1.5.0 \
     --hash=sha256:fd8536e902db7e365f49e7d9029283403974ccf29b13fc7028b97e2295b33556 \
     --hash=sha256:fe70e325aa68fa4b5edf7d1a4b6f691eb04bbccac0ace68e34820d283b5f80d4
     # via google-resumable-media
-google-resumable-media==2.6.0 \
-    --hash=sha256:972852f6c65f933e15a4a210c2b96930763b47197cdf4aa5f5bea435efb626e7 \
-    --hash=sha256:fc03d344381970f79eebb632a3c18bb1828593a2dc5572b5f90115ef7d11e81b
+google-resumable-media==2.7.2 \
+    --hash=sha256:3ce7551e9fe6d99e9a126101d2536612bb73486721951e9562fee0f90c6ababa \
+    --hash=sha256:5280aed4629f2b60b847b0d42f9857fd4935c11af266744df33d8074cae92fe0
     # via google-cloud-storage
 googleapis-common-protos==1.65.0 \
     --hash=sha256:2972e6c496f435b92590fd54045060867f3fe9be2c82ab148fc8885035479a63 \

From 2759430672ff18e0fe6dbb44e45403ec01e38f8b Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 08:14:19 +0100
Subject: [PATCH 061/133] chore(deps): update dependency google-crc32c to
 v1.6.0 (#439)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [google-crc32c](https://redirect.github.com/googleapis/python-crc32c) | `==1.5.0` -> `==1.6.0` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/google-crc32c/1.6.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/google-crc32c/1.6.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/google-crc32c/1.5.0/1.6.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/google-crc32c/1.5.0/1.6.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>googleapis/python-crc32c (google-crc32c)</summary>

### [`v1.6.0`](https://redirect.github.com/googleapis/python-crc32c/blob/HEAD/CHANGELOG.md#160-2024-08-29)

[Compare Source](https://redirect.github.com/googleapis/python-crc32c/compare/v1.5.0...v1.6.0)

##### Features

-   Add support for python 3.12 ([#&#8203;177](https://redirect.github.com/googleapis/python-crc32c/issues/177)) ([5ff1207](https://redirect.github.com/googleapis/python-crc32c/commit/5ff1207e7b60256e7a32932324ccb9ad4ec265d2))
-   Build using Visual Studio 17 2022 instead of Visual Studio 16 2019 ([c1c8c59](https://redirect.github.com/googleapis/python-crc32c/commit/c1c8c597d07e573406d76765022a837b007f9074))

##### Bug Fixes

-   Drop support for python 3.7 and 3.8 ([c1c8c59](https://redirect.github.com/googleapis/python-crc32c/commit/c1c8c597d07e573406d76765022a837b007f9074))
-   Drop support for Windows 32bit which is not supported in Visual Studio 17 2022 ([c1c8c59](https://redirect.github.com/googleapis/python-crc32c/commit/c1c8c597d07e573406d76765022a837b007f9074))
-   Remove manylinux1 which is no longer supported by PyPA ([#&#8203;186](https://redirect.github.com/googleapis/python-crc32c/issues/186)) ([79edb3f](https://redirect.github.com/googleapis/python-crc32c/commit/79edb3fd3cda0e4193a6fb6a8346058398df43de))

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOC4xMzUuMiIsInVwZGF0ZWRJblZlciI6IjM4LjEzNS4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
---
 .kokoro/requirements.txt | 97 ++++++++++++----------------------------
 1 file changed, 28 insertions(+), 69 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index bd124e98..f344093e 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -289,75 +289,34 @@ google-cloud-storage==2.5.0 \
     --hash=sha256:19a26c66c317ce542cea0830b7e787e8dac2588b6bfa4d3fd3b871ba16305ab0 \
     --hash=sha256:382f34b91de2212e3c2e7b40ec079d27ee2e3dbbae99b75b1bcd8c63063ce235
     # via gcp-docuploader
-google-crc32c==1.5.0 \
-    --hash=sha256:024894d9d3cfbc5943f8f230e23950cd4906b2fe004c72e29b209420a1e6b05a \
-    --hash=sha256:02c65b9817512edc6a4ae7c7e987fea799d2e0ee40c53ec573a692bee24de876 \
-    --hash=sha256:02ebb8bf46c13e36998aeaad1de9b48f4caf545e91d14041270d9dca767b780c \
-    --hash=sha256:07eb3c611ce363c51a933bf6bd7f8e3878a51d124acfc89452a75120bc436289 \
-    --hash=sha256:1034d91442ead5a95b5aaef90dbfaca8633b0247d1e41621d1e9f9db88c36298 \
-    --hash=sha256:116a7c3c616dd14a3de8c64a965828b197e5f2d121fedd2f8c5585c547e87b02 \
-    --hash=sha256:19e0a019d2c4dcc5e598cd4a4bc7b008546b0358bd322537c74ad47a5386884f \
-    --hash=sha256:1c7abdac90433b09bad6c43a43af253e688c9cfc1c86d332aed13f9a7c7f65e2 \
-    --hash=sha256:1e986b206dae4476f41bcec1faa057851f3889503a70e1bdb2378d406223994a \
-    --hash=sha256:272d3892a1e1a2dbc39cc5cde96834c236d5327e2122d3aaa19f6614531bb6eb \
-    --hash=sha256:278d2ed7c16cfc075c91378c4f47924c0625f5fc84b2d50d921b18b7975bd210 \
-    --hash=sha256:2ad40e31093a4af319dadf503b2467ccdc8f67c72e4bcba97f8c10cb078207b5 \
-    --hash=sha256:2e920d506ec85eb4ba50cd4228c2bec05642894d4c73c59b3a2fe20346bd00ee \
-    --hash=sha256:3359fc442a743e870f4588fcf5dcbc1bf929df1fad8fb9905cd94e5edb02e84c \
-    --hash=sha256:37933ec6e693e51a5b07505bd05de57eee12f3e8c32b07da7e73669398e6630a \
-    --hash=sha256:398af5e3ba9cf768787eef45c803ff9614cc3e22a5b2f7d7ae116df8b11e3314 \
-    --hash=sha256:3b747a674c20a67343cb61d43fdd9207ce5da6a99f629c6e2541aa0e89215bcd \
-    --hash=sha256:461665ff58895f508e2866824a47bdee72497b091c730071f2b7575d5762ab65 \
-    --hash=sha256:4c6fdd4fccbec90cc8a01fc00773fcd5fa28db683c116ee3cb35cd5da9ef6c37 \
-    --hash=sha256:5829b792bf5822fd0a6f6eb34c5f81dd074f01d570ed7f36aa101d6fc7a0a6e4 \
-    --hash=sha256:596d1f98fc70232fcb6590c439f43b350cb762fb5d61ce7b0e9db4539654cc13 \
-    --hash=sha256:5ae44e10a8e3407dbe138984f21e536583f2bba1be9491239f942c2464ac0894 \
-    --hash=sha256:635f5d4dd18758a1fbd1049a8e8d2fee4ffed124462d837d1a02a0e009c3ab31 \
-    --hash=sha256:64e52e2b3970bd891309c113b54cf0e4384762c934d5ae56e283f9a0afcd953e \
-    --hash=sha256:66741ef4ee08ea0b2cc3c86916ab66b6aef03768525627fd6a1b34968b4e3709 \
-    --hash=sha256:67b741654b851abafb7bc625b6d1cdd520a379074e64b6a128e3b688c3c04740 \
-    --hash=sha256:6ac08d24c1f16bd2bf5eca8eaf8304812f44af5cfe5062006ec676e7e1d50afc \
-    --hash=sha256:6f998db4e71b645350b9ac28a2167e6632c239963ca9da411523bb439c5c514d \
-    --hash=sha256:72218785ce41b9cfd2fc1d6a017dc1ff7acfc4c17d01053265c41a2c0cc39b8c \
-    --hash=sha256:74dea7751d98034887dbd821b7aae3e1d36eda111d6ca36c206c44478035709c \
-    --hash=sha256:759ce4851a4bb15ecabae28f4d2e18983c244eddd767f560165563bf9aefbc8d \
-    --hash=sha256:77e2fd3057c9d78e225fa0a2160f96b64a824de17840351b26825b0848022906 \
-    --hash=sha256:7c074fece789b5034b9b1404a1f8208fc2d4c6ce9decdd16e8220c5a793e6f61 \
-    --hash=sha256:7c42c70cd1d362284289c6273adda4c6af8039a8ae12dc451dcd61cdabb8ab57 \
-    --hash=sha256:7f57f14606cd1dd0f0de396e1e53824c371e9544a822648cd76c034d209b559c \
-    --hash=sha256:83c681c526a3439b5cf94f7420471705bbf96262f49a6fe546a6db5f687a3d4a \
-    --hash=sha256:8485b340a6a9e76c62a7dce3c98e5f102c9219f4cfbf896a00cf48caf078d438 \
-    --hash=sha256:84e6e8cd997930fc66d5bb4fde61e2b62ba19d62b7abd7a69920406f9ecca946 \
-    --hash=sha256:89284716bc6a5a415d4eaa11b1726d2d60a0cd12aadf5439828353662ede9dd7 \
-    --hash=sha256:8b87e1a59c38f275c0e3676fc2ab6d59eccecfd460be267ac360cc31f7bcde96 \
-    --hash=sha256:8f24ed114432de109aa9fd317278518a5af2d31ac2ea6b952b2f7782b43da091 \
-    --hash=sha256:98cb4d057f285bd80d8778ebc4fde6b4d509ac3f331758fb1528b733215443ae \
-    --hash=sha256:998679bf62b7fb599d2878aa3ed06b9ce688b8974893e7223c60db155f26bd8d \
-    --hash=sha256:9ba053c5f50430a3fcfd36f75aff9caeba0440b2d076afdb79a318d6ca245f88 \
-    --hash=sha256:9c99616c853bb585301df6de07ca2cadad344fd1ada6d62bb30aec05219c45d2 \
-    --hash=sha256:a1fd716e7a01f8e717490fbe2e431d2905ab8aa598b9b12f8d10abebb36b04dd \
-    --hash=sha256:a2355cba1f4ad8b6988a4ca3feed5bff33f6af2d7f134852cf279c2aebfde541 \
-    --hash=sha256:b1f8133c9a275df5613a451e73f36c2aea4fe13c5c8997e22cf355ebd7bd0728 \
-    --hash=sha256:b8667b48e7a7ef66afba2c81e1094ef526388d35b873966d8a9a447974ed9178 \
-    --hash=sha256:ba1eb1843304b1e5537e1fca632fa894d6f6deca8d6389636ee5b4797affb968 \
-    --hash=sha256:be82c3c8cfb15b30f36768797a640e800513793d6ae1724aaaafe5bf86f8f346 \
-    --hash=sha256:c02ec1c5856179f171e032a31d6f8bf84e5a75c45c33b2e20a3de353b266ebd8 \
-    --hash=sha256:c672d99a345849301784604bfeaeba4db0c7aae50b95be04dd651fd2a7310b93 \
-    --hash=sha256:c6c777a480337ac14f38564ac88ae82d4cd238bf293f0a22295b66eb89ffced7 \
-    --hash=sha256:cae0274952c079886567f3f4f685bcaf5708f0a23a5f5216fdab71f81a6c0273 \
-    --hash=sha256:cd67cf24a553339d5062eff51013780a00d6f97a39ca062781d06b3a73b15462 \
-    --hash=sha256:d3515f198eaa2f0ed49f8819d5732d70698c3fa37384146079b3799b97667a94 \
-    --hash=sha256:d5280312b9af0976231f9e317c20e4a61cd2f9629b7bfea6a693d1878a264ebd \
-    --hash=sha256:de06adc872bcd8c2a4e0dc51250e9e65ef2ca91be023b9d13ebd67c2ba552e1e \
-    --hash=sha256:e1674e4307fa3024fc897ca774e9c7562c957af85df55efe2988ed9056dc4e57 \
-    --hash=sha256:e2096eddb4e7c7bdae4bd69ad364e55e07b8316653234a56552d9c988bd2d61b \
-    --hash=sha256:e560628513ed34759456a416bf86b54b2476c59144a9138165c9a1575801d0d9 \
-    --hash=sha256:edfedb64740750e1a3b16152620220f51d58ff1b4abceb339ca92e934775c27a \
-    --hash=sha256:f13cae8cc389a440def0c8c52057f37359014ccbc9dc1f0827936bcd367c6100 \
-    --hash=sha256:f314013e7dcd5cf45ab1945d92e713eec788166262ae8deb2cfacd53def27325 \
-    --hash=sha256:f583edb943cf2e09c60441b910d6a20b4d9d626c75a36c8fcac01a6c96c01183 \
-    --hash=sha256:fd8536e902db7e365f49e7d9029283403974ccf29b13fc7028b97e2295b33556 \
-    --hash=sha256:fe70e325aa68fa4b5edf7d1a4b6f691eb04bbccac0ace68e34820d283b5f80d4
+google-crc32c==1.6.0 \
+    --hash=sha256:05e2d8c9a2f853ff116db9706b4a27350587f341eda835f46db3c0a8c8ce2f24 \
+    --hash=sha256:18e311c64008f1f1379158158bb3f0c8d72635b9eb4f9545f8cf990c5668e59d \
+    --hash=sha256:236c87a46cdf06384f614e9092b82c05f81bd34b80248021f729396a78e55d7e \
+    --hash=sha256:35834855408429cecf495cac67ccbab802de269e948e27478b1e47dfb6465e57 \
+    --hash=sha256:386122eeaaa76951a8196310432c5b0ef3b53590ef4c317ec7588ec554fec5d2 \
+    --hash=sha256:40b05ab32a5067525670880eb5d169529089a26fe35dce8891127aeddc1950e8 \
+    --hash=sha256:48abd62ca76a2cbe034542ed1b6aee851b6f28aaca4e6551b5599b6f3ef175cc \
+    --hash=sha256:50cf2a96da226dcbff8671233ecf37bf6e95de98b2a2ebadbfdf455e6d05df42 \
+    --hash=sha256:51c4f54dd8c6dfeb58d1df5e4f7f97df8abf17a36626a217f169893d1d7f3e9f \
+    --hash=sha256:5bcc90b34df28a4b38653c36bb5ada35671ad105c99cfe915fb5bed7ad6924aa \
+    --hash=sha256:62f6d4a29fea082ac4a3c9be5e415218255cf11684ac6ef5488eea0c9132689b \
+    --hash=sha256:6eceb6ad197656a1ff49ebfbbfa870678c75be4344feb35ac1edf694309413dc \
+    --hash=sha256:7aec8e88a3583515f9e0957fe4f5f6d8d4997e36d0f61624e70469771584c760 \
+    --hash=sha256:91ca8145b060679ec9176e6de4f89b07363d6805bd4760631ef254905503598d \
+    --hash=sha256:a184243544811e4a50d345838a883733461e67578959ac59964e43cca2c791e7 \
+    --hash=sha256:a9e4b426c3702f3cd23b933436487eb34e01e00327fac20c9aebb68ccf34117d \
+    --hash=sha256:bb0966e1c50d0ef5bc743312cc730b533491d60585a9a08f897274e57c3f70e0 \
+    --hash=sha256:bb8b3c75bd157010459b15222c3fd30577042a7060e29d42dabce449c087f2b3 \
+    --hash=sha256:bd5e7d2445d1a958c266bfa5d04c39932dc54093fa391736dbfdb0f1929c1fb3 \
+    --hash=sha256:c87d98c7c4a69066fd31701c4e10d178a648c2cac3452e62c6b24dc51f9fcc00 \
+    --hash=sha256:d2952396dc604544ea7476b33fe87faedc24d666fb0c2d5ac971a2b9576ab871 \
+    --hash=sha256:d8797406499f28b5ef791f339594b0b5fdedf54e203b5066675c406ba69d705c \
+    --hash=sha256:d9e9913f7bd69e093b81da4535ce27af842e7bf371cde42d1ae9e9bd382dc0e9 \
+    --hash=sha256:e2806553238cd076f0a55bddab37a532b53580e699ed8e5606d0de1f856b5205 \
+    --hash=sha256:ebab974b1687509e5c973b5c4b8b146683e101e102e17a86bd196ecaa4d099fc \
+    --hash=sha256:ed767bf4ba90104c1216b68111613f0d5926fb3780660ea1198fc469af410e9d \
+    --hash=sha256:f7a1fc29803712f80879b0806cb83ab24ce62fc8daf0569f2204a0cfd7f68ed4
     # via google-resumable-media
 google-resumable-media==2.7.2 \
     --hash=sha256:3ce7551e9fe6d99e9a126101d2536612bb73486721951e9562fee0f90c6ababa \

From 1006bddd84654d06ec19b02212324af54293891b Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 09:18:58 +0100
Subject: [PATCH 062/133] chore(deps): update dependency rich to v13 (#477)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* chore(deps): update dependency rich to v13

* build: update hashes

* deps: add secretstorage

* deps: add back missing deps

* deps: downgrade pkginfo

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>
---
 .kokoro/requirements.txt | 36 ++++++++++++++++++++----------------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index f344093e..96c1aba5 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -1,6 +1,6 @@
 #
-# This file is autogenerated by pip-compile with python 3.10
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.12
+# by the following command:
 #
 #    pip-compile --generate-hashes requirements.in
 #
@@ -244,9 +244,7 @@ cryptography==43.0.3 \
     --hash=sha256:f18c716be16bc1fea8e95def49edf46b82fccaa88587a45f8dc0ff6ab5d8e0a7 \
     --hash=sha256:f46304d6f0c6ab8e52770addfa2fc41e6629495548862279641972b6215451cd \
     --hash=sha256:f7b178f11ed3664fd0e995a47ed2b5ff0a12d893e41dd0494f406d1cf555cab7
-    # via
-    #   gcp-releasetool
-    #   secretstorage
+    # via gcp-releasetool
 distlib==0.3.9 \
     --hash=sha256:47f8c22fd27c27e25a65601af709b38e4f0a45ea4fc2e710f65755fa8caaaf87 \
     --hash=sha256:a60f20dea646b8a33f3e7772f74dc0b2d0772d2837ee1342a00645c81edf9403
@@ -356,7 +354,11 @@ keyring==23.13.1 \
     # via
     #   gcp-releasetool
     #   twine
-MarkupSafe==3.0.2 \
+markdown-it-py==3.0.0 \
+    --hash=sha256:355216845c60bd96232cd8d8c40e8f9765cc86f46880e43a8fd22dc1a1a8cab1 \
+    --hash=sha256:e3f60a94fa066dc52ec76661e37c851cb232d92f9886b15cb560aaada2df8feb
+    # via rich
+markupsafe==3.0.2 \
     --hash=sha256:0bff5e0ae4ef2e1ae4fdf2dfd5b76c75e5c2fa4132d05fc1b0dabcd20c7e28c4 \
     --hash=sha256:0f4ca02bea9a23221c0182836703cbf8930c5e9454bacce27e767509fa286a30 \
     --hash=sha256:1225beacc926f536dc82e45f8a4d68502949dc67eea90eab715dea3a21c1b5f0 \
@@ -419,6 +421,10 @@ MarkupSafe==3.0.2 \
     --hash=sha256:f8b3d067f2e40fe93e1ccdd6b2e1d16c43140e76f02fb1319a05cf2b79d99430 \
     --hash=sha256:fcabf5ff6eea076f859677f5f0b6b5c1a51e70a376b0579e0eadef8db48c6b50
     # via jinja2
+mdurl==0.1.2 \
+    --hash=sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8 \
+    --hash=sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba
+    # via markdown-it-py
 more-itertools==10.5.0 \
     --hash=sha256:037b0d3203ce90cca8ab1defbbdac29d5f993fc20131f3664dc8d6acfa872aef \
     --hash=sha256:5482bfef7849c25dc3c6dd53a6173ae4795da2a41a80faea6700d9f5846c5da6
@@ -433,9 +439,9 @@ packaging==24.1 \
     # via
     #   gcp-releasetool
     #   nox
-pkginfo==1.11.2 \
-    --hash=sha256:9ec518eefccd159de7ed45386a6bb4c6ca5fa2cb3bd9b71154fae44f6f1b36a3 \
-    --hash=sha256:c6bc916b8298d159e31f2c216e35ee5b86da7da18874f879798d0a1983537c86
+pkginfo==1.10.0 \
+    --hash=sha256:5df73835398d10db79f8eecd5cd86b1f6d29317589ea70796994d49399af6297 \
+    --hash=sha256:889a6da2ed7ffc58ab5b900d888ddce90bce912f2d2de1dc1c26f4cb9fe65097
     # via twine
 platformdirs==2.6.2 \
     --hash=sha256:83c8f6d04389165de7c9b6f0c682439697887bca0aa2f1c87ef1826be3584490 \
@@ -487,13 +493,13 @@ pycparser==2.22 \
     --hash=sha256:491c8be9c040f5390f5bf44a5b07752bd07f56edf992381b05c701439eec10f6 \
     --hash=sha256:c3702b6d3dd8c7abc1afa565d7e63d53a1d0bd86cdc24edd75470f4de499cfcc
     # via cffi
-Pygments==2.18.0 \
+pygments==2.18.0 \
     --hash=sha256:786ff802f32e91311bff3889f6e9a86e81505fe99f2735bb6d60ae0c5004f199 \
     --hash=sha256:b8e6aca0523f3ab76fee51799c488e38782ac06eafcf95e7ba832985c8e7b13a
     # via
     #   readme-renderer
     #   rich
-PyJWT==2.9.0 \
+pyjwt==2.9.0 \
     --hash=sha256:3b02fb0f44517787776cf48f2ae25d8e14f300e6d7545a4315cee571a415e850 \
     --hash=sha256:7e1e5b56cc735432a7369cbfa0efe50fa113ebecdc04ae6922deba8b84582d0c
     # via gcp-releasetool
@@ -529,9 +535,9 @@ rfc3986==2.0.0 \
     --hash=sha256:50b1502b60e289cb37883f3dfd34532b8873c7de9f49bb546641ce9cbd256ebd \
     --hash=sha256:97aacf9dbd4bfd829baad6e6309fa6573aaf1be3f6fa735c8ab05e46cecb261c
     # via twine
-rich==12.6.0 \
-    --hash=sha256:a4eb26484f2c82589bd9a17c73d32a010b1e29d89f1604cd9bf3a2097b81bb5e \
-    --hash=sha256:ba3a3775974105c221d31141f2c116f4fd65c5ceb0698657a11e9f295ec93fd0
+rich==13.9.3 \
+    --hash=sha256:9836f5096eb2172c9e77df411c1b009bace4193d6a481d534fea75ebba758283 \
+    --hash=sha256:bc1e01b899537598cf02579d2b9f4a415104d3fc439313a7a2c165d76557a08e
     # via twine
 rsa==4.9 \
     --hash=sha256:90260d9058e514786967344d0ef75fa8727eed8a7d2e43ce9f4bcf1b536174f7 \
@@ -545,9 +551,7 @@ six==1.16.0 \
     --hash=sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926 \
     --hash=sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254
     # via
-    #   bleach
     #   gcp-docuploader
-    #   google-auth
     #   python-dateutil
 twine==5.1.1 \
     --hash=sha256:215dbe7b4b94c2c50a7315c0275d2258399280fbb7d04182c7e55e24b5f93997 \

From 3c2bcf9901ce132a6d5d5d3b1ad3608526a378b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Fri, 1 Nov 2024 09:32:51 +0100
Subject: [PATCH 063/133] deps: add nh3 (#481)

---
 .kokoro/requirements.in  |  1 +
 .kokoro/requirements.txt | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/.kokoro/requirements.in b/.kokoro/requirements.in
index 689b5ee1..cdc2d4ef 100644
--- a/.kokoro/requirements.in
+++ b/.kokoro/requirements.in
@@ -6,3 +6,4 @@ twine
 wheel
 setuptools
 nox
+nh3
diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 96c1aba5..54570f2c 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -429,6 +429,24 @@ more-itertools==10.5.0 \
     --hash=sha256:037b0d3203ce90cca8ab1defbbdac29d5f993fc20131f3664dc8d6acfa872aef \
     --hash=sha256:5482bfef7849c25dc3c6dd53a6173ae4795da2a41a80faea6700d9f5846c5da6
     # via jaraco-classes
+nh3==0.2.18 \
+    --hash=sha256:0411beb0589eacb6734f28d5497ca2ed379eafab8ad8c84b31bb5c34072b7164 \
+    --hash=sha256:14c5a72e9fe82aea5fe3072116ad4661af5cf8e8ff8fc5ad3450f123e4925e86 \
+    --hash=sha256:19aaba96e0f795bd0a6c56291495ff59364f4300d4a39b29a0abc9cb3774a84b \
+    --hash=sha256:34c03fa78e328c691f982b7c03d4423bdfd7da69cd707fe572f544cf74ac23ad \
+    --hash=sha256:36c95d4b70530b320b365659bb5034341316e6a9b30f0b25fa9c9eff4c27a204 \
+    --hash=sha256:3a157ab149e591bb638a55c8c6bcb8cdb559c8b12c13a8affaba6cedfe51713a \
+    --hash=sha256:42c64511469005058cd17cc1537578eac40ae9f7200bedcfd1fc1a05f4f8c200 \
+    --hash=sha256:5f36b271dae35c465ef5e9090e1fdaba4a60a56f0bb0ba03e0932a66f28b9189 \
+    --hash=sha256:6955369e4d9f48f41e3f238a9e60f9410645db7e07435e62c6a9ea6135a4907f \
+    --hash=sha256:7b7c2a3c9eb1a827d42539aa64091640bd275b81e097cd1d8d82ef91ffa2e811 \
+    --hash=sha256:8ce0f819d2f1933953fca255db2471ad58184a60508f03e6285e5114b6254844 \
+    --hash=sha256:94a166927e53972a9698af9542ace4e38b9de50c34352b962f4d9a7d4c927af4 \
+    --hash=sha256:a7f1b5b2c15866f2db413a3649a8fe4fd7b428ae58be2c0f6bca5eefd53ca2be \
+    --hash=sha256:c8b3a1cebcba9b3669ed1a84cc65bf005728d2f0bc1ed2a6594a992e817f3a50 \
+    --hash=sha256:de3ceed6e661954871d6cd78b410213bdcb136f79aafe22aa7182e028b8c7307 \
+    --hash=sha256:f0eca9ca8628dbb4e916ae2491d72957fdd35f7a5d326b7032a345f111ac07fe
+    # via -r requirements.in
 nox==2022.11.21 \
     --hash=sha256:0e41a990e290e274cb205a976c4c97ee3c5234441a8132c8c3fd9ea3c22149eb \
     --hash=sha256:e21c31de0711d1274ca585a2c5fde36b1aa962005ba8e9322bf5eeed16dcd684

From acdf1be760c577c45944e6975f27ab8af5ef1fe4 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 09:38:44 +0100
Subject: [PATCH 064/133] chore(deps): update dependency readme-renderer to v44
 (#475)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 54570f2c..6e284e16 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -532,9 +532,9 @@ python-dateutil==2.9.0.post0 \
     --hash=sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3 \
     --hash=sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427
     # via gcp-releasetool
-readme-renderer==37.3 \
-    --hash=sha256:cd653186dfc73055656f090f227f5cb22a046d7f71a841dfa305f55c9a513273 \
-    --hash=sha256:f67a16caedfa71eef48a31b39708637a6f4664c4394801a7b0d6432d13907343
+readme-renderer==44.0 \
+    --hash=sha256:2fbca89b81a08526aadf1357a8c2ae889ec05fb03f5da67f9769c9a592166151 \
+    --hash=sha256:8712034eabbfa6805cacf1402b4eeb2a73028f72d1166d6f5cb7f9c047c5d1e1
     # via twine
 requests==2.32.3 \
     --hash=sha256:55365417734eb18255590a9ff9eb97e9e1da868d4ccd6402399eaf68af20a760 \

From e6b1eaa39027763351920512fc452ad293fcd924 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 09:44:00 +0100
Subject: [PATCH 065/133] chore(deps): update dependency pyasn1 to v0.6.1
 (#448)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 6e284e16..b7c7c9b0 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -497,9 +497,9 @@ py==1.11.0 \
     --hash=sha256:51c75c4126074b472f746a24399ad32f6053d1b34b68d2fa41e558e6f4a98719 \
     --hash=sha256:607c53218732647dff4acdfcd50cb62615cedf612e72d1724fb1a0cc6405b378
     # via nox
-pyasn1==0.4.8 \
-    --hash=sha256:39c7e2ec30515947ff4e87fb6f456dfc6e84857d34be479c9d4a4ba4bf46aa5d \
-    --hash=sha256:aef77c9fb94a3ac588e87841208bdec464471d9871bd5050a287cc9a475cd0ba
+pyasn1==0.6.1 \
+    --hash=sha256:0d632f46f2ba09143da3a8afe9e33fb6f92fa2320ab7e886e2d0f7672af84629 \
+    --hash=sha256:6f580d2bdd84365380830acf45550f2511469f673cb4a5ae3857a3170128b034
     # via
     #   pyasn1-modules
     #   rsa

From 86634531793cf01b46cefe87f74375ee59060638 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Fri, 1 Nov 2024 10:08:12 +0100
Subject: [PATCH 066/133] deps: add proto plus (#482)

---
 .kokoro/requirements.in  | 1 +
 .kokoro/requirements.txt | 8 +++++++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/.kokoro/requirements.in b/.kokoro/requirements.in
index cdc2d4ef..a4020358 100644
--- a/.kokoro/requirements.in
+++ b/.kokoro/requirements.in
@@ -7,3 +7,4 @@ wheel
 setuptools
 nox
 nh3
+proto-plus
diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index b7c7c9b0..59a77546 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -446,7 +446,9 @@ nh3==0.2.18 \
     --hash=sha256:c8b3a1cebcba9b3669ed1a84cc65bf005728d2f0bc1ed2a6594a992e817f3a50 \
     --hash=sha256:de3ceed6e661954871d6cd78b410213bdcb136f79aafe22aa7182e028b8c7307 \
     --hash=sha256:f0eca9ca8628dbb4e916ae2491d72957fdd35f7a5d326b7032a345f111ac07fe
-    # via -r requirements.in
+    # via
+    #   -r requirements.in
+    #   readme-renderer
 nox==2022.11.21 \
     --hash=sha256:0e41a990e290e274cb205a976c4c97ee3c5234441a8132c8c3fd9ea3c22149eb \
     --hash=sha256:e21c31de0711d1274ca585a2c5fde36b1aa962005ba8e9322bf5eeed16dcd684
@@ -465,6 +467,10 @@ platformdirs==2.6.2 \
     --hash=sha256:83c8f6d04389165de7c9b6f0c682439697887bca0aa2f1c87ef1826be3584490 \
     --hash=sha256:e1fea1fe471b9ff8332e229df3cb7de4f53eeea4998d3b6bfff542115e998bd2
     # via virtualenv
+proto-plus==1.25.0 \
+    --hash=sha256:c91fc4a65074ade8e458e95ef8bac34d4008daa7cce4a12d6707066fca648961 \
+    --hash=sha256:fbb17f57f7bd05a68b7707e745e26528b0b3c34e378db91eef93912c54982d91
+    # via -r requirements.in
 protobuf==3.20.3 \
     --hash=sha256:03038ac1cfbc41aa21f6afcbcd357281d7521b4157926f30ebecc8d4ea59dcb7 \
     --hash=sha256:28545383d61f55b57cf4df63eebd9827754fd2dc25f80c5253f9184235db242c \

From 21584d9344dc8b14901e274eed92cd0ffa54a6dd Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 10:17:46 +0100
Subject: [PATCH 067/133] chore(deps): update dependency google-api-core to
 v2.22.0 (#296)

---
 .kokoro/requirements.txt | 6 +++---
 requirements.txt         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 59a77546..d0ed7920 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -265,9 +265,9 @@ gcp-releasetool==1.17.0 \
     --hash=sha256:1a759f4b0906f4ea9dc7db3649aa11a632c72f6dc6a54f10cf57c1925d034a1c \
     --hash=sha256:f23db51d85484998af5549181be726f177bf90b481de238fe7a99ec970266b6b
     # via -r requirements.in
-google-api-core==2.10.2 \
-    --hash=sha256:10c06f7739fe57781f87523375e8e1a3a4674bf6392cd6131a3222182b971320 \
-    --hash=sha256:34f24bd1d5f72a8c4519773d99ca6bf080a6c4e041b4e9f024fe230191dda62e
+google-api-core==2.22.0 \
+    --hash=sha256:26f8d76b96477db42b55fd02a33aae4a42ec8b86b98b94969b7333a2c828bf35 \
+    --hash=sha256:a6652b6bd51303902494998626653671703c420f6f4c88cfd3f50ed723e9d021
     # via
     #   google-cloud-core
     #   google-cloud-storage
diff --git a/requirements.txt b/requirements.txt
index ddcfad4e..2097bfc7 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -141,9 +141,9 @@ deprecated==1.2.14 \
     # via
     #   opentelemetry-api
     #   opentelemetry-semantic-conventions
-google-api-core[grpc]==2.21.0 \
-    --hash=sha256:4a152fd11a9f774ea606388d423b68aa7e6d6a0ffe4c8266f74979613ec09f81 \
-    --hash=sha256:6869eacb2a37720380ba5898312af79a4d30b8bca1548fb4093e0697dc4bdf5d
+google-api-core[grpc]==2.22.0 \
+    --hash=sha256:26f8d76b96477db42b55fd02a33aae4a42ec8b86b98b94969b7333a2c828bf35 \
+    --hash=sha256:a6652b6bd51303902494998626653671703c420f6f4c88cfd3f50ed723e9d021
     # via
     #   google-cloud-core
     #   google-cloud-spanner

From 7a50c37a1f5abc0b6c2f348ce046653fbf40836d Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 10:25:29 +0100
Subject: [PATCH 068/133] chore(deps): update dependency google-cloud-storage
 to v2.18.2 (#438)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index d0ed7920..f0c501eb 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -283,9 +283,9 @@ google-cloud-core==2.4.1 \
     --hash=sha256:9b7749272a812bde58fff28868d0c5e2f585b82f37e09a1f6ed2d4d10f134073 \
     --hash=sha256:a9e6a4422b9ac5c29f79a0ede9485473338e2ce78d91f2370c01e730eab22e61
     # via google-cloud-storage
-google-cloud-storage==2.5.0 \
-    --hash=sha256:19a26c66c317ce542cea0830b7e787e8dac2588b6bfa4d3fd3b871ba16305ab0 \
-    --hash=sha256:382f34b91de2212e3c2e7b40ec079d27ee2e3dbbae99b75b1bcd8c63063ce235
+google-cloud-storage==2.18.2 \
+    --hash=sha256:97a4d45c368b7d401ed48c4fdfe86e1e1cb96401c9e199e419d289e2c0370166 \
+    --hash=sha256:aaf7acd70cdad9f274d29332673fcab98708d0e1f4dceb5a5356aaef06af4d99
     # via gcp-docuploader
 google-crc32c==1.6.0 \
     --hash=sha256:05e2d8c9a2f853ff116db9706b4a27350587f341eda835f46db3c0a8c8ce2f24 \

From 3faae2c5db0f150cedfedca74d5ea0ac0d7e0219 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 11:09:29 +0100
Subject: [PATCH 069/133] chore(deps): update dependency virtualenv to v20.27.1
 (#458)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* chore(deps): update dependency virtualenv to v20.27.1

* deps: update platformdirs

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>
---
 .kokoro/requirements.txt | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index f0c501eb..636f6c06 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -463,10 +463,9 @@ pkginfo==1.10.0 \
     --hash=sha256:5df73835398d10db79f8eecd5cd86b1f6d29317589ea70796994d49399af6297 \
     --hash=sha256:889a6da2ed7ffc58ab5b900d888ddce90bce912f2d2de1dc1c26f4cb9fe65097
     # via twine
-platformdirs==2.6.2 \
-    --hash=sha256:83c8f6d04389165de7c9b6f0c682439697887bca0aa2f1c87ef1826be3584490 \
-    --hash=sha256:e1fea1fe471b9ff8332e229df3cb7de4f53eeea4998d3b6bfff542115e998bd2
-    # via virtualenv
+platformdirs==4.3.6 \
+    --hash=sha256:357fb2acbc885b0419afd3ce3ed34564c13c9b95c89360cd9563f73aa5e2b907 \
+    --hash=sha256:73e575e1408ab8103900836b97580d5307456908a03e92031bab39e4554cc3fb
 proto-plus==1.25.0 \
     --hash=sha256:c91fc4a65074ade8e458e95ef8bac34d4008daa7cce4a12d6707066fca648961 \
     --hash=sha256:fbb17f57f7bd05a68b7707e745e26528b0b3c34e378db91eef93912c54982d91
@@ -591,9 +590,9 @@ urllib3==2.2.3 \
     # via
     #   requests
     #   twine
-virtualenv==20.16.5 \
-    --hash=sha256:227ea1b9994fdc5ea31977ba3383ef296d7472ea85be9d6732e42a91c04e80da \
-    --hash=sha256:d07dfc5df5e4e0dbc92862350ad87a36ed505b978f6c39609dc489eadd5b0d27
+virtualenv==20.27.1 \
+    --hash=sha256:142c6be10212543b32c6c45d3d3893dff89112cc588b7d0879ae5a1ec03a47ba \
+    --hash=sha256:f11f1b8a29525562925f745563bfd48b189450f61fb34c4f9cc79dd5aa32a1f4
     # via nox
 webencodings==0.5.1 \
     --hash=sha256:a0af1213f3c2226497a97e2b3aa01a7e4bee4f403f95be16fc9acd2947514a78 \

From 2725def201041e8d46ef26bbf4b3962e2523ede4 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 11:16:28 +0100
Subject: [PATCH 070/133] chore(deps): update dependency nox to v2024 (#471)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* chore(deps): update dependency nox to v2024

* deps: add tomli

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>
---
 .kokoro/requirements.in  |  1 +
 .kokoro/requirements.txt | 19 ++++++++++++++-----
 2 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/.kokoro/requirements.in b/.kokoro/requirements.in
index a4020358..9aedbff3 100644
--- a/.kokoro/requirements.in
+++ b/.kokoro/requirements.in
@@ -8,3 +8,4 @@ setuptools
 nox
 nh3
 proto-plus
+tomli
diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 636f6c06..b2814b5f 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -315,7 +315,9 @@ google-crc32c==1.6.0 \
     --hash=sha256:ebab974b1687509e5c973b5c4b8b146683e101e102e17a86bd196ecaa4d099fc \
     --hash=sha256:ed767bf4ba90104c1216b68111613f0d5926fb3780660ea1198fc469af410e9d \
     --hash=sha256:f7a1fc29803712f80879b0806cb83ab24ce62fc8daf0569f2204a0cfd7f68ed4
-    # via google-resumable-media
+    # via
+    #   google-cloud-storage
+    #   google-resumable-media
 google-resumable-media==2.7.2 \
     --hash=sha256:3ce7551e9fe6d99e9a126101d2536612bb73486721951e9562fee0f90c6ababa \
     --hash=sha256:5280aed4629f2b60b847b0d42f9857fd4935c11af266744df33d8074cae92fe0
@@ -449,9 +451,9 @@ nh3==0.2.18 \
     # via
     #   -r requirements.in
     #   readme-renderer
-nox==2022.11.21 \
-    --hash=sha256:0e41a990e290e274cb205a976c4c97ee3c5234441a8132c8c3fd9ea3c22149eb \
-    --hash=sha256:e21c31de0711d1274ca585a2c5fde36b1aa962005ba8e9322bf5eeed16dcd684
+nox==2024.10.9 \
+    --hash=sha256:1d36f309a0a2a853e9bccb76bbef6bb118ba92fa92674d15604ca99adeb29eab \
+    --hash=sha256:7aa9dc8d1c27e9f45ab046ffd1c3b2c4f7c91755304769df231308849ebded95
     # via -r requirements.in
 packaging==24.1 \
     --hash=sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002 \
@@ -466,10 +468,13 @@ pkginfo==1.10.0 \
 platformdirs==4.3.6 \
     --hash=sha256:357fb2acbc885b0419afd3ce3ed34564c13c9b95c89360cd9563f73aa5e2b907 \
     --hash=sha256:73e575e1408ab8103900836b97580d5307456908a03e92031bab39e4554cc3fb
+    # via virtualenv
 proto-plus==1.25.0 \
     --hash=sha256:c91fc4a65074ade8e458e95ef8bac34d4008daa7cce4a12d6707066fca648961 \
     --hash=sha256:fbb17f57f7bd05a68b7707e745e26528b0b3c34e378db91eef93912c54982d91
-    # via -r requirements.in
+    # via
+    #   -r requirements.in
+    #   google-api-core
 protobuf==3.20.3 \
     --hash=sha256:03038ac1cfbc41aa21f6afcbcd357281d7521b4157926f30ebecc8d4ea59dcb7 \
     --hash=sha256:28545383d61f55b57cf4df63eebd9827754fd2dc25f80c5253f9184235db242c \
@@ -576,6 +581,10 @@ six==1.16.0 \
     # via
     #   gcp-docuploader
     #   python-dateutil
+tomli==2.0.2 \
+    --hash=sha256:2ebe24485c53d303f690b0ec092806a085f07af5a5aa1464f3931eec36caaa38 \
+    --hash=sha256:d46d457a85337051c36524bc5349dd91b1877838e2979ac5ced3e710ed8a60ed
+    # via -r requirements.in
 twine==5.1.1 \
     --hash=sha256:215dbe7b4b94c2c50a7315c0275d2258399280fbb7d04182c7e55e24b5f93997 \
     --hash=sha256:9aa0825139c02b3434d913545c7b847a21c835e11597f5255842d457da2322db

From a434259225daee5b4772e44a331e7b831c1f0ab6 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 11:26:18 +0100
Subject: [PATCH 071/133] chore(deps): update dependency argcomplete to v3
 (#463)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index b2814b5f..44037b9c 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -4,9 +4,9 @@
 #
 #    pip-compile --generate-hashes requirements.in
 #
-argcomplete==2.1.2 \
-    --hash=sha256:4ba9cdaa28c361d251edce884cd50b4b1215d65cdc881bd204426cdde9f52731 \
-    --hash=sha256:fc82ef070c607b1559b5c720529d63b54d9dcf2dcfc2632b10e6372314a34457
+argcomplete==3.5.1 \
+    --hash=sha256:1a1d148bdaa3e3b93454900163403df41448a248af01b6e849edc5ac08e6c363 \
+    --hash=sha256:eb1ee355aa2557bd3d0145de7b06b2a45b0ce461e1e7813f5d066039ab4177b4
     # via nox
 attrs==24.2.0 \
     --hash=sha256:5cfb1b9148b5b086569baec03f20d7b6bf3bcacc9a42bebf87ffaaca362f6346 \

From dfa7f940497ca84ad889ef83e9a50ceb900a1fec Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 11:35:58 +0100
Subject: [PATCH 072/133] chore(deps): update dependency gcp-releasetool to v2
 (#466)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* chore(deps): update dependency gcp-releasetool to v2

* deps: update protobuf

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>
---
 .kokoro/requirements.txt | 41 +++++++++++++++-------------------------
 1 file changed, 15 insertions(+), 26 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 44037b9c..b2fa27e7 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -261,9 +261,9 @@ gcp-docuploader==0.6.5 \
     --hash=sha256:30221d4ac3e5a2b9c69aa52fdbef68cc3f27d0e6d0d90e220fc024584b8d2318 \
     --hash=sha256:b7458ef93f605b9d46a4bf3a8dc1755dad1f31d030c8679edf304e343b347eea
     # via -r requirements.in
-gcp-releasetool==1.17.0 \
-    --hash=sha256:1a759f4b0906f4ea9dc7db3649aa11a632c72f6dc6a54f10cf57c1925d034a1c \
-    --hash=sha256:f23db51d85484998af5549181be726f177bf90b481de238fe7a99ec970266b6b
+gcp-releasetool==2.2.0 \
+    --hash=sha256:9ca3a41d397485bb7f6ad7933d64d9071961188f41fc0182e47562b41cebaff2 \
+    --hash=sha256:ae0fc2525fdf1eb4638059dee3ec265620e1a85cb89f564615793698b3b422d6
     # via -r requirements.in
 google-api-core==2.22.0 \
     --hash=sha256:26f8d76b96477db42b55fd02a33aae4a42ec8b86b98b94969b7333a2c828bf35 \
@@ -475,29 +475,18 @@ proto-plus==1.25.0 \
     # via
     #   -r requirements.in
     #   google-api-core
-protobuf==3.20.3 \
-    --hash=sha256:03038ac1cfbc41aa21f6afcbcd357281d7521b4157926f30ebecc8d4ea59dcb7 \
-    --hash=sha256:28545383d61f55b57cf4df63eebd9827754fd2dc25f80c5253f9184235db242c \
-    --hash=sha256:2e3427429c9cffebf259491be0af70189607f365c2f41c7c3764af6f337105f2 \
-    --hash=sha256:398a9e0c3eaceb34ec1aee71894ca3299605fa8e761544934378bbc6c97de23b \
-    --hash=sha256:44246bab5dd4b7fbd3c0c80b6f16686808fab0e4aca819ade6e8d294a29c7050 \
-    --hash=sha256:447d43819997825d4e71bf5769d869b968ce96848b6479397e29fc24c4a5dfe9 \
-    --hash=sha256:67a3598f0a2dcbc58d02dd1928544e7d88f764b47d4a286202913f0b2801c2e7 \
-    --hash=sha256:74480f79a023f90dc6e18febbf7b8bac7508420f2006fabd512013c0c238f454 \
-    --hash=sha256:819559cafa1a373b7096a482b504ae8a857c89593cf3a25af743ac9ecbd23480 \
-    --hash=sha256:899dc660cd599d7352d6f10d83c95df430a38b410c1b66b407a6b29265d66469 \
-    --hash=sha256:8c0c984a1b8fef4086329ff8dd19ac77576b384079247c770f29cc8ce3afa06c \
-    --hash=sha256:9aae4406ea63d825636cc11ffb34ad3379335803216ee3a856787bcf5ccc751e \
-    --hash=sha256:a7ca6d488aa8ff7f329d4c545b2dbad8ac31464f1d8b1c87ad1346717731e4db \
-    --hash=sha256:b6cc7ba72a8850621bfec987cb72623e703b7fe2b9127a161ce61e61558ad905 \
-    --hash=sha256:bf01b5720be110540be4286e791db73f84a2b721072a3711efff6c324cdf074b \
-    --hash=sha256:c02ce36ec760252242a33967d51c289fd0e1c0e6e5cc9397e2279177716add86 \
-    --hash=sha256:d9e4432ff660d67d775c66ac42a67cf2453c27cb4d738fc22cb53b5d84c135d4 \
-    --hash=sha256:daa564862dd0d39c00f8086f88700fdbe8bc717e993a21e90711acfed02f2402 \
-    --hash=sha256:de78575669dddf6099a8a0f46a27e82a1783c557ccc38ee620ed8cc96d3be7d7 \
-    --hash=sha256:e64857f395505ebf3d2569935506ae0dfc4a15cb80dc25261176c784662cdcc4 \
-    --hash=sha256:f4bd856d702e5b0d96a00ec6b307b0f51c1982c2bf9c0052cf9019e9a544ba99 \
-    --hash=sha256:f4c42102bc82a51108e449cbb32b19b180022941c727bac0cfd50170341f16ee
+protobuf==5.28.3 \
+    --hash=sha256:0c4eec6f987338617072592b97943fdbe30d019c56126493111cf24344c1cc24 \
+    --hash=sha256:135658402f71bbd49500322c0f736145731b16fc79dc8f367ab544a17eab4535 \
+    --hash=sha256:27b246b3723692bf1068d5734ddaf2fccc2cdd6e0c9b47fe099244d80200593b \
+    --hash=sha256:3e6101d095dfd119513cde7259aa703d16c6bbdfae2554dfe5cfdbe94e32d548 \
+    --hash=sha256:3fa2de6b8b29d12c61911505d893afe7320ce7ccba4df913e2971461fa36d584 \
+    --hash=sha256:64badbc49180a5e401f373f9ce7ab1d18b63f7dd4a9cdc43c92b9f0b481cef7b \
+    --hash=sha256:70585a70fc2dd4818c51287ceef5bdba6387f88a578c86d47bb34669b5552c36 \
+    --hash=sha256:712319fbdddb46f21abb66cd33cb9e491a5763b2febd8f228251add221981135 \
+    --hash=sha256:91fba8f445723fcf400fdbe9ca796b19d3b1242cd873907979b9ed71e4afe868 \
+    --hash=sha256:a3f6857551e53ce35e60b403b8a27b0295f7d6eb63d10484f12bc6879c715687 \
+    --hash=sha256:cee1757663fa32a1ee673434fcf3bf24dd54763c79690201208bafec62f19eed
     # via
     #   gcp-docuploader
     #   gcp-releasetool

From 483ebfa23c7c2fcbd0cc35db5e5c20f2ce96b805 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 11:45:09 +0100
Subject: [PATCH 073/133] chore(deps): update dependency importlib-metadata to
 v8.5.0 (#467)

---
 .kokoro/requirements.txt | 6 +++---
 requirements.txt         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index b2fa27e7..ab10ebe0 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -330,9 +330,9 @@ idna==3.10 \
     --hash=sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9 \
     --hash=sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3
     # via requests
-importlib-metadata==5.2.0 \
-    --hash=sha256:0eafa39ba42bf225fc00e67f701d71f85aead9f878569caf13c3724f704b970f \
-    --hash=sha256:404d48d62bba0b7a77ff9d405efd91501bef2e67ff4ace0bed40a0cf28c3c7cd
+importlib-metadata==8.5.0 \
+    --hash=sha256:45e54197d28b7a7f1559e60b95e7c567032b602131fbd588f1497f47880aa68b \
+    --hash=sha256:71522656f0abace1d072b9e5481a48f07c138e00f079c38c8f883823f9c26bd7
     # via
     #   -r requirements.in
     #   twine
diff --git a/requirements.txt b/requirements.txt
index 2097bfc7..91a9fd4f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -246,9 +246,9 @@ idna==3.10 \
     --hash=sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9 \
     --hash=sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3
     # via requests
-importlib-metadata==8.4.0 \
-    --hash=sha256:66f342cc6ac9818fc6ff340576acd24d65ba0b3efabb2b4ac08b598965a4a2f1 \
-    --hash=sha256:9a547d3bc3608b025f93d403fdd1aae741c24fbb8314df4b155675742ce303c5
+importlib-metadata==8.5.0 \
+    --hash=sha256:45e54197d28b7a7f1559e60b95e7c567032b602131fbd588f1497f47880aa68b \
+    --hash=sha256:71522656f0abace1d072b9e5481a48f07c138e00f079c38c8f883823f9c26bd7
     # via opentelemetry-api
 mako==1.3.6 \
     --hash=sha256:9ec3a1583713479fae654f83ed9fa8c9a4c16b7bb0daba0e6bbebff50c0d983d \

From d9bb41b97ba9d4354f8c5db0aeeda42bfc3ff147 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 12:03:54 +0100
Subject: [PATCH 074/133] chore(deps): update dependency keyring to v25 (#468)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* chore(deps): update dependency keyring to v25

* deps: add jaroco.context

* deps: add backports.tarfile

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>
---
 .kokoro/requirements.in  |  2 ++
 .kokoro/requirements.txt | 28 +++++++++++++++++++++-------
 2 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/.kokoro/requirements.in b/.kokoro/requirements.in
index 9aedbff3..b52510c9 100644
--- a/.kokoro/requirements.in
+++ b/.kokoro/requirements.in
@@ -9,3 +9,5 @@ nox
 nh3
 proto-plus
 tomli
+jaraco.context
+backports.tarfile
diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index ab10ebe0..ece81019 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -12,6 +12,10 @@ attrs==24.2.0 \
     --hash=sha256:5cfb1b9148b5b086569baec03f20d7b6bf3bcacc9a42bebf87ffaaca362f6346 \
     --hash=sha256:81921eb96de3191c8258c199618104dd27ac608d9366f5e35d011eae1867ede2
     # via gcp-releasetool
+backports-tarfile==1.2.0 \
+    --hash=sha256:77e284d754527b01fb1e6fa8a1afe577858ebe4e9dad8919e34c862cb399bc34 \
+    --hash=sha256:d75e02c268746e1b8144c278978b6e98e85de6ad16f8e4b0844a154557eca991
+    # via -r requirements.in
 bleach==6.2.0 \
     --hash=sha256:117d9c6097a7c3d22fd578fcd8d35ff1e125df6736f554da4e432fdd63f31e5e \
     --hash=sha256:123e894118b8a599fd80d3ec1a6d4cc7ce4e5882b1317a7e1ba69b56e95f991f
@@ -340,19 +344,26 @@ jaraco-classes==3.2.3 \
     --hash=sha256:2353de3288bc6b82120752201c6b1c1a14b058267fa424ed5ce5984e3b922158 \
     --hash=sha256:89559fa5c1d3c34eff6f631ad80bb21f378dbcbb35dd161fd2c6b93f5be2f98a
     # via keyring
+jaraco-context==6.0.1 \
+    --hash=sha256:9bae4ea555cf0b14938dc0aee7c9f32ed303aa20a3b73e7dc80111628792d1b3 \
+    --hash=sha256:f797fc481b490edb305122c9181830a3a5b76d84ef6d1aef2fb9b47ab956f9e4
+    # via
+    #   -r requirements.in
+    #   keyring
+jaraco-functools==4.1.0 \
+    --hash=sha256:70f7e0e2ae076498e212562325e805204fc092d7b4c17e0e86c959e249701a9d \
+    --hash=sha256:ad159f13428bc4acbf5541ad6dec511f91573b90fba04df61dafa2a1231cf649
+    # via keyring
 jeepney==0.8.0 \
     --hash=sha256:5efe48d255973902f6badc3ce55e2aa6c5c3b3bc642059ef3a91247bcfcc5806 \
     --hash=sha256:c0a454ad016ca575060802ee4d590dd912e35c122fa04e70306de3d076cce755
-    # via
-    #   keyring
-    #   secretstorage
 jinja2==3.1.4 \
     --hash=sha256:4a3aee7acbbe7303aede8e9648d13b8bf88a429282aa6122a993f0ac800cb369 \
     --hash=sha256:bc5dd2abb727a5319567b7a813e6a2e7318c39f4f487cfe6c89c6f9c7d25197d
     # via gcp-releasetool
-keyring==23.13.1 \
-    --hash=sha256:771ed2a91909389ed6148631de678f82ddc73737d85a927f382a8a1b157898cd \
-    --hash=sha256:ba2e15a9b35e21908d0aaf4e0a47acc52d6ae33444df0da2b49d41a46ef6d678
+keyring==25.5.0 \
+    --hash=sha256:4c753b3ec91717fe713c4edd522d625889d8973a349b0e582622f49766de58e6 \
+    --hash=sha256:e67f8ac32b04be4714b42fe84ce7dad9c40985b9ca827c592cc303e7c26d9741
     # via
     #   gcp-releasetool
     #   twine
@@ -430,7 +441,9 @@ mdurl==0.1.2 \
 more-itertools==10.5.0 \
     --hash=sha256:037b0d3203ce90cca8ab1defbbdac29d5f993fc20131f3664dc8d6acfa872aef \
     --hash=sha256:5482bfef7849c25dc3c6dd53a6173ae4795da2a41a80faea6700d9f5846c5da6
-    # via jaraco-classes
+    # via
+    #   jaraco-classes
+    #   jaraco-functools
 nh3==0.2.18 \
     --hash=sha256:0411beb0589eacb6734f28d5497ca2ed379eafab8ad8c84b31bb5c34072b7164 \
     --hash=sha256:14c5a72e9fe82aea5fe3072116ad4661af5cf8e8ff8fc5ad3450f123e4925e86 \
@@ -492,6 +505,7 @@ protobuf==5.28.3 \
     #   gcp-releasetool
     #   google-api-core
     #   googleapis-common-protos
+    #   proto-plus
 py==1.11.0 \
     --hash=sha256:51c75c4126074b472f746a24399ad32f6053d1b34b68d2fa41e558e6f4a98719 \
     --hash=sha256:607c53218732647dff4acdfcd50cb62615cedf612e72d1724fb1a0cc6405b378

From 1368fbdc3b7894b714fcbbb5247b452fe091c047 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 12:07:35 +0100
Subject: [PATCH 075/133] chore(deps): update ubuntu docker tag to v24 (#480)

---
 .kokoro/docker/docs/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.kokoro/docker/docs/Dockerfile b/.kokoro/docker/docs/Dockerfile
index cf3922d7..e2bfb5b8 100644
--- a/.kokoro/docker/docs/Dockerfile
+++ b/.kokoro/docker/docs/Dockerfile
@@ -4,7 +4,7 @@
 # license that can be found in the LICENSE file or at
 # https://developers.google.com/open-source/licenses/bsd
 
-from ubuntu:20.04
+from ubuntu:24.04
 
 ENV DEBIAN_FRONTEND noninteractive
 

From a9e61177bc2e825f92e5e2dab435179e3243d6b2 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 1 Nov 2024 12:19:48 +0100
Subject: [PATCH 076/133] chore(deps): update dependency jaraco-classes to
 v3.4.0 (#443)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* chore(deps): update dependency jaraco-classes to v3.4.0

* deps: update hashes

* deps: remove duplicate entry

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>
---
 .kokoro/requirements.txt | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index ece81019..71e0b165 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -340,9 +340,9 @@ importlib-metadata==8.5.0 \
     # via
     #   -r requirements.in
     #   twine
-jaraco-classes==3.2.3 \
-    --hash=sha256:2353de3288bc6b82120752201c6b1c1a14b058267fa424ed5ce5984e3b922158 \
-    --hash=sha256:89559fa5c1d3c34eff6f631ad80bb21f378dbcbb35dd161fd2c6b93f5be2f98a
+jaraco-classes==3.4.0 \
+    --hash=sha256:47a024b51d0239c0dd8c8540c6c7f484be3b8fcf0b2d85c13825780d3b3f3acd \
+    --hash=sha256:f662826b6bed8cace05e7ff873ce0f9283b5c924470fe664fff1c2f00f581790
     # via keyring
 jaraco-context==6.0.1 \
     --hash=sha256:9bae4ea555cf0b14938dc0aee7c9f32ed303aa20a3b73e7dc80111628792d1b3 \
@@ -618,8 +618,3 @@ zipp==3.20.2 \
     --hash=sha256:a817ac80d6cf4b23bf7f2828b7cabf326f15a001bea8b1f9b49631780ba28350 \
     --hash=sha256:bc9eb26f4506fda01b81bcde0ca78103b6e62f991b381fec825435c836edbc29
     # via importlib-metadata
-
-# WARNING: The following packages were not pinned, but pip requires them to be
-# pinned when the requirements file includes hashes and the requirement is not
-# satisfied by a package already installed. Consider using the --allow-unsafe flag.
-# setuptools

From 994a44d1131f5a4153c08ab7192f64331b231858 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Fri, 1 Nov 2024 19:48:32 +0100
Subject: [PATCH 077/133] build: fix kokoro build (#486)

---
 .kokoro/build.sh                | 4 +---
 .kokoro/presubmit/presubmit.cfg | 6 ------
 2 files changed, 1 insertion(+), 9 deletions(-)

diff --git a/.kokoro/build.sh b/.kokoro/build.sh
index 2c87f749..54514682 100755
--- a/.kokoro/build.sh
+++ b/.kokoro/build.sh
@@ -43,8 +43,6 @@ fi
 # otherwise run all the sessions.
 if [[ -n "${NOX_SESSION:-}" ]]; then
     python3 -m nox -s ${NOX_SESSION:-}
-elif [[ "${RUN_COMPLIANCE_TESTS}" -eq "false" ]]; then
-    python3 -m nox -s unit
 else
-    python3 -m nox
+    python3 -m nox -s unit
 fi
diff --git a/.kokoro/presubmit/presubmit.cfg b/.kokoro/presubmit/presubmit.cfg
index 3aa90144..18a4c353 100644
--- a/.kokoro/presubmit/presubmit.cfg
+++ b/.kokoro/presubmit/presubmit.cfg
@@ -1,7 +1 @@
 # Format: //devtools/kokoro/config/proto/build.proto
-
-# Disable system tests.
-env_vars: {
-    key: "RUN_COMPLIANCE_TESTS"
-    value: "false"
-}

From 013bd8394c432fef7d5331b9b69d2b6f69369a35 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Mon, 4 Nov 2024 13:44:09 +0100
Subject: [PATCH 078/133] chore(deps): update dependency rich to v13.9.4 (#484)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 71e0b165..78422e59 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -566,9 +566,9 @@ rfc3986==2.0.0 \
     --hash=sha256:50b1502b60e289cb37883f3dfd34532b8873c7de9f49bb546641ce9cbd256ebd \
     --hash=sha256:97aacf9dbd4bfd829baad6e6309fa6573aaf1be3f6fa735c8ab05e46cecb261c
     # via twine
-rich==13.9.3 \
-    --hash=sha256:9836f5096eb2172c9e77df411c1b009bace4193d6a481d534fea75ebba758283 \
-    --hash=sha256:bc1e01b899537598cf02579d2b9f4a415104d3fc439313a7a2c165d76557a08e
+rich==13.9.4 \
+    --hash=sha256:439594978a49a09530cff7ebc4b5c7103ef57baf48d5ea3184f21d9a2befa098 \
+    --hash=sha256:6049d5e6ec054bf2779ab3358186963bac2ea89175919d699e378b99738c2a90
     # via twine
 rsa==4.9 \
     --hash=sha256:90260d9058e514786967344d0ef75fa8727eed8a7d2e43ce9f4bcf1b536174f7 \

From 273f03bdf27c12317712a9939eedd25bd88c475a Mon Sep 17 00:00:00 2001
From: minev-dev <90937832+minev-dev@users.noreply.github.com>
Date: Mon, 4 Nov 2024 09:04:15 -0800
Subject: [PATCH 079/133] fix: Add `existing_nullable` usage to
 `visit_column_type` (#329)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix: Add `existing_nullable` usage to `visit_column_type`

Without this, altering operations (e.g. change column length) can cause nullability change of the column.
It then causes error if this column is a part of index:
"400 Changing NOT NULL constraints on column column_name is not allowed because it affects index index_name"

* fix: add missing placeholder

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>
---
 google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
index 6754931a..1514f9e3 100644
--- a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
+++ b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
@@ -1564,8 +1564,9 @@ def visit_column_nullable(
 def visit_column_type(
     element: "ColumnType", compiler: "SpannerDDLCompiler", **kw
 ) -> str:
-    return "%s %s %s" % (
+    return "%s %s %s %s" % (
         alter_table(compiler, element.table_name, element.schema),
         alter_column(compiler, element.column_name),
         "%s" % format_type(compiler, element.type_),
+        "" if element.existing_nullable else "NOT NULL",
     )

From 538c640e6470c1cc5be835abcc4f6216c4676cf6 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 8 Nov 2024 13:57:50 +0100
Subject: [PATCH 080/133] chore(deps): update dependency alembic to v1.14.0
 (#488)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 91a9fd4f..918162cd 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -4,9 +4,9 @@
 #
 #    pip-compile --generate-hashes
 #
-alembic==1.13.3 \
-    --hash=sha256:203503117415561e203aa14541740643a611f641517f0209fcae63e9fa09f1a2 \
-    --hash=sha256:908e905976d15235fae59c9ac42c4c5b75cfcefe3d27c0fbf7ae15a37715d80e
+alembic==1.14.0 \
+    --hash=sha256:99bd884ca390466db5e27ffccff1d179ec5c05c965cfefc0607e69f9e411cb25 \
+    --hash=sha256:b00892b53b3642d0b8dbedba234dbf1924b69be83a9a769d5a624b01094e304b
     # via -r requirements.in
 build==1.2.2.post1 \
     --hash=sha256:1d61c0887fa860c01971625baae8bdd338e517b836a2f70dd1f7aa3a6b2fc5b5 \

From 0f99f8d77fa973ec8972e7852cc0f97150909d78 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Fri, 8 Nov 2024 14:01:13 +0100
Subject: [PATCH 081/133] test: add system tests (#420)

* test: add system tests

* test: run system tests on prod

* build: allow any Python version for sys tests

* build: keep instance and create new databases instead

* chore: format code

* fix: do not use static fallback config

* fix: cleanup job

* fix: search until end of string

* build: only run system tests on the emulator for presubmits

* build: skip system tests when skipping conformance tests

* test: run tests with Python 3.8

* test: try this

* test: no tests

* build: run system tests on real Spanner

* chore: cleanup test database after system test run
---
 .github/workflows/test_suite.yml | 24 ++++++++++
 .kokoro/build.sh                 |  1 +
 create_test_config.py            | 19 ++++----
 create_test_database.py          | 76 ++++++++++++++++++++------------
 drop_test_database.py            | 63 ++++++++++++++++++++++++++
 migration_test_cleanup.py        |  3 +-
 noxfile.py                       | 53 +++++++++++++++++-----
 test/system/test_basics.py       | 39 ++++++++++++++++
 8 files changed, 229 insertions(+), 49 deletions(-)
 create mode 100644 drop_test_database.py
 create mode 100644 test/system/test_basics.py

diff --git a/.github/workflows/test_suite.yml b/.github/workflows/test_suite.yml
index 748378ab..0f219787 100644
--- a/.github/workflows/test_suite.yml
+++ b/.github/workflows/test_suite.yml
@@ -126,6 +126,30 @@ jobs:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: appdev-soda-spanner-staging
 
+  system:
+    runs-on: ubuntu-latest
+
+    services:
+      emulator-0:
+        image: gcr.io/cloud-spanner-emulator/emulator:latest
+        ports:
+          - 9010:9010
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.12
+      - name: Install nox
+        run: python -m pip install nox
+      - name: Run System Tests
+        run: nox -s system
+        env:
+          SPANNER_EMULATOR_HOST: localhost:9010
+          GOOGLE_CLOUD_PROJECT: appdev-soda-spanner-staging
+
   migration_tests:
     runs-on: ubuntu-latest
 
diff --git a/.kokoro/build.sh b/.kokoro/build.sh
index 54514682..0985afd0 100755
--- a/.kokoro/build.sh
+++ b/.kokoro/build.sh
@@ -45,4 +45,5 @@ if [[ -n "${NOX_SESSION:-}" ]]; then
     python3 -m nox -s ${NOX_SESSION:-}
 else
     python3 -m nox -s unit
+    python3 -m nox -s system
 fi
diff --git a/create_test_config.py b/create_test_config.py
index 7ef6f255..388cba86 100644
--- a/create_test_config.py
+++ b/create_test_config.py
@@ -18,18 +18,18 @@
 import sys
 
 
-def set_test_config(project, instance, user=None, password=None, host=None, port=None):
+def set_test_config(project, instance, database, user=None, password=None, host=None, port=None):
     config = configparser.ConfigParser()
     if user is not None and password is not None and host is not None and port is not None:
         url = (
             f"spanner+spanner://{user}:{password}@{host}:{port}"
             f"/projects/{project}/instances/{instance}/"
-            "databases/compliance-test"
+            f"databases/{database}"
         )
     else:
         url = (
             f"spanner+spanner:///projects/{project}/instances/{instance}/"
-            "databases/compliance-test"
+            f"databases/{database}"
         )
     config.add_section("db")
     config["db"]["default"] = url
@@ -41,17 +41,18 @@ def set_test_config(project, instance, user=None, password=None, host=None, port
 def main(argv):
     project = argv[0]
     instance = argv[1]
-    if len(argv) == 6:
-        user = argv[2]
-        password = argv[3]
-        host = argv[4]
-        port = argv[5]
+    database = argv[2]
+    if len(argv) == 7:
+        user = argv[3]
+        password = argv[4]
+        host = argv[5]
+        port = argv[6]
     else:
         user = None
         password = None
         host = None
         port = None
-    set_test_config(project, instance, user, password, host, port)
+    set_test_config(project, instance, database, user, password, host, port)
 
 
 if __name__ == "__main__":
diff --git a/create_test_database.py b/create_test_database.py
index 1e29d44f..5938eb82 100644
--- a/create_test_database.py
+++ b/create_test_database.py
@@ -14,14 +14,15 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import configparser
 import os
 import time
 
 from create_test_config import set_test_config
+from google.api_core import datetime_helpers
 from google.api_core.exceptions import AlreadyExists, ResourceExhausted
 from google.cloud.spanner_v1 import Client
 from google.cloud.spanner_v1.instance import Instance
+from google.cloud.spanner_v1.database import Database
 
 
 USE_EMULATOR = os.getenv("SPANNER_EMULATOR_HOST") is not None
@@ -66,43 +67,62 @@ def delete_stale_test_instances():
             )
 
 
-def create_test_instance():
-    configs = list(CLIENT.list_instance_configs())
-    if not USE_EMULATOR:
-        # Filter out non "us" locations
-        configs = [config for config in configs if "asia-southeast1" in config.name]
+def delete_stale_test_databases():
+    """Delete test databases that are older than four hours."""
+    cutoff = (int(time.time()) - 4 * 60 * 60) * 1000
+    instance = CLIENT.instance("sqlalchemy-dialect-test")
+    if not instance.exists():
+        return
+    database_pbs = instance.list_databases()
+    for database_pb in database_pbs:
+        database = Database.from_pb(database_pb, instance)
+        # The emulator does not return a create_time for databases.
+        if database.create_time is None:
+            continue
+        create_time = datetime_helpers.to_milliseconds(database_pb.create_time)
+        if create_time > cutoff:
+            continue
+        try:
+            database.drop()
+        except ResourceExhausted:
+            print(
+                "Unable to drop stale database '{}'. May need manual delete.".format(
+                    database.database_id
+                )
+            )
 
-    instance_config = configs[0].name
-    create_time = str(int(time.time()))
-    unique_resource_id = "%s%d" % ("-", 1000 * time.time())
-    instance_id = (
-        "sqlalchemy-dialect-test"
-        if USE_EMULATOR
-        else "sqlalchemy-test" + unique_resource_id
-    )
-    labels = {"python-spanner-sqlalchemy-systest": "true", "created": create_time}
 
-    instance = CLIENT.instance(instance_id, instance_config, labels=labels)
+def create_test_instance():
+    instance_id = "sqlalchemy-dialect-test"
+    instance = CLIENT.instance(instance_id)
+    if not instance.exists():
+        instance_config = f"projects/{PROJECT}/instanceConfigs/regional-us-east1"
+        if USE_EMULATOR:
+            configs = list(CLIENT.list_instance_configs())
+            instance_config = configs[0].name
+        create_time = str(int(time.time()))
+        labels = {"python-spanner-sqlalchemy-systest": "true", "created": create_time}
+
+        instance = CLIENT.instance(instance_id, instance_config, labels=labels)
 
-    try:
-        created_op = instance.create()
-        created_op.result(1800)  # block until completion
-    except AlreadyExists:
-        pass  # instance was already created
+        try:
+            created_op = instance.create()
+            created_op.result(1800)  # block until completion
+        except AlreadyExists:
+            pass  # instance was already created
 
-    if USE_EMULATOR:
-        database = instance.database("compliance-test")
-        database.drop()
+    unique_resource_id = "%s%d" % ("-", 1000 * time.time())
+    database_id = "sqlalchemy-test" + unique_resource_id
 
     try:
-        database = instance.database("compliance-test")
+        database = instance.database(database_id)
         created_op = database.create()
         created_op.result(1800)
     except AlreadyExists:
-        pass  # instance was already created
+        pass  # database was already created
 
-    set_test_config(PROJECT, instance_id)
+    set_test_config(PROJECT, instance_id, database_id)
 
 
-delete_stale_test_instances()
+delete_stale_test_databases()
 create_test_instance()
diff --git a/drop_test_database.py b/drop_test_database.py
new file mode 100644
index 00000000..3f2b25c2
--- /dev/null
+++ b/drop_test_database.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     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.
+
+import configparser
+import os
+import re
+import time
+
+from create_test_config import set_test_config
+from google.api_core import datetime_helpers
+from google.api_core.exceptions import AlreadyExists, ResourceExhausted
+from google.cloud.spanner_v1 import Client
+from google.cloud.spanner_v1.instance import Instance
+from google.cloud.spanner_v1.database import Database
+
+
+USE_EMULATOR = os.getenv("SPANNER_EMULATOR_HOST") is not None
+
+PROJECT = os.getenv(
+    "GOOGLE_CLOUD_PROJECT",
+    os.getenv("PROJECT_ID", "emulator-test-project"),
+)
+CLIENT = None
+
+if USE_EMULATOR:
+    from google.auth.credentials import AnonymousCredentials
+
+    CLIENT = Client(project=PROJECT, credentials=AnonymousCredentials())
+else:
+    CLIENT = Client(project=PROJECT)
+
+
+def delete_test_database():
+    """Delete the currently configured test database."""
+    config = configparser.ConfigParser()
+    if os.path.exists("test.cfg"):
+        config.read("test.cfg")
+    else:
+        config.read("setup.cfg")
+    db_url = config.get("db", "default")
+
+    instance_id = re.findall(r"instances(.*?)databases", db_url)
+    database_id = re.findall(r"databases(.*?)$", db_url)
+
+    instance = CLIENT.instance(
+        instance_id="".join(instance_id).replace("/", ""))
+    database = instance.database("".join(database_id).replace("/", ""))
+    database.drop()
+
+delete_test_database()
diff --git a/migration_test_cleanup.py b/migration_test_cleanup.py
index 62266359..c56b10d0 100644
--- a/migration_test_cleanup.py
+++ b/migration_test_cleanup.py
@@ -25,10 +25,11 @@ def main(argv):
 
   project = re.findall(r"projects(.*?)instances", db_url)
   instance_id = re.findall(r"instances(.*?)databases", db_url)
+  database_id = re.findall(r"databases(.*?)$", db_url)
 
   client = spanner.Client(project="".join(project).replace("/", ""))
   instance = client.instance(instance_id="".join(instance_id).replace("/", ""))
-  database = instance.database("compliance-test")
+  database = instance.database("".join(database_id).replace("/", ""))
 
   database.update_ddl(["DROP TABLE account", "DROP TABLE alembic_version"]).result(120)
 
diff --git a/noxfile.py b/noxfile.py
index eff6bfc9..2c4b21bc 100644
--- a/noxfile.py
+++ b/noxfile.py
@@ -252,6 +252,43 @@ def compliance_test_20(session):
     )
 
 
+@nox.session()
+def system(session):
+    """Run SQLAlchemy dialect system test suite."""
+
+    # 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 os.environ.get("RUN_COMPLIANCE_TESTS", "true") == "false" and not os.environ.get(
+        "SPANNER_EMULATOR_HOST", ""
+    ):
+        session.skip("RUN_COMPLIANCE_TESTS is set to false, skipping")
+
+    session.install(
+        "pytest",
+        "pytest-cov",
+        "pytest-asyncio",
+    )
+
+    session.install("mock")
+    session.install(".[tracing]")
+    session.install("opentelemetry-api==1.27.0")
+    session.install("opentelemetry-sdk==1.27.0")
+    session.install("opentelemetry-instrumentation==0.48b0")
+    session.run("python", "create_test_database.py")
+
+    session.install("sqlalchemy>=2.0")
+
+    session.run("py.test", "--quiet", os.path.join("test", "system"), *session.posargs)
+
+    session.run("python", "drop_test_database.py")
+
+
 @nox.session(python=DEFAULT_PYTHON_VERSION)
 def unit(session):
     """Run unit tests."""
@@ -263,7 +300,9 @@ def unit(session):
     session.install("opentelemetry-api==1.27.0")
     session.install("opentelemetry-sdk==1.27.0")
     session.install("opentelemetry-instrumentation==0.48b0")
-    session.run("python", "create_test_config.py", "my-project", "my-instance")
+    session.run(
+        "python", "create_test_config.py", "my-project", "my-instance", "my-database"
+    )
     session.run("py.test", "--quiet", os.path.join("test/unit"), *session.posargs)
 
 
@@ -281,6 +320,7 @@ def mockserver(session):
         "create_test_config.py",
         "my-project",
         "my-instance",
+        "my-database",
         "none",
         "AnonymousCredentials",
         "localhost",
@@ -323,21 +363,12 @@ def _migration_test(session):
 
     session.run("python", "create_test_database.py")
 
-    project = os.getenv(
-        "GOOGLE_CLOUD_PROJECT",
-        os.getenv("PROJECT_ID", "emulator-test-project"),
-    )
-    db_url = (
-        f"spanner+spanner:///projects/{project}/instances/"
-        "sqlalchemy-dialect-test/databases/compliance-test"
-    )
-
     config = configparser.ConfigParser()
     if os.path.exists("test.cfg"):
         config.read("test.cfg")
     else:
         config.read("setup.cfg")
-    db_url = config.get("db", "default", fallback=db_url)
+    db_url = config.get("db", "default")
 
     session.run("alembic", "init", "test_migration")
 
diff --git a/test/system/test_basics.py b/test/system/test_basics.py
new file mode 100644
index 00000000..6a53b234
--- /dev/null
+++ b/test/system/test_basics.py
@@ -0,0 +1,39 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import text, Table, Column, Integer, PrimaryKeyConstraint, String
+from sqlalchemy.testing import eq_
+from sqlalchemy.testing.plugin.plugin_base import fixtures
+
+
+class TestBasics(fixtures.TablesTest):
+    @classmethod
+    def define_tables(cls, metadata):
+        Table(
+            "numbers",
+            metadata,
+            Column("number", Integer),
+            Column("name", String(20)),
+            PrimaryKeyConstraint("number"),
+        )
+
+    def test_hello_world(self, connection):
+        greeting = connection.execute(text("select 'Hello World'"))
+        eq_("Hello World", greeting.fetchone()[0])
+
+    def test_insert_number(self, connection):
+        connection.execute(
+            text("insert or update into numbers(number, name) values (1, 'One')")
+        )
+        name = connection.execute(text("select name from numbers where number=1"))
+        eq_("One", name.fetchone()[0])

From b452b4f73d200b99fd800862c88304b67aa035c5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Fri, 8 Nov 2024 14:02:00 +0100
Subject: [PATCH 082/133] docs: fix readme typo (#487)

---
 README.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.rst b/README.rst
index 85fecf20..25cde459 100644
--- a/README.rst
+++ b/README.rst
@@ -508,7 +508,7 @@ run the tests the ``nox`` package commands can be used:
 Running tests on Spanner emulator
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The dialect test suite can be runned on `Spanner
+The dialect test suite can be run on `Spanner
 emulator <https://cloud.google.com/spanner/docs/emulator>`__. Several
 tests, relating to ``NULL`` values of data types, are skipped when
 executed on emulator.

From ac78890b3b6d7b429378bb7c171e126f1b3322ba Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 8 Nov 2024 14:02:44 +0100
Subject: [PATCH 083/133] chore(deps): update dependency opentelemetry-api to
 v1.28.0 (#489)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 918162cd..fb196b96 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -317,9 +317,9 @@ markupsafe==3.0.2 \
     --hash=sha256:f8b3d067f2e40fe93e1ccdd6b2e1d16c43140e76f02fb1319a05cf2b79d99430 \
     --hash=sha256:fcabf5ff6eea076f859677f5f0b6b5c1a51e70a376b0579e0eadef8db48c6b50
     # via mako
-opentelemetry-api==1.27.0 \
-    --hash=sha256:953d5871815e7c30c81b56d910c707588000fff7a3ca1c73e6531911d53065e7 \
-    --hash=sha256:ed673583eaa5f81b5ce5e86ef7cdaf622f88ef65f0b9aab40b843dcae5bef342
+opentelemetry-api==1.28.0 \
+    --hash=sha256:578610bcb8aa5cdcb11169d136cc752958548fb6ccffb0969c1036b0ee9e5353 \
+    --hash=sha256:8457cd2c59ea1bd0988560f021656cecd254ad7ef6be4ba09dbefeca2409ce52
     # via
     #   -r requirements.in
     #   opentelemetry-instrumentation

From b579769ff546b32943afd281292a90cd2d833f2c Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 8 Nov 2024 14:02:56 +0100
Subject: [PATCH 084/133] chore(deps): update dependency opentelemetry-sdk to
 v1.28.0 (#490)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index fb196b96..8d0f2a7a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -329,9 +329,9 @@ opentelemetry-instrumentation==0.48b0 \
     --hash=sha256:94929685d906380743a71c3970f76b5f07476eea1834abd5dd9d17abfe23cc35 \
     --hash=sha256:a69750dc4ba6a5c3eb67986a337185a25b739966d80479befe37b546fc870b44
     # via -r requirements.in
-opentelemetry-sdk==1.27.0 \
-    --hash=sha256:365f5e32f920faf0fd9e14fdfd92c086e317eaa5f860edba9cdc17a380d9197d \
-    --hash=sha256:d525017dea0ccce9ba4e0245100ec46ecdc043f2d7b8315d56b19aff0904fa6f
+opentelemetry-sdk==1.28.0 \
+    --hash=sha256:41d5420b2e3fb7716ff4981b510d551eff1fc60eb5a95cf7335b31166812a893 \
+    --hash=sha256:4b37da81d7fad67f6683c4420288c97f4ed0d988845d5886435f428ec4b8429a
     # via -r requirements.in
 opentelemetry-semantic-conventions==0.48b0 \
     --hash=sha256:12d74983783b6878162208be57c9effcb89dc88691c64992d70bb89dc00daa1a \

From fd50309e790c737ea5eec2f7f3376b2db4eaf4d2 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 8 Nov 2024 14:03:08 +0100
Subject: [PATCH 085/133] chore(deps): update dependency google-auth to v2.36.0
 (#491)

---
 .kokoro/requirements.txt | 6 +++---
 requirements.txt         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 78422e59..22118575 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -275,9 +275,9 @@ google-api-core==2.22.0 \
     # via
     #   google-cloud-core
     #   google-cloud-storage
-google-auth==2.35.0 \
-    --hash=sha256:25df55f327ef021de8be50bad0dfd4a916ad0de96da86cd05661c9297723ad3f \
-    --hash=sha256:f4c64ed4e01e8e8b646ef34c018f8bf3338df0c8e37d8b3bba40e7f574a3278a
+google-auth==2.36.0 \
+    --hash=sha256:51a15d47028b66fd36e5c64a82d2d57480075bccc7da37cde257fc94177a61fb \
+    --hash=sha256:545e9618f2df0bcbb7dcbc45a546485b1212624716975a1ea5ae8149ce769ab1
     # via
     #   gcp-releasetool
     #   google-api-core
diff --git a/requirements.txt b/requirements.txt
index 8d0f2a7a..0416b9cb 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -147,9 +147,9 @@ google-api-core[grpc]==2.22.0 \
     # via
     #   google-cloud-core
     #   google-cloud-spanner
-google-auth==2.35.0 \
-    --hash=sha256:25df55f327ef021de8be50bad0dfd4a916ad0de96da86cd05661c9297723ad3f \
-    --hash=sha256:f4c64ed4e01e8e8b646ef34c018f8bf3338df0c8e37d8b3bba40e7f574a3278a
+google-auth==2.36.0 \
+    --hash=sha256:51a15d47028b66fd36e5c64a82d2d57480075bccc7da37cde257fc94177a61fb \
+    --hash=sha256:545e9618f2df0bcbb7dcbc45a546485b1212624716975a1ea5ae8149ce769ab1
     # via
     #   google-api-core
     #   google-cloud-core

From 358fbfff8f429fa327dbe3c615ef76afbaf52ae1 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 8 Nov 2024 14:07:08 +0100
Subject: [PATCH 086/133] chore(deps): update dependency packaging to v24.2
 (#499)

---
 .kokoro/requirements.txt | 6 +++---
 requirements.txt         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 22118575..3339b12b 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -468,9 +468,9 @@ nox==2024.10.9 \
     --hash=sha256:1d36f309a0a2a853e9bccb76bbef6bb118ba92fa92674d15604ca99adeb29eab \
     --hash=sha256:7aa9dc8d1c27e9f45ab046ffd1c3b2c4f7c91755304769df231308849ebded95
     # via -r requirements.in
-packaging==24.1 \
-    --hash=sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002 \
-    --hash=sha256:5b8f2217dbdbd2f7f384c41c628544e6d52f2d0f53c6d0c3ea61aa5d1d7ff124
+packaging==24.2 \
+    --hash=sha256:09abb1bccd265c01f4a3aa3f7a7db064b36514d2cba19a2f694fe6150451a759 \
+    --hash=sha256:c228a6dc5e932d346bc5739379109d49e8853dd8223571c7c5b55260edc0b97f
     # via
     #   gcp-releasetool
     #   nox
diff --git a/requirements.txt b/requirements.txt
index 0416b9cb..9a0a96f8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -337,9 +337,9 @@ opentelemetry-semantic-conventions==0.48b0 \
     --hash=sha256:12d74983783b6878162208be57c9effcb89dc88691c64992d70bb89dc00daa1a \
     --hash=sha256:a0de9f45c413a8669788a38569c7e0a11ce6ce97861a628cca785deecdc32a1f
     # via opentelemetry-sdk
-packaging==24.1 \
-    --hash=sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002 \
-    --hash=sha256:5b8f2217dbdbd2f7f384c41c628544e6d52f2d0f53c6d0c3ea61aa5d1d7ff124
+packaging==24.2 \
+    --hash=sha256:09abb1bccd265c01f4a3aa3f7a7db064b36514d2cba19a2f694fe6150451a759 \
+    --hash=sha256:c228a6dc5e932d346bc5739379109d49e8853dd8223571c7c5b55260edc0b97f
     # via
     #   -r requirements.in
     #   build

From b44be101117b3fe619489077bd82dc672043d80c Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 8 Nov 2024 14:07:19 +0100
Subject: [PATCH 087/133] chore(deps): update actions/checkout action to v4
 (#500)

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

diff --git a/.github/workflows/test_suite.yml b/.github/workflows/test_suite.yml
index 0f219787..9f146a9b 100644
--- a/.github/workflows/test_suite.yml
+++ b/.github/workflows/test_suite.yml
@@ -137,7 +137,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
       - name: Setup Python
         uses: actions/setup-python@v4
         with:

From 210698771e41a56809df8ff34c33094f4c52cd11 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 8 Nov 2024 14:07:36 +0100
Subject: [PATCH 088/133] chore(deps): update actions/setup-python action to v5
 (#501)

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

diff --git a/.github/workflows/test_suite.yml b/.github/workflows/test_suite.yml
index 9f146a9b..b234dc03 100644
--- a/.github/workflows/test_suite.yml
+++ b/.github/workflows/test_suite.yml
@@ -139,7 +139,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.12
       - name: Install nox

From 93579c8d6298dd9a07b2ca2b9c451036e33d2e6f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Fri, 8 Nov 2024 14:23:31 +0100
Subject: [PATCH 089/133] fix: support storing columns for indices (#485)

* test: add system tests

* test: run system tests on prod

* build: allow any Python version for sys tests

* build: keep instance and create new databases instead

* chore: format code

* fix: do not use static fallback config

* fix: cleanup job

* fix: search until end of string

* build: only run system tests on the emulator for presubmits

* build: skip system tests when skipping conformance tests

* test: run tests with Python 3.8

* test: try this

* test: no tests

* fix: support storing columns for indices

* fix: split key and non-key columns

* build: run system tests on real Spanner

* fix: add include_columns as none

* fix: remove unused test

* fix: use lower case for asc/desc

* test: expect lower case desc
---
 .../sqlalchemy_spanner/sqlalchemy_spanner.py  | 65 ++++++++++++++++---
 test/system/test_basics.py                    | 43 +++++++++++-
 test/test_suite_20.py                         |  6 +-
 3 files changed, 99 insertions(+), 15 deletions(-)

diff --git a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
index 1514f9e3..e57d46a8 100644
--- a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
+++ b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
@@ -492,6 +492,26 @@ def post_create_table(self, table):
 
         return post_cmds
 
+    def visit_create_index(
+        self, create, include_schema=False, include_table_schema=True, **kw
+    ):
+        text = super().visit_create_index(
+            create, include_schema, include_table_schema, **kw
+        )
+        index = create.element
+        if "spanner" in index.dialect_options:
+            options = index.dialect_options["spanner"]
+            if "storing" in options:
+                storing = options["storing"]
+                storing_columns = [
+                    index.table.c[col] if isinstance(col, str) else col
+                    for col in storing
+                ]
+                text += " STORING (%s)" % ", ".join(
+                    [self.preparer.quote(c.name) for c in storing_columns]
+                )
+        return text
+
     def get_identity_options(self, identity_options):
         text = ["sequence_kind = 'bit_reversed_positive'"]
         if identity_options.start is not None:
@@ -997,15 +1017,35 @@ def get_multi_indexes(
                i.table_schema,
                i.table_name,
                i.index_name,
-               ARRAY_AGG(ic.column_name),
+               (
+                   SELECT ARRAY_AGG(ic.column_name)
+                   FROM information_schema.index_columns ic
+                   WHERE ic.index_name = i.index_name
+                   AND ic.table_catalog = i.table_catalog
+                   AND ic.table_schema = i.table_schema
+                   AND ic.table_name = i.table_name
+                   AND ic.column_ordering is not null
+               ) as columns,
                i.is_unique,
-               ARRAY_AGG(ic.column_ordering)
+               (
+                   SELECT ARRAY_AGG(ic.column_ordering)
+                   FROM information_schema.index_columns ic
+                   WHERE ic.index_name = i.index_name
+                   AND ic.table_catalog = i.table_catalog
+                   AND ic.table_schema = i.table_schema
+                   AND ic.table_name = i.table_name
+                   AND ic.column_ordering is not null
+               ) as column_orderings,
+               (
+                   SELECT ARRAY_AGG(storing.column_name)
+                   FROM information_schema.index_columns storing
+                   WHERE storing.index_name = i.index_name
+                   AND storing.table_catalog = i.table_catalog
+                   AND storing.table_schema = i.table_schema
+                   AND storing.table_name = i.table_name
+                   AND storing.column_ordering is null
+               ) as storing_columns,
             FROM information_schema.indexes as i
-            JOIN information_schema.index_columns AS ic
-                ON  ic.index_name = i.index_name
-                AND ic.table_catalog = i.table_catalog
-                AND ic.table_schema = i.table_schema
-                AND ic.table_name = i.table_name
             JOIN information_schema.tables AS t
                 ON  i.table_catalog = t.table_catalog
                 AND i.table_schema = t.table_schema
@@ -1016,7 +1056,8 @@ def get_multi_indexes(
                 {schema_filter_query}
                 i.index_type != 'PRIMARY_KEY'
                 AND i.spanner_is_managed = FALSE
-            GROUP BY i.table_schema, i.table_name, i.index_name, i.is_unique
+            GROUP BY i.table_catalog, i.table_schema, i.table_name,
+                     i.index_name, i.is_unique
             ORDER BY i.index_name
         """.format(
             table_filter_query=table_filter_query,
@@ -1029,13 +1070,19 @@ def get_multi_indexes(
             result_dict = {}
 
             for row in rows:
+                dialect_options = {}
+                include_columns = row[6]
+                if include_columns:
+                    dialect_options["spanner_storing"] = include_columns
                 index_info = {
                     "name": row[2],
                     "column_names": row[3],
                     "unique": row[4],
                     "column_sorting": {
-                        col: order for col, order in zip(row[3], row[5])
+                        col: order.lower() for col, order in zip(row[3], row[5])
                     },
+                    "include_columns": include_columns if include_columns else [],
+                    "dialect_options": dialect_options,
                 }
                 row[0] = row[0] or None
                 table_info = result_dict.get((row[0], row[1]), [])
diff --git a/test/system/test_basics.py b/test/system/test_basics.py
index 6a53b234..3357104c 100644
--- a/test/system/test_basics.py
+++ b/test/system/test_basics.py
@@ -11,7 +11,18 @@
 # 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 sqlalchemy import text, Table, Column, Integer, PrimaryKeyConstraint, String
+
+from sqlalchemy import (
+    text,
+    Table,
+    Column,
+    Integer,
+    PrimaryKeyConstraint,
+    String,
+    Index,
+    MetaData,
+    Boolean,
+)
 from sqlalchemy.testing import eq_
 from sqlalchemy.testing.plugin.plugin_base import fixtures
 
@@ -19,13 +30,21 @@
 class TestBasics(fixtures.TablesTest):
     @classmethod
     def define_tables(cls, metadata):
-        Table(
+        numbers = Table(
             "numbers",
             metadata,
             Column("number", Integer),
             Column("name", String(20)),
+            Column("alternative_name", String(20)),
+            Column("prime", Boolean),
             PrimaryKeyConstraint("number"),
         )
+        Index(
+            "idx_numbers_name",
+            numbers.c.name,
+            numbers.c.prime.desc(),
+            spanner_storing=[numbers.c.alternative_name],
+        )
 
     def test_hello_world(self, connection):
         greeting = connection.execute(text("select 'Hello World'"))
@@ -33,7 +52,25 @@ def test_hello_world(self, connection):
 
     def test_insert_number(self, connection):
         connection.execute(
-            text("insert or update into numbers(number, name) values (1, 'One')")
+            text(
+                """insert or update into numbers (number, name, prime)
+                   values (1, 'One', false)"""
+            )
         )
         name = connection.execute(text("select name from numbers where number=1"))
         eq_("One", name.fetchone()[0])
+
+    def test_reflect(self, connection):
+        engine = connection.engine
+        meta: MetaData = MetaData()
+        meta.reflect(bind=engine)
+        eq_(1, len(meta.tables))
+        table = meta.tables["numbers"]
+        eq_(1, len(table.indexes))
+        index = next(iter(table.indexes))
+        eq_(2, len(index.columns))
+        eq_("name", index.columns[0].name)
+        eq_("prime", index.columns[1].name)
+        dialect_options = index.dialect_options["spanner"]
+        eq_(1, len(dialect_options["storing"]))
+        eq_("alternative_name", dialect_options["storing"][0])
diff --git a/test/test_suite_20.py b/test/test_suite_20.py
index 4902b3ab..22b23e0a 100644
--- a/test/test_suite_20.py
+++ b/test/test_suite_20.py
@@ -1414,7 +1414,7 @@ def idx(
                 "include_columns": [],
             }
             if column_sorting:
-                res["column_sorting"] = {"q": "DESC"}
+                res["column_sorting"] = {"q": "desc"}
             if duplicates:
                 res["duplicates_constraint"] = name
             return [res]
@@ -1458,11 +1458,11 @@ def idx(
                 *idx(
                     "q",
                     name="noncol_idx_nopk",
-                    column_sorting={"q": "DESC"},
+                    column_sorting={"q": "desc"},
                 )
             ],
             (schema, "noncol_idx_test_pk"): [
-                *idx("q", name="noncol_idx_pk", column_sorting={"q": "DESC"})
+                *idx("q", name="noncol_idx_pk", column_sorting={"q": "desc"})
             ],
             (schema, self.temp_table_name()): [
                 *idx("foo", name="user_tmp_ix"),

From a6ed382be2a7105f9e8b2f855df3919e8c6750c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Fri, 8 Nov 2024 17:24:52 +0100
Subject: [PATCH 090/133] docs: add samples for Spanner-specific features
 (#492)

* docs: add samples for Spanner-specific features

* docs: more samples

* docs: add more samples

* test: add tests for samples

* chore: fix linting error

* docs: document samples

* docs: link to README
---
 .github/workflows/test_suite.yml        |  16 +++
 README.rst                              |   7 +
 samples/README.md                       |  30 +++++
 samples/bit_reversed_sequence_sample.py |  70 ++++++++++
 samples/date_and_timestamp_sample.py    |  64 +++++++++
 samples/default_column_value_sample.py  |  61 +++++++++
 samples/generated_column_sample.py      |  50 +++++++
 samples/hello_world_sample.py           |  31 +++++
 samples/insert_data_sample.py           |  73 +++++++++++
 samples/interleaved_table_sample.py     |  98 ++++++++++++++
 samples/model.py                        | 167 ++++++++++++++++++++++++
 samples/noxfile.py                      |  80 ++++++++++++
 samples/sample_helper.py                |  86 ++++++++++++
 samples/transaction_sample.py           |  82 ++++++++++++
 14 files changed, 915 insertions(+)
 create mode 100644 samples/README.md
 create mode 100644 samples/bit_reversed_sequence_sample.py
 create mode 100644 samples/date_and_timestamp_sample.py
 create mode 100644 samples/default_column_value_sample.py
 create mode 100644 samples/generated_column_sample.py
 create mode 100644 samples/hello_world_sample.py
 create mode 100644 samples/insert_data_sample.py
 create mode 100644 samples/interleaved_table_sample.py
 create mode 100644 samples/model.py
 create mode 100644 samples/noxfile.py
 create mode 100644 samples/sample_helper.py
 create mode 100644 samples/transaction_sample.py

diff --git a/.github/workflows/test_suite.yml b/.github/workflows/test_suite.yml
index b234dc03..23f28e19 100644
--- a/.github/workflows/test_suite.yml
+++ b/.github/workflows/test_suite.yml
@@ -53,6 +53,22 @@ jobs:
       - name: Run mockserver tests
         run: nox -s mockserver
 
+  samples:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.12
+      - name: Install nox
+        run: python -m pip install nox
+      - name: Run samples
+        run: nox -s _all_samples
+        working-directory: samples
+
   compliance_tests_13:
     runs-on: ubuntu-latest
 
diff --git a/README.rst b/README.rst
index 25cde459..5c39e139 100644
--- a/README.rst
+++ b/README.rst
@@ -58,6 +58,13 @@ Next install the package from the package ``setup.py`` file:
 
 During setup the dialect will be registered with entry points.
 
+Samples
+-------------
+
+The `samples directory <https://github.com/googleapis/python-spanner-sqlalchemy/blob/-/samples/README.md>`__
+contains multiple examples for how to configure and use common Spanner features.
+
+
 A Minimal App
 -------------
 
diff --git a/samples/README.md b/samples/README.md
new file mode 100644
index 00000000..7ebf7e9e
--- /dev/null
+++ b/samples/README.md
@@ -0,0 +1,30 @@
+# Spanner SQLAlchemy Samples
+
+This folder contains samples for how to use common Spanner features with SQLAlchemy. The samples use
+a shared [data model](model.py) and can be executed as a standalone application. The samples
+automatically start the [Spanner Emulator](https://cloud.google.com/spanner/docs/emulator) in a
+Docker container when they are executed. You must therefore have Docker installed on your system to
+run a sample.
+
+You can run a sample with `nox`:
+
+```shell
+nox -s hello_world
+```
+
+Change `hello_world` to run any of the other sample names. The runnable samples all end with
+`_sample.py`. Omit the `_sample.py` part of the file name to run the sample.
+
+
+
+| Sample name           | Description                                                                 |
+|-----------------------|-----------------------------------------------------------------------------|
+| bit_reversed_sequence | Use a bit-reversed sequence for primary key generation.                     |
+| date_and_timestamp    | Map Spanner DATE and TIMESTAMP columns to SQLAlchemy.                       |
+| default_column_value  | Create and use a Spanner DEFAULT column constraint in SQLAlchemy.           |
+| generated_column      | Create and use a Spanner generated column in SQLAlchemy.                    |
+| hello_world           | Shows how to connect to Spanner with SQLAlchemy and execute a simple query. |
+| insert_data           | Insert multiple rows to Spanner with SQLAlchemy.                            |
+| interleaved_table     | Create and use an interleaved table (INTERLEAVE IN PARENT) with SQLAlchemy. |
+| transaction           | Execute a read/write transaction on Spanner with SQLAlchemy.                |
+
diff --git a/samples/bit_reversed_sequence_sample.py b/samples/bit_reversed_sequence_sample.py
new file mode 100644
index 00000000..bd7d80ce
--- /dev/null
+++ b/samples/bit_reversed_sequence_sample.py
@@ -0,0 +1,70 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 datetime
+import uuid
+
+from sqlalchemy import create_engine
+from sqlalchemy.orm import Session
+
+from sample_helper import run_sample
+from model import Singer, Concert, Venue, TicketSale
+
+
+# Shows how to use a bit-reversed sequence for primary key generation.
+#
+# The TicketSale model uses a bit-reversed sequence for automatic primary key
+# generation:
+#
+# id: Mapped[int] = mapped_column(
+#         BigInteger,
+#         Sequence("ticket_sale_id"),
+#         server_default=TextClause("GET_NEXT_SEQUENCE_VALUE(SEQUENCE ticket_sale_id)"),
+#         primary_key=True,
+#     )
+#
+# This leads to the following table definition:
+#
+# CREATE TABLE ticket_sales (
+# 	id INT64 NOT NULL DEFAULT (GET_NEXT_SEQUENCE_VALUE(SEQUENCE ticket_sale_id)),
+#   ...
+# ) PRIMARY KEY (id)
+def bit_reversed_sequence_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    with Session(engine) as session:
+        singer = Singer(id=str(uuid.uuid4()), first_name="John", last_name="Doe")
+        venue = Venue(code="CH", name="Concert Hall", active=True)
+        concert = Concert(
+            venue=venue,
+            start_time=datetime.datetime(2024, 11, 7, 19, 30, 0),
+            singer=singer,
+            title="John Doe - Live in Concert Hall",
+        )
+        # TicketSale automatically generates a primary key value using a
+        # bit-reversed sequence. We therefore do not need to specify a primary
+        # key value when we create an instance of TicketSale.
+        ticket_sale = TicketSale(
+            concert=concert, customer_name="Alice Doe", seats=["A010", "A011", "A012"]
+        )
+        session.add_all([singer, venue, concert, ticket_sale])
+        session.commit()
+
+
+if __name__ == "__main__":
+    run_sample(bit_reversed_sequence_sample)
diff --git a/samples/date_and_timestamp_sample.py b/samples/date_and_timestamp_sample.py
new file mode 100644
index 00000000..442ec611
--- /dev/null
+++ b/samples/date_and_timestamp_sample.py
@@ -0,0 +1,64 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 datetime
+import uuid
+
+from sqlalchemy import create_engine
+from sqlalchemy.orm import Session
+
+from sample_helper import run_sample
+from model import Singer, Concert, Venue
+
+
+# Shows how to map and use the DATE and TIMESTAMP data types in Spanner.
+def date_and_timestamp_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    with Session(engine) as session:
+        # Singer has a property birthdate, which is mapped to a DATE column.
+        # Use the datetime.date type for this.
+        singer = Singer(
+            id=str(uuid.uuid4()),
+            first_name="John",
+            last_name="Doe",
+            birthdate=datetime.date(1979, 10, 14),
+        )
+        venue = Venue(code="CH", name="Concert Hall", active=True)
+        # Concert has a property `start_time`, which is mapped to a TIMESTAMP
+        # column. Use the datetime.datetime type for this.
+        concert = Concert(
+            venue=venue,
+            start_time=datetime.datetime(2024, 11, 7, 19, 30, 0),
+            singer=singer,
+            title="John Doe - Live in Concert Hall",
+        )
+        session.add_all([singer, venue, concert])
+        session.commit()
+
+        # Use AUTOCOMMIT for sessions that only read. This is more
+        # efficient than using a read/write transaction to only read.
+        session.connection(execution_options={"isolation_level": "AUTOCOMMIT"})
+        print(
+            f"{singer.full_name}, born on {singer.birthdate}, has planned "
+            f"a concert that starts on {concert.start_time} in {venue.name}."
+        )
+
+
+if __name__ == "__main__":
+    run_sample(date_and_timestamp_sample)
diff --git a/samples/default_column_value_sample.py b/samples/default_column_value_sample.py
new file mode 100644
index 00000000..82ecf566
--- /dev/null
+++ b/samples/default_column_value_sample.py
@@ -0,0 +1,61 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 datetime
+import uuid
+
+from sqlalchemy import create_engine
+from sqlalchemy.orm import Session
+
+from sample_helper import run_sample
+from model import Singer, Album, Track
+
+
+# Shows how to use a default column with SQLAlchemy and Spanner.
+def default_column_value_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    with Session(engine) as session:
+        # The Track model has a `recorded_at` property that is set to
+        # CURRENT_TIMESTAMP if no other value is supplied.
+        singer = Singer(id=str(uuid.uuid4()), first_name="John", last_name="Doe")
+        album = Album(id=str(uuid.uuid4()), title="My album", singer=singer)
+
+        # This track will use the default CURRENT_TIMESTAMP for the recorded_at
+        # property.
+        track1 = Track(
+            id=str(uuid.uuid4()),
+            track_number=1,
+            title="My track 1",
+            album=album,
+        )
+        track2 = Track(
+            id=str(uuid.uuid4()),
+            track_number=2,
+            title="My track 2",
+            recorded_at=datetime.datetime(2024, 11, 7, 10, 0, 0),
+            album=album,
+        )
+        session.add_all([singer, album, track1, track2])
+        session.commit()
+        print(f"Track 1 was recorded at: " f"{track1.recorded_at}")
+        print(f"Track 2 was recorded at: " f"{track2.recorded_at}")
+
+
+if __name__ == "__main__":
+    run_sample(default_column_value_sample)
diff --git a/samples/generated_column_sample.py b/samples/generated_column_sample.py
new file mode 100644
index 00000000..fe6b157b
--- /dev/null
+++ b/samples/generated_column_sample.py
@@ -0,0 +1,50 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 uuid
+
+from sqlalchemy import create_engine
+from sqlalchemy.orm import Session
+
+from sample_helper import run_sample
+from model import Singer
+
+
+# Shows how to use a generated column with SQLAlchemy and Spanner.
+def generated_column_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    with Session(engine) as session:
+        # The Singer model has a `full_name` property that is generated by the
+        # database.
+        singer = Singer(id=str(uuid.uuid4()), first_name="John", last_name="Doe")
+        session.add(singer)
+        session.commit()
+        print(
+            f"The database generated a full name for the singer: " f"{singer.full_name}"
+        )
+
+        # Updating the first name or last name of the singer will also update
+        # the generated full name property.
+        singer.last_name = "Jones"
+        session.commit()
+        print(f"Updated full name for singer: " f"{singer.full_name}")
+
+
+if __name__ == "__main__":
+    run_sample(generated_column_sample)
diff --git a/samples/hello_world_sample.py b/samples/hello_world_sample.py
new file mode 100644
index 00000000..57f676c1
--- /dev/null
+++ b/samples/hello_world_sample.py
@@ -0,0 +1,31 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import create_engine, select, text
+from sample_helper import run_sample
+
+
+def quickstart():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database"
+    )
+    with engine.connect().execution_options(isolation_level="AUTOCOMMIT") as connection:
+        results = connection.execute(select(text("'Hello World!'"))).fetchall()
+        print("\nMessage from Spanner: ", results[0][0], "\n")
+
+
+if __name__ == "__main__":
+    run_sample(quickstart)
diff --git a/samples/insert_data_sample.py b/samples/insert_data_sample.py
new file mode 100644
index 00000000..a415e621
--- /dev/null
+++ b/samples/insert_data_sample.py
@@ -0,0 +1,73 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 uuid
+
+from sqlalchemy import create_engine
+from sqlalchemy.orm import Session
+
+from sample_helper import run_sample
+from model import Singer, Album, Track
+
+# Shows how to insert data using SQLAlchemy, including relationships that are
+# defined both as foreign keys and as interleaved tables.
+def insert_data():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    with Session(engine) as session:
+        singer = Singer(
+            id=str(uuid.uuid4()),
+            first_name="John",
+            last_name="Smith",
+            albums=[
+                Album(
+                    id=str(uuid.uuid4()),
+                    title="Rainforest",
+                    tracks=[
+                        # Track is INTERLEAVED IN PARENT Album, but can be treated
+                        # as a normal relationship in SQLAlchemy.
+                        Track(track_number=1, title="Green"),
+                        Track(track_number=2, title="Blue"),
+                        Track(track_number=3, title="Yellow"),
+                    ],
+                ),
+                Album(
+                    id=str(uuid.uuid4()),
+                    title="Butterflies",
+                    tracks=[
+                        Track(track_number=1, title="Purple"),
+                        Track(track_number=2, title="Cyan"),
+                        Track(track_number=3, title="Mauve"),
+                    ],
+                ),
+            ],
+        )
+        session.add(singer)
+        session.commit()
+
+        # Use AUTOCOMMIT for sessions that only read. This is more
+        # efficient than using a read/write transaction to only read.
+        session.connection(execution_options={"isolation_level": "AUTOCOMMIT"})
+        print(
+            f"Inserted singer {singer.full_name} with {len(singer.albums)} "
+            f"albums successfully"
+        )
+
+
+if __name__ == "__main__":
+    run_sample(insert_data)
diff --git a/samples/interleaved_table_sample.py b/samples/interleaved_table_sample.py
new file mode 100644
index 00000000..0d652159
--- /dev/null
+++ b/samples/interleaved_table_sample.py
@@ -0,0 +1,98 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 uuid
+
+from sqlalchemy import create_engine
+from sqlalchemy.orm import Session
+
+from sample_helper import run_sample
+from model import Singer, Album, Track
+
+# Shows how INTERLEAVE IN PARENT can be used in SQLAlchemy.
+# INTERLEAVE IN PARENT can be modelled as if it were a normal relationship
+# in SQLAlchemy. SQLAlchemy can also generate the correct DDL for this.
+#
+# This sample uses the following table structure:
+# CREATE TABLE albums (
+# 	id STRING(36) NOT NULL,
+# 	title STRING(200) NOT NULL,
+# 	release_date DATE,
+# 	singer_id STRING(36) NOT NULL,
+# 	FOREIGN KEY(singer_id) REFERENCES singers (id)
+# ) PRIMARY KEY (id);
+#
+# CREATE TABLE tracks (
+# 	id STRING(36) NOT NULL,
+# 	track_number INT64 NOT NULL,
+# 	title STRING(200) NOT NULL,
+# 	duration NUMERIC
+# ) PRIMARY KEY (id, track_number),
+# INTERLEAVE IN PARENT albums ON DELETE CASCADE
+#
+# See model.py for the full model definitions.
+def interleaved_table():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    with Session(engine) as session:
+        # Insert a Singer row, two Albums, and six Tracks.
+        # Track is INTERLEAVED IN PARENT Album.
+        singer = Singer(
+            id=str(uuid.uuid4()),
+            first_name="John",
+            last_name="Smith",
+            albums=[
+                Album(
+                    id=str(uuid.uuid4()),
+                    title="Rainforest",
+                    tracks=[
+                        # Track is INTERLEAVED IN PARENT Album, but can be treated
+                        # as a normal relationship in SQLAlchemy.
+                        Track(track_number=1, title="Green"),
+                        Track(track_number=2, title="Blue"),
+                        Track(track_number=3, title="Yellow"),
+                    ],
+                ),
+                Album(
+                    id=str(uuid.uuid4()),
+                    title="Butterflies",
+                    tracks=[
+                        Track(track_number=1, title="Purple"),
+                        Track(track_number=2, title="Cyan"),
+                        Track(track_number=3, title="Mauve"),
+                    ],
+                ),
+            ],
+        )
+        session.add(singer)
+        session.commit()
+
+        # Use AUTOCOMMIT for sessions that only read. This is more
+        # efficient than using a read/write transaction to only read.
+        session.connection(execution_options={"isolation_level": "AUTOCOMMIT"})
+        # We can iterate over the tracks of an album as if it were a normal
+        # relationship.
+        print(f"Singer {singer.full_name} has these albums:")
+        for album in singer.albums:
+            print(f"\tAlbum {album.title} has these tracks:")
+            for track in album.tracks:
+                print(f"\t\t{track.track_number} - {track.title}")
+
+
+if __name__ == "__main__":
+    run_sample(interleaved_table)
diff --git a/samples/model.py b/samples/model.py
new file mode 100644
index 00000000..13a4c83d
--- /dev/null
+++ b/samples/model.py
@@ -0,0 +1,167 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 datetime
+from typing import Optional, List
+
+from sqlalchemy import (
+    String,
+    Computed,
+    Date,
+    LargeBinary,
+    Integer,
+    Numeric,
+    ForeignKey,
+    JSON,
+    Boolean,
+    DateTime,
+    BigInteger,
+    ARRAY,
+    ForeignKeyConstraint,
+    Sequence,
+    TextClause,
+    func,
+    FetchedValue,
+)
+from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, relationship
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+# Most models in this sample use a client-side generated UUID as primary key.
+# This allows inserts to use Batch DML, as the primary key value does not need
+# to be returned from Spanner using a THEN RETURN clause.
+#
+# The TicketSale model uses a bit-reversed sequence for primary key generation.
+# This is achieved by creating a bit-reversed sequence and assigning the id
+# column of the model a server_default value that gets the next value from that
+# sequence.
+
+
+class Singer(Base):
+    __tablename__ = "singers"
+    id: Mapped[str] = mapped_column(String(36), primary_key=True)
+    first_name: Mapped[Optional[str]] = mapped_column(String(200), nullable=True)
+    last_name: Mapped[str] = mapped_column(String(200), nullable=False)
+    full_name: Mapped[str] = mapped_column(
+        String, Computed("COALESCE(first_name || ' ', '') || last_name")
+    )
+    birthdate: Mapped[Optional[datetime.date]] = mapped_column(Date, nullable=True)
+    picture: Mapped[Optional[bytes]] = mapped_column(LargeBinary, nullable=True)
+    albums: Mapped[List["Album"]] = relationship(
+        back_populates="singer", cascade="all, delete-orphan"
+    )
+    concerts: Mapped[List["Concert"]] = relationship(
+        back_populates="singer", cascade="all, delete-orphan"
+    )
+
+
+class Album(Base):
+    __tablename__ = "albums"
+    id: Mapped[str] = mapped_column(String(36), primary_key=True)
+    title: Mapped[str] = mapped_column(String(200), nullable=False)
+    release_date: Mapped[Optional[datetime.date]] = mapped_column(Date, nullable=True)
+    singer_id: Mapped[str] = mapped_column(ForeignKey("singers.id"))
+    singer: Mapped["Singer"] = relationship(back_populates="albums")
+    tracks: Mapped[List["Track"]] = relationship(
+        back_populates="album",
+        primaryjoin="Album.id == foreign(Track.id)",
+        order_by="Track.track_number",
+    )
+
+
+class Track(Base):
+    __tablename__ = "tracks"
+    # This interleaves the table `tracks` in its parent `albums`.
+    __table_args__ = {
+        "spanner_interleave_in": "albums",
+        "spanner_interleave_on_delete_cascade": True,
+    }
+    id: Mapped[str] = mapped_column(String(36), primary_key=True)
+    track_number: Mapped[int] = mapped_column(Integer, primary_key=True)
+    title: Mapped[str] = mapped_column(String(200), nullable=False)
+    duration: Mapped[Optional[float]] = mapped_column(Numeric, nullable=True)
+    recorded_at: Mapped[Optional[datetime.datetime]] = mapped_column(
+        DateTime,
+        nullable=True,
+        # TODO: Enable this once 'func.now()' is mapped to CURRENT_TIMESTAMP
+        # server_default=func.now(),
+        server_default=TextClause("CURRENT_TIMESTAMP"),
+    )
+    album: Mapped["Album"] = relationship(
+        back_populates="tracks",
+        foreign_keys=[id],
+        primaryjoin="Track.id == Album.id",
+        remote_side="Album.id",
+    )
+
+
+# SQLAlchemy does not know what 'spanner_interleave_in' means, so we need to
+# explicitly tell SQLAlchemy that `tracks` depends on `albums`, and that
+# `albums` therefore must be created before `tracks`.
+Track.__table__.add_is_dependent_on(Album.__table__)
+
+
+class Venue(Base):
+    __tablename__ = "venues"
+    code: Mapped[str] = mapped_column(String(10), primary_key=True)
+    name: Mapped[str] = mapped_column(String(200), nullable=False)
+    description: Mapped[str] = mapped_column(JSON, nullable=True)
+    active: Mapped[bool] = mapped_column(Boolean, nullable=False)
+    concerts: Mapped[List["Concert"]] = relationship(
+        back_populates="venue", cascade="all, delete-orphan"
+    )
+
+
+class Concert(Base):
+    __tablename__ = "concerts"
+    venue_code: Mapped[str] = mapped_column(
+        String(10), ForeignKey("venues.code"), primary_key=True
+    )
+    start_time: Mapped[Optional[datetime.datetime]] = mapped_column(
+        DateTime, primary_key=True, nullable=False
+    )
+    singer_id: Mapped[str] = mapped_column(
+        String(36), ForeignKey("singers.id"), primary_key=True
+    )
+    title: Mapped[str] = mapped_column(String(200), nullable=False)
+    singer: Mapped["Singer"] = relationship(back_populates="concerts")
+    venue: Mapped["Venue"] = relationship(back_populates="concerts")
+    ticket_sales: Mapped[List["TicketSale"]] = relationship(back_populates="concert")
+
+
+class TicketSale(Base):
+    __tablename__ = "ticket_sales"
+    __table_args__ = (
+        ForeignKeyConstraint(
+            ["venue_code", "start_time", "singer_id"],
+            ["concerts.venue_code", "concerts.start_time", "concerts.singer_id"],
+        ),
+    )
+    id: Mapped[int] = mapped_column(
+        BigInteger,
+        Sequence("ticket_sale_id"),
+        server_default=TextClause("GET_NEXT_SEQUENCE_VALUE(SEQUENCE ticket_sale_id)"),
+        primary_key=True,
+    )
+    customer_name: Mapped[str] = mapped_column(String(200), nullable=False)
+    seats: Mapped[list[str]] = mapped_column(ARRAY(String(20)), nullable=False)
+    concert: Mapped["Concert"] = relationship(back_populates="ticket_sales")
+    venue_code: Mapped[str] = mapped_column(String(10), ForeignKey("venues.code"))
+    start_time: Mapped[Optional[datetime.datetime]] = mapped_column(
+        DateTime, nullable=False
+    )
+    singer_id: Mapped[str] = mapped_column(String(36), ForeignKey("singers.id"))
diff --git a/samples/noxfile.py b/samples/noxfile.py
new file mode 100644
index 00000000..b103fd77
--- /dev/null
+++ b/samples/noxfile.py
@@ -0,0 +1,80 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 os import listdir
+from os.path import isfile, join
+
+import nox
+
+
+@nox.session()
+def hello_world(session):
+    _sample(session)
+
+
+@nox.session()
+def bit_reversed_sequence(session):
+    _sample(session)
+
+
+@nox.session()
+def date_and_timestamp(session):
+    _sample(session)
+
+
+@nox.session()
+def default_column_value(session):
+    _sample(session)
+
+
+@nox.session()
+def generated_column(session):
+    _sample(session)
+
+
+@nox.session()
+def insert_data(session):
+    _sample(session)
+
+
+@nox.session()
+def interleaved_table(session):
+    _sample(session)
+
+
+@nox.session()
+def transaction(session):
+    _sample(session)
+
+
+@nox.session()
+def _all_samples(session):
+    _sample(session)
+
+
+def _sample(session):
+    session.install("testcontainers")
+    session.install("sqlalchemy")
+    session.install("setuptools")
+    session.install(
+        "git+https://github.com/googleapis/python-spanner.git#egg=google-cloud-spanner"
+    )
+    session.install("../.")
+    if session.name == "_all_samples":
+        files = [
+            f for f in listdir(".") if isfile(join(".", f)) and f.endswith("_sample.py")
+        ]
+        for file in files:
+            session.run("python", file)
+    else:
+        session.run("python", session.name + "_sample.py")
diff --git a/samples/sample_helper.py b/samples/sample_helper.py
new file mode 100644
index 00000000..862d535d
--- /dev/null
+++ b/samples/sample_helper.py
@@ -0,0 +1,86 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 os
+from typing import Callable
+
+from google.api_core.client_options import ClientOptions
+from google.auth.credentials import AnonymousCredentials
+from google.cloud.spanner_v1 import Client
+from sqlalchemy import create_engine
+from sqlalchemy.dialects import registry
+from testcontainers.core.container import DockerContainer
+from testcontainers.core.waiting_utils import wait_for_logs
+
+from model import Base
+
+
+def run_sample(sample_method: Callable):
+    registry.register(
+        "spanner",
+        "google.cloud.sqlalchemy_spanner.sqlalchemy_spanner",
+        "SpannerDialect",
+    )
+    os.environ["SPANNER_EMULATOR_HOST"] = ""
+    emulator, port = start_emulator()
+    os.environ["SPANNER_EMULATOR_HOST"] = "localhost:" + str(port)
+    try:
+        _create_tables()
+        sample_method()
+    finally:
+        if emulator is not None:
+            emulator.stop()
+
+
+def start_emulator() -> (DockerContainer, str):
+    emulator = DockerContainer(
+        "gcr.io/cloud-spanner-emulator/emulator"
+    ).with_exposed_ports(9010)
+    emulator.start()
+    wait_for_logs(emulator, "gRPC server listening at 0.0.0.0:9010")
+    port = emulator.get_exposed_port(9010)
+    _create_instance_and_database(port)
+    return emulator, port
+
+
+def _create_instance_and_database(port: str):
+    client = Client(
+        project="sample-project",
+        credentials=AnonymousCredentials(),
+        client_options=ClientOptions(
+            api_endpoint="localhost:" + port,
+        ),
+    )
+    configs = list(client.list_instance_configs())
+    instance_config = configs[0].name
+    instance_id = "sample-instance"
+    database_id = "sample-database"
+
+    instance = client.instance(instance_id, instance_config)
+    created_op = instance.create()
+    created_op.result(1800)  # block until completion
+
+    database = instance.database(database_id)
+    created_op = database.create()
+    created_op.result(1800)
+
+
+def _create_tables():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    Base.metadata.create_all(engine)
diff --git a/samples/transaction_sample.py b/samples/transaction_sample.py
new file mode 100644
index 00000000..b1f42ede
--- /dev/null
+++ b/samples/transaction_sample.py
@@ -0,0 +1,82 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 datetime
+import uuid
+
+from sqlalchemy import create_engine
+from sqlalchemy.orm import Session
+
+from sample_helper import run_sample
+from model import Singer, Concert, Venue
+
+
+# Shows how to execute a read/write transaction on Spanner using SQLAlchemy.
+def transaction_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    with Session(engine) as session:
+        # SQLAlchemy by default automatically starts a transaction the first
+        # time the database is accessed.
+        singer_id = str(uuid.uuid4())
+        singer = Singer(id=singer_id, first_name="John", last_name="Doe")
+        session.add(singer)
+        # Flush the session. This pushes all changes in this session to the
+        # database without committing the current transaction.
+        session.flush([singer])
+
+        # Verify that we can read this singer from the database during the
+        # same transaction. The Singer model has a `full_name` property that is
+        # generated by the database. This will be read from the database when
+        # we call refresh.
+        session.refresh(singer)
+        print(
+            f"The database generated a full name for the singer: " f"{singer.full_name}"
+        )
+
+        # We cannot read the singer in a different session, as the current
+        # transaction has not yet committed.
+        # We use AUTOCOMMIT for the additional session, as we do not need a
+        # read/write transaction for just trying to read one row.
+        with Session(
+            engine.execution_options(isolation_level="AUTOCOMMIT")
+        ) as session2:
+            # singer2 will be None, as the row will not be found.
+            singer2 = session2.get(Singer, singer_id)
+            print(
+                f"Fetching singer in a different transaction before the "
+                f"transaction was committed: {singer2}"
+            )
+
+        session.commit()
+
+        # Now that the original transaction has committed, we can read the
+        # singer in a different session.
+        with Session(
+            engine.execution_options(isolation_level="AUTOCOMMIT")
+        ) as session2:
+            # singer2 will now return the actual row.
+            singer2 = session2.get(Singer, singer_id)
+            print(
+                f"Fetching singer in a different transaction after the "
+                f"transaction was committed: {singer2.full_name}"
+            )
+
+
+if __name__ == "__main__":
+    run_sample(transaction_sample)

From 306fc44d7fe3d73f2eec1a4b363b336571cad3e8 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 14:55:47 +0100
Subject: [PATCH 091/133] chore(deps): update dependency opentelemetry-api to
 v1.28.2 (#504)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 9a0a96f8..d32ce308 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -317,9 +317,9 @@ markupsafe==3.0.2 \
     --hash=sha256:f8b3d067f2e40fe93e1ccdd6b2e1d16c43140e76f02fb1319a05cf2b79d99430 \
     --hash=sha256:fcabf5ff6eea076f859677f5f0b6b5c1a51e70a376b0579e0eadef8db48c6b50
     # via mako
-opentelemetry-api==1.28.0 \
-    --hash=sha256:578610bcb8aa5cdcb11169d136cc752958548fb6ccffb0969c1036b0ee9e5353 \
-    --hash=sha256:8457cd2c59ea1bd0988560f021656cecd254ad7ef6be4ba09dbefeca2409ce52
+opentelemetry-api==1.28.2 \
+    --hash=sha256:6fcec89e265beb258fe6b1acaaa3c8c705a934bd977b9f534a2b7c0d2d4275a6 \
+    --hash=sha256:ecdc70c7139f17f9b0cf3742d57d7020e3e8315d6cffcdf1a12a905d45b19cc0
     # via
     #   -r requirements.in
     #   opentelemetry-instrumentation

From 926b38f3f708c6bcc127fd671dc36c0de020b43b Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 14:57:54 +0100
Subject: [PATCH 092/133] chore(deps): update dependency opentelemetry-sdk to
 v1.28.2 (#505)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index d32ce308..b8f26e7a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -329,9 +329,9 @@ opentelemetry-instrumentation==0.48b0 \
     --hash=sha256:94929685d906380743a71c3970f76b5f07476eea1834abd5dd9d17abfe23cc35 \
     --hash=sha256:a69750dc4ba6a5c3eb67986a337185a25b739966d80479befe37b546fc870b44
     # via -r requirements.in
-opentelemetry-sdk==1.28.0 \
-    --hash=sha256:41d5420b2e3fb7716ff4981b510d551eff1fc60eb5a95cf7335b31166812a893 \
-    --hash=sha256:4b37da81d7fad67f6683c4420288c97f4ed0d988845d5886435f428ec4b8429a
+opentelemetry-sdk==1.28.2 \
+    --hash=sha256:5fed24c5497e10df30282456fe2910f83377797511de07d14cec0d3e0a1a3110 \
+    --hash=sha256:93336c129556f1e3ccd21442b94d3521759541521861b2214c499571b85cb71b
     # via -r requirements.in
 opentelemetry-semantic-conventions==0.48b0 \
     --hash=sha256:12d74983783b6878162208be57c9effcb89dc88691c64992d70bb89dc00daa1a \

From 53592b28db1b7baf57d9f5fc2f1b1decc3730521 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 14:58:55 +0100
Subject: [PATCH 093/133] chore(deps): update dependency zipp to v3.21.0 (#507)

---
 .kokoro/requirements.txt | 6 +++---
 requirements.txt         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 3339b12b..b39eaf5c 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -614,7 +614,7 @@ wheel==0.44.0 \
     --hash=sha256:2376a90c98cc337d18623527a97c31797bd02bad0033d41547043a1cbfbe448f \
     --hash=sha256:a29c3f2817e95ab89aa4660681ad547c0e9547f20e75b0562fe7723c9a2a9d49
     # via -r requirements.in
-zipp==3.20.2 \
-    --hash=sha256:a817ac80d6cf4b23bf7f2828b7cabf326f15a001bea8b1f9b49631780ba28350 \
-    --hash=sha256:bc9eb26f4506fda01b81bcde0ca78103b6e62f991b381fec825435c836edbc29
+zipp==3.21.0 \
+    --hash=sha256:2c9958f6430a2040341a52eb608ed6dd93ef4392e02ffe219417c1b28b5dd1f4 \
+    --hash=sha256:ac1bbe05fd2991f160ebce24ffbac5f6d11d83dc90891255885223d42b3cd931
     # via importlib-metadata
diff --git a/requirements.txt b/requirements.txt
index b8f26e7a..02019bc3 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -562,9 +562,9 @@ wrapt==1.16.0 \
     # via
     #   deprecated
     #   opentelemetry-instrumentation
-zipp==3.20.2 \
-    --hash=sha256:a817ac80d6cf4b23bf7f2828b7cabf326f15a001bea8b1f9b49631780ba28350 \
-    --hash=sha256:bc9eb26f4506fda01b81bcde0ca78103b6e62f991b381fec825435c836edbc29
+zipp==3.21.0 \
+    --hash=sha256:2c9958f6430a2040341a52eb608ed6dd93ef4392e02ffe219417c1b28b5dd1f4 \
+    --hash=sha256:ac1bbe05fd2991f160ebce24ffbac5f6d11d83dc90891255885223d42b3cd931
     # via importlib-metadata
 
 # WARNING: The following packages were not pinned, but pip requires them to be

From 08624e06b1f487154c5424b617cba9e970e2ae76 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:01:16 +0100
Subject: [PATCH 094/133] chore(deps): update dependency wheel to v0.45.1
 (#506)

---
 .kokoro/requirements.txt | 6 +++---
 requirements.txt         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index b39eaf5c..adec3916 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -610,9 +610,9 @@ webencodings==0.5.1 \
     --hash=sha256:a0af1213f3c2226497a97e2b3aa01a7e4bee4f403f95be16fc9acd2947514a78 \
     --hash=sha256:b36a1c245f2d304965eb4e0a82848379241dc04b865afcc4aab16748587e1923
     # via bleach
-wheel==0.44.0 \
-    --hash=sha256:2376a90c98cc337d18623527a97c31797bd02bad0033d41547043a1cbfbe448f \
-    --hash=sha256:a29c3f2817e95ab89aa4660681ad547c0e9547f20e75b0562fe7723c9a2a9d49
+wheel==0.45.1 \
+    --hash=sha256:661e1abd9198507b1409a20c02106d9670b2576e916d58f520316666abca6729 \
+    --hash=sha256:708e7481cc80179af0e556bbf0cc00b8444c7321e2700b8d8580231d13017248
     # via -r requirements.in
 zipp==3.21.0 \
     --hash=sha256:2c9958f6430a2040341a52eb608ed6dd93ef4392e02ffe219417c1b28b5dd1f4 \
diff --git a/requirements.txt b/requirements.txt
index 02019bc3..272f9305 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -484,9 +484,9 @@ urllib3==2.2.3 \
     --hash=sha256:ca899ca043dcb1bafa3e262d73aa25c465bfb49e0bd9dd5d59f1d0acba2f8fac \
     --hash=sha256:e7d814a81dad81e6caf2ec9fdedb284ecc9c73076b62654547cc64ccdcae26e9
     # via requests
-wheel==0.44.0 \
-    --hash=sha256:2376a90c98cc337d18623527a97c31797bd02bad0033d41547043a1cbfbe448f \
-    --hash=sha256:a29c3f2817e95ab89aa4660681ad547c0e9547f20e75b0562fe7723c9a2a9d49
+wheel==0.45.1 \
+    --hash=sha256:661e1abd9198507b1409a20c02106d9670b2576e916d58f520316666abca6729 \
+    --hash=sha256:708e7481cc80179af0e556bbf0cc00b8444c7321e2700b8d8580231d13017248
     # via pip-tools
 wrapt==1.16.0 \
     --hash=sha256:0d2691979e93d06a95a26257adb7bfd0c93818e89b1406f5a28f36e0d8c1e1fc \

From 4fc380c1df45d874db59f3c8424b7b4fa9c5d5ae Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:01:30 +0100
Subject: [PATCH 095/133] chore(deps): update dependency google-cloud-spanner
 to v3.50.1 (#508)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 272f9305..90ad9bab 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -157,9 +157,9 @@ google-cloud-core==2.4.1 \
     --hash=sha256:9b7749272a812bde58fff28868d0c5e2f585b82f37e09a1f6ed2d4d10f134073 \
     --hash=sha256:a9e6a4422b9ac5c29f79a0ede9485473338e2ce78d91f2370c01e730eab22e61
     # via google-cloud-spanner
-google-cloud-spanner==3.49.1 \
-    --hash=sha256:261eafb63b0dd55256afcb5f7149b7527e55b5c8aca8059f77771dfe935ab03b \
-    --hash=sha256:c064d1175319f8c9b634a3888de226f4ec70493f7ec08a45321a4b17a47fc3ca
+google-cloud-spanner==3.50.1 \
+    --hash=sha256:82937ea03b55de86bddf622f555aeae65ae86bb4f28ab35bd920ac505917c9bf \
+    --hash=sha256:9d399aa53fae58816023a4eb31fa267333c3a879a9221229e7f06fdda543884a
     # via -r requirements.in
 googleapis-common-protos[grpc]==1.65.0 \
     --hash=sha256:2972e6c496f435b92590fd54045060867f3fe9be2c82ab148fc8885035479a63 \

From dee28e2d2a1569f682618c08e6c7bc27794af52b Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:01:43 +0100
Subject: [PATCH 096/133] chore(deps): update dependency google-api-core to
 v2.23.0 (#509)

---
 .kokoro/requirements.txt | 6 +++---
 requirements.txt         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index adec3916..d85d9cdf 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -269,9 +269,9 @@ gcp-releasetool==2.2.0 \
     --hash=sha256:9ca3a41d397485bb7f6ad7933d64d9071961188f41fc0182e47562b41cebaff2 \
     --hash=sha256:ae0fc2525fdf1eb4638059dee3ec265620e1a85cb89f564615793698b3b422d6
     # via -r requirements.in
-google-api-core==2.22.0 \
-    --hash=sha256:26f8d76b96477db42b55fd02a33aae4a42ec8b86b98b94969b7333a2c828bf35 \
-    --hash=sha256:a6652b6bd51303902494998626653671703c420f6f4c88cfd3f50ed723e9d021
+google-api-core==2.23.0 \
+    --hash=sha256:2ceb087315e6af43f256704b871d99326b1f12a9d6ce99beaedec99ba26a0ace \
+    --hash=sha256:c20100d4c4c41070cf365f1d8ddf5365915291b5eb11b83829fbd1c999b5122f
     # via
     #   google-cloud-core
     #   google-cloud-storage
diff --git a/requirements.txt b/requirements.txt
index 90ad9bab..c5afe282 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -141,9 +141,9 @@ deprecated==1.2.14 \
     # via
     #   opentelemetry-api
     #   opentelemetry-semantic-conventions
-google-api-core[grpc]==2.22.0 \
-    --hash=sha256:26f8d76b96477db42b55fd02a33aae4a42ec8b86b98b94969b7333a2c828bf35 \
-    --hash=sha256:a6652b6bd51303902494998626653671703c420f6f4c88cfd3f50ed723e9d021
+google-api-core[grpc]==2.23.0 \
+    --hash=sha256:2ceb087315e6af43f256704b871d99326b1f12a9d6ce99beaedec99ba26a0ace \
+    --hash=sha256:c20100d4c4c41070cf365f1d8ddf5365915291b5eb11b83829fbd1c999b5122f
     # via
     #   google-cloud-core
     #   google-cloud-spanner

From e804b4c894655eedd4135bdbb5694ad9c912e188 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:01:56 +0100
Subject: [PATCH 097/133] chore(deps): update dependency tomli to v2.1.0 (#510)

---
 .kokoro/requirements.txt | 6 +++---
 requirements.txt         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index d85d9cdf..1754187b 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -584,9 +584,9 @@ six==1.16.0 \
     # via
     #   gcp-docuploader
     #   python-dateutil
-tomli==2.0.2 \
-    --hash=sha256:2ebe24485c53d303f690b0ec092806a085f07af5a5aa1464f3931eec36caaa38 \
-    --hash=sha256:d46d457a85337051c36524bc5349dd91b1877838e2979ac5ced3e710ed8a60ed
+tomli==2.1.0 \
+    --hash=sha256:3f646cae2aec94e17d04973e4249548320197cfabdf130015d023de4b74d8ab8 \
+    --hash=sha256:a5c57c3d1c56f5ccdf89f6523458f60ef716e210fc47c4cfb188c5ba473e0391
     # via -r requirements.in
 twine==5.1.1 \
     --hash=sha256:215dbe7b4b94c2c50a7315c0275d2258399280fbb7d04182c7e55e24b5f93997 \
diff --git a/requirements.txt b/requirements.txt
index c5afe282..a603f6b4 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -469,9 +469,9 @@ sqlparse==0.5.1 \
     --hash=sha256:773dcbf9a5ab44a090f3441e2180efe2560220203dc2f8c0b0fa141e18b505e4 \
     --hash=sha256:bb6b4df465655ef332548e24f08e205afc81b9ab86cb1c45657a7ff173a3a00e
     # via google-cloud-spanner
-tomli==2.0.2 \
-    --hash=sha256:2ebe24485c53d303f690b0ec092806a085f07af5a5aa1464f3931eec36caaa38 \
-    --hash=sha256:d46d457a85337051c36524bc5349dd91b1877838e2979ac5ced3e710ed8a60ed
+tomli==2.1.0 \
+    --hash=sha256:3f646cae2aec94e17d04973e4249548320197cfabdf130015d023de4b74d8ab8 \
+    --hash=sha256:a5c57c3d1c56f5ccdf89f6523458f60ef716e210fc47c4cfb188c5ba473e0391
     # via -r requirements.in
 typing-extensions==4.12.2 \
     --hash=sha256:04e5ca0351e0f3f85c6853954072df659d0d13fac324d0072316b67d7794700d \

From c83546eed1c7fe25df2e9204520c34c9c334a4e4 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:02:08 +0100
Subject: [PATCH 098/133] chore(deps): update dependency gcp-releasetool to
 v2.3.0 (#511)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 1754187b..b37bdaf2 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -265,9 +265,9 @@ gcp-docuploader==0.6.5 \
     --hash=sha256:30221d4ac3e5a2b9c69aa52fdbef68cc3f27d0e6d0d90e220fc024584b8d2318 \
     --hash=sha256:b7458ef93f605b9d46a4bf3a8dc1755dad1f31d030c8679edf304e343b347eea
     # via -r requirements.in
-gcp-releasetool==2.2.0 \
-    --hash=sha256:9ca3a41d397485bb7f6ad7933d64d9071961188f41fc0182e47562b41cebaff2 \
-    --hash=sha256:ae0fc2525fdf1eb4638059dee3ec265620e1a85cb89f564615793698b3b422d6
+gcp-releasetool==2.3.0 \
+    --hash=sha256:510516c6a2135e55503fd58f5c8e9d93506d8fba4ebed381a1eccb3d8f9b6740 \
+    --hash=sha256:804547a3d2e022924bceadcc453fc49e3059a42a607b99e55b1e2a2d10cb5323
     # via -r requirements.in
 google-api-core==2.23.0 \
     --hash=sha256:2ceb087315e6af43f256704b871d99326b1f12a9d6ce99beaedec99ba26a0ace \

From efdb4f297bcb069e036c82df95ca32bd4d14dbd4 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:02:21 +0100
Subject: [PATCH 099/133] chore(deps): update dependency
 googleapis-common-protos to v1.66.0 (#512)

---
 .kokoro/requirements.txt | 6 +++---
 requirements.txt         | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index b37bdaf2..0a1623fe 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -326,9 +326,9 @@ google-resumable-media==2.7.2 \
     --hash=sha256:3ce7551e9fe6d99e9a126101d2536612bb73486721951e9562fee0f90c6ababa \
     --hash=sha256:5280aed4629f2b60b847b0d42f9857fd4935c11af266744df33d8074cae92fe0
     # via google-cloud-storage
-googleapis-common-protos==1.65.0 \
-    --hash=sha256:2972e6c496f435b92590fd54045060867f3fe9be2c82ab148fc8885035479a63 \
-    --hash=sha256:334a29d07cddc3aa01dee4988f9afd9b2916ee2ff49d6b757155dc0d197852c0
+googleapis-common-protos==1.66.0 \
+    --hash=sha256:c3e7b33d15fdca5374cc0a7346dd92ffa847425cc4ea941d970f13680052ec8c \
+    --hash=sha256:d7abcd75fabb2e0ec9f74466401f6c119a0b498e27370e9be4c94cb7e382b8ed
     # via google-api-core
 idna==3.10 \
     --hash=sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9 \
diff --git a/requirements.txt b/requirements.txt
index a603f6b4..207d1a37 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -161,9 +161,9 @@ google-cloud-spanner==3.50.1 \
     --hash=sha256:82937ea03b55de86bddf622f555aeae65ae86bb4f28ab35bd920ac505917c9bf \
     --hash=sha256:9d399aa53fae58816023a4eb31fa267333c3a879a9221229e7f06fdda543884a
     # via -r requirements.in
-googleapis-common-protos[grpc]==1.65.0 \
-    --hash=sha256:2972e6c496f435b92590fd54045060867f3fe9be2c82ab148fc8885035479a63 \
-    --hash=sha256:334a29d07cddc3aa01dee4988f9afd9b2916ee2ff49d6b757155dc0d197852c0
+googleapis-common-protos[grpc]==1.66.0 \
+    --hash=sha256:c3e7b33d15fdca5374cc0a7346dd92ffa847425cc4ea941d970f13680052ec8c \
+    --hash=sha256:d7abcd75fabb2e0ec9f74466401f6c119a0b498e27370e9be4c94cb7e382b8ed
     # via
     #   google-api-core
     #   grpc-google-iam-v1

From 0b5f966b8e72fade3d113f01c50f048ce6d3053c Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:03:00 +0100
Subject: [PATCH 100/133] chore(deps): update dependency sqlparse to v0.5.2
 (#513)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 207d1a37..1e721b70 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -465,9 +465,9 @@ sqlalchemy==2.0.36 \
     # via
     #   -r requirements.in
     #   alembic
-sqlparse==0.5.1 \
-    --hash=sha256:773dcbf9a5ab44a090f3441e2180efe2560220203dc2f8c0b0fa141e18b505e4 \
-    --hash=sha256:bb6b4df465655ef332548e24f08e205afc81b9ab86cb1c45657a7ff173a3a00e
+sqlparse==0.5.2 \
+    --hash=sha256:9e37b35e16d1cc652a2545f0997c1deb23ea28fa1f3eefe609eee3063c3b105f \
+    --hash=sha256:e99bc85c78160918c3e1d9230834ab8d80fc06c59d03f8db2618f65f65dda55e
     # via google-cloud-spanner
 tomli==2.1.0 \
     --hash=sha256:3f646cae2aec94e17d04973e4249548320197cfabdf130015d023de4b74d8ab8 \

From 708df2c189ebef4139b9ade7835f538f133f0a99 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:14:05 +0100
Subject: [PATCH 101/133] chore(deps): update dependency deprecated to v1.2.15
 (#515)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 1e721b70..8e34354c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -135,9 +135,9 @@ click==8.1.7 \
     # via
     #   -r requirements.in
     #   pip-tools
-deprecated==1.2.14 \
-    --hash=sha256:6fac8b097794a90302bdbb17b9b815e732d3c4720583ff1b198499d78470466c \
-    --hash=sha256:e5323eb936458dccc2582dc6f9c322c852a775a27065ff2b0c4970b9d53d01b3
+Deprecated==1.2.15 \
+    --hash=sha256:353bc4a8ac4bfc96800ddab349d89c25dec1079f65fd53acdcc1e0b975b21320 \
+    --hash=sha256:683e561a90de76239796e6b6feac66b99030d2dd3fcf61ef996330f14bbb9b0d
     # via
     #   opentelemetry-api
     #   opentelemetry-semantic-conventions

From 3d65a541cf45af618b791b441280c2b2e681c783 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:14:27 +0100
Subject: [PATCH 102/133] chore(deps): update dependency grpcio to v1.68.0
 (#516)

---
 requirements.txt | 112 +++++++++++++++++++++++------------------------
 1 file changed, 56 insertions(+), 56 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 8e34354c..5410b394 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -176,62 +176,62 @@ grpc-interceptor==0.15.4 \
     --hash=sha256:0035f33228693ed3767ee49d937bac424318db173fef4d2d0170b3215f254d9d \
     --hash=sha256:1f45c0bcb58b6f332f37c637632247c9b02bc6af0fdceb7ba7ce8d2ebbfb0926
     # via google-cloud-spanner
-grpcio==1.67.1 \
-    --hash=sha256:01f616a964e540638af5130469451cf580ba8c7329f45ca998ab66e0c7dcdb04 \
-    --hash=sha256:0489063974d1452436139501bf6b180f63d4977223ee87488fe36858c5725292 \
-    --hash=sha256:0e6f255980afef598a9e64a24efce87b625e3e3c80a45162d111a461a9f92955 \
-    --hash=sha256:0f3e49c738396e93b7ba9016e153eb09e0778e776df6090c1b8c91877cc1c426 \
-    --hash=sha256:178f5db771c4f9a9facb2ab37a434c46cb9be1a75e820f187ee3d1e7805c4f65 \
-    --hash=sha256:1a65b503d008f066e994f34f456e0647e5ceb34cfcec5ad180b1b44020ad4970 \
-    --hash=sha256:1d7616d2ded471231c701489190379e0c311ee0a6c756f3c03e6a62b95a7146e \
-    --hash=sha256:24e8a26dbfc5274d7474c27759b54486b8de23c709d76695237515bc8b5baeab \
-    --hash=sha256:267d1745894200e4c604958da5f856da6293f063327cb049a51fe67348e4f953 \
-    --hash=sha256:299b3d8c4f790c6bcca485f9963b4846dd92cf6f1b65d3697145d005c80f9fe8 \
-    --hash=sha256:3b6c16489326d79ead41689c4b84bc40d522c9a7617219f4ad94bc7f448c5085 \
-    --hash=sha256:3dc2ed4cabea4dc14d5e708c2b426205956077cc5de419b4d4079315017e9732 \
-    --hash=sha256:43112046864317498a33bdc4797ae6a268c36345a910de9b9c17159d8346602f \
-    --hash=sha256:4422581cdc628f77302270ff839a44f4c24fdc57887dc2a45b7e53d8fc2376af \
-    --hash=sha256:4e7b904484a634a0fff132958dabdb10d63e0927398273917da3ee103e8d1f78 \
-    --hash=sha256:5721e66a594a6c4204458004852719b38f3d5522082be9061d6510b455c90afc \
-    --hash=sha256:5db70d32d6703b89912af16d6d45d78406374a8b8ef0d28140351dd0ec610e98 \
-    --hash=sha256:5ed601c4c6008429e3d247ddb367fe8c7259c355757448d7c1ef7bd4a6739e8e \
-    --hash=sha256:60336bff760fbb47d7e86165408126f1dded184448e9a4c892189eb7c9d3f90f \
-    --hash=sha256:608d87d1bdabf9e2868b12338cd38a79969eaf920c89d698ead08f48de9c0f9e \
-    --hash=sha256:60e6a4dcf5af7bbc36fd9f81c9f372e8ae580870a9e4b6eafe948cd334b81cf3 \
-    --hash=sha256:638354e698fd0c6c76b04540a850bf1db27b4d2515a19fcd5cf645c48d3eb1ed \
-    --hash=sha256:699e964923b70f3101393710793289e42845791ea07565654ada0969522d0a38 \
-    --hash=sha256:7818c0454027ae3384235a65210bbf5464bd715450e30a3d40385453a85a70cb \
-    --hash=sha256:786a5b18544622bfb1e25cc08402bd44ea83edfb04b93798d85dca4d1a0b5be5 \
-    --hash=sha256:804c6457c3cd3ec04fe6006c739579b8d35c86ae3298ffca8de57b493524b771 \
-    --hash=sha256:80b866f73224b0634f4312a4674c1be21b2b4afa73cb20953cbbb73a6b36c3cc \
-    --hash=sha256:85f69fdc1d28ce7cff8de3f9c67db2b0ca9ba4449644488c1e0303c146135ddb \
-    --hash=sha256:85f862069b86a305497e74d0dc43c02de3d1d184fc2c180993aa8aa86fbd19b8 \
-    --hash=sha256:8a00efecde9d6fcc3ab00c13f816313c040a28450e5e25739c24f432fc6d3c75 \
-    --hash=sha256:8a23cbcc5bb11ea7dc6163078be36c065db68d915c24f5faa4f872c573bb400f \
-    --hash=sha256:8b0341d66a57f8a3119b77ab32207072be60c9bf79760fa609c5609f2deb1f3f \
-    --hash=sha256:917e8d8994eed1d86b907ba2a61b9f0aef27a2155bca6cbb322430fc7135b7bb \
-    --hash=sha256:95b5f2b857856ed78d72da93cd7d09b6db8ef30102e5e7fe0961fe4d9f7d48e8 \
-    --hash=sha256:9e838cad2176ebd5d4a8bb03955138d6589ce9e2ce5d51c3ada34396dbd2dba8 \
-    --hash=sha256:9fd042de4a82e3e7aca44008ee2fb5da01b3e5adb316348c21980f7f58adc311 \
-    --hash=sha256:a25bdea92b13ff4d7790962190bf6bf5c4639876e01c0f3dda70fc2769616335 \
-    --hash=sha256:a6703916c43b1d468d0756c8077b12017a9fcb6a1ef13faf49e67d20d7ebda62 \
-    --hash=sha256:a93deda571a1bf94ec1f6fcda2872dad3ae538700d94dc283c672a3b508ba3af \
-    --hash=sha256:aa0162e56fd10a5547fac8774c4899fc3e18c1aa4a4759d0ce2cd00d3696ea6b \
-    --hash=sha256:b49359977c6ec9f5d0573ea4e0071ad278ef905aa74e420acc73fd28ce39e9ce \
-    --hash=sha256:beee96c8c0b1a75d556fe57b92b58b4347c77a65781ee2ac749d550f2a365dc1 \
-    --hash=sha256:c7a01337407dd89005527623a4a72c5c8e2894d22bead0895306b23c6695698f \
-    --hash=sha256:c9b929f13677b10f63124c1a410994a401cdd85214ad83ab67cc077fc7e480f0 \
-    --hash=sha256:cdc491ae35a13535fd9196acb5afe1af37c8237df2e54427be3eecda3653127e \
-    --hash=sha256:e279330bef1744040db8fc432becc8a727b84f456ab62b744d3fdb83f327e121 \
-    --hash=sha256:e29ca27bec8e163dca0c98084040edec3bc49afd10f18b412f483cc68c712744 \
-    --hash=sha256:e7d1797a8a3845437d327145959a2c0c47c05947c9eef5ff1a4c80e499dcc6fa \
-    --hash=sha256:ea33986b70f83844cd00814cee4451055cd8cab36f00ac64a31f5bb09b31919e \
-    --hash=sha256:ec74ef02010186185de82cc594058a3ccd8d86821842bbac9873fd4a2cf8be8d \
-    --hash=sha256:f26b0b547eb8d00e195274cdfc63ce64c8fc2d3e2d00b12bf468ece41a0423a0 \
-    --hash=sha256:f5a27dddefe0e2357d3e617b9079b4bfdc91341a91565111a21ed6ebbc51b22d \
-    --hash=sha256:f5b76ff64aaac53fede0cc93abf57894ab2a7362986ba22243d06218b93efe46 \
-    --hash=sha256:f9fff78ba10d4250bfc07a01bd6254a6d87dc67f9627adece85c0b2ed754fa96 \
-    --hash=sha256:fa0c739ad8b1996bd24823950e3cb5152ae91fca1c09cc791190bf1627ffefba
+grpcio==1.68.0 \
+    --hash=sha256:0d230852ba97654453d290e98d6aa61cb48fa5fafb474fb4c4298d8721809354 \
+    --hash=sha256:0efbbd849867e0e569af09e165363ade75cf84f5229b2698d53cf22c7a4f9e21 \
+    --hash=sha256:14331e5c27ed3545360464a139ed279aa09db088f6e9502e95ad4bfa852bb116 \
+    --hash=sha256:15327ab81131ef9b94cb9f45b5bd98803a179c7c61205c8c0ac9aff9d6c4e82a \
+    --hash=sha256:15377bce516b1c861c35e18eaa1c280692bf563264836cece693c0f169b48829 \
+    --hash=sha256:15fa1fe25d365a13bc6d52fcac0e3ee1f9baebdde2c9b3b2425f8a4979fccea1 \
+    --hash=sha256:18668e36e7f4045820f069997834e94e8275910b1f03e078a6020bd464cb2363 \
+    --hash=sha256:2af76ab7c427aaa26aa9187c3e3c42f38d3771f91a20f99657d992afada2294a \
+    --hash=sha256:2bddd04a790b69f7a7385f6a112f46ea0b34c4746f361ebafe9ca0be567c78e9 \
+    --hash=sha256:32a9cb4686eb2e89d97022ecb9e1606d132f85c444354c17a7dbde4a455e4a3b \
+    --hash=sha256:3ac7f10850fd0487fcce169c3c55509101c3bde2a3b454869639df2176b60a03 \
+    --hash=sha256:3b2b559beb2d433129441783e5f42e3be40a9e1a89ec906efabf26591c5cd415 \
+    --hash=sha256:4028b8e9a3bff6f377698587d642e24bd221810c06579a18420a17688e421af7 \
+    --hash=sha256:44bcbebb24363d587472089b89e2ea0ab2e2b4df0e4856ba4c0b087c82412121 \
+    --hash=sha256:46a2d74d4dd8993151c6cd585594c082abe74112c8e4175ddda4106f2ceb022f \
+    --hash=sha256:4df81d78fd1646bf94ced4fb4cd0a7fe2e91608089c522ef17bc7db26e64effd \
+    --hash=sha256:4e300e6978df0b65cc2d100c54e097c10dfc7018b9bd890bbbf08022d47f766d \
+    --hash=sha256:4f1931c7aa85be0fa6cea6af388e576f3bf6baee9e5d481c586980c774debcb4 \
+    --hash=sha256:50992f214264e207e07222703c17d9cfdcc2c46ed5a1ea86843d440148ebbe10 \
+    --hash=sha256:55d3b52fd41ec5772a953612db4e70ae741a6d6ed640c4c89a64f017a1ac02b5 \
+    --hash=sha256:5a180328e92b9a0050958ced34dddcb86fec5a8b332f5a229e353dafc16cd332 \
+    --hash=sha256:619b5d0f29f4f5351440e9343224c3e19912c21aeda44e0c49d0d147a8d01544 \
+    --hash=sha256:6b2f98165ea2790ea159393a2246b56f580d24d7da0d0342c18a085299c40a75 \
+    --hash=sha256:6f9c7ad1a23e1047f827385f4713b5b8c6c7d325705be1dd3e31fb00dcb2f665 \
+    --hash=sha256:79f81b7fbfb136247b70465bd836fa1733043fdee539cd6031cb499e9608a110 \
+    --hash=sha256:7e0a3e72c0e9a1acab77bef14a73a416630b7fd2cbd893c0a873edc47c42c8cd \
+    --hash=sha256:7e7483d39b4a4fddb9906671e9ea21aaad4f031cdfc349fec76bdfa1e404543a \
+    --hash=sha256:88fb2925789cfe6daa20900260ef0a1d0a61283dfb2d2fffe6194396a354c618 \
+    --hash=sha256:8af6137cc4ae8e421690d276e7627cfc726d4293f6607acf9ea7260bd8fc3d7d \
+    --hash=sha256:8b0ff09c81e3aded7a183bc6473639b46b6caa9c1901d6f5e2cba24b95e59e30 \
+    --hash=sha256:8c73f9fbbaee1a132487e31585aa83987ddf626426d703ebcb9a528cf231c9b1 \
+    --hash=sha256:99f06232b5c9138593ae6f2e355054318717d32a9c09cdc5a2885540835067a1 \
+    --hash=sha256:9fe1b141cda52f2ca73e17d2d3c6a9f3f3a0c255c216b50ce616e9dca7e3441d \
+    --hash=sha256:a17278d977746472698460c63abf333e1d806bd41f2224f90dbe9460101c9796 \
+    --hash=sha256:a59f5822f9459bed098ffbceb2713abbf7c6fd13f2b9243461da5c338d0cd6c3 \
+    --hash=sha256:a6213d2f7a22c3c30a479fb5e249b6b7e648e17f364598ff64d08a5136fe488b \
+    --hash=sha256:a831dcc343440969aaa812004685ed322cdb526cd197112d0db303b0da1e8659 \
+    --hash=sha256:afbf45a62ba85a720491bfe9b2642f8761ff348006f5ef67e4622621f116b04a \
+    --hash=sha256:b0cf343c6f4f6aa44863e13ec9ddfe299e0be68f87d68e777328bff785897b05 \
+    --hash=sha256:c03d89df516128febc5a7e760d675b478ba25802447624edf7aa13b1e7b11e2a \
+    --hash=sha256:c1245651f3c9ea92a2db4f95d37b7597db6b246d5892bca6ee8c0e90d76fb73c \
+    --hash=sha256:cc5f0a4f5904b8c25729a0498886b797feb817d1fd3812554ffa39551112c161 \
+    --hash=sha256:dba037ff8d284c8e7ea9a510c8ae0f5b016004f13c3648f72411c464b67ff2fb \
+    --hash=sha256:def1a60a111d24376e4b753db39705adbe9483ef4ca4761f825639d884d5da78 \
+    --hash=sha256:e0d2f68eaa0a755edd9a47d40e50dba6df2bceda66960dee1218da81a2834d27 \
+    --hash=sha256:e0d30f3fee9372796f54d3100b31ee70972eaadcc87314be369360248a3dcffe \
+    --hash=sha256:e18589e747c1e70b60fab6767ff99b2d0c359ea1db8a2cb524477f93cdbedf5b \
+    --hash=sha256:e1e7ed311afb351ff0d0e583a66fcb39675be112d61e7cfd6c8269884a98afbc \
+    --hash=sha256:e46541de8425a4d6829ac6c5d9b16c03c292105fe9ebf78cb1c31e8d242f9155 \
+    --hash=sha256:e694b5928b7b33ca2d3b4d5f9bf8b5888906f181daff6b406f4938f3a997a490 \
+    --hash=sha256:f60fa2adf281fd73ae3a50677572521edca34ba373a45b457b5ebe87c2d01e1d \
+    --hash=sha256:f84890b205692ea813653ece4ac9afa2139eae136e419231b0eec7c39fdbe4c2 \
+    --hash=sha256:f8f695d9576ce836eab27ba7401c60acaf9ef6cf2f70dfe5462055ba3df02cc3 \
+    --hash=sha256:fc05759ffbd7875e0ff2bd877be1438dfe97c9312bbc558c8284a9afa1d0f40e \
+    --hash=sha256:fd2c2d47969daa0e27eadaf15c13b5e92605c5e5953d23c06d0b5239a2f176d3
     # via
     #   google-api-core
     #   googleapis-common-protos

From 77f224485fcc59bf781c3abad1a03c7ca3230aae Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:14:41 +0100
Subject: [PATCH 103/133] chore(deps): update dependency grpcio-status to
 v1.68.0 (#517)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 5410b394..2fa958b9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -238,9 +238,9 @@ grpcio==1.68.0 \
     #   grpc-google-iam-v1
     #   grpc-interceptor
     #   grpcio-status
-grpcio-status==1.67.1 \
-    --hash=sha256:16e6c085950bdacac97c779e6a502ea671232385e6e37f258884d6883392c2bd \
-    --hash=sha256:2bf38395e028ceeecfd8866b081f61628114b384da7d51ae064ddc8d766a5d11
+grpcio-status==1.68.0 \
+    --hash=sha256:0a71b15d989f02df803b4ba85c5bf1f43aeaa58ac021e5f9974b8cadc41f784d \
+    --hash=sha256:8369823de22ab6a2cddb3804669c149ae7a71819e127c2dca7c2322028d52bea
     # via google-api-core
 idna==3.10 \
     --hash=sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9 \

From 051baca8738ce4e8f709ea7239ed0c1d4e7ec9b8 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:15:01 +0100
Subject: [PATCH 104/133] chore(deps): update dependency pyjwt to v2.10.0
 (#518)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 0a1623fe..e7334f5c 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -530,9 +530,9 @@ pygments==2.18.0 \
     # via
     #   readme-renderer
     #   rich
-pyjwt==2.9.0 \
-    --hash=sha256:3b02fb0f44517787776cf48f2ae25d8e14f300e6d7545a4315cee571a415e850 \
-    --hash=sha256:7e1e5b56cc735432a7369cbfa0efe50fa113ebecdc04ae6922deba8b84582d0c
+PyJWT==2.10.0 \
+    --hash=sha256:543b77207db656de204372350926bed5a86201c4cbff159f623f79c7bb487a15 \
+    --hash=sha256:7628a7eb7938959ac1b26e819a1df0fd3259505627b575e4bad6d08f76db695c
     # via gcp-releasetool
 pyparsing==3.2.0 \
     --hash=sha256:93d9577b88da0bbea8cc8334ee8b918ed014968fd2ec383e868fb8afb1ccef84 \

From 6017ec578b3aa60b71a59fb24beb054e6c4ea9ac Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:16:39 +0100
Subject: [PATCH 105/133] chore(deps): update dependency virtualenv to v20.28.0
 (#514)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index e7334f5c..5136ca74 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -602,9 +602,9 @@ urllib3==2.2.3 \
     # via
     #   requests
     #   twine
-virtualenv==20.27.1 \
-    --hash=sha256:142c6be10212543b32c6c45d3d3893dff89112cc588b7d0879ae5a1ec03a47ba \
-    --hash=sha256:f11f1b8a29525562925f745563bfd48b189450f61fb34c4f9cc79dd5aa32a1f4
+virtualenv==20.28.0 \
+    --hash=sha256:23eae1b4516ecd610481eda647f3a7c09aea295055337331bb4e6892ecce47b0 \
+    --hash=sha256:2c9c3262bb8e7b87ea801d715fae4495e6032450c71d2309be9550e7364049aa
     # via nox
 webencodings==0.5.1 \
     --hash=sha256:a0af1213f3c2226497a97e2b3aa01a7e4bee4f403f95be16fc9acd2947514a78 \

From 142cbee3560a0dbe0017c7680f00084860b0e41f Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 26 Nov 2024 15:17:00 +0100
Subject: [PATCH 106/133] chore(deps): update dependency wrapt to v1.17.0
 (#519)

---
 requirements.txt | 137 +++++++++++++++++++++++------------------------
 1 file changed, 66 insertions(+), 71 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 2fa958b9..0ea726d8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -488,77 +488,72 @@ wheel==0.45.1 \
     --hash=sha256:661e1abd9198507b1409a20c02106d9670b2576e916d58f520316666abca6729 \
     --hash=sha256:708e7481cc80179af0e556bbf0cc00b8444c7321e2700b8d8580231d13017248
     # via pip-tools
-wrapt==1.16.0 \
-    --hash=sha256:0d2691979e93d06a95a26257adb7bfd0c93818e89b1406f5a28f36e0d8c1e1fc \
-    --hash=sha256:14d7dc606219cdd7405133c713f2c218d4252f2a469003f8c46bb92d5d095d81 \
-    --hash=sha256:1a5db485fe2de4403f13fafdc231b0dbae5eca4359232d2efc79025527375b09 \
-    --hash=sha256:1acd723ee2a8826f3d53910255643e33673e1d11db84ce5880675954183ec47e \
-    --hash=sha256:1ca9b6085e4f866bd584fb135a041bfc32cab916e69f714a7d1d397f8c4891ca \
-    --hash=sha256:1dd50a2696ff89f57bd8847647a1c363b687d3d796dc30d4dd4a9d1689a706f0 \
-    --hash=sha256:2076fad65c6736184e77d7d4729b63a6d1ae0b70da4868adeec40989858eb3fb \
-    --hash=sha256:2a88e6010048489cda82b1326889ec075a8c856c2e6a256072b28eaee3ccf487 \
-    --hash=sha256:3ebf019be5c09d400cf7b024aa52b1f3aeebeff51550d007e92c3c1c4afc2a40 \
-    --hash=sha256:418abb18146475c310d7a6dc71143d6f7adec5b004ac9ce08dc7a34e2babdc5c \
-    --hash=sha256:43aa59eadec7890d9958748db829df269f0368521ba6dc68cc172d5d03ed8060 \
-    --hash=sha256:44a2754372e32ab315734c6c73b24351d06e77ffff6ae27d2ecf14cf3d229202 \
-    --hash=sha256:490b0ee15c1a55be9c1bd8609b8cecd60e325f0575fc98f50058eae366e01f41 \
-    --hash=sha256:49aac49dc4782cb04f58986e81ea0b4768e4ff197b57324dcbd7699c5dfb40b9 \
-    --hash=sha256:5eb404d89131ec9b4f748fa5cfb5346802e5ee8836f57d516576e61f304f3b7b \
-    --hash=sha256:5f15814a33e42b04e3de432e573aa557f9f0f56458745c2074952f564c50e664 \
-    --hash=sha256:5f370f952971e7d17c7d1ead40e49f32345a7f7a5373571ef44d800d06b1899d \
-    --hash=sha256:66027d667efe95cc4fa945af59f92c5a02c6f5bb6012bff9e60542c74c75c362 \
-    --hash=sha256:66dfbaa7cfa3eb707bbfcd46dab2bc6207b005cbc9caa2199bcbc81d95071a00 \
-    --hash=sha256:685f568fa5e627e93f3b52fda002c7ed2fa1800b50ce51f6ed1d572d8ab3e7fc \
-    --hash=sha256:6906c4100a8fcbf2fa735f6059214bb13b97f75b1a61777fcf6432121ef12ef1 \
-    --hash=sha256:6a42cd0cfa8ffc1915aef79cb4284f6383d8a3e9dcca70c445dcfdd639d51267 \
-    --hash=sha256:6dcfcffe73710be01d90cae08c3e548d90932d37b39ef83969ae135d36ef3956 \
-    --hash=sha256:6f6eac2360f2d543cc875a0e5efd413b6cbd483cb3ad7ebf888884a6e0d2e966 \
-    --hash=sha256:72554a23c78a8e7aa02abbd699d129eead8b147a23c56e08d08dfc29cfdddca1 \
-    --hash=sha256:73870c364c11f03ed072dda68ff7aea6d2a3a5c3fe250d917a429c7432e15228 \
-    --hash=sha256:73aa7d98215d39b8455f103de64391cb79dfcad601701a3aa0dddacf74911d72 \
-    --hash=sha256:75ea7d0ee2a15733684badb16de6794894ed9c55aa5e9903260922f0482e687d \
-    --hash=sha256:7bd2d7ff69a2cac767fbf7a2b206add2e9a210e57947dd7ce03e25d03d2de292 \
-    --hash=sha256:807cc8543a477ab7422f1120a217054f958a66ef7314f76dd9e77d3f02cdccd0 \
-    --hash=sha256:8e9723528b9f787dc59168369e42ae1c3b0d3fadb2f1a71de14531d321ee05b0 \
-    --hash=sha256:9090c9e676d5236a6948330e83cb89969f433b1943a558968f659ead07cb3b36 \
-    --hash=sha256:9153ed35fc5e4fa3b2fe97bddaa7cbec0ed22412b85bcdaf54aeba92ea37428c \
-    --hash=sha256:9159485323798c8dc530a224bd3ffcf76659319ccc7bbd52e01e73bd0241a0c5 \
-    --hash=sha256:941988b89b4fd6b41c3f0bfb20e92bd23746579736b7343283297c4c8cbae68f \
-    --hash=sha256:94265b00870aa407bd0cbcfd536f17ecde43b94fb8d228560a1e9d3041462d73 \
-    --hash=sha256:98b5e1f498a8ca1858a1cdbffb023bfd954da4e3fa2c0cb5853d40014557248b \
-    --hash=sha256:9b201ae332c3637a42f02d1045e1d0cccfdc41f1f2f801dafbaa7e9b4797bfc2 \
-    --hash=sha256:a0ea261ce52b5952bf669684a251a66df239ec6d441ccb59ec7afa882265d593 \
-    --hash=sha256:a33a747400b94b6d6b8a165e4480264a64a78c8a4c734b62136062e9a248dd39 \
-    --hash=sha256:a452f9ca3e3267cd4d0fcf2edd0d035b1934ac2bd7e0e57ac91ad6b95c0c6389 \
-    --hash=sha256:a86373cf37cd7764f2201b76496aba58a52e76dedfaa698ef9e9688bfd9e41cf \
-    --hash=sha256:ac83a914ebaf589b69f7d0a1277602ff494e21f4c2f743313414378f8f50a4cf \
-    --hash=sha256:aefbc4cb0a54f91af643660a0a150ce2c090d3652cf4052a5397fb2de549cd89 \
-    --hash=sha256:b3646eefa23daeba62643a58aac816945cadc0afaf21800a1421eeba5f6cfb9c \
-    --hash=sha256:b47cfad9e9bbbed2339081f4e346c93ecd7ab504299403320bf85f7f85c7d46c \
-    --hash=sha256:b935ae30c6e7400022b50f8d359c03ed233d45b725cfdd299462f41ee5ffba6f \
-    --hash=sha256:bb2dee3874a500de01c93d5c71415fcaef1d858370d405824783e7a8ef5db440 \
-    --hash=sha256:bc57efac2da352a51cc4658878a68d2b1b67dbe9d33c36cb826ca449d80a8465 \
-    --hash=sha256:bf5703fdeb350e36885f2875d853ce13172ae281c56e509f4e6eca049bdfb136 \
-    --hash=sha256:c31f72b1b6624c9d863fc095da460802f43a7c6868c5dda140f51da24fd47d7b \
-    --hash=sha256:c5cd603b575ebceca7da5a3a251e69561bec509e0b46e4993e1cac402b7247b8 \
-    --hash=sha256:d2efee35b4b0a347e0d99d28e884dfd82797852d62fcd7ebdeee26f3ceb72cf3 \
-    --hash=sha256:d462f28826f4657968ae51d2181a074dfe03c200d6131690b7d65d55b0f360f8 \
-    --hash=sha256:d5e49454f19ef621089e204f862388d29e6e8d8b162efce05208913dde5b9ad6 \
-    --hash=sha256:da4813f751142436b075ed7aa012a8778aa43a99f7b36afe9b742d3ed8bdc95e \
-    --hash=sha256:db2e408d983b0e61e238cf579c09ef7020560441906ca990fe8412153e3b291f \
-    --hash=sha256:db98ad84a55eb09b3c32a96c576476777e87c520a34e2519d3e59c44710c002c \
-    --hash=sha256:dbed418ba5c3dce92619656802cc5355cb679e58d0d89b50f116e4a9d5a9603e \
-    --hash=sha256:dcdba5c86e368442528f7060039eda390cc4091bfd1dca41e8046af7c910dda8 \
-    --hash=sha256:decbfa2f618fa8ed81c95ee18a387ff973143c656ef800c9f24fb7e9c16054e2 \
-    --hash=sha256:e4fdb9275308292e880dcbeb12546df7f3e0f96c6b41197e0cf37d2826359020 \
-    --hash=sha256:eb1b046be06b0fce7249f1d025cd359b4b80fc1c3e24ad9eca33e0dcdb2e4a35 \
-    --hash=sha256:eb6e651000a19c96f452c85132811d25e9264d836951022d6e81df2fff38337d \
-    --hash=sha256:ed867c42c268f876097248e05b6117a65bcd1e63b779e916fe2e33cd6fd0d3c3 \
-    --hash=sha256:edfad1d29c73f9b863ebe7082ae9321374ccb10879eeabc84ba3b69f2579d537 \
-    --hash=sha256:f2058f813d4f2b5e3a9eb2eb3faf8f1d99b81c3e51aeda4b168406443e8ba809 \
-    --hash=sha256:f6b2d0c6703c988d334f297aa5df18c45e97b0af3679bb75059e0e0bd8b1069d \
-    --hash=sha256:f8212564d49c50eb4565e502814f694e240c55551a5f1bc841d4fcaabb0a9b8a \
-    --hash=sha256:ffa565331890b90056c01db69c0fe634a776f8019c143a5ae265f9c6bc4bd6d4
+wrapt==1.17.0 \
+    --hash=sha256:0229b247b0fc7dee0d36176cbb79dbaf2a9eb7ecc50ec3121f40ef443155fb1d \
+    --hash=sha256:0698d3a86f68abc894d537887b9bbf84d29bcfbc759e23f4644be27acf6da301 \
+    --hash=sha256:0a0a1a1ec28b641f2a3a2c35cbe86c00051c04fffcfcc577ffcdd707df3f8635 \
+    --hash=sha256:0b48554952f0f387984da81ccfa73b62e52817a4386d070c75e4db7d43a28c4a \
+    --hash=sha256:0f2a28eb35cf99d5f5bd12f5dd44a0f41d206db226535b37b0c60e9da162c3ed \
+    --hash=sha256:140ea00c87fafc42739bd74a94a5a9003f8e72c27c47cd4f61d8e05e6dec8721 \
+    --hash=sha256:16187aa2317c731170a88ef35e8937ae0f533c402872c1ee5e6d079fcf320801 \
+    --hash=sha256:17fcf043d0b4724858f25b8826c36e08f9fb2e475410bece0ec44a22d533da9b \
+    --hash=sha256:18b956061b8db634120b58f668592a772e87e2e78bc1f6a906cfcaa0cc7991c1 \
+    --hash=sha256:2399408ac33ffd5b200480ee858baa58d77dd30e0dd0cab6a8a9547135f30a88 \
+    --hash=sha256:2a0c23b8319848426f305f9cb0c98a6e32ee68a36264f45948ccf8e7d2b941f8 \
+    --hash=sha256:2dfb7cff84e72e7bf975b06b4989477873dcf160b2fd89959c629535df53d4e0 \
+    --hash=sha256:2f495b6754358979379f84534f8dd7a43ff8cff2558dcdea4a148a6e713a758f \
+    --hash=sha256:33539c6f5b96cf0b1105a0ff4cf5db9332e773bb521cc804a90e58dc49b10578 \
+    --hash=sha256:3c34f6896a01b84bab196f7119770fd8466c8ae3dfa73c59c0bb281e7b588ce7 \
+    --hash=sha256:498fec8da10e3e62edd1e7368f4b24aa362ac0ad931e678332d1b209aec93045 \
+    --hash=sha256:4d63f4d446e10ad19ed01188d6c1e1bb134cde8c18b0aa2acfd973d41fcc5ada \
+    --hash=sha256:4e4b4385363de9052dac1a67bfb535c376f3d19c238b5f36bddc95efae15e12d \
+    --hash=sha256:4e547b447073fc0dbfcbff15154c1be8823d10dab4ad401bdb1575e3fdedff1b \
+    --hash=sha256:4f643df3d4419ea3f856c5c3f40fec1d65ea2e89ec812c83f7767c8730f9827a \
+    --hash=sha256:4f763a29ee6a20c529496a20a7bcb16a73de27f5da6a843249c7047daf135977 \
+    --hash=sha256:5ae271862b2142f4bc687bdbfcc942e2473a89999a54231aa1c2c676e28f29ea \
+    --hash=sha256:5d8fd17635b262448ab8f99230fe4dac991af1dabdbb92f7a70a6afac8a7e346 \
+    --hash=sha256:69c40d4655e078ede067a7095544bcec5a963566e17503e75a3a3e0fe2803b13 \
+    --hash=sha256:69d093792dc34a9c4c8a70e4973a3361c7a7578e9cd86961b2bbf38ca71e4e22 \
+    --hash=sha256:6a9653131bda68a1f029c52157fd81e11f07d485df55410401f745007bd6d339 \
+    --hash=sha256:6ff02a91c4fc9b6a94e1c9c20f62ea06a7e375f42fe57587f004d1078ac86ca9 \
+    --hash=sha256:714c12485aa52efbc0fc0ade1e9ab3a70343db82627f90f2ecbc898fdf0bb181 \
+    --hash=sha256:7264cbb4a18dc4acfd73b63e4bcfec9c9802614572025bdd44d0721983fc1d9c \
+    --hash=sha256:73a96fd11d2b2e77d623a7f26e004cc31f131a365add1ce1ce9a19e55a1eef90 \
+    --hash=sha256:74bf625b1b4caaa7bad51d9003f8b07a468a704e0644a700e936c357c17dd45a \
+    --hash=sha256:81b1289e99cf4bad07c23393ab447e5e96db0ab50974a280f7954b071d41b489 \
+    --hash=sha256:8425cfce27b8b20c9b89d77fb50e368d8306a90bf2b6eef2cdf5cd5083adf83f \
+    --hash=sha256:875d240fdbdbe9e11f9831901fb8719da0bd4e6131f83aa9f69b96d18fae7504 \
+    --hash=sha256:879591c2b5ab0a7184258274c42a126b74a2c3d5a329df16d69f9cee07bba6ea \
+    --hash=sha256:89fc28495896097622c3fc238915c79365dd0ede02f9a82ce436b13bd0ab7569 \
+    --hash=sha256:8a5e7cc39a45fc430af1aefc4d77ee6bad72c5bcdb1322cfde852c15192b8bd4 \
+    --hash=sha256:8f8909cdb9f1b237786c09a810e24ee5e15ef17019f7cecb207ce205b9b5fcce \
+    --hash=sha256:914f66f3b6fc7b915d46c1cc424bc2441841083de01b90f9e81109c9759e43ab \
+    --hash=sha256:92a3d214d5e53cb1db8b015f30d544bc9d3f7179a05feb8f16df713cecc2620a \
+    --hash=sha256:948a9bd0fb2c5120457b07e59c8d7210cbc8703243225dbd78f4dfc13c8d2d1f \
+    --hash=sha256:9c900108df470060174108012de06d45f514aa4ec21a191e7ab42988ff42a86c \
+    --hash=sha256:9f2939cd4a2a52ca32bc0b359015718472d7f6de870760342e7ba295be9ebaf9 \
+    --hash=sha256:a4192b45dff127c7d69b3bdfb4d3e47b64179a0b9900b6351859f3001397dabf \
+    --hash=sha256:a8fc931382e56627ec4acb01e09ce66e5c03c384ca52606111cee50d931a342d \
+    --hash=sha256:ad47b095f0bdc5585bced35bd088cbfe4177236c7df9984b3cc46b391cc60627 \
+    --hash=sha256:b1ca5f060e205f72bec57faae5bd817a1560fcfc4af03f414b08fa29106b7e2d \
+    --hash=sha256:ba1739fb38441a27a676f4de4123d3e858e494fac05868b7a281c0a383c098f4 \
+    --hash=sha256:baa7ef4e0886a6f482e00d1d5bcd37c201b383f1d314643dfb0367169f94f04c \
+    --hash=sha256:bb90765dd91aed05b53cd7a87bd7f5c188fcd95960914bae0d32c5e7f899719d \
+    --hash=sha256:bc7f729a72b16ee21795a943f85c6244971724819819a41ddbaeb691b2dd85ad \
+    --hash=sha256:bdf62d25234290db1837875d4dceb2151e4ea7f9fff2ed41c0fde23ed542eb5b \
+    --hash=sha256:c30970bdee1cad6a8da2044febd824ef6dc4cc0b19e39af3085c763fdec7de33 \
+    --hash=sha256:d2c63b93548eda58abf5188e505ffed0229bf675f7c3090f8e36ad55b8cbc371 \
+    --hash=sha256:d751300b94e35b6016d4b1e7d0e7bbc3b5e1751e2405ef908316c2a9024008a1 \
+    --hash=sha256:da427d311782324a376cacb47c1a4adc43f99fd9d996ffc1b3e8529c4074d393 \
+    --hash=sha256:daba396199399ccabafbfc509037ac635a6bc18510ad1add8fd16d4739cdd106 \
+    --hash=sha256:e185ec6060e301a7e5f8461c86fb3640a7beb1a0f0208ffde7a65ec4074931df \
+    --hash=sha256:e4a557d97f12813dc5e18dad9fa765ae44ddd56a672bb5de4825527c847d6379 \
+    --hash=sha256:e5ed16d95fd142e9c72b6c10b06514ad30e846a0d0917ab406186541fe68b451 \
+    --hash=sha256:e711fc1acc7468463bc084d1b68561e40d1eaa135d8c509a65dd534403d83d7b \
+    --hash=sha256:f28b29dc158ca5d6ac396c8e0a2ef45c4e97bb7e65522bfc04c989e6fe814575 \
+    --hash=sha256:f335579a1b485c834849e9075191c9898e0731af45705c2ebf70e0cd5d58beed \
+    --hash=sha256:fce6fee67c318fdfb7f285c29a82d84782ae2579c0e1b385b7f36c6e8074fffb \
+    --hash=sha256:fd136bb85f4568fffca995bd3c8d52080b1e5b225dbf1c2b17b66b4c5fa02838
     # via
     #   deprecated
     #   opentelemetry-instrumentation

From ac644726665213f234ce8ec4dea715c820a670e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Thu, 28 Nov 2024 14:22:34 +0100
Subject: [PATCH 107/133] fix: support THEN RETURN for insert, update, delete
 (#503)

* fix: support THEN RETURN for insert, update, delete

Support THEN RETURN clauses for INSERT, UPDATE, and DELETE statements.

Fixes #498

* test: override insert auto-generated pk test
---
 .../sqlalchemy_spanner/sqlalchemy_spanner.py  |   4 +
 noxfile.py                                    |   2 +-
 .../bit_reversed_sequence_model.py            |  33 +++++
 .../test_bit_reversed_sequence.py             | 137 ++++++++++++++++++
 test/test_suite_20.py                         |  26 ++++
 5 files changed, 201 insertions(+), 1 deletion(-)
 create mode 100644 test/mockserver_tests/bit_reversed_sequence_model.py
 create mode 100644 test/mockserver_tests/test_bit_reversed_sequence.py

diff --git a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
index e57d46a8..e2fb651d 100644
--- a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
+++ b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
@@ -611,6 +611,10 @@ class SpannerDialect(DefaultDialect):
     supports_native_decimal = True
     supports_statement_cache = True
 
+    insert_returning = True
+    update_returning = True
+    delete_returning = True
+
     ddl_compiler = SpannerDDLCompiler
     preparer = SpannerIdentifierPreparer
     statement_compiler = SpannerSQLCompiler
diff --git a/noxfile.py b/noxfile.py
index 2c4b21bc..974daf99 100644
--- a/noxfile.py
+++ b/noxfile.py
@@ -327,7 +327,7 @@ def mockserver(session):
         "9999",
     )
     session.run(
-        "py.test", "--quiet", os.path.join("test/mockserver_tests"), *session.posargs
+        "py.test", "--quiet", os.path.join("test", "mockserver_tests"), *session.posargs
     )
 
 
diff --git a/test/mockserver_tests/bit_reversed_sequence_model.py b/test/mockserver_tests/bit_reversed_sequence_model.py
new file mode 100644
index 00000000..b76cdd3f
--- /dev/null
+++ b/test/mockserver_tests/bit_reversed_sequence_model.py
@@ -0,0 +1,33 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import String, BigInteger, Sequence, TextClause
+from sqlalchemy.orm import DeclarativeBase
+from sqlalchemy.orm import Mapped
+from sqlalchemy.orm import mapped_column
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class Singer(Base):
+    __tablename__ = "singers"
+    id: Mapped[int] = mapped_column(
+        BigInteger,
+        Sequence("singer_id"),
+        server_default=TextClause("GET_NEXT_SEQUENCE_VALUE(SEQUENCE singer_id)"),
+        primary_key=True,
+    )
+    name: Mapped[str] = mapped_column(String)
diff --git a/test/mockserver_tests/test_bit_reversed_sequence.py b/test/mockserver_tests/test_bit_reversed_sequence.py
new file mode 100644
index 00000000..82822d44
--- /dev/null
+++ b/test/mockserver_tests/test_bit_reversed_sequence.py
@@ -0,0 +1,137 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import create_engine
+from sqlalchemy.orm import Session
+from sqlalchemy.testing import eq_, is_instance_of
+from google.cloud.spanner_v1 import (
+    FixedSizePool,
+    ResultSet,
+    BatchCreateSessionsRequest,
+    ExecuteSqlRequest,
+    CommitRequest,
+    GetSessionRequest,
+    BeginTransactionRequest,
+)
+from test.mockserver_tests.mock_server_test_base import (
+    MockServerTestBase,
+    add_result,
+)
+from google.cloud.spanner_admin_database_v1 import UpdateDatabaseDdlRequest
+import google.cloud.spanner_v1.types.type as spanner_type
+import google.cloud.spanner_v1.types.result_set as result_set
+
+
+class TestBitReversedSequence(MockServerTestBase):
+    def test_create_table(self):
+        from test.mockserver_tests.bit_reversed_sequence_model import Base
+
+        add_result(
+            """SELECT true
+FROM INFORMATION_SCHEMA.TABLES
+WHERE TABLE_SCHEMA="" AND TABLE_NAME="singers"
+LIMIT 1
+""",
+            ResultSet(),
+        )
+        add_result(
+            """SELECT true
+                FROM INFORMATION_SCHEMA.SEQUENCES
+                WHERE NAME="singer_id"
+                AND SCHEMA=""
+                LIMIT 1""",
+            ResultSet(),
+        )
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+        Base.metadata.create_all(engine)
+        requests = self.database_admin_service.requests
+        eq_(1, len(requests))
+        is_instance_of(requests[0], UpdateDatabaseDdlRequest)
+        eq_(2, len(requests[0].statements))
+        eq_(
+            "CREATE SEQUENCE singer_id OPTIONS "
+            "(sequence_kind = 'bit_reversed_positive')",
+            requests[0].statements[0],
+        )
+        eq_(
+            "CREATE TABLE singers (\n"
+            "\tid INT64 NOT NULL DEFAULT "
+            "(GET_NEXT_SEQUENCE_VALUE(SEQUENCE singer_id)), \n"
+            "\tname STRING(MAX) NOT NULL\n"
+            ") PRIMARY KEY (id)",
+            requests[0].statements[1],
+        )
+
+    def test_insert_row(self):
+        from test.mockserver_tests.bit_reversed_sequence_model import Singer
+
+        result = result_set.ResultSet(
+            dict(
+                metadata=result_set.ResultSetMetadata(
+                    dict(
+                        row_type=spanner_type.StructType(
+                            dict(
+                                fields=[
+                                    spanner_type.StructType.Field(
+                                        dict(
+                                            name="id",
+                                            type=spanner_type.Type(
+                                                dict(code=spanner_type.TypeCode.INT64)
+                                            ),
+                                        )
+                                    )
+                                ]
+                            )
+                        )
+                    )
+                ),
+                stats=result_set.ResultSetStats(
+                    dict(
+                        row_count_exact=1,
+                    )
+                ),
+            )
+        )
+        result.rows.extend(["1"])
+
+        add_result(
+            "INSERT INTO singers (id, name) "
+            "VALUES ( GET_NEXT_SEQUENCE_VALUE(SEQUENCE singer_id), @a0) "
+            "THEN RETURN singers.id",
+            result,
+        )
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+
+        with Session(engine) as session:
+            singer = Singer(name="Test")
+            session.add(singer)
+            # Flush the session to send the insert statement to the database.
+            session.flush()
+            eq_(1, singer.id)
+            session.commit()
+        # Verify the requests that we got.
+        requests = self.spanner_service.requests
+        eq_(5, len(requests))
+        is_instance_of(requests[0], BatchCreateSessionsRequest)
+        # We should get rid of this extra round-trip for GetSession....
+        is_instance_of(requests[1], GetSessionRequest)
+        is_instance_of(requests[2], BeginTransactionRequest)
+        is_instance_of(requests[3], ExecuteSqlRequest)
+        is_instance_of(requests[4], CommitRequest)
diff --git a/test/test_suite_20.py b/test/test_suite_20.py
index 22b23e0a..dbbc8f88 100644
--- a/test/test_suite_20.py
+++ b/test/test_suite_20.py
@@ -2171,6 +2171,32 @@ def test_autoclose_on_insert(self):
         assert r.is_insert
         assert not r.returns_rows
 
+    def test_autoclose_on_insert_implicit_returning(self, connection):
+        """
+        SPANNER OVERRIDE:
+
+        Cloud Spanner doesn't support tables with an auto increment primary key,
+        following insertions will fail with `400 id must not be NULL in table
+        autoinc_pk`.
+
+        Overriding the tests and adding a manual primary key value to avoid the same
+        failures.
+        """
+        r = connection.execute(
+            # return_defaults() ensures RETURNING will be used,
+            # new in 2.0 as sqlite/mariadb offer both RETURNING and
+            # cursor.lastrowid
+            self.tables.autoinc_pk.insert().return_defaults(),
+            dict(id=2, data="some data"),
+        )
+        assert r._soft_closed
+        assert not r.closed
+        assert r.is_insert
+
+        # Spanner does not return any rows in this case, because the primary key
+        # is not auto-generated.
+        assert not r.returns_rows
+
 
 class BytesTest(_LiteralRoundTripFixture, fixtures.TestBase):
     __backend__ = True

From 98338f187226aa0581e774a38903823eee13c58f Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 28 Nov 2024 15:52:13 +0100
Subject: [PATCH 108/133] chore(deps): update dependency cryptography to v44
 (#521)

---
 .kokoro/requirements.txt | 58 +++++++++++++++++++++-------------------
 1 file changed, 30 insertions(+), 28 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 5136ca74..9fd86335 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -220,34 +220,36 @@ commonmark==0.9.1 \
     --hash=sha256:452f9dc859be7f06631ddcb328b6919c67984aca654e5fefb3914d54691aed60 \
     --hash=sha256:da2f38c92590f83de410ba1a3cbceafbc74fee9def35f9251ba9a971d6d66fd9
     # via rich
-cryptography==43.0.3 \
-    --hash=sha256:0c580952eef9bf68c4747774cde7ec1d85a6e61de97281f2dba83c7d2c806362 \
-    --hash=sha256:0f996e7268af62598f2fc1204afa98a3b5712313a55c4c9d434aef49cadc91d4 \
-    --hash=sha256:1ec0bcf7e17c0c5669d881b1cd38c4972fade441b27bda1051665faaa89bdcaa \
-    --hash=sha256:281c945d0e28c92ca5e5930664c1cefd85efe80e5c0d2bc58dd63383fda29f83 \
-    --hash=sha256:2ce6fae5bdad59577b44e4dfed356944fbf1d925269114c28be377692643b4ff \
-    --hash=sha256:315b9001266a492a6ff443b61238f956b214dbec9910a081ba5b6646a055a805 \
-    --hash=sha256:443c4a81bb10daed9a8f334365fe52542771f25aedaf889fd323a853ce7377d6 \
-    --hash=sha256:4a02ded6cd4f0a5562a8887df8b3bd14e822a90f97ac5e544c162899bc467664 \
-    --hash=sha256:53a583b6637ab4c4e3591a15bc9db855b8d9dee9a669b550f311480acab6eb08 \
-    --hash=sha256:63efa177ff54aec6e1c0aefaa1a241232dcd37413835a9b674b6e3f0ae2bfd3e \
-    --hash=sha256:74f57f24754fe349223792466a709f8e0c093205ff0dca557af51072ff47ab18 \
-    --hash=sha256:7e1ce50266f4f70bf41a2c6dc4358afadae90e2a1e5342d3c08883df1675374f \
-    --hash=sha256:81ef806b1fef6b06dcebad789f988d3b37ccaee225695cf3e07648eee0fc6b73 \
-    --hash=sha256:846da004a5804145a5f441b8530b4bf35afbf7da70f82409f151695b127213d5 \
-    --hash=sha256:8ac43ae87929a5982f5948ceda07001ee5e83227fd69cf55b109144938d96984 \
-    --hash=sha256:9762ea51a8fc2a88b70cf2995e5675b38d93bf36bd67d91721c309df184f49bd \
-    --hash=sha256:a2a431ee15799d6db9fe80c82b055bae5a752bef645bba795e8e52687c69efe3 \
-    --hash=sha256:bf7a1932ac4176486eab36a19ed4c0492da5d97123f1406cf15e41b05e787d2e \
-    --hash=sha256:c2e6fc39c4ab499049df3bdf567f768a723a5e8464816e8f009f121a5a9f4405 \
-    --hash=sha256:cbeb489927bd7af4aa98d4b261af9a5bc025bd87f0e3547e11584be9e9427be2 \
-    --hash=sha256:d03b5621a135bffecad2c73e9f4deb1a0f977b9a8ffe6f8e002bf6c9d07b918c \
-    --hash=sha256:d56e96520b1020449bbace2b78b603442e7e378a9b3bd68de65c782db1507995 \
-    --hash=sha256:df6b6c6d742395dd77a23ea3728ab62f98379eff8fb61be2744d4679ab678f73 \
-    --hash=sha256:e1be4655c7ef6e1bbe6b5d0403526601323420bcf414598955968c9ef3eb7d16 \
-    --hash=sha256:f18c716be16bc1fea8e95def49edf46b82fccaa88587a45f8dc0ff6ab5d8e0a7 \
-    --hash=sha256:f46304d6f0c6ab8e52770addfa2fc41e6629495548862279641972b6215451cd \
-    --hash=sha256:f7b178f11ed3664fd0e995a47ed2b5ff0a12d893e41dd0494f406d1cf555cab7
+cryptography==44.0.0 \
+    --hash=sha256:1923cb251c04be85eec9fda837661c67c1049063305d6be5721643c22dd4e2b7 \
+    --hash=sha256:37d76e6863da3774cd9db5b409a9ecfd2c71c981c38788d3fcfaf177f447b731 \
+    --hash=sha256:3c672a53c0fb4725a29c303be906d3c1fa99c32f58abe008a82705f9ee96f40b \
+    --hash=sha256:404fdc66ee5f83a1388be54300ae978b2efd538018de18556dde92575e05defc \
+    --hash=sha256:4ac4c9f37eba52cb6fbeaf5b59c152ea976726b865bd4cf87883a7e7006cc543 \
+    --hash=sha256:60eb32934076fa07e4316b7b2742fa52cbb190b42c2df2863dbc4230a0a9b385 \
+    --hash=sha256:62901fb618f74d7d81bf408c8719e9ec14d863086efe4185afd07c352aee1d2c \
+    --hash=sha256:660cb7312a08bc38be15b696462fa7cc7cd85c3ed9c576e81f4dc4d8b2b31591 \
+    --hash=sha256:708ee5f1bafe76d041b53a4f95eb28cdeb8d18da17e597d46d7833ee59b97ede \
+    --hash=sha256:761817a3377ef15ac23cd7834715081791d4ec77f9297ee694ca1ee9c2c7e5eb \
+    --hash=sha256:831c3c4d0774e488fdc83a1923b49b9957d33287de923d58ebd3cec47a0ae43f \
+    --hash=sha256:84111ad4ff3f6253820e6d3e58be2cc2a00adb29335d4cacb5ab4d4d34f2a123 \
+    --hash=sha256:8b3e6eae66cf54701ee7d9c83c30ac0a1e3fa17be486033000f2a73a12ab507c \
+    --hash=sha256:9abcc2e083cbe8dde89124a47e5e53ec38751f0d7dfd36801008f316a127d7ba \
+    --hash=sha256:9e6fc8a08e116fb7c7dd1f040074c9d7b51d74a8ea40d4df2fc7aa08b76b9e6c \
+    --hash=sha256:a01956ddfa0a6790d594f5b34fc1bfa6098aca434696a03cfdbe469b8ed79285 \
+    --hash=sha256:abc998e0c0eee3c8a1904221d3f67dcfa76422b23620173e28c11d3e626c21bd \
+    --hash=sha256:b15492a11f9e1b62ba9d73c210e2416724633167de94607ec6069ef724fad092 \
+    --hash=sha256:be4ce505894d15d5c5037167ffb7f0ae90b7be6f2a98f9a5c3442395501c32fa \
+    --hash=sha256:c5eb858beed7835e5ad1faba59e865109f3e52b3783b9ac21e7e47dc5554e289 \
+    --hash=sha256:cd4e834f340b4293430701e772ec543b0fbe6c2dea510a5286fe0acabe153a02 \
+    --hash=sha256:d2436114e46b36d00f8b72ff57e598978b37399d2786fd39793c36c6d5cb1c64 \
+    --hash=sha256:eb33480f1bad5b78233b0ad3e1b0be21e8ef1da745d8d2aecbb20671658b9053 \
+    --hash=sha256:eca27345e1214d1b9f9490d200f9db5a874479be914199194e746c893788d417 \
+    --hash=sha256:ed3534eb1090483c96178fcb0f8893719d96d5274dfde98aa6add34614e97c8e \
+    --hash=sha256:f3f6fdfa89ee2d9d496e2c087cebef9d4fcbb0ad63c40e821b39f74bf48d9c5e \
+    --hash=sha256:f53c2c87e0fb4b0c00fa9571082a057e37690a8f12233306161c8f4b819960b7 \
+    --hash=sha256:f5e7cb1e5e56ca0933b4873c0220a78b773b24d40d186b6738080b73d3d0a756 \
+    --hash=sha256:f677e1268c4e23420c3acade68fac427fffcb8d19d7df95ed7ad17cdef8404f4
     # via gcp-releasetool
 distlib==0.3.9 \
     --hash=sha256:47f8c22fd27c27e25a65601af709b38e4f0a45ea4fc2e710f65755fa8caaaf87 \

From 6d21b9ed1038d8f55843d2debe616a5290332f4a Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 28 Nov 2024 15:52:35 +0100
Subject: [PATCH 109/133] chore(deps): update dependency protobuf to v5.29.0
 (#522)

---
 .kokoro/requirements.txt | 24 ++++++++++++------------
 requirements.txt         | 24 ++++++++++++------------
 2 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 9fd86335..67ecdc7b 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -490,18 +490,18 @@ proto-plus==1.25.0 \
     # via
     #   -r requirements.in
     #   google-api-core
-protobuf==5.28.3 \
-    --hash=sha256:0c4eec6f987338617072592b97943fdbe30d019c56126493111cf24344c1cc24 \
-    --hash=sha256:135658402f71bbd49500322c0f736145731b16fc79dc8f367ab544a17eab4535 \
-    --hash=sha256:27b246b3723692bf1068d5734ddaf2fccc2cdd6e0c9b47fe099244d80200593b \
-    --hash=sha256:3e6101d095dfd119513cde7259aa703d16c6bbdfae2554dfe5cfdbe94e32d548 \
-    --hash=sha256:3fa2de6b8b29d12c61911505d893afe7320ce7ccba4df913e2971461fa36d584 \
-    --hash=sha256:64badbc49180a5e401f373f9ce7ab1d18b63f7dd4a9cdc43c92b9f0b481cef7b \
-    --hash=sha256:70585a70fc2dd4818c51287ceef5bdba6387f88a578c86d47bb34669b5552c36 \
-    --hash=sha256:712319fbdddb46f21abb66cd33cb9e491a5763b2febd8f228251add221981135 \
-    --hash=sha256:91fba8f445723fcf400fdbe9ca796b19d3b1242cd873907979b9ed71e4afe868 \
-    --hash=sha256:a3f6857551e53ce35e60b403b8a27b0295f7d6eb63d10484f12bc6879c715687 \
-    --hash=sha256:cee1757663fa32a1ee673434fcf3bf24dd54763c79690201208bafec62f19eed
+protobuf==5.29.0 \
+    --hash=sha256:0cd67a1e5c2d88930aa767f702773b2d054e29957432d7c6a18f8be02a07719a \
+    --hash=sha256:0d10091d6d03537c3f902279fcf11e95372bdd36a79556311da0487455791b20 \
+    --hash=sha256:17d128eebbd5d8aee80300aed7a43a48a25170af3337f6f1333d1fac2c6839ac \
+    --hash=sha256:34a90cf30c908f47f40ebea7811f743d360e202b6f10d40c02529ebd84afc069 \
+    --hash=sha256:445a0c02483869ed8513a585d80020d012c6dc60075f96fa0563a724987b1001 \
+    --hash=sha256:6c3009e22717c6cc9e6594bb11ef9f15f669b19957ad4087214d69e08a213368 \
+    --hash=sha256:85286a47caf63b34fa92fdc1fd98b649a8895db595cfa746c5286eeae890a0b1 \
+    --hash=sha256:88c4af76a73183e21061881360240c0cdd3c39d263b4e8fb570aaf83348d608f \
+    --hash=sha256:c931c61d0cc143a2e756b1e7f8197a508de5365efd40f83c907a9febf36e6b43 \
+    --hash=sha256:e467f81fdd12ded9655cea3e9b83dc319d93b394ce810b556fb0f421d8613e86 \
+    --hash=sha256:ea7fb379b257911c8c020688d455e8f74efd2f734b72dc1ea4b4d7e9fd1326f2
     # via
     #   gcp-docuploader
     #   gcp-releasetool
diff --git a/requirements.txt b/requirements.txt
index 0ea726d8..0838c63a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -357,18 +357,18 @@ proto-plus==1.25.0 \
     # via
     #   google-api-core
     #   google-cloud-spanner
-protobuf==5.28.3 \
-    --hash=sha256:0c4eec6f987338617072592b97943fdbe30d019c56126493111cf24344c1cc24 \
-    --hash=sha256:135658402f71bbd49500322c0f736145731b16fc79dc8f367ab544a17eab4535 \
-    --hash=sha256:27b246b3723692bf1068d5734ddaf2fccc2cdd6e0c9b47fe099244d80200593b \
-    --hash=sha256:3e6101d095dfd119513cde7259aa703d16c6bbdfae2554dfe5cfdbe94e32d548 \
-    --hash=sha256:3fa2de6b8b29d12c61911505d893afe7320ce7ccba4df913e2971461fa36d584 \
-    --hash=sha256:64badbc49180a5e401f373f9ce7ab1d18b63f7dd4a9cdc43c92b9f0b481cef7b \
-    --hash=sha256:70585a70fc2dd4818c51287ceef5bdba6387f88a578c86d47bb34669b5552c36 \
-    --hash=sha256:712319fbdddb46f21abb66cd33cb9e491a5763b2febd8f228251add221981135 \
-    --hash=sha256:91fba8f445723fcf400fdbe9ca796b19d3b1242cd873907979b9ed71e4afe868 \
-    --hash=sha256:a3f6857551e53ce35e60b403b8a27b0295f7d6eb63d10484f12bc6879c715687 \
-    --hash=sha256:cee1757663fa32a1ee673434fcf3bf24dd54763c79690201208bafec62f19eed
+protobuf==5.29.0 \
+    --hash=sha256:0cd67a1e5c2d88930aa767f702773b2d054e29957432d7c6a18f8be02a07719a \
+    --hash=sha256:0d10091d6d03537c3f902279fcf11e95372bdd36a79556311da0487455791b20 \
+    --hash=sha256:17d128eebbd5d8aee80300aed7a43a48a25170af3337f6f1333d1fac2c6839ac \
+    --hash=sha256:34a90cf30c908f47f40ebea7811f743d360e202b6f10d40c02529ebd84afc069 \
+    --hash=sha256:445a0c02483869ed8513a585d80020d012c6dc60075f96fa0563a724987b1001 \
+    --hash=sha256:6c3009e22717c6cc9e6594bb11ef9f15f669b19957ad4087214d69e08a213368 \
+    --hash=sha256:85286a47caf63b34fa92fdc1fd98b649a8895db595cfa746c5286eeae890a0b1 \
+    --hash=sha256:88c4af76a73183e21061881360240c0cdd3c39d263b4e8fb570aaf83348d608f \
+    --hash=sha256:c931c61d0cc143a2e756b1e7f8197a508de5365efd40f83c907a9febf36e6b43 \
+    --hash=sha256:e467f81fdd12ded9655cea3e9b83dc319d93b394ce810b556fb0f421d8613e86 \
+    --hash=sha256:ea7fb379b257911c8c020688d455e8f74efd2f734b72dc1ea4b4d7e9fd1326f2
     # via
     #   google-api-core
     #   google-cloud-spanner

From 4c4d7316fe52df3260260fc31d246c49083972ba Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 28 Nov 2024 15:52:52 +0100
Subject: [PATCH 110/133] chore(deps): update dependency tomli to v2.2.1 (#523)

---
 .kokoro/requirements.txt | 36 +++++++++++++++++++++++++++++++++---
 requirements.txt         | 36 +++++++++++++++++++++++++++++++++---
 2 files changed, 66 insertions(+), 6 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 67ecdc7b..58ccf31d 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -586,9 +586,39 @@ six==1.16.0 \
     # via
     #   gcp-docuploader
     #   python-dateutil
-tomli==2.1.0 \
-    --hash=sha256:3f646cae2aec94e17d04973e4249548320197cfabdf130015d023de4b74d8ab8 \
-    --hash=sha256:a5c57c3d1c56f5ccdf89f6523458f60ef716e210fc47c4cfb188c5ba473e0391
+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 -r requirements.in
 twine==5.1.1 \
     --hash=sha256:215dbe7b4b94c2c50a7315c0275d2258399280fbb7d04182c7e55e24b5f93997 \
diff --git a/requirements.txt b/requirements.txt
index 0838c63a..9131e5a2 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -469,9 +469,39 @@ sqlparse==0.5.2 \
     --hash=sha256:9e37b35e16d1cc652a2545f0997c1deb23ea28fa1f3eefe609eee3063c3b105f \
     --hash=sha256:e99bc85c78160918c3e1d9230834ab8d80fc06c59d03f8db2618f65f65dda55e
     # via google-cloud-spanner
-tomli==2.1.0 \
-    --hash=sha256:3f646cae2aec94e17d04973e4249548320197cfabdf130015d023de4b74d8ab8 \
-    --hash=sha256:a5c57c3d1c56f5ccdf89f6523458f60ef716e210fc47c4cfb188c5ba473e0391
+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 -r requirements.in
 typing-extensions==4.12.2 \
     --hash=sha256:04e5ca0351e0f3f85c6853954072df659d0d13fac324d0072316b67d7794700d \

From 50a911fa176ebd8b0f982cd4f7ab231598d02d48 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 28 Nov 2024 15:53:11 +0100
Subject: [PATCH 111/133] chore(deps): update dependency pyjwt to v2.10.1
 (#524)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 58ccf31d..0da919e7 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -532,9 +532,9 @@ pygments==2.18.0 \
     # via
     #   readme-renderer
     #   rich
-PyJWT==2.10.0 \
-    --hash=sha256:543b77207db656de204372350926bed5a86201c4cbff159f623f79c7bb487a15 \
-    --hash=sha256:7628a7eb7938959ac1b26e819a1df0fd3259505627b575e4bad6d08f76db695c
+PyJWT==2.10.1 \
+    --hash=sha256:3cc5772eb20009233caf06e9d8a0577824723b44e6648ee0a2aedb6cf9381953 \
+    --hash=sha256:dcdd193e30abefd5debf142f9adfcdd2b58004e644f25406ffaebd50bd98dacb
     # via gcp-releasetool
 pyparsing==3.2.0 \
     --hash=sha256:93d9577b88da0bbea8cc8334ee8b918ed014968fd2ec383e868fb8afb1ccef84 \

From 6ff12ecf6f1883525a901df4b4103b45ca95abed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Thu, 28 Nov 2024 15:54:15 +0100
Subject: [PATCH 112/133] feat: add helper function for insert-or-update (#526)

Adds helper functions for insert-or-update and insert-or-ignore
and samples for how to use these functions.

Fixes #391
---
 google/cloud/sqlalchemy_spanner/dml.py | 26 +++++++++++++
 samples/insert_or_ignore_sample.py     | 54 ++++++++++++++++++++++++++
 samples/insert_or_update_sample.py     | 54 ++++++++++++++++++++++++++
 3 files changed, 134 insertions(+)
 create mode 100644 google/cloud/sqlalchemy_spanner/dml.py
 create mode 100644 samples/insert_or_ignore_sample.py
 create mode 100644 samples/insert_or_update_sample.py

diff --git a/google/cloud/sqlalchemy_spanner/dml.py b/google/cloud/sqlalchemy_spanner/dml.py
new file mode 100644
index 00000000..311aee0d
--- /dev/null
+++ b/google/cloud/sqlalchemy_spanner/dml.py
@@ -0,0 +1,26 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import Insert, insert
+from sqlalchemy.sql._typing import _DMLTableArgument
+
+
+def insert_or_update(table: _DMLTableArgument) -> Insert:
+    """Construct a Spanner-specific insert-or-update statement."""
+    return insert(table).prefix_with("OR UPDATE")
+
+
+def insert_or_ignore(table: _DMLTableArgument) -> Insert:
+    """Construct a Spanner-specific insert-or-ignore statement."""
+    return insert(table).prefix_with("OR IGNORE")
diff --git a/samples/insert_or_ignore_sample.py b/samples/insert_or_ignore_sample.py
new file mode 100644
index 00000000..36fbd492
--- /dev/null
+++ b/samples/insert_or_ignore_sample.py
@@ -0,0 +1,54 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 uuid
+
+from sqlalchemy import create_engine, select
+from sqlalchemy.orm import Session
+
+from google.cloud.sqlalchemy_spanner.dml import insert_or_ignore
+from sample_helper import run_sample
+from model import Singer
+
+# Shows how to use insert-or-ignore using SQLAlchemy and Spanner.
+def insert_or_ignore_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    with Session(engine) as session:
+        stmt = (
+            insert_or_ignore(Singer)
+            .values(
+                id=str(uuid.uuid4()),
+                first_name="John",
+                last_name="Smith",
+            )
+            .returning(Singer.id)
+        )
+        singer_id = session.execute(stmt).scalar()
+        print(singer_id)
+
+        # Use AUTOCOMMIT for sessions that only read. This is more
+        # efficient than using a read/write transaction to only read.
+        session.connection(execution_options={"isolation_level": "AUTOCOMMIT"})
+        stmt = select(Singer).where(Singer.id == singer_id)
+        singer = session.execute(stmt).scalar()
+        print(f"Inserted or ignored singer {singer.full_name} successfully")
+
+
+if __name__ == "__main__":
+    run_sample(insert_or_ignore_sample)
diff --git a/samples/insert_or_update_sample.py b/samples/insert_or_update_sample.py
new file mode 100644
index 00000000..9b23b24a
--- /dev/null
+++ b/samples/insert_or_update_sample.py
@@ -0,0 +1,54 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 uuid
+
+from sqlalchemy import create_engine, select
+from sqlalchemy.orm import Session
+
+from google.cloud.sqlalchemy_spanner.dml import insert_or_update
+from sample_helper import run_sample
+from model import Singer
+
+# Shows how to use insert-or-update using SQLAlchemy and Spanner.
+def insert_or_update_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    with Session(engine) as session:
+        stmt = (
+            insert_or_update(Singer)
+            .values(
+                id=str(uuid.uuid4()),
+                first_name="John",
+                last_name="Smith",
+            )
+            .returning(Singer.id)
+        )
+        singer_id = session.execute(stmt).scalar()
+        print(singer_id)
+
+        # Use AUTOCOMMIT for sessions that only read. This is more
+        # efficient than using a read/write transaction to only read.
+        session.connection(execution_options={"isolation_level": "AUTOCOMMIT"})
+        stmt = select(Singer).where(Singer.id == singer_id)
+        singer = session.execute(stmt).scalar()
+        print(f"Inserted or updated singer {singer.full_name} successfully")
+
+
+if __name__ == "__main__":
+    run_sample(insert_or_update_sample)

From 7e871fcd06e792066c46030cd16bfc5de0c6d53e Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 3 Dec 2024 18:14:29 +0100
Subject: [PATCH 113/133] chore(deps): update dependency nh3 to v0.2.19 (#527)

---
 .kokoro/requirements.txt | 41 +++++++++++++++++++++++-----------------
 1 file changed, 24 insertions(+), 17 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 0da919e7..2e425b36 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -446,23 +446,30 @@ more-itertools==10.5.0 \
     # via
     #   jaraco-classes
     #   jaraco-functools
-nh3==0.2.18 \
-    --hash=sha256:0411beb0589eacb6734f28d5497ca2ed379eafab8ad8c84b31bb5c34072b7164 \
-    --hash=sha256:14c5a72e9fe82aea5fe3072116ad4661af5cf8e8ff8fc5ad3450f123e4925e86 \
-    --hash=sha256:19aaba96e0f795bd0a6c56291495ff59364f4300d4a39b29a0abc9cb3774a84b \
-    --hash=sha256:34c03fa78e328c691f982b7c03d4423bdfd7da69cd707fe572f544cf74ac23ad \
-    --hash=sha256:36c95d4b70530b320b365659bb5034341316e6a9b30f0b25fa9c9eff4c27a204 \
-    --hash=sha256:3a157ab149e591bb638a55c8c6bcb8cdb559c8b12c13a8affaba6cedfe51713a \
-    --hash=sha256:42c64511469005058cd17cc1537578eac40ae9f7200bedcfd1fc1a05f4f8c200 \
-    --hash=sha256:5f36b271dae35c465ef5e9090e1fdaba4a60a56f0bb0ba03e0932a66f28b9189 \
-    --hash=sha256:6955369e4d9f48f41e3f238a9e60f9410645db7e07435e62c6a9ea6135a4907f \
-    --hash=sha256:7b7c2a3c9eb1a827d42539aa64091640bd275b81e097cd1d8d82ef91ffa2e811 \
-    --hash=sha256:8ce0f819d2f1933953fca255db2471ad58184a60508f03e6285e5114b6254844 \
-    --hash=sha256:94a166927e53972a9698af9542ace4e38b9de50c34352b962f4d9a7d4c927af4 \
-    --hash=sha256:a7f1b5b2c15866f2db413a3649a8fe4fd7b428ae58be2c0f6bca5eefd53ca2be \
-    --hash=sha256:c8b3a1cebcba9b3669ed1a84cc65bf005728d2f0bc1ed2a6594a992e817f3a50 \
-    --hash=sha256:de3ceed6e661954871d6cd78b410213bdcb136f79aafe22aa7182e028b8c7307 \
-    --hash=sha256:f0eca9ca8628dbb4e916ae2491d72957fdd35f7a5d326b7032a345f111ac07fe
+nh3==0.2.19 \
+    --hash=sha256:00810cd5275f5c3f44b9eb0e521d1a841ee2f8023622de39ffc7d88bd533d8e0 \
+    --hash=sha256:0b6820fc64f2ff7ef3e7253a093c946a87865c877b3889149a6d21d322ed8dbd \
+    --hash=sha256:11270b16c1b012677e3e2dd166c1aa273388776bf99a3e3677179db5097ee16a \
+    --hash=sha256:2b926f179eb4bce72b651bfdf76f8aa05d167b2b72bc2f3657fd319f40232adc \
+    --hash=sha256:2eb021804e9df1761abeb844bb86648d77aa118a663c82f50ea04110d87ed707 \
+    --hash=sha256:3805161c4e12088bd74752ba69630e915bc30fe666034f47217a2f16b16efc37 \
+    --hash=sha256:5d4f5e2189861b352b73acb803b5f4bb409c2f36275d22717e27d4e0c217ae55 \
+    --hash=sha256:75c7cafb840f24430b009f7368945cb5ca88b2b54bb384ebfba495f16bc9c121 \
+    --hash=sha256:7e98621856b0a911c21faa5eef8f8ea3e691526c2433f9afc2be713cb6fbdb48 \
+    --hash=sha256:833b3b5f1783ce95834a13030300cea00cbdfd64ea29260d01af9c4821da0aa9 \
+    --hash=sha256:a7b928862daddb29805a1010a0282f77f4b8b238a37b5f76bc6c0d16d930fd22 \
+    --hash=sha256:ac536a4b5c073fdadd8f5f4889adabe1cbdae55305366fb870723c96ca7f49c3 \
+    --hash=sha256:b8eb7affc590e542fa7981ef508cd1644f62176bcd10d4429890fc629b47f0bc \
+    --hash=sha256:c2e3f0d18cc101132fe10ab7ef5c4f41411297e639e23b64b5e888ccaad63f41 \
+    --hash=sha256:d0adf00e2b2026fa10a42537b60d161e516f206781c7515e4e97e09f72a8c5d0 \
+    --hash=sha256:d53a4577b6123ca1d7e8483fad3e13cb7eda28913d516bd0a648c1a473aa21a9 \
+    --hash=sha256:d8325d51e47cb5b11f649d55e626d56c76041ba508cd59e0cb1cf687cc7612f1 \
+    --hash=sha256:df8eac98fec80bd6f5fd0ae27a65de14f1e1a65a76d8e2237eb695f9cd1121d9 \
+    --hash=sha256:e3dedd7858a21312f7675841529941035a2ac91057db13402c8fe907aa19205a \
+    --hash=sha256:ec9c8bf86e397cb88c560361f60fdce478b5edb8b93f04ead419b72fbe937ea6 \
+    --hash=sha256:ed06ed78f6b69d57463b46a04f68f270605301e69d80756a8adf7519002de57d \
+    --hash=sha256:fc483dd8d20f8f8c010783a25a84db3bebeadced92d24d34b40d687f8043ac69 \
+    --hash=sha256:fdb20740d24ab9f2a1341458a00a11205294e97e905de060eeab1ceca020c09c
     # via
     #   -r requirements.in
     #   readme-renderer

From e34fcef85542a4449035a0c51130824e0b478898 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 3 Dec 2024 18:15:37 +0100
Subject: [PATCH 114/133] chore(deps): update dependency twine to v6 (#528)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 2e425b36..6b481ff4 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -627,9 +627,9 @@ tomli==2.2.1 \
     --hash=sha256:ece47d672db52ac607a3d9599a9d48dcb2f2f735c6c2d1f34130085bb12b112a \
     --hash=sha256:f4039b9cbc3048b2416cc57ab3bda989a6fcf9b36cf8937f01a6e731b64f80d7
     # via -r requirements.in
-twine==5.1.1 \
-    --hash=sha256:215dbe7b4b94c2c50a7315c0275d2258399280fbb7d04182c7e55e24b5f93997 \
-    --hash=sha256:9aa0825139c02b3434d913545c7b847a21c835e11597f5255842d457da2322db
+twine==6.0.1 \
+    --hash=sha256:36158b09df5406e1c9c1fb8edb24fc2be387709443e7376689b938531582ee27 \
+    --hash=sha256:9c6025b203b51521d53e200f4a08b116dee7500a38591668c6a6033117bdc218
     # via -r requirements.in
 typing-extensions==4.12.2 \
     --hash=sha256:04e5ca0351e0f3f85c6853954072df659d0d13fac324d0072316b67d7794700d \

From ccf0ce2c2e3594a2d2d0039d40ac75d8f200d6bb Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 3 Dec 2024 18:15:55 +0100
Subject: [PATCH 115/133] chore(deps): update dependency grpcio to v1.68.1
 (#529)

---
 requirements.txt | 112 +++++++++++++++++++++++------------------------
 1 file changed, 56 insertions(+), 56 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 9131e5a2..e2cab69c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -176,62 +176,62 @@ grpc-interceptor==0.15.4 \
     --hash=sha256:0035f33228693ed3767ee49d937bac424318db173fef4d2d0170b3215f254d9d \
     --hash=sha256:1f45c0bcb58b6f332f37c637632247c9b02bc6af0fdceb7ba7ce8d2ebbfb0926
     # via google-cloud-spanner
-grpcio==1.68.0 \
-    --hash=sha256:0d230852ba97654453d290e98d6aa61cb48fa5fafb474fb4c4298d8721809354 \
-    --hash=sha256:0efbbd849867e0e569af09e165363ade75cf84f5229b2698d53cf22c7a4f9e21 \
-    --hash=sha256:14331e5c27ed3545360464a139ed279aa09db088f6e9502e95ad4bfa852bb116 \
-    --hash=sha256:15327ab81131ef9b94cb9f45b5bd98803a179c7c61205c8c0ac9aff9d6c4e82a \
-    --hash=sha256:15377bce516b1c861c35e18eaa1c280692bf563264836cece693c0f169b48829 \
-    --hash=sha256:15fa1fe25d365a13bc6d52fcac0e3ee1f9baebdde2c9b3b2425f8a4979fccea1 \
-    --hash=sha256:18668e36e7f4045820f069997834e94e8275910b1f03e078a6020bd464cb2363 \
-    --hash=sha256:2af76ab7c427aaa26aa9187c3e3c42f38d3771f91a20f99657d992afada2294a \
-    --hash=sha256:2bddd04a790b69f7a7385f6a112f46ea0b34c4746f361ebafe9ca0be567c78e9 \
-    --hash=sha256:32a9cb4686eb2e89d97022ecb9e1606d132f85c444354c17a7dbde4a455e4a3b \
-    --hash=sha256:3ac7f10850fd0487fcce169c3c55509101c3bde2a3b454869639df2176b60a03 \
-    --hash=sha256:3b2b559beb2d433129441783e5f42e3be40a9e1a89ec906efabf26591c5cd415 \
-    --hash=sha256:4028b8e9a3bff6f377698587d642e24bd221810c06579a18420a17688e421af7 \
-    --hash=sha256:44bcbebb24363d587472089b89e2ea0ab2e2b4df0e4856ba4c0b087c82412121 \
-    --hash=sha256:46a2d74d4dd8993151c6cd585594c082abe74112c8e4175ddda4106f2ceb022f \
-    --hash=sha256:4df81d78fd1646bf94ced4fb4cd0a7fe2e91608089c522ef17bc7db26e64effd \
-    --hash=sha256:4e300e6978df0b65cc2d100c54e097c10dfc7018b9bd890bbbf08022d47f766d \
-    --hash=sha256:4f1931c7aa85be0fa6cea6af388e576f3bf6baee9e5d481c586980c774debcb4 \
-    --hash=sha256:50992f214264e207e07222703c17d9cfdcc2c46ed5a1ea86843d440148ebbe10 \
-    --hash=sha256:55d3b52fd41ec5772a953612db4e70ae741a6d6ed640c4c89a64f017a1ac02b5 \
-    --hash=sha256:5a180328e92b9a0050958ced34dddcb86fec5a8b332f5a229e353dafc16cd332 \
-    --hash=sha256:619b5d0f29f4f5351440e9343224c3e19912c21aeda44e0c49d0d147a8d01544 \
-    --hash=sha256:6b2f98165ea2790ea159393a2246b56f580d24d7da0d0342c18a085299c40a75 \
-    --hash=sha256:6f9c7ad1a23e1047f827385f4713b5b8c6c7d325705be1dd3e31fb00dcb2f665 \
-    --hash=sha256:79f81b7fbfb136247b70465bd836fa1733043fdee539cd6031cb499e9608a110 \
-    --hash=sha256:7e0a3e72c0e9a1acab77bef14a73a416630b7fd2cbd893c0a873edc47c42c8cd \
-    --hash=sha256:7e7483d39b4a4fddb9906671e9ea21aaad4f031cdfc349fec76bdfa1e404543a \
-    --hash=sha256:88fb2925789cfe6daa20900260ef0a1d0a61283dfb2d2fffe6194396a354c618 \
-    --hash=sha256:8af6137cc4ae8e421690d276e7627cfc726d4293f6607acf9ea7260bd8fc3d7d \
-    --hash=sha256:8b0ff09c81e3aded7a183bc6473639b46b6caa9c1901d6f5e2cba24b95e59e30 \
-    --hash=sha256:8c73f9fbbaee1a132487e31585aa83987ddf626426d703ebcb9a528cf231c9b1 \
-    --hash=sha256:99f06232b5c9138593ae6f2e355054318717d32a9c09cdc5a2885540835067a1 \
-    --hash=sha256:9fe1b141cda52f2ca73e17d2d3c6a9f3f3a0c255c216b50ce616e9dca7e3441d \
-    --hash=sha256:a17278d977746472698460c63abf333e1d806bd41f2224f90dbe9460101c9796 \
-    --hash=sha256:a59f5822f9459bed098ffbceb2713abbf7c6fd13f2b9243461da5c338d0cd6c3 \
-    --hash=sha256:a6213d2f7a22c3c30a479fb5e249b6b7e648e17f364598ff64d08a5136fe488b \
-    --hash=sha256:a831dcc343440969aaa812004685ed322cdb526cd197112d0db303b0da1e8659 \
-    --hash=sha256:afbf45a62ba85a720491bfe9b2642f8761ff348006f5ef67e4622621f116b04a \
-    --hash=sha256:b0cf343c6f4f6aa44863e13ec9ddfe299e0be68f87d68e777328bff785897b05 \
-    --hash=sha256:c03d89df516128febc5a7e760d675b478ba25802447624edf7aa13b1e7b11e2a \
-    --hash=sha256:c1245651f3c9ea92a2db4f95d37b7597db6b246d5892bca6ee8c0e90d76fb73c \
-    --hash=sha256:cc5f0a4f5904b8c25729a0498886b797feb817d1fd3812554ffa39551112c161 \
-    --hash=sha256:dba037ff8d284c8e7ea9a510c8ae0f5b016004f13c3648f72411c464b67ff2fb \
-    --hash=sha256:def1a60a111d24376e4b753db39705adbe9483ef4ca4761f825639d884d5da78 \
-    --hash=sha256:e0d2f68eaa0a755edd9a47d40e50dba6df2bceda66960dee1218da81a2834d27 \
-    --hash=sha256:e0d30f3fee9372796f54d3100b31ee70972eaadcc87314be369360248a3dcffe \
-    --hash=sha256:e18589e747c1e70b60fab6767ff99b2d0c359ea1db8a2cb524477f93cdbedf5b \
-    --hash=sha256:e1e7ed311afb351ff0d0e583a66fcb39675be112d61e7cfd6c8269884a98afbc \
-    --hash=sha256:e46541de8425a4d6829ac6c5d9b16c03c292105fe9ebf78cb1c31e8d242f9155 \
-    --hash=sha256:e694b5928b7b33ca2d3b4d5f9bf8b5888906f181daff6b406f4938f3a997a490 \
-    --hash=sha256:f60fa2adf281fd73ae3a50677572521edca34ba373a45b457b5ebe87c2d01e1d \
-    --hash=sha256:f84890b205692ea813653ece4ac9afa2139eae136e419231b0eec7c39fdbe4c2 \
-    --hash=sha256:f8f695d9576ce836eab27ba7401c60acaf9ef6cf2f70dfe5462055ba3df02cc3 \
-    --hash=sha256:fc05759ffbd7875e0ff2bd877be1438dfe97c9312bbc558c8284a9afa1d0f40e \
-    --hash=sha256:fd2c2d47969daa0e27eadaf15c13b5e92605c5e5953d23c06d0b5239a2f176d3
+grpcio==1.68.1 \
+    --hash=sha256:025f790c056815b3bf53da850dd70ebb849fd755a4b1ac822cb65cd631e37d43 \
+    --hash=sha256:04cfd68bf4f38f5bb959ee2361a7546916bd9a50f78617a346b3aeb2b42e2161 \
+    --hash=sha256:0feb02205a27caca128627bd1df4ee7212db051019a9afa76f4bb6a1a80ca95e \
+    --hash=sha256:1098f03dedc3b9810810568060dea4ac0822b4062f537b0f53aa015269be0a76 \
+    --hash=sha256:12941d533f3cd45d46f202e3667be8ebf6bcb3573629c7ec12c3e211d99cfccf \
+    --hash=sha256:255b1635b0ed81e9f91da4fcc8d43b7ea5520090b9a9ad9340d147066d1d3613 \
+    --hash=sha256:298ee7f80e26f9483f0b6f94cc0a046caf54400a11b644713bb5b3d8eb387600 \
+    --hash=sha256:2c4cec6177bf325eb6faa6bd834d2ff6aa8bb3b29012cceb4937b86f8b74323c \
+    --hash=sha256:2cc1fd04af8399971bcd4f43bd98c22d01029ea2e56e69c34daf2bf8470e47f5 \
+    --hash=sha256:334ab917792904245a028f10e803fcd5b6f36a7b2173a820c0b5b076555825e1 \
+    --hash=sha256:3522c77d7e6606d6665ec8d50e867f13f946a4e00c7df46768f1c85089eae515 \
+    --hash=sha256:37ea3be171f3cf3e7b7e412a98b77685eba9d4fd67421f4a34686a63a65d99f9 \
+    --hash=sha256:390eee4225a661c5cd133c09f5da1ee3c84498dc265fd292a6912b65c421c78c \
+    --hash=sha256:3aed6544e4d523cd6b3119b0916cef3d15ef2da51e088211e4d1eb91a6c7f4f1 \
+    --hash=sha256:3ceb56c4285754e33bb3c2fa777d055e96e6932351a3082ce3559be47f8024f0 \
+    --hash=sha256:44a8502dd5de653ae6a73e2de50a401d84184f0331d0ac3daeb044e66d5c5054 \
+    --hash=sha256:4b177f5547f1b995826ef529d2eef89cca2f830dd8b2c99ffd5fde4da734ba73 \
+    --hash=sha256:4efac5481c696d5cb124ff1c119a78bddbfdd13fc499e3bc0ca81e95fc573684 \
+    --hash=sha256:52fbf85aa71263380d330f4fce9f013c0798242e31ede05fcee7fbe40ccfc20d \
+    --hash=sha256:55857c71641064f01ff0541a1776bfe04a59db5558e82897d35a7793e525774c \
+    --hash=sha256:66a24f3d45c33550703f0abb8b656515b0ab777970fa275693a2f6dc8e35f1c1 \
+    --hash=sha256:6ab2d912ca39c51f46baf2a0d92aa265aa96b2443266fc50d234fa88bf877d8e \
+    --hash=sha256:77d65165fc35cff6e954e7fd4229e05ec76102d4406d4576528d3a3635fc6172 \
+    --hash=sha256:7dfc914cc31c906297b30463dde0b9be48e36939575eaf2a0a22a8096e69afe5 \
+    --hash=sha256:7f20ebec257af55694d8f993e162ddf0d36bd82d4e57f74b31c67b3c6d63d8b2 \
+    --hash=sha256:80af6f1e69c5e68a2be529990684abdd31ed6622e988bf18850075c81bb1ad6e \
+    --hash=sha256:83bbf5807dc3ee94ce1de2dfe8a356e1d74101e4b9d7aa8c720cc4818a34aded \
+    --hash=sha256:8720c25cd9ac25dd04ee02b69256d0ce35bf8a0f29e20577427355272230965a \
+    --hash=sha256:8829924fffb25386995a31998ccbbeaa7367223e647e0122043dfc485a87c666 \
+    --hash=sha256:8a3869a6661ec8f81d93f4597da50336718bde9eb13267a699ac7e0a1d6d0bea \
+    --hash=sha256:8cb620037a2fd9eeee97b4531880e439ebfcd6d7d78f2e7dcc3726428ab5ef63 \
+    --hash=sha256:919d7f18f63bcad3a0f81146188e90274fde800a94e35d42ffe9eadf6a9a6330 \
+    --hash=sha256:95c87ce2a97434dffe7327a4071839ab8e8bffd0054cc74cbe971fba98aedd60 \
+    --hash=sha256:963cc8d7d79b12c56008aabd8b457f400952dbea8997dd185f155e2f228db079 \
+    --hash=sha256:96f473cdacfdd506008a5d7579c9f6a7ff245a9ade92c3c0265eb76cc591914f \
+    --hash=sha256:9d1fae6bbf0816415b81db1e82fb3bf56f7857273c84dcbe68cbe046e58e1ccd \
+    --hash=sha256:a0c8ddabef9c8f41617f213e527254c41e8b96ea9d387c632af878d05db9229c \
+    --hash=sha256:a1b988b40f2fd9de5c820f3a701a43339d8dcf2cb2f1ca137e2c02671cc83ac1 \
+    --hash=sha256:a47faedc9ea2e7a3b6569795c040aae5895a19dde0c728a48d3c5d7995fda385 \
+    --hash=sha256:a8040f85dcb9830d8bbb033ae66d272614cec6faceee88d37a88a9bd1a7a704e \
+    --hash=sha256:b33bd114fa5a83f03ec6b7b262ef9f5cac549d4126f1dc702078767b10c46ed9 \
+    --hash=sha256:c08079b4934b0bf0a8847f42c197b1d12cba6495a3d43febd7e99ecd1cdc8d54 \
+    --hash=sha256:c28848761a6520c5c6071d2904a18d339a796ebe6b800adc8b3f474c5ce3c3ad \
+    --hash=sha256:cb400138e73969eb5e0535d1d06cae6a6f7a15f2cc74add320e2130b8179211a \
+    --hash=sha256:cbb5780e2e740b6b4f2d208e90453591036ff80c02cc605fea1af8e6fc6b1bbe \
+    --hash=sha256:ccf2ebd2de2d6661e2520dae293298a3803a98ebfc099275f113ce1f6c2a80f1 \
+    --hash=sha256:d35740e3f45f60f3c37b1e6f2f4702c23867b9ce21c6410254c9c682237da68d \
+    --hash=sha256:d99abcd61760ebb34bdff37e5a3ba333c5cc09feda8c1ad42547bea0416ada78 \
+    --hash=sha256:ddda1aa22495d8acd9dfbafff2866438d12faec4d024ebc2e656784d96328ad0 \
+    --hash=sha256:dffd29a2961f3263a16d73945b57cd44a8fd0b235740cb14056f0612329b345e \
+    --hash=sha256:e4842e4872ae4ae0f5497bf60a0498fa778c192cc7a9e87877abd2814aca9475 \
+    --hash=sha256:e8dbe3e00771bfe3d04feed8210fc6617006d06d9a2679b74605b9fed3e8362c \
+    --hash=sha256:ee2e743e51cb964b4975de572aa8fb95b633f496f9fcb5e257893df3be854746 \
+    --hash=sha256:eeb38ff04ab6e5756a2aef6ad8d94e89bb4a51ef96e20f45c44ba190fa0bcaad \
+    --hash=sha256:f8261fa2a5f679abeb2a0a93ad056d765cdca1c47745eda3f2d87f874ff4b8c9
     # via
     #   google-api-core
     #   googleapis-common-protos

From 6ea6776b295b09e202d6f61de70ebc3c6813fe87 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Tue, 3 Dec 2024 18:16:08 +0100
Subject: [PATCH 116/133] chore(deps): update dependency grpcio-status to
 v1.68.1 (#530)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index e2cab69c..b638d478 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -238,9 +238,9 @@ grpcio==1.68.1 \
     #   grpc-google-iam-v1
     #   grpc-interceptor
     #   grpcio-status
-grpcio-status==1.68.0 \
-    --hash=sha256:0a71b15d989f02df803b4ba85c5bf1f43aeaa58ac021e5f9974b8cadc41f784d \
-    --hash=sha256:8369823de22ab6a2cddb3804669c149ae7a71819e127c2dca7c2322028d52bea
+grpcio-status==1.68.1 \
+    --hash=sha256:66f3d8847f665acfd56221333d66f7ad8927903d87242a482996bdb45e8d28fd \
+    --hash=sha256:e1378d036c81a1610d7b4c7a146cd663dd13fcc915cf4d7d053929dba5bbb6e1
     # via google-api-core
 idna==3.10 \
     --hash=sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9 \

From 0fafa54a8e7ba20681d7a5f479c29060fd513c60 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Wed, 4 Dec 2024 12:20:45 +0100
Subject: [PATCH 117/133] chore(deps): update dependency pkginfo to v1.12.0
 (#532)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 6b481ff4..36440e8b 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -483,9 +483,9 @@ packaging==24.2 \
     # via
     #   gcp-releasetool
     #   nox
-pkginfo==1.10.0 \
-    --hash=sha256:5df73835398d10db79f8eecd5cd86b1f6d29317589ea70796994d49399af6297 \
-    --hash=sha256:889a6da2ed7ffc58ab5b900d888ddce90bce912f2d2de1dc1c26f4cb9fe65097
+pkginfo==1.12.0 \
+    --hash=sha256:8ad91a0445a036782b9366ef8b8c2c50291f83a553478ba8580c73d3215700cf \
+    --hash=sha256:dcd589c9be4da8973eceffa247733c144812759aa67eaf4bbf97016a02f39088
     # via twine
 platformdirs==4.3.6 \
     --hash=sha256:357fb2acbc885b0419afd3ce3ed34564c13c9b95c89360cd9563f73aa5e2b907 \

From 3944cea4664ee46401014f8b652548f7623e4646 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Wed, 4 Dec 2024 14:10:15 +0100
Subject: [PATCH 118/133] chore(deps): update dependency mako to v1.3.7 (#535)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index b638d478..6cf0222e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -250,9 +250,9 @@ importlib-metadata==8.5.0 \
     --hash=sha256:45e54197d28b7a7f1559e60b95e7c567032b602131fbd588f1497f47880aa68b \
     --hash=sha256:71522656f0abace1d072b9e5481a48f07c138e00f079c38c8f883823f9c26bd7
     # via opentelemetry-api
-mako==1.3.6 \
-    --hash=sha256:9ec3a1583713479fae654f83ed9fa8c9a4c16b7bb0daba0e6bbebff50c0d983d \
-    --hash=sha256:a91198468092a2f1a0de86ca92690fb0cfc43ca90ee17e15d93662b4c04b241a
+Mako==1.3.7 \
+    --hash=sha256:20405b1232e0759f0e7d87b01f6bb94fce0761747f1cb876ecf90bd512d0b639 \
+    --hash=sha256:d18f990ad57f800ce8e76cbfb0b74afe471c293517e9f5003ace6dad5aa72c36
     # via alembic
 markupsafe==3.0.2 \
     --hash=sha256:0bff5e0ae4ef2e1ae4fdf2dfd5b76c75e5c2fa4132d05fc1b0dabcd20c7e28c4 \

From 7bb914b7d0f5b2032287c3bf1fa4258def17347f Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 5 Dec 2024 16:17:25 +0100
Subject: [PATCH 119/133] chore(deps): update dependency google-cloud-storage
 to v2.19.0 (#538)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 36440e8b..f4183ce0 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -289,9 +289,9 @@ google-cloud-core==2.4.1 \
     --hash=sha256:9b7749272a812bde58fff28868d0c5e2f585b82f37e09a1f6ed2d4d10f134073 \
     --hash=sha256:a9e6a4422b9ac5c29f79a0ede9485473338e2ce78d91f2370c01e730eab22e61
     # via google-cloud-storage
-google-cloud-storage==2.18.2 \
-    --hash=sha256:97a4d45c368b7d401ed48c4fdfe86e1e1cb96401c9e199e419d289e2c0370166 \
-    --hash=sha256:aaf7acd70cdad9f274d29332673fcab98708d0e1f4dceb5a5356aaef06af4d99
+google-cloud-storage==2.19.0 \
+    --hash=sha256:aeb971b5c29cf8ab98445082cbfe7b161a1f48ed275822f59ed3f1524ea54fba \
+    --hash=sha256:cd05e9e7191ba6cb68934d8eb76054d9be4562aa89dbc4236feee4d7d51342b2
     # via gcp-docuploader
 google-crc32c==1.6.0 \
     --hash=sha256:05e2d8c9a2f853ff116db9706b4a27350587f341eda835f46db3c0a8c8ce2f24 \

From 0ce9e609144938e35935687c8ef3ef240d57d406 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 5 Dec 2024 16:18:09 +0100
Subject: [PATCH 120/133] chore(deps): update dependency protobuf to v5.29.1
 (#537)

---
 .kokoro/requirements.txt | 24 ++++++++++++------------
 requirements.txt         | 24 ++++++++++++------------
 2 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index f4183ce0..89187a7d 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -497,18 +497,18 @@ proto-plus==1.25.0 \
     # via
     #   -r requirements.in
     #   google-api-core
-protobuf==5.29.0 \
-    --hash=sha256:0cd67a1e5c2d88930aa767f702773b2d054e29957432d7c6a18f8be02a07719a \
-    --hash=sha256:0d10091d6d03537c3f902279fcf11e95372bdd36a79556311da0487455791b20 \
-    --hash=sha256:17d128eebbd5d8aee80300aed7a43a48a25170af3337f6f1333d1fac2c6839ac \
-    --hash=sha256:34a90cf30c908f47f40ebea7811f743d360e202b6f10d40c02529ebd84afc069 \
-    --hash=sha256:445a0c02483869ed8513a585d80020d012c6dc60075f96fa0563a724987b1001 \
-    --hash=sha256:6c3009e22717c6cc9e6594bb11ef9f15f669b19957ad4087214d69e08a213368 \
-    --hash=sha256:85286a47caf63b34fa92fdc1fd98b649a8895db595cfa746c5286eeae890a0b1 \
-    --hash=sha256:88c4af76a73183e21061881360240c0cdd3c39d263b4e8fb570aaf83348d608f \
-    --hash=sha256:c931c61d0cc143a2e756b1e7f8197a508de5365efd40f83c907a9febf36e6b43 \
-    --hash=sha256:e467f81fdd12ded9655cea3e9b83dc319d93b394ce810b556fb0f421d8613e86 \
-    --hash=sha256:ea7fb379b257911c8c020688d455e8f74efd2f734b72dc1ea4b4d7e9fd1326f2
+protobuf==5.29.1 \
+    --hash=sha256:012ce28d862ff417fd629285aca5d9772807f15ceb1a0dbd15b88f58c776c98c \
+    --hash=sha256:027fbcc48cea65a6b17028510fdd054147057fa78f4772eb547b9274e5219331 \
+    --hash=sha256:1fc55267f086dd4050d18ef839d7bd69300d0d08c2a53ca7df3920cc271a3c34 \
+    --hash=sha256:22c1f539024241ee545cbcb00ee160ad1877975690b16656ff87dde107b5f110 \
+    --hash=sha256:32600ddb9c2a53dedc25b8581ea0f1fd8ea04956373c0c07577ce58d312522e0 \
+    --hash=sha256:50879eb0eb1246e3a5eabbbe566b44b10348939b7cc1b267567e8c3d07213853 \
+    --hash=sha256:5a41deccfa5e745cef5c65a560c76ec0ed8e70908a67cc8f4da5fce588b50d57 \
+    --hash=sha256:683be02ca21a6ffe80db6dd02c0b5b2892322c59ca57fd6c872d652cb80549cb \
+    --hash=sha256:8ee1461b3af56145aca2800e6a3e2f928108c749ba8feccc6f5dd0062c410c0d \
+    --hash=sha256:b5ba1d0e4c8a40ae0496d0e2ecfdbb82e1776928a205106d14ad6985a09ec155 \
+    --hash=sha256:d473655e29c0c4bbf8b69e9a8fb54645bc289dead6d753b952e7aa660254ae18
     # via
     #   gcp-docuploader
     #   gcp-releasetool
diff --git a/requirements.txt b/requirements.txt
index 6cf0222e..6e90193d 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -357,18 +357,18 @@ proto-plus==1.25.0 \
     # via
     #   google-api-core
     #   google-cloud-spanner
-protobuf==5.29.0 \
-    --hash=sha256:0cd67a1e5c2d88930aa767f702773b2d054e29957432d7c6a18f8be02a07719a \
-    --hash=sha256:0d10091d6d03537c3f902279fcf11e95372bdd36a79556311da0487455791b20 \
-    --hash=sha256:17d128eebbd5d8aee80300aed7a43a48a25170af3337f6f1333d1fac2c6839ac \
-    --hash=sha256:34a90cf30c908f47f40ebea7811f743d360e202b6f10d40c02529ebd84afc069 \
-    --hash=sha256:445a0c02483869ed8513a585d80020d012c6dc60075f96fa0563a724987b1001 \
-    --hash=sha256:6c3009e22717c6cc9e6594bb11ef9f15f669b19957ad4087214d69e08a213368 \
-    --hash=sha256:85286a47caf63b34fa92fdc1fd98b649a8895db595cfa746c5286eeae890a0b1 \
-    --hash=sha256:88c4af76a73183e21061881360240c0cdd3c39d263b4e8fb570aaf83348d608f \
-    --hash=sha256:c931c61d0cc143a2e756b1e7f8197a508de5365efd40f83c907a9febf36e6b43 \
-    --hash=sha256:e467f81fdd12ded9655cea3e9b83dc319d93b394ce810b556fb0f421d8613e86 \
-    --hash=sha256:ea7fb379b257911c8c020688d455e8f74efd2f734b72dc1ea4b4d7e9fd1326f2
+protobuf==5.29.1 \
+    --hash=sha256:012ce28d862ff417fd629285aca5d9772807f15ceb1a0dbd15b88f58c776c98c \
+    --hash=sha256:027fbcc48cea65a6b17028510fdd054147057fa78f4772eb547b9274e5219331 \
+    --hash=sha256:1fc55267f086dd4050d18ef839d7bd69300d0d08c2a53ca7df3920cc271a3c34 \
+    --hash=sha256:22c1f539024241ee545cbcb00ee160ad1877975690b16656ff87dde107b5f110 \
+    --hash=sha256:32600ddb9c2a53dedc25b8581ea0f1fd8ea04956373c0c07577ce58d312522e0 \
+    --hash=sha256:50879eb0eb1246e3a5eabbbe566b44b10348939b7cc1b267567e8c3d07213853 \
+    --hash=sha256:5a41deccfa5e745cef5c65a560c76ec0ed8e70908a67cc8f4da5fce588b50d57 \
+    --hash=sha256:683be02ca21a6ffe80db6dd02c0b5b2892322c59ca57fd6c872d652cb80549cb \
+    --hash=sha256:8ee1461b3af56145aca2800e6a3e2f928108c749ba8feccc6f5dd0062c410c0d \
+    --hash=sha256:b5ba1d0e4c8a40ae0496d0e2ecfdbb82e1776928a205106d14ad6985a09ec155 \
+    --hash=sha256:d473655e29c0c4bbf8b69e9a8fb54645bc289dead6d753b952e7aa660254ae18
     # via
     #   google-api-core
     #   google-cloud-spanner

From a633c23bc8cbae2107f0e827519bcfbbc4b23494 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Thu, 5 Dec 2024 16:18:22 +0100
Subject: [PATCH 121/133] chore(deps): update dependency six to v1.17.0 (#536)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 89187a7d..2da7b143 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -587,9 +587,9 @@ secretstorage==3.3.3 \
     --hash=sha256:2403533ef369eca6d2ba81718576c5e0f564d5cca1b58f73a8b23e7d4eeebd77 \
     --hash=sha256:f356e6628222568e3af06f2eba8df495efa13b3b63081dafd4f7d9a7b7bc9f99
     # via keyring
-six==1.16.0 \
-    --hash=sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926 \
-    --hash=sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254
+six==1.17.0 \
+    --hash=sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274 \
+    --hash=sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81
     # via
     #   gcp-docuploader
     #   python-dateutil

From dbb19c495cf6fe9b8fb33cd3ccaf001b8b5af9f1 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Fri, 6 Dec 2024 12:34:20 +0100
Subject: [PATCH 122/133] chore(deps): update dependency google-cloud-spanner
 to v3.51.0 (#542)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [google-cloud-spanner](https://redirect.github.com/googleapis/python-spanner) | `==3.50.1` -> `==3.51.0` | [![age](https://developer.mend.io/api/mc/badges/age/pypi/google-cloud-spanner/3.51.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/pypi/google-cloud-spanner/3.51.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/pypi/google-cloud-spanner/3.50.1/3.51.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/pypi/google-cloud-spanner/3.50.1/3.51.0?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>googleapis/python-spanner (google-cloud-spanner)</summary>

### [`v3.51.0`](https://redirect.github.com/googleapis/python-spanner/blob/HEAD/CHANGELOG.md#3510-2024-12-05)

[Compare Source](https://redirect.github.com/googleapis/python-spanner/compare/v3.50.1...v3.51.0)

##### Features

-   Add connection variable for ignoring transaction warnings ([#&#8203;1249](https://redirect.github.com/googleapis/python-spanner/issues/1249)) ([eeb7836](https://redirect.github.com/googleapis/python-spanner/commit/eeb7836b6350aa9626dfb733208e6827d38bb9c9))
-   **spanner:** Implement custom tracer_provider injection for opentelemetry traces ([#&#8203;1229](https://redirect.github.com/googleapis/python-spanner/issues/1229)) ([6869ed6](https://redirect.github.com/googleapis/python-spanner/commit/6869ed651e41d7a8af046884bc6c792a4177f766))
-   Support float32 parameters in dbapi ([#&#8203;1245](https://redirect.github.com/googleapis/python-spanner/issues/1245)) ([829b799](https://redirect.github.com/googleapis/python-spanner/commit/829b799e0c9c6da274bf95c272cda564cfdba928))

##### Bug Fixes

-   Allow setting connection.read_only to same value ([#&#8203;1247](https://redirect.github.com/googleapis/python-spanner/issues/1247)) ([5e8ca94](https://redirect.github.com/googleapis/python-spanner/commit/5e8ca949b583fbcf0b92b42696545973aad8c78f))
-   Allow setting staleness to same value in tx ([#&#8203;1253](https://redirect.github.com/googleapis/python-spanner/issues/1253)) ([a214885](https://redirect.github.com/googleapis/python-spanner/commit/a214885ed474f3d69875ef580d5f8cbbabe9199a))
-   Dbapi raised AttributeError with \[] as arguments ([#&#8203;1257](https://redirect.github.com/googleapis/python-spanner/issues/1257)) ([758bf48](https://redirect.github.com/googleapis/python-spanner/commit/758bf4889a7f3346bc8282a3eed47aee43be650c))

##### Performance Improvements

-   Optimize ResultSet decoding ([#&#8203;1244](https://redirect.github.com/googleapis/python-spanner/issues/1244)) ([ccae6e0](https://redirect.github.com/googleapis/python-spanner/commit/ccae6e0287ba6cf3c14f15a907b2106b11ef1fdc))
-   Remove repeated GetSession calls for FixedSizePool ([#&#8203;1252](https://redirect.github.com/googleapis/python-spanner/issues/1252)) ([c064815](https://redirect.github.com/googleapis/python-spanner/commit/c064815abaaa4b564edd6f0e365a37e7e839080c))

##### Documentation

-   **samples:** Add samples for Cloud Spanner Default Backup Schedules ([#&#8203;1238](https://redirect.github.com/googleapis/python-spanner/issues/1238)) ([054a186](https://redirect.github.com/googleapis/python-spanner/commit/054a18658eedc5d4dbecb7508baa3f3d67f5b815))

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/python-spanner-sqlalchemy).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOS40Mi40IiwidXBkYXRlZEluVmVyIjoiMzkuNDIuNCIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOltdfQ==-->
---
 requirements.txt                                    |  6 +++---
 test/mockserver_tests/test_bit_reversed_sequence.py | 11 ++++-------
 test/test_suite_13.py                               |  3 +++
 test/test_suite_14.py                               | 10 +++++++++-
 test/test_suite_20.py                               | 10 +++++++++-
 5 files changed, 28 insertions(+), 12 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 6e90193d..71ed5445 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -157,9 +157,9 @@ google-cloud-core==2.4.1 \
     --hash=sha256:9b7749272a812bde58fff28868d0c5e2f585b82f37e09a1f6ed2d4d10f134073 \
     --hash=sha256:a9e6a4422b9ac5c29f79a0ede9485473338e2ce78d91f2370c01e730eab22e61
     # via google-cloud-spanner
-google-cloud-spanner==3.50.1 \
-    --hash=sha256:82937ea03b55de86bddf622f555aeae65ae86bb4f28ab35bd920ac505917c9bf \
-    --hash=sha256:9d399aa53fae58816023a4eb31fa267333c3a879a9221229e7f06fdda543884a
+google-cloud-spanner==3.51.0 \
+    --hash=sha256:2d01f33582526ebe7fab62034e92e722e512c21f6bc4abe27e03d86ef7ea576a \
+    --hash=sha256:346c2c20f64847883464fb0de5a6f9b48ecc6f79b032a2fb3a0aa088d9a9863f
     # via -r requirements.in
 googleapis-common-protos[grpc]==1.66.0 \
     --hash=sha256:c3e7b33d15fdca5374cc0a7346dd92ffa847425cc4ea941d970f13680052ec8c \
diff --git a/test/mockserver_tests/test_bit_reversed_sequence.py b/test/mockserver_tests/test_bit_reversed_sequence.py
index 82822d44..a18bc08e 100644
--- a/test/mockserver_tests/test_bit_reversed_sequence.py
+++ b/test/mockserver_tests/test_bit_reversed_sequence.py
@@ -21,7 +21,6 @@
     BatchCreateSessionsRequest,
     ExecuteSqlRequest,
     CommitRequest,
-    GetSessionRequest,
     BeginTransactionRequest,
 )
 from test.mockserver_tests.mock_server_test_base import (
@@ -128,10 +127,8 @@ def test_insert_row(self):
             session.commit()
         # Verify the requests that we got.
         requests = self.spanner_service.requests
-        eq_(5, len(requests))
+        eq_(4, len(requests))
         is_instance_of(requests[0], BatchCreateSessionsRequest)
-        # We should get rid of this extra round-trip for GetSession....
-        is_instance_of(requests[1], GetSessionRequest)
-        is_instance_of(requests[2], BeginTransactionRequest)
-        is_instance_of(requests[3], ExecuteSqlRequest)
-        is_instance_of(requests[4], CommitRequest)
+        is_instance_of(requests[1], BeginTransactionRequest)
+        is_instance_of(requests[2], ExecuteSqlRequest)
+        is_instance_of(requests[3], CommitRequest)
diff --git a/test/test_suite_13.py b/test/test_suite_13.py
index b0cddf59..97f5754e 100644
--- a/test/test_suite_13.py
+++ b/test/test_suite_13.py
@@ -1300,6 +1300,9 @@ def test_float_as_float(self):
             filter_=lambda n: n is not None and round(n, 5) or None,
         )
 
+    def test_float_coerce_round_trip(self, connection):
+        pass
+
     @requires.precision_numerics_general
     def test_precision_decimal(self):
         """
diff --git a/test/test_suite_14.py b/test/test_suite_14.py
index e4183821..57305157 100644
--- a/test/test_suite_14.py
+++ b/test/test_suite_14.py
@@ -27,7 +27,7 @@
 from google.cloud.spanner_v1 import RequestOptions, Client
 
 import sqlalchemy
-from sqlalchemy import create_engine
+from sqlalchemy import create_engine, literal, FLOAT
 from sqlalchemy import inspect
 from sqlalchemy import testing
 from sqlalchemy import ForeignKey
@@ -53,6 +53,7 @@
 from sqlalchemy import Float
 from sqlalchemy import LargeBinary
 from sqlalchemy import String
+from sqlalchemy.sql.expression import cast
 from sqlalchemy.ext.declarative import declarative_base
 from sqlalchemy.orm import relation
 from sqlalchemy.orm import Session
@@ -1650,6 +1651,13 @@ def test_float_as_float(self, do_numeric_test):
             filter_=lambda n: n is not None and round(n, 5) or None,
         )
 
+    @testing.requires.literal_float_coercion
+    def test_float_coerce_round_trip(self, connection):
+        expr = 15.7563
+
+        val = connection.scalar(select(cast(literal(expr), FLOAT)))
+        eq_(val, expr)
+
     @requires.precision_numerics_general
     def test_precision_decimal(self, do_numeric_test):
         """
diff --git a/test/test_suite_20.py b/test/test_suite_20.py
index dbbc8f88..4b6849e4 100644
--- a/test/test_suite_20.py
+++ b/test/test_suite_20.py
@@ -26,7 +26,7 @@
 
 from google.cloud.spanner_v1 import RequestOptions, Client
 import sqlalchemy
-from sqlalchemy import create_engine
+from sqlalchemy import create_engine, literal, FLOAT
 from sqlalchemy.engine import Inspector
 from sqlalchemy import inspect
 from sqlalchemy import testing
@@ -55,6 +55,7 @@
 from sqlalchemy import Float
 from sqlalchemy import LargeBinary
 from sqlalchemy import String
+from sqlalchemy.sql.expression import cast
 from sqlalchemy.ext.declarative import declarative_base
 from sqlalchemy.orm import relationship
 from sqlalchemy.orm import Session
@@ -2455,6 +2456,13 @@ def test_float_as_float(self, do_numeric_test):
             filter_=lambda n: n is not None and round(n, 5) or None,
         )
 
+    @testing.requires.literal_float_coercion
+    def test_float_coerce_round_trip(self, connection):
+        expr = 15.7563
+
+        val = connection.scalar(select(cast(literal(expr), FLOAT)))
+        eq_(val, expr)
+
     @requires.precision_numerics_general
     def test_precision_decimal(self, do_numeric_test):
         """

From 6c3cb42919c5c8d52719d855af4fc2bb22c13fae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Mon, 9 Dec 2024 08:44:08 +0100
Subject: [PATCH 123/133] feat: support float32 (#531)

* feat: support float32

Adds support for FLOAT32 columns. Applications should use the SQLAlchemy
type REAL to create a FLOAT32 column, as FLOAT is already reserved for
FLOAT64.

Fixes #409

* chore: run code formatter

* fix: remove DOUBLE reference which is SQLAlchemy 2.0-only
---
 .../sqlalchemy_spanner/sqlalchemy_spanner.py  | 11 +++
 test/mockserver_tests/float32_model.py        | 30 ++++++++
 test/mockserver_tests/test_float32.py         | 73 +++++++++++++++++++
 test/mockserver_tests/test_quickstart.py      |  1 -
 test/system/test_basics.py                    | 39 +++++++++-
 5 files changed, 151 insertions(+), 3 deletions(-)
 create mode 100644 test/mockserver_tests/float32_model.py
 create mode 100644 test/mockserver_tests/test_float32.py

diff --git a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
index e2fb651d..09c7f9ae 100644
--- a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
+++ b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
@@ -84,6 +84,7 @@ def reset_connection(dbapi_conn, connection_record, reset_state=None):
     "BYTES": types.LargeBinary,
     "DATE": types.DATE,
     "DATETIME": types.DATETIME,
+    "FLOAT32": types.REAL,
     "FLOAT64": types.Float,
     "INT64": types.BIGINT,
     "NUMERIC": types.NUMERIC(precision=38, scale=9),
@@ -101,6 +102,7 @@ def reset_connection(dbapi_conn, connection_record, reset_state=None):
     types.LargeBinary: "BYTES(MAX)",
     types.DATE: "DATE",
     types.DATETIME: "DATETIME",
+    types.REAL: "FLOAT32",
     types.Float: "FLOAT64",
     types.BIGINT: "INT64",
     types.DECIMAL: "NUMERIC",
@@ -540,9 +542,18 @@ class SpannerTypeCompiler(GenericTypeCompiler):
     def visit_INTEGER(self, type_, **kw):
         return "INT64"
 
+    def visit_DOUBLE(self, type_, **kw):
+        return "FLOAT64"
+
     def visit_FLOAT(self, type_, **kw):
+        # Note: This was added before Spanner supported FLOAT32.
+        # Changing this now to generate a FLOAT32 would be a breaking change.
+        # Users therefore have to use REAL to generate a FLOAT32 column.
         return "FLOAT64"
 
+    def visit_REAL(self, type_, **kw):
+        return "FLOAT32"
+
     def visit_TEXT(self, type_, **kw):
         return "STRING({})".format(type_.length or "MAX")
 
diff --git a/test/mockserver_tests/float32_model.py b/test/mockserver_tests/float32_model.py
new file mode 100644
index 00000000..b6987e97
--- /dev/null
+++ b/test/mockserver_tests/float32_model.py
@@ -0,0 +1,30 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import String
+from sqlalchemy.orm import DeclarativeBase
+from sqlalchemy.orm import Mapped
+from sqlalchemy.orm import mapped_column
+from sqlalchemy.types import REAL
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class Number(Base):
+    __tablename__ = "numbers"
+    number: Mapped[int] = mapped_column(primary_key=True)
+    name: Mapped[str] = mapped_column(String(30))
+    ln: Mapped[float] = mapped_column(REAL)
diff --git a/test/mockserver_tests/test_float32.py b/test/mockserver_tests/test_float32.py
new file mode 100644
index 00000000..801a57c2
--- /dev/null
+++ b/test/mockserver_tests/test_float32.py
@@ -0,0 +1,73 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy.orm import Session
+from sqlalchemy.testing import (
+    eq_,
+    is_instance_of,
+    is_false,
+)
+from google.cloud.spanner_v1 import (
+    BatchCreateSessionsRequest,
+    ExecuteSqlRequest,
+    ResultSet,
+    ResultSetStats,
+    BeginTransactionRequest,
+    CommitRequest,
+    TypeCode,
+)
+from test.mockserver_tests.mock_server_test_base import (
+    MockServerTestBase,
+    add_result,
+)
+
+
+class TestFloat32(MockServerTestBase):
+    def test_insert_data(self):
+        from test.mockserver_tests.float32_model import Number
+
+        update_count = ResultSet(
+            dict(
+                stats=ResultSetStats(
+                    dict(
+                        row_count_exact=1,
+                    )
+                )
+            )
+        )
+        add_result(
+            "INSERT INTO numbers (number, name, ln) VALUES (@a0, @a1, @a2)",
+            update_count,
+        )
+
+        engine = self.create_engine()
+        with Session(engine) as session:
+            n1 = Number(number=1, name="One", ln=0.0)
+            session.add_all([n1])
+            session.commit()
+
+            requests = self.spanner_service.requests
+            eq_(4, len(requests))
+            is_instance_of(requests[0], BatchCreateSessionsRequest)
+            is_instance_of(requests[1], BeginTransactionRequest)
+            is_instance_of(requests[2], ExecuteSqlRequest)
+            is_instance_of(requests[3], CommitRequest)
+            request: ExecuteSqlRequest = requests[2]
+            eq_(3, len(request.params))
+            eq_("1", request.params["a0"])
+            eq_("One", request.params["a1"])
+            eq_(0.0, request.params["a2"])
+            eq_(TypeCode.INT64, request.param_types["a0"].code)
+            eq_(TypeCode.STRING, request.param_types["a1"].code)
+            is_false("a2" in request.param_types)
diff --git a/test/mockserver_tests/test_quickstart.py b/test/mockserver_tests/test_quickstart.py
index ce9711f7..0b31f9e2 100644
--- a/test/mockserver_tests/test_quickstart.py
+++ b/test/mockserver_tests/test_quickstart.py
@@ -30,7 +30,6 @@ class TestQuickStart(MockServerTestBase):
     def test_create_tables(self):
         from test.mockserver_tests.quickstart_model import Base
 
-        # TODO: Fix the double quotes inside these SQL fragments.
         add_result(
             """SELECT true
 FROM INFORMATION_SCHEMA.TABLES
diff --git a/test/system/test_basics.py b/test/system/test_basics.py
index 3357104c..171485b8 100644
--- a/test/system/test_basics.py
+++ b/test/system/test_basics.py
@@ -22,7 +22,10 @@
     Index,
     MetaData,
     Boolean,
+    BIGINT,
 )
+from sqlalchemy.orm import Session, DeclarativeBase, Mapped, mapped_column
+from sqlalchemy.types import REAL
 from sqlalchemy.testing import eq_
 from sqlalchemy.testing.plugin.plugin_base import fixtures
 
@@ -37,6 +40,7 @@ def define_tables(cls, metadata):
             Column("name", String(20)),
             Column("alternative_name", String(20)),
             Column("prime", Boolean),
+            Column("ln", REAL),
             PrimaryKeyConstraint("number"),
         )
         Index(
@@ -53,8 +57,8 @@ def test_hello_world(self, connection):
     def test_insert_number(self, connection):
         connection.execute(
             text(
-                """insert or update into numbers (number, name, prime)
-                   values (1, 'One', false)"""
+                """insert or update into numbers (number, name, prime, ln)
+                   values (1, 'One', false, cast(ln(1) as float32))"""
             )
         )
         name = connection.execute(text("select name from numbers where number=1"))
@@ -66,6 +70,17 @@ def test_reflect(self, connection):
         meta.reflect(bind=engine)
         eq_(1, len(meta.tables))
         table = meta.tables["numbers"]
+        eq_(5, len(table.columns))
+        eq_("number", table.columns[0].name)
+        eq_(BIGINT, type(table.columns[0].type))
+        eq_("name", table.columns[1].name)
+        eq_(String, type(table.columns[1].type))
+        eq_("alternative_name", table.columns[2].name)
+        eq_(String, type(table.columns[2].type))
+        eq_("prime", table.columns[3].name)
+        eq_(Boolean, type(table.columns[3].type))
+        eq_("ln", table.columns[4].name)
+        eq_(REAL, type(table.columns[4].type))
         eq_(1, len(table.indexes))
         index = next(iter(table.indexes))
         eq_(2, len(index.columns))
@@ -74,3 +89,23 @@ def test_reflect(self, connection):
         dialect_options = index.dialect_options["spanner"]
         eq_(1, len(dialect_options["storing"]))
         eq_("alternative_name", dialect_options["storing"][0])
+
+    def test_orm(self, connection):
+        class Base(DeclarativeBase):
+            pass
+
+        class Number(Base):
+            __tablename__ = "numbers"
+            number: Mapped[int] = mapped_column(primary_key=True)
+            name: Mapped[str] = mapped_column(String(20))
+            alternative_name: Mapped[str] = mapped_column(String(20))
+            prime: Mapped[bool] = mapped_column(Boolean)
+            ln: Mapped[float] = mapped_column(REAL)
+
+        engine = connection.engine
+        with Session(engine) as session:
+            number = Number(
+                number=1, name="One", alternative_name="Uno", prime=False, ln=0.0
+            )
+            session.add(number)
+            session.commit()

From d2d72b6fad4ea457114a50a2869d053798fed452 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Mon, 9 Dec 2024 08:44:44 +0100
Subject: [PATCH 124/133] docs: add sample for read-only transactions (#533)

* docs: add sample for read-only transactions

Adds a sample and documentation for read-only transactions.

Fixes #493

* chore: run two read-only transactions in test

* chore: remove GetSession requests

* chore: remove unused import
---
 README.rst                                    |  13 +-
 samples/noxfile.py                            |   5 +
 samples/read_only_transaction_sample.py       |  64 ++++++++++
 test/mockserver_tests/read_only_model.py      |  33 +++++
 .../test_read_only_transaction.py             | 119 ++++++++++++++++++
 5 files changed, 229 insertions(+), 5 deletions(-)
 create mode 100644 samples/read_only_transaction_sample.py
 create mode 100644 test/mockserver_tests/read_only_model.py
 create mode 100644 test/mockserver_tests/test_read_only_transaction.py

diff --git a/README.rst b/README.rst
index 5c39e139..852bdc5c 100644
--- a/README.rst
+++ b/README.rst
@@ -344,8 +344,9 @@ ReadOnly transactions
 ~~~~~~~~~~~~~~~~~~~~~
 
 By default, transactions produced by a Spanner connection are in
-ReadWrite mode. However, some applications require an ability to grant
-ReadOnly access to users/methods; for these cases Spanner dialect
+ReadWrite mode. However, workloads that only read data perform better
+if they use read-only transactions, as Spanner does not need to take
+locks for the data that is read; for these cases, the Spanner dialect
 supports the ``read_only`` execution option, which switches a connection
 into ReadOnly mode:
 
@@ -354,11 +355,13 @@ into ReadOnly mode:
    with engine.connect().execution_options(read_only=True) as connection:
        connection.execute(select(["*"], from_obj=table)).fetchall()
 
-Note that execution options are applied lazily - on the ``execute()``
-method call, right before it.
+See the `Read-only transaction sample
+<https://github.com/googleapis/python-spanner-sqlalchemy/blob/-/samples/read_only_transaction_sample.py>`__
+for a concrete example.
 
 ReadOnly/ReadWrite mode of a connection can't be changed while a
-transaction is in progress - first you must commit or rollback it.
+transaction is in progress - you must commit or rollback the current
+transaction before changing the mode.
 
 Stale reads
 ~~~~~~~~~~~
diff --git a/samples/noxfile.py b/samples/noxfile.py
index b103fd77..5011e971 100644
--- a/samples/noxfile.py
+++ b/samples/noxfile.py
@@ -57,6 +57,11 @@ def transaction(session):
     _sample(session)
 
 
+@nox.session()
+def read_only_transaction(session):
+    _sample(session)
+
+
 @nox.session()
 def _all_samples(session):
     _sample(session)
diff --git a/samples/read_only_transaction_sample.py b/samples/read_only_transaction_sample.py
new file mode 100644
index 00000000..35ef84e7
--- /dev/null
+++ b/samples/read_only_transaction_sample.py
@@ -0,0 +1,64 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 datetime
+import uuid
+
+from sqlalchemy import create_engine, Engine
+from sqlalchemy.orm import Session
+
+from sample_helper import run_sample
+from model import Singer, Concert, Venue
+
+
+# Shows how to execute a read-only transaction on Spanner using SQLAlchemy.
+def read_only_transaction_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    # First insert a few test rows that can be queried in a read-only transaction.
+    insert_test_data(engine)
+
+    # Create a session that uses a read-only transaction.
+    # Read-only transactions do not take locks, and are therefore preferred
+    # above read/write transactions for workloads that only read data on Spanner.
+    with Session(engine.execution_options(read_only=True)) as session:
+        print("Singers ordered by last name")
+        singers = session.query(Singer).order_by(Singer.last_name).all()
+        for singer in singers:
+            print("Singer: ", singer.full_name)
+
+        print()
+        print("Singers ordered by first name")
+        singers = session.query(Singer).order_by(Singer.first_name).all()
+        for singer in singers:
+            print("Singer: ", singer.full_name)
+
+
+def insert_test_data(engine: Engine):
+    with Session(engine) as session:
+        session.add_all(
+            [
+                Singer(id=str(uuid.uuid4()), first_name="John", last_name="Doe"),
+                Singer(id=str(uuid.uuid4()), first_name="Jane", last_name="Doe"),
+            ]
+        )
+        session.commit()
+
+
+if __name__ == "__main__":
+    run_sample(read_only_transaction_sample)
diff --git a/test/mockserver_tests/read_only_model.py b/test/mockserver_tests/read_only_model.py
new file mode 100644
index 00000000..b76cdd3f
--- /dev/null
+++ b/test/mockserver_tests/read_only_model.py
@@ -0,0 +1,33 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import String, BigInteger, Sequence, TextClause
+from sqlalchemy.orm import DeclarativeBase
+from sqlalchemy.orm import Mapped
+from sqlalchemy.orm import mapped_column
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class Singer(Base):
+    __tablename__ = "singers"
+    id: Mapped[int] = mapped_column(
+        BigInteger,
+        Sequence("singer_id"),
+        server_default=TextClause("GET_NEXT_SEQUENCE_VALUE(SEQUENCE singer_id)"),
+        primary_key=True,
+    )
+    name: Mapped[str] = mapped_column(String)
diff --git a/test/mockserver_tests/test_read_only_transaction.py b/test/mockserver_tests/test_read_only_transaction.py
new file mode 100644
index 00000000..18abf69f
--- /dev/null
+++ b/test/mockserver_tests/test_read_only_transaction.py
@@ -0,0 +1,119 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import create_engine, select
+from sqlalchemy.orm import Session
+from sqlalchemy.testing import eq_, is_instance_of
+from google.cloud.spanner_v1 import (
+    FixedSizePool,
+    BatchCreateSessionsRequest,
+    ExecuteSqlRequest,
+    BeginTransactionRequest,
+    TransactionOptions,
+)
+from test.mockserver_tests.mock_server_test_base import MockServerTestBase
+from test.mockserver_tests.mock_server_test_base import add_result
+import google.cloud.spanner_v1.types.type as spanner_type
+import google.cloud.spanner_v1.types.result_set as result_set
+
+
+class TestReadOnlyTransaction(MockServerTestBase):
+    def test_read_only_transaction(self):
+        from test.mockserver_tests.read_only_model import Singer
+
+        add_singer_query_result("SELECT singers.id, singers.name \n" + "FROM singers")
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            echo=True,
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+
+        for i in range(2):
+            with Session(engine.execution_options(read_only=True)) as session:
+                # Execute two queries in a read-only transaction.
+                session.scalars(select(Singer)).all()
+                session.scalars(select(Singer)).all()
+
+        # Verify the requests that we got.
+        requests = self.spanner_service.requests
+        eq_(7, len(requests))
+        is_instance_of(requests[0], BatchCreateSessionsRequest)
+        is_instance_of(requests[1], BeginTransactionRequest)
+        is_instance_of(requests[2], ExecuteSqlRequest)
+        is_instance_of(requests[3], ExecuteSqlRequest)
+        is_instance_of(requests[4], BeginTransactionRequest)
+        is_instance_of(requests[5], ExecuteSqlRequest)
+        is_instance_of(requests[6], ExecuteSqlRequest)
+        # Verify that the transaction is a read-only transaction.
+        for index in [1, 4]:
+            begin_request: BeginTransactionRequest = requests[index]
+            eq_(
+                TransactionOptions(
+                    dict(
+                        read_only=TransactionOptions.ReadOnly(
+                            dict(
+                                strong=True,
+                                return_read_timestamp=True,
+                            )
+                        )
+                    )
+                ),
+                begin_request.options,
+            )
+
+
+def add_singer_query_result(sql: str):
+    result = result_set.ResultSet(
+        dict(
+            metadata=result_set.ResultSetMetadata(
+                dict(
+                    row_type=spanner_type.StructType(
+                        dict(
+                            fields=[
+                                spanner_type.StructType.Field(
+                                    dict(
+                                        name="singers_id",
+                                        type=spanner_type.Type(
+                                            dict(code=spanner_type.TypeCode.INT64)
+                                        ),
+                                    )
+                                ),
+                                spanner_type.StructType.Field(
+                                    dict(
+                                        name="singers_name",
+                                        type=spanner_type.Type(
+                                            dict(code=spanner_type.TypeCode.STRING)
+                                        ),
+                                    )
+                                ),
+                            ]
+                        )
+                    )
+                )
+            ),
+        )
+    )
+    result.rows.extend(
+        [
+            (
+                "1",
+                "Jane Doe",
+            ),
+            (
+                "2",
+                "John Doe",
+            ),
+        ]
+    )
+    add_result(sql, result)

From cd1e5fe1736a3bb17791542148bb0c0c44b5d62e Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Mon, 9 Dec 2024 08:51:57 +0100
Subject: [PATCH 125/133] chore(deps): update dependency argcomplete to v3.5.2
 (#543)

---
 .kokoro/requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt
index 2da7b143..4f5d4af4 100644
--- a/.kokoro/requirements.txt
+++ b/.kokoro/requirements.txt
@@ -4,9 +4,9 @@
 #
 #    pip-compile --generate-hashes requirements.in
 #
-argcomplete==3.5.1 \
-    --hash=sha256:1a1d148bdaa3e3b93454900163403df41448a248af01b6e849edc5ac08e6c363 \
-    --hash=sha256:eb1ee355aa2557bd3d0145de7b06b2a45b0ce461e1e7813f5d066039ab4177b4
+argcomplete==3.5.2 \
+    --hash=sha256:036d020d79048a5d525bc63880d7a4b8d1668566b8a76daf1144c0bbe0f63472 \
+    --hash=sha256:23146ed7ac4403b70bd6026402468942ceba34a6732255b9edf5b7354f68a6bb
     # via nox
 attrs==24.2.0 \
     --hash=sha256:5cfb1b9148b5b086569baec03f20d7b6bf3bcacc9a42bebf87ffaaca362f6346 \

From 0f33c1cb021a54436d64feb88ecf4ac163766fa8 Mon Sep 17 00:00:00 2001
From: Mend Renovate <bot@renovateapp.com>
Date: Mon, 9 Dec 2024 08:52:09 +0100
Subject: [PATCH 126/133] chore(deps): update dependency mako to v1.3.8 (#544)

---
 requirements.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 71ed5445..d3b98e3f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -250,9 +250,9 @@ importlib-metadata==8.5.0 \
     --hash=sha256:45e54197d28b7a7f1559e60b95e7c567032b602131fbd588f1497f47880aa68b \
     --hash=sha256:71522656f0abace1d072b9e5481a48f07c138e00f079c38c8f883823f9c26bd7
     # via opentelemetry-api
-Mako==1.3.7 \
-    --hash=sha256:20405b1232e0759f0e7d87b01f6bb94fce0761747f1cb876ecf90bd512d0b639 \
-    --hash=sha256:d18f990ad57f800ce8e76cbfb0b74afe471c293517e9f5003ace6dad5aa72c36
+Mako==1.3.8 \
+    --hash=sha256:42f48953c7eb91332040ff567eb7eea69b22e7a4affbc5ba8e845e8f730f6627 \
+    --hash=sha256:577b97e414580d3e088d47c2dbbe9594aa7a5146ed2875d4dfa9075af2dd3cc8
     # via alembic
 markupsafe==3.0.2 \
     --hash=sha256:0bff5e0ae4ef2e1ae4fdf2dfd5b76c75e5c2fa4132d05fc1b0dabcd20c7e28c4 \

From 108d965c60b6ea817de7fed86dca3d20f923d975 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Mon, 9 Dec 2024 08:53:34 +0100
Subject: [PATCH 127/133] feat: support Partitioned DML (#541)

Adds tests and samples for executing Partitioned DML using SQLAlchemy.

Fixes #496
---
 samples/partitioned_dml_sample.py             | 45 +++++++++++++++++++
 .../mockserver_tests/mock_server_test_base.py | 12 +++++
 test/mockserver_tests/mock_spanner.py         | 25 ++++++++---
 test/mockserver_tests/test_basics.py          | 31 ++++++++++++-
 4 files changed, 106 insertions(+), 7 deletions(-)
 create mode 100644 samples/partitioned_dml_sample.py

diff --git a/samples/partitioned_dml_sample.py b/samples/partitioned_dml_sample.py
new file mode 100644
index 00000000..62c312ff
--- /dev/null
+++ b/samples/partitioned_dml_sample.py
@@ -0,0 +1,45 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 google.cloud.spanner_dbapi.parsed_statement import AutocommitDmlMode
+from sqlalchemy import create_engine, text
+
+from sample_helper import run_sample
+
+# Shows how to use Partitioned DML using SQLAlchemy and Spanner.
+def partitioned_dml_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    # Get a connection in auto-commit mode.
+    # Partitioned DML can only be executed in auto-commit mode, as each
+    # Partitioned DML transaction can only consist of one statement.
+    with engine.connect().execution_options(isolation_level="AUTOCOMMIT") as connection:
+        # Set the DML mode to PARTITIONED_NON_ATOMIC.
+        connection.connection.set_autocommit_dml_mode(
+            AutocommitDmlMode.PARTITIONED_NON_ATOMIC
+        )
+        # Use a bulk update statement to back-fill a column.
+        lower_bound_rowcount = connection.execute(
+            text("update venues set active=true where active is null")
+        ).rowcount
+        # Partitioned DML returns the lower-bound update count.
+        print("Updated at least ", lower_bound_rowcount, " venue records")
+
+
+if __name__ == "__main__":
+    run_sample(partitioned_dml_sample)
diff --git a/test/mockserver_tests/mock_server_test_base.py b/test/mockserver_tests/mock_server_test_base.py
index 71e1bf1f..5aa33732 100644
--- a/test/mockserver_tests/mock_server_test_base.py
+++ b/test/mockserver_tests/mock_server_test_base.py
@@ -11,6 +11,7 @@
 # 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 google.cloud.spanner_dbapi.parsed_statement import AutocommitDmlMode
 from sqlalchemy import Engine, create_engine
 from sqlalchemy.testing.plugin.plugin_base import fixtures
 import google.cloud.spanner_v1.types.type as spanner_type
@@ -35,6 +36,17 @@ def add_result(sql: str, result: ResultSet):
     MockServerTestBase.spanner_service.mock_spanner.add_result(sql, result)
 
 
+def add_update_count(
+    sql: str, count: int, dml_mode: AutocommitDmlMode = AutocommitDmlMode.TRANSACTIONAL
+):
+    if dml_mode == AutocommitDmlMode.PARTITIONED_NON_ATOMIC:
+        stats = dict(row_count_lower_bound=count)
+    else:
+        stats = dict(row_count_exact=count)
+    result = result_set.ResultSet(dict(stats=result_set.ResultSetStats(stats)))
+    add_result(sql, result)
+
+
 def add_select1_result():
     result = result_set.ResultSet(
         dict(
diff --git a/test/mockserver_tests/mock_spanner.py b/test/mockserver_tests/mock_spanner.py
index db189144..932f6371 100644
--- a/test/mockserver_tests/mock_spanner.py
+++ b/test/mockserver_tests/mock_spanner.py
@@ -12,7 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from google.cloud.spanner_v1 import TransactionOptions, ResultSetMetadata
+from google.cloud.spanner_v1 import (
+    TransactionOptions,
+    ResultSetMetadata,
+    ExecuteSqlRequest,
+)
 from google.protobuf import empty_pb2
 import test.mockserver_tests.spanner_pb2_grpc as spanner_grpc
 import test.mockserver_tests.spanner_database_admin_pb2_grpc as database_admin_grpc
@@ -40,23 +44,25 @@ def get_result(self, sql: str) -> result_set.ResultSet:
         return result
 
     def get_result_as_partial_result_sets(
-        self, sql: str
+        self, sql: str, started_transaction: transaction.Transaction
     ) -> [result_set.PartialResultSet]:
         result: result_set.ResultSet = self.get_result(sql)
         partials = []
         first = True
         if len(result.rows) == 0:
             partial = result_set.PartialResultSet()
-            partial.metadata = result.metadata
+            partial.metadata = ResultSetMetadata(result.metadata)
             partials.append(partial)
         else:
             for row in result.rows:
                 partial = result_set.PartialResultSet()
                 if first:
-                    partial.metadata = result.metadata
+                    partial.metadata = ResultSetMetadata(result.metadata)
                 partial.values.extend(row)
                 partials.append(partial)
         partials[len(partials) - 1].stats = result.stats
+        if started_transaction:
+            partials[0].metadata.transaction = started_transaction
         return partials
 
 
@@ -120,9 +126,16 @@ def ExecuteSql(self, request, context):
         self._requests.append(request)
         return result_set.ResultSet()
 
-    def ExecuteStreamingSql(self, request, context):
+    def ExecuteStreamingSql(self, request: ExecuteSqlRequest, context):
         self._requests.append(request)
-        partials = self.mock_spanner.get_result_as_partial_result_sets(request.sql)
+        started_transaction = None
+        if not request.transaction.begin == TransactionOptions():
+            started_transaction = self.__create_transaction(
+                request.session, request.transaction.begin
+            )
+        partials = self.mock_spanner.get_result_as_partial_result_sets(
+            request.sql, started_transaction
+        )
         for result in partials:
             yield result
 
diff --git a/test/mockserver_tests/test_basics.py b/test/mockserver_tests/test_basics.py
index b6c916c4..82918366 100644
--- a/test/mockserver_tests/test_basics.py
+++ b/test/mockserver_tests/test_basics.py
@@ -13,7 +13,17 @@
 # limitations under the License.
 
 from google.cloud.spanner_admin_database_v1 import UpdateDatabaseDdlRequest
-from sqlalchemy import create_engine, select, MetaData, Table, Column, Integer, String
+from google.cloud.spanner_dbapi.parsed_statement import AutocommitDmlMode
+from sqlalchemy import (
+    create_engine,
+    select,
+    MetaData,
+    Table,
+    Column,
+    Integer,
+    String,
+    text,
+)
 from sqlalchemy.testing import eq_, is_instance_of
 from google.cloud.spanner_v1 import (
     FixedSizePool,
@@ -26,6 +36,7 @@
     MockServerTestBase,
     add_select1_result,
     add_result,
+    add_update_count,
 )
 
 
@@ -127,3 +138,21 @@ def test_create_multiple_tables(self):
                 "\n) PRIMARY KEY (id)",
                 requests[0].statements[i],
             )
+
+    def test_partitioned_dml(self):
+        sql = "UPDATE singers SET checked=true WHERE active = true"
+        add_update_count(sql, 100, AutocommitDmlMode.PARTITIONED_NON_ATOMIC)
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": PingingPool(size=10)},
+        )
+        # TODO: Support autocommit_dml_mode as a connection variable in execution
+        #       options.
+        with engine.connect().execution_options(
+            isolation_level="AUTOCOMMIT"
+        ) as connection:
+            connection.connection.set_autocommit_dml_mode(
+                AutocommitDmlMode.PARTITIONED_NON_ATOMIC
+            )
+            results = connection.execute(text(sql)).rowcount
+            eq_(100, results)

From e9df8105b18e03dbf3b746fed85ffe9da286b953 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Mon, 9 Dec 2024 08:57:01 +0100
Subject: [PATCH 128/133] docs: add sample for stale reads (#539)

* docs: add sample for stale reads

Adds a sample and tests for executing stale reads on Spanner. Using
stale reads can improve performance when the application does not require
the guarantees that are given by strong reads.

Fixes #495

* chore: remove GetSession requests
---
 samples/noxfile.py                        |   5 +
 samples/stale_read_sample.py              |  96 ++++++++++++
 test/mockserver_tests/stale_read_model.py |  28 ++++
 test/mockserver_tests/test_stale_reads.py | 169 ++++++++++++++++++++++
 4 files changed, 298 insertions(+)
 create mode 100644 samples/stale_read_sample.py
 create mode 100644 test/mockserver_tests/stale_read_model.py
 create mode 100644 test/mockserver_tests/test_stale_reads.py

diff --git a/samples/noxfile.py b/samples/noxfile.py
index 5011e971..35b744dc 100644
--- a/samples/noxfile.py
+++ b/samples/noxfile.py
@@ -57,6 +57,11 @@ def transaction(session):
     _sample(session)
 
 
+@nox.session()
+def stale_read(session):
+    _sample(session)
+
+
 @nox.session()
 def read_only_transaction(session):
     _sample(session)
diff --git a/samples/stale_read_sample.py b/samples/stale_read_sample.py
new file mode 100644
index 00000000..989a0c13
--- /dev/null
+++ b/samples/stale_read_sample.py
@@ -0,0 +1,96 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 uuid
+from sqlalchemy import create_engine, Engine, select, text
+from sqlalchemy.orm import Session
+from sample_helper import run_sample
+from model import Singer
+
+
+# Shows how to execute stale reads on Spanner using SQLAlchemy.
+def stale_read_sample():
+    engine = create_engine(
+        "spanner:///projects/sample-project/"
+        "instances/sample-instance/"
+        "databases/sample-database",
+        echo=True,
+    )
+    # First get the current database timestamp. We can use this timestamp to
+    # query the database at a point in time where we know it was empty.
+    with Session(engine.execution_options(isolation_level="AUTOCOMMIT")) as session:
+        timestamp = session.execute(select(text("current_timestamp"))).one()[0]
+    print(timestamp)
+
+    # Insert a few test rows.
+    insert_test_data(engine)
+
+    # Create a session that uses a read-only transaction with a strong timestamp
+    # bound. This means that it will read all data that has been committed at the
+    # time this transaction starts.
+    # Read-only transactions do not take locks, and are therefore preferred
+    # above read/write transactions for workloads that only read data on Spanner.
+    with Session(engine.execution_options(read_only=True)) as session:
+        print("Found singers with strong timestamp bound:")
+        singers = session.query(Singer).order_by(Singer.last_name).all()
+        for singer in singers:
+            print("Singer: ", singer.full_name)
+
+    # Create a session that uses a read-only transaction that selects data in
+    # the past. We'll use the timestamp that we retrieved before inserting the
+    # test data for this transaction.
+    with Session(
+        engine.execution_options(
+            read_only=True, staleness={"read_timestamp": timestamp}
+        )
+    ) as session:
+        print("Searching for singers using a read timestamp in the past:")
+        singers = session.query(Singer).order_by(Singer.last_name).all()
+        if singers:
+            for singer in singers:
+                print("Singer: ", singer.full_name)
+        else:
+            print("No singers found.")
+
+    # Spanner also supports min_read_timestamp and max_staleness as staleness
+    # options. These can only be used in auto-commit mode.
+    # Spanner will choose a read timestamp that satisfies the given restriction
+    # and that can be served as efficiently as possible.
+    with Session(
+        engine.execution_options(
+            isolation_level="AUTOCOMMIT", staleness={"max_staleness": {"seconds": 15}}
+        )
+    ) as session:
+        print("Searching for singers using a max staleness of 15 seconds:")
+        singers = session.query(Singer).order_by(Singer.last_name).all()
+        if singers:
+            for singer in singers:
+                print("Singer: ", singer.full_name)
+        else:
+            print("No singers found.")
+
+
+def insert_test_data(engine: Engine):
+    with Session(engine) as session:
+        session.add_all(
+            [
+                Singer(id=str(uuid.uuid4()), first_name="John", last_name="Doe"),
+                Singer(id=str(uuid.uuid4()), first_name="Jane", last_name="Doe"),
+            ]
+        )
+        session.commit()
+
+
+if __name__ == "__main__":
+    run_sample(stale_read_sample)
diff --git a/test/mockserver_tests/stale_read_model.py b/test/mockserver_tests/stale_read_model.py
new file mode 100644
index 00000000..025a56d2
--- /dev/null
+++ b/test/mockserver_tests/stale_read_model.py
@@ -0,0 +1,28 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import String, BigInteger
+from sqlalchemy.orm import DeclarativeBase
+from sqlalchemy.orm import Mapped
+from sqlalchemy.orm import mapped_column
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class Singer(Base):
+    __tablename__ = "singers"
+    id: Mapped[int] = mapped_column(BigInteger, primary_key=True)
+    name: Mapped[str] = mapped_column(String)
diff --git a/test/mockserver_tests/test_stale_reads.py b/test/mockserver_tests/test_stale_reads.py
new file mode 100644
index 00000000..02be066c
--- /dev/null
+++ b/test/mockserver_tests/test_stale_reads.py
@@ -0,0 +1,169 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 datetime
+from sqlalchemy import create_engine, select
+from sqlalchemy.orm import Session
+from sqlalchemy.testing import eq_, is_instance_of
+from google.cloud.spanner_v1 import (
+    FixedSizePool,
+    BatchCreateSessionsRequest,
+    ExecuteSqlRequest,
+    BeginTransactionRequest,
+    TransactionOptions,
+)
+from test.mockserver_tests.mock_server_test_base import MockServerTestBase
+from test.mockserver_tests.mock_server_test_base import add_result
+import google.cloud.spanner_v1.types.type as spanner_type
+import google.cloud.spanner_v1.types.result_set as result_set
+
+
+class TestStaleReads(MockServerTestBase):
+    def test_stale_read_multi_use(self):
+        from test.mockserver_tests.stale_read_model import Singer
+
+        add_singer_query_result("SELECT singers.id, singers.name \n" + "FROM singers")
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            echo=True,
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+
+        timestamp = datetime.datetime.fromtimestamp(1733328910)
+        for i in range(2):
+            with Session(
+                engine.execution_options(
+                    read_only=True,
+                    staleness={"read_timestamp": timestamp},
+                )
+            ) as session:
+                # Execute two queries in a read-only transaction.
+                session.scalars(select(Singer)).all()
+                session.scalars(select(Singer)).all()
+
+        # Verify the requests that we got.
+        requests = self.spanner_service.requests
+        eq_(7, len(requests))
+        is_instance_of(requests[0], BatchCreateSessionsRequest)
+        is_instance_of(requests[1], BeginTransactionRequest)
+        is_instance_of(requests[2], ExecuteSqlRequest)
+        is_instance_of(requests[3], ExecuteSqlRequest)
+        is_instance_of(requests[4], BeginTransactionRequest)
+        is_instance_of(requests[5], ExecuteSqlRequest)
+        is_instance_of(requests[6], ExecuteSqlRequest)
+        # Verify that the transaction is a read-only transaction.
+        for index in [1, 4]:
+            begin_request: BeginTransactionRequest = requests[index]
+            eq_(
+                TransactionOptions(
+                    dict(
+                        read_only=TransactionOptions.ReadOnly(
+                            dict(
+                                read_timestamp={"seconds": 1733328910},
+                                return_read_timestamp=True,
+                            )
+                        )
+                    )
+                ),
+                begin_request.options,
+            )
+
+    def test_stale_read_single_use(self):
+        from test.mockserver_tests.stale_read_model import Singer
+
+        add_singer_query_result("SELECT singers.id, singers.name\n" + "FROM singers")
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            echo=True,
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+
+        with Session(
+            engine.execution_options(
+                isolation_level="AUTOCOMMIT",
+                staleness={"max_staleness": {"seconds": 15}},
+            )
+        ) as session:
+            # Execute two queries in autocommit.
+            session.scalars(select(Singer)).all()
+            session.scalars(select(Singer)).all()
+
+        # Verify the requests that we got.
+        requests = self.spanner_service.requests
+        eq_(3, len(requests))
+        is_instance_of(requests[0], BatchCreateSessionsRequest)
+        is_instance_of(requests[1], ExecuteSqlRequest)
+        is_instance_of(requests[2], ExecuteSqlRequest)
+        # Verify that the requests use a stale read.
+        for index in [1, 2]:
+            execute_request: ExecuteSqlRequest = requests[index]
+            eq_(
+                TransactionOptions(
+                    dict(
+                        read_only=TransactionOptions.ReadOnly(
+                            dict(
+                                max_staleness={"seconds": 15},
+                                return_read_timestamp=True,
+                            )
+                        )
+                    )
+                ),
+                execute_request.transaction.single_use,
+            )
+
+
+def add_singer_query_result(sql: str):
+    result = result_set.ResultSet(
+        dict(
+            metadata=result_set.ResultSetMetadata(
+                dict(
+                    row_type=spanner_type.StructType(
+                        dict(
+                            fields=[
+                                spanner_type.StructType.Field(
+                                    dict(
+                                        name="singers_id",
+                                        type=spanner_type.Type(
+                                            dict(code=spanner_type.TypeCode.INT64)
+                                        ),
+                                    )
+                                ),
+                                spanner_type.StructType.Field(
+                                    dict(
+                                        name="singers_name",
+                                        type=spanner_type.Type(
+                                            dict(code=spanner_type.TypeCode.STRING)
+                                        ),
+                                    )
+                                ),
+                            ]
+                        )
+                    )
+                )
+            ),
+        )
+    )
+    result.rows.extend(
+        [
+            (
+                "1",
+                "Jane Doe",
+            ),
+            (
+                "2",
+                "John Doe",
+            ),
+        ]
+    )
+    add_result(sql, result)

From 7952799ae6789c36dd3c5d204c77935960720ffe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Mon, 9 Dec 2024 09:58:23 +0100
Subject: [PATCH 129/133] test: add tests for using json array (#534)

* test: add tests for using json array

Adds test to verify that using JSON with both an array and a dict
work as expected.

Fixes #404

* chore: remove GetSession checks in tests

---------

Co-authored-by: Sanjeev Bhatt <bhatt4982@gmail.com>
---
 test/mockserver_tests/json_model.py |  30 +++++
 test/mockserver_tests/test_json.py  | 186 ++++++++++++++++++++++++++++
 2 files changed, 216 insertions(+)
 create mode 100644 test/mockserver_tests/json_model.py
 create mode 100644 test/mockserver_tests/test_json.py

diff --git a/test/mockserver_tests/json_model.py b/test/mockserver_tests/json_model.py
new file mode 100644
index 00000000..7a8ca530
--- /dev/null
+++ b/test/mockserver_tests/json_model.py
@@ -0,0 +1,30 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import String, BigInteger
+from sqlalchemy.sql.sqltypes import JSON
+from sqlalchemy.orm import DeclarativeBase
+from sqlalchemy.orm import Mapped
+from sqlalchemy.orm import mapped_column
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class Venue(Base):
+    __tablename__ = "venues"
+    id: Mapped[int] = mapped_column(BigInteger, primary_key=True)
+    name: Mapped[str] = mapped_column(String)
+    description = mapped_column(JSON)
diff --git a/test/mockserver_tests/test_json.py b/test/mockserver_tests/test_json.py
new file mode 100644
index 00000000..d38eb704
--- /dev/null
+++ b/test/mockserver_tests/test_json.py
@@ -0,0 +1,186 @@
+# Copyright 2024 Google LLC All rights reserved.
+#
+# 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 sqlalchemy import create_engine, select
+from sqlalchemy.orm import Session
+from sqlalchemy.testing import eq_, is_instance_of
+from google.cloud.spanner_v1 import (
+    FixedSizePool,
+    ResultSet,
+    BatchCreateSessionsRequest,
+    ExecuteSqlRequest,
+    CommitRequest,
+    BeginTransactionRequest,
+    TypeCode,
+    JsonObject,
+)
+from test.mockserver_tests.mock_server_test_base import (
+    MockServerTestBase,
+    add_result,
+    add_update_count,
+)
+from google.cloud.spanner_admin_database_v1 import UpdateDatabaseDdlRequest
+import google.cloud.spanner_v1.types.type as spanner_type
+import google.cloud.spanner_v1.types.result_set as result_set
+
+
+class TestJson(MockServerTestBase):
+    def test_create_table(self):
+        from test.mockserver_tests.json_model import Base
+
+        add_result(
+            """SELECT true
+FROM INFORMATION_SCHEMA.TABLES
+WHERE TABLE_SCHEMA="" AND TABLE_NAME="venues"
+LIMIT 1
+""",
+            ResultSet(),
+        )
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+        Base.metadata.create_all(engine)
+        requests = self.database_admin_service.requests
+        eq_(1, len(requests))
+        is_instance_of(requests[0], UpdateDatabaseDdlRequest)
+        eq_(1, len(requests[0].statements))
+        eq_(
+            "CREATE TABLE venues (\n"
+            "\tid INT64 NOT NULL, \n"
+            "\tname STRING(MAX) NOT NULL, \n"
+            "\tdescription JSON\n"
+            ") PRIMARY KEY (id)",
+            requests[0].statements[0],
+        )
+
+    def test_insert_dict(self):
+        self._test_insert_json(
+            {"type": "Stadium", "size": "Great"}, '{"size":"Great","type":"Stadium"}'
+        )
+
+    def test_insert_array(self):
+        self._test_insert_json(
+            [{"type": "Stadium", "size": "Great"}],
+            '[{"size":"Great","type":"Stadium"}]',
+        )
+
+    def _test_insert_json(self, description, expected):
+        from test.mockserver_tests.json_model import Venue
+
+        add_update_count(
+            "INSERT INTO venues (id, name, description) VALUES (@a0, @a1, @a2)", 1
+        )
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+
+        with Session(engine) as session:
+            venue = Venue(id=1, name="Test", description=description)
+            session.add(venue)
+            session.commit()
+
+        # Verify the requests that we got.
+        requests = self.spanner_service.requests
+        eq_(4, len(requests))
+        is_instance_of(requests[0], BatchCreateSessionsRequest)
+        is_instance_of(requests[1], BeginTransactionRequest)
+        is_instance_of(requests[2], ExecuteSqlRequest)
+        is_instance_of(requests[3], CommitRequest)
+        request: ExecuteSqlRequest = requests[2]
+        eq_(3, len(request.params))
+        eq_("1", request.params["a0"])
+        eq_("Test", request.params["a1"])
+        eq_(expected, request.params["a2"])
+        eq_(TypeCode.INT64, request.param_types["a0"].code)
+        eq_(TypeCode.STRING, request.param_types["a1"].code)
+        eq_(TypeCode.JSON, request.param_types["a2"].code)
+
+    def test_select_dict(self):
+        self._test_select_json(
+            '{"size":"Great","type":"Stadium"}',
+            JsonObject({"size": "Great", "type": "Stadium"}),
+        )
+
+    def test_select_array(self):
+        self._test_select_json(
+            '[{"size":"Great","type":"Stadium"}]',
+            JsonObject([{"size": "Great", "type": "Stadium"}]),
+        )
+
+    def _test_select_json(self, description, expected):
+        from test.mockserver_tests.json_model import Venue
+
+        sql = "SELECT venues.id, venues.name, venues.description \n" "FROM venues"
+        add_venue_query_result(sql, description)
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": FixedSizePool(size=10)},
+        )
+
+        with Session(engine.execution_options(read_only=True)) as session:
+            venue = session.execute(select(Venue)).first()[0]
+            eq_(venue.description, expected)
+
+
+def add_venue_query_result(sql: str, description: str):
+    result = result_set.ResultSet(
+        dict(
+            metadata=result_set.ResultSetMetadata(
+                dict(
+                    row_type=spanner_type.StructType(
+                        dict(
+                            fields=[
+                                spanner_type.StructType.Field(
+                                    dict(
+                                        name="id",
+                                        type=spanner_type.Type(
+                                            dict(code=spanner_type.TypeCode.INT64)
+                                        ),
+                                    )
+                                ),
+                                spanner_type.StructType.Field(
+                                    dict(
+                                        name="name",
+                                        type=spanner_type.Type(
+                                            dict(code=spanner_type.TypeCode.STRING)
+                                        ),
+                                    )
+                                ),
+                                spanner_type.StructType.Field(
+                                    dict(
+                                        name="description",
+                                        type=spanner_type.Type(
+                                            dict(code=spanner_type.TypeCode.JSON)
+                                        ),
+                                    )
+                                ),
+                            ]
+                        )
+                    )
+                )
+            ),
+        )
+    )
+    result.rows.extend(
+        [
+            (
+                "1",
+                "Test",
+                description,
+            ),
+        ]
+    )
+    add_result(sql, result)

From 4b24f335ff918c7404201db16d05ccc817626dfe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Mon, 9 Dec 2024 10:08:17 +0100
Subject: [PATCH 130/133] fix: map now() to current_timestamp (#540)

Fixes #497
---
 .../sqlalchemy_spanner/sqlalchemy_spanner.py  |  3 +++
 .../mockserver_tests/mock_server_test_base.py | 17 +++++++++-----
 test/mockserver_tests/test_basics.py          | 23 +++++++++++++++++++
 3 files changed, 37 insertions(+), 6 deletions(-)

diff --git a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
index 09c7f9ae..e6042e31 100644
--- a/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
+++ b/google/cloud/sqlalchemy_spanner/sqlalchemy_spanner.py
@@ -235,6 +235,9 @@ def get_from_hint_text(self, _, text):
         """
         return text
 
+    def visit_now_func(self, func, **kwargs):
+        return "current_timestamp"
+
     def visit_empty_set_expr(self, type_, **kw):
         """Return an empty set expression of the given type.
 
diff --git a/test/mockserver_tests/mock_server_test_base.py b/test/mockserver_tests/mock_server_test_base.py
index 5aa33732..fa5ed4bd 100644
--- a/test/mockserver_tests/mock_server_test_base.py
+++ b/test/mockserver_tests/mock_server_test_base.py
@@ -22,6 +22,7 @@
     Client,
     ResultSet,
     PingingPool,
+    TypeCode,
 )
 from google.cloud.spanner_v1.database import Database
 from google.cloud.spanner_v1.instance import Instance
@@ -48,6 +49,12 @@ def add_update_count(
 
 
 def add_select1_result():
+    add_single_result("select 1", "c", TypeCode.INT64, [("1",)])
+
+
+def add_single_result(
+    sql: str, column_name: str, type_code: spanner_type.TypeCode, row
+):
     result = result_set.ResultSet(
         dict(
             metadata=result_set.ResultSetMetadata(
@@ -57,10 +64,8 @@ def add_select1_result():
                             fields=[
                                 spanner_type.StructType.Field(
                                     dict(
-                                        name="c",
-                                        type=spanner_type.Type(
-                                            dict(code=spanner_type.TypeCode.INT64)
-                                        ),
+                                        name=column_name,
+                                        type=spanner_type.Type(dict(code=type_code)),
                                     )
                                 )
                             ]
@@ -70,8 +75,8 @@ def add_select1_result():
             ),
         )
     )
-    result.rows.extend(["1"])
-    MockServerTestBase.spanner_service.mock_spanner.add_result("select 1", result)
+    result.rows.extend(row)
+    MockServerTestBase.spanner_service.mock_spanner.add_result(sql, result)
 
 
 class MockServerTestBase(fixtures.TestBase):
diff --git a/test/mockserver_tests/test_basics.py b/test/mockserver_tests/test_basics.py
index 82918366..28ea1b86 100644
--- a/test/mockserver_tests/test_basics.py
+++ b/test/mockserver_tests/test_basics.py
@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import datetime
 from google.cloud.spanner_admin_database_v1 import UpdateDatabaseDdlRequest
 from google.cloud.spanner_dbapi.parsed_statement import AutocommitDmlMode
 from sqlalchemy import (
@@ -22,6 +23,7 @@
     Column,
     Integer,
     String,
+    func,
     text,
 )
 from sqlalchemy.testing import eq_, is_instance_of
@@ -31,11 +33,13 @@
     ExecuteSqlRequest,
     ResultSet,
     PingingPool,
+    TypeCode,
 )
 from test.mockserver_tests.mock_server_test_base import (
     MockServerTestBase,
     add_select1_result,
     add_result,
+    add_single_result,
     add_update_count,
 )
 
@@ -70,6 +74,25 @@ def test_sqlalchemy_select1(self):
             results = connection.execute(select(1)).fetchall()
             self.verify_select1(results)
 
+    def test_sqlalchemy_select_now(self):
+        now = datetime.datetime.now(datetime.UTC)
+        iso_now = now.isoformat().replace("+00:00", "Z")
+        add_single_result(
+            "SELECT current_timestamp AS now_1",
+            "now_1",
+            TypeCode.TIMESTAMP,
+            [(iso_now,)],
+        )
+        engine = create_engine(
+            "spanner:///projects/p/instances/i/databases/d",
+            connect_args={"client": self.client, "pool": PingingPool(size=10)},
+        )
+        with engine.connect().execution_options(
+            isolation_level="AUTOCOMMIT"
+        ) as connection:
+            spanner_now = connection.execute(select(func.now())).fetchone()[0]
+            eq_(spanner_now.timestamp(), now.timestamp())
+
     def test_create_table(self):
         add_result(
             """SELECT true

From e4e8cd5ed1ddc51b85c3edebb1e5089f7b525d9a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Mon, 9 Dec 2024 10:18:20 +0100
Subject: [PATCH 131/133] test: add test with 'roles' table (#520)

* test: add test with 'roles' table

Add a test that verifies that a table with the same name as a
system view can be used.

* chore: fix linting
---
 test/system/test_basics.py | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/test/system/test_basics.py b/test/system/test_basics.py
index 171485b8..e3099912 100644
--- a/test/system/test_basics.py
+++ b/test/system/test_basics.py
@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from typing import Optional
 from sqlalchemy import (
     text,
     Table,
@@ -90,6 +91,30 @@ def test_reflect(self, connection):
         eq_(1, len(dialect_options["storing"]))
         eq_("alternative_name", dialect_options["storing"][0])
 
+    def test_table_name_overlapping_with_system_table(self, connection):
+        class Base(DeclarativeBase):
+            pass
+
+        class Role(Base):
+            __tablename__ = "roles"
+            id: Mapped[int] = mapped_column(Integer, primary_key=True)
+            name: Mapped[str] = mapped_column(String(100), nullable=True)
+            type: Mapped[str] = mapped_column(String(100), nullable=True)
+            description: Mapped[Optional[str]] = mapped_column(String(512))
+
+        engine = connection.engine
+        Base.metadata.create_all(engine)
+
+        with Session(engine) as session:
+            role = Role(
+                id=1,
+                name="Test",
+                type="Test",
+                description="Test",
+            )
+            session.add(role)
+            session.commit()
+
     def test_orm(self, connection):
         class Base(DeclarativeBase):
             pass

From c3b5df52c2fc62b11aa684c2d02dac95dd06ab59 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Knut=20Olav=20L=C3=B8ite?= <koloite@gmail.com>
Date: Mon, 9 Dec 2024 12:00:24 +0100
Subject: [PATCH 132/133] docs: cleanup the transaction section of README a bit
 (#545)

Cleans up the Transaction section of the README file a bit.
---
 README.rst | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/README.rst b/README.rst
index 852bdc5c..1ec9dfc9 100644
--- a/README.rst
+++ b/README.rst
@@ -80,7 +80,7 @@ on this step in a dialect prefix part:
    # for SQLAlchemy 1.3:
    spanner:///projects/project-id/instances/instance-id/databases/database-id
 
-   # for SQLAlchemy 1.4:
+   # for SQLAlchemy 1.4 and 2.0:
    spanner+spanner:///projects/project-id/instances/instance-id/databases/database-id
 
 To pass your custom client object directly to be be used, create engine as following:
@@ -237,7 +237,7 @@ Unique constraints
 ~~~~~~~~~~~~~~~~~~
 
 Cloud Spanner doesn't support direct UNIQUE constraints creation. In
-order to achieve column values uniqueness UNIQUE indexes should be used.
+order to achieve column values uniqueness, UNIQUE indexes should be used.
 
 Instead of direct UNIQUE constraint creation:
 
@@ -265,10 +265,16 @@ Autocommit mode
 ~~~~~~~~~~~~~~~
 
 Spanner dialect supports both ``SERIALIZABLE`` and ``AUTOCOMMIT``
-isolation levels. ``SERIALIZABLE`` is the default one, where
-transactions need to be committed manually. ``AUTOCOMMIT`` mode
-corresponds to automatically committing of a query right in its
-execution time.
+isolation levels. ``SERIALIZABLE`` is the default isolation level.
+
+``AUTOCOMMIT`` mode corresponds to automatically committing each
+insert/update/delete statement right after is has been executed.
+Queries that are executed in ``AUTOCOMMIT`` mode use a single-use
+read-only transaction. These do not take any locks and do not need
+to be committed.
+
+Workloads that only read data, should use either ``AUTOCOMMIT`` or
+a read-only transaction.
 
 Isolation level change example:
 
@@ -279,7 +285,7 @@ Isolation level change example:
    eng = create_engine("spanner:///projects/project-id/instances/instance-id/databases/database-id")
    autocommit_engine = eng.execution_options(isolation_level="AUTOCOMMIT")
 
-Automatic transactions retry
+Automatic transaction retry
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 In the default ``SERIALIZABLE`` mode transactions may fail with ``Aborted`` exception. This is a transient kind of errors, which mostly happen to prevent data corruption by concurrent modifications. Though the original transaction becomes non operational, a simple retry of the queries solves the issue.
 
@@ -287,8 +293,8 @@ This, however, may require to manually repeat a long list of operations, execute
 
 In ``AUTOCOMMIT`` mode automatic transactions retry mechanism is disabled, as every operation is committed just in time, and there is no way an ``Aborted`` exception can happen.
 
-Autoincremented IDs
-~~~~~~~~~~~~~~~~~~~
+Auto-incremented IDs
+~~~~~~~~~~~~~~~~~~~~
 
 Cloud Spanner doesn't support autoincremented IDs mechanism due to
 performance reasons (`see for more

From 39a41d942b58913582cbbcd99e063f9fcdb58ffc Mon Sep 17 00:00:00 2001
From: "release-please[bot]"
 <55107282+release-please[bot]@users.noreply.github.com>
Date: Mon, 9 Dec 2024 12:12:45 +0100
Subject: [PATCH 133/133] chore(main): release 1.8.0 (#415)

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
---
 CHANGELOG.md | 34 ++++++++++++++++++++++++++++++++++
 version.py   |  2 +-
 2 files changed, 35 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 83533552..fccd8630 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,39 @@
 # Changelog
 
+## [1.8.0](https://github.com/googleapis/python-spanner-sqlalchemy/compare/v1.7.0...v1.8.0) (2024-12-09)
+
+
+### Features
+
+* Add helper function for insert-or-update ([#526](https://github.com/googleapis/python-spanner-sqlalchemy/issues/526)) ([6ff12ec](https://github.com/googleapis/python-spanner-sqlalchemy/commit/6ff12ecf6f1883525a901df4b4103b45ca95abed)), closes [#391](https://github.com/googleapis/python-spanner-sqlalchemy/issues/391)
+* Support dml returning ([#335](https://github.com/googleapis/python-spanner-sqlalchemy/issues/335)) ([7db3f37](https://github.com/googleapis/python-spanner-sqlalchemy/commit/7db3f374510673d6521b16ca44d21043069d6ee7))
+* Support float32 ([#531](https://github.com/googleapis/python-spanner-sqlalchemy/issues/531)) ([6c3cb42](https://github.com/googleapis/python-spanner-sqlalchemy/commit/6c3cb42919c5c8d52719d855af4fc2bb22c13fae))
+* Support Partitioned DML ([#541](https://github.com/googleapis/python-spanner-sqlalchemy/issues/541)) ([108d965](https://github.com/googleapis/python-spanner-sqlalchemy/commit/108d965c60b6ea817de7fed86dca3d20f923d975)), closes [#496](https://github.com/googleapis/python-spanner-sqlalchemy/issues/496)
+
+
+### Bug Fixes
+
+* Add `existing_nullable` usage to `visit_column_type` ([#329](https://github.com/googleapis/python-spanner-sqlalchemy/issues/329)) ([273f03b](https://github.com/googleapis/python-spanner-sqlalchemy/commit/273f03bdf27c12317712a9939eedd25bd88c475a))
+* Map now() to current_timestamp ([#540](https://github.com/googleapis/python-spanner-sqlalchemy/issues/540)) ([4b24f33](https://github.com/googleapis/python-spanner-sqlalchemy/commit/4b24f335ff918c7404201db16d05ccc817626dfe)), closes [#497](https://github.com/googleapis/python-spanner-sqlalchemy/issues/497)
+* Support storing columns for indices ([#485](https://github.com/googleapis/python-spanner-sqlalchemy/issues/485)) ([93579c8](https://github.com/googleapis/python-spanner-sqlalchemy/commit/93579c8d6298dd9a07b2ca2b9c451036e33d2e6f))
+* Support THEN RETURN for insert, update, delete ([#503](https://github.com/googleapis/python-spanner-sqlalchemy/issues/503)) ([ac64472](https://github.com/googleapis/python-spanner-sqlalchemy/commit/ac644726665213f234ce8ec4dea715c820a670e9))
+
+
+### Dependencies
+
+* Add nh3 ([#481](https://github.com/googleapis/python-spanner-sqlalchemy/issues/481)) ([3c2bcf9](https://github.com/googleapis/python-spanner-sqlalchemy/commit/3c2bcf9901ce132a6d5d5d3b1ad3608526a378b5))
+* Add proto plus ([#482](https://github.com/googleapis/python-spanner-sqlalchemy/issues/482)) ([8663453](https://github.com/googleapis/python-spanner-sqlalchemy/commit/86634531793cf01b46cefe87f74375ee59060638))
+* Update all deps ([#413](https://github.com/googleapis/python-spanner-sqlalchemy/issues/413)) ([25d9d2c](https://github.com/googleapis/python-spanner-sqlalchemy/commit/25d9d2c32638eb3e551921eecea435452c548bcb))
+
+
+### Documentation
+
+* Add sample for read-only transactions ([#533](https://github.com/googleapis/python-spanner-sqlalchemy/issues/533)) ([d2d72b6](https://github.com/googleapis/python-spanner-sqlalchemy/commit/d2d72b6fad4ea457114a50a2869d053798fed452))
+* Add sample for stale reads ([#539](https://github.com/googleapis/python-spanner-sqlalchemy/issues/539)) ([e9df810](https://github.com/googleapis/python-spanner-sqlalchemy/commit/e9df8105b18e03dbf3b746fed85ffe9da286b953))
+* Add samples for Spanner-specific features ([#492](https://github.com/googleapis/python-spanner-sqlalchemy/issues/492)) ([a6ed382](https://github.com/googleapis/python-spanner-sqlalchemy/commit/a6ed382be2a7105f9e8b2f855df3919e8c6750c9))
+* Cleanup the transaction section of README a bit ([#545](https://github.com/googleapis/python-spanner-sqlalchemy/issues/545)) ([c3b5df5](https://github.com/googleapis/python-spanner-sqlalchemy/commit/c3b5df52c2fc62b11aa684c2d02dac95dd06ab59))
+* Fix readme typo ([#487](https://github.com/googleapis/python-spanner-sqlalchemy/issues/487)) ([b452b4f](https://github.com/googleapis/python-spanner-sqlalchemy/commit/b452b4f73d200b99fd800862c88304b67aa035c5))
+
 ## [1.7.0](https://github.com/googleapis/python-spanner-sqlalchemy/compare/v1.6.2...v1.7.0) (2024-02-07)
 
 
diff --git a/version.py b/version.py
index 5c96bcc4..fa701398 100644
--- a/version.py
+++ b/version.py
@@ -4,4 +4,4 @@
 # license that can be found in the LICENSE file or at
 # https://developers.google.com/open-source/licenses/bsd
 
-__version__ = "1.7.0"
+__version__ = "1.8.0"