feat(spanner): add native AsyncIO Spanner adapter, extension stores, and sync/async parity

.github/workflows/publish.yml

@@ -33,7 +33,7 @@ jobs:
         run: uv build --sdist
 
       - name: Upload source artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: source-dist
           path: dist/*.tar.gz
@@ -62,7 +62,7 @@ jobs:
         run: uv build --wheel
 
       - name: Upload wheel artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: wheels-standard
           path: dist/*.whl
@@ -179,7 +179,7 @@ jobs:
             MYPYC_OPT_LEVEL=3 MYPYC_DEBUG_LEVEL=0 MYPYC_MULTI_FILE=1
 
       - name: Upload wheel artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: wheels-mypyc-${{ matrix.os }}-py${{ matrix.python-version }}
           path: wheelhouse/*.whl
@@ -224,13 +224,13 @@ jobs:
         run: uv python install ${{ matrix.python-version }}
 
       - name: Download standard wheel artifacts
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           name: wheels-standard
           path: dist-standard/
 
       - name: Download mypyc wheel artifacts
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           pattern: wheels-mypyc-*
           merge-multiple: true
@@ -275,7 +275,7 @@ jobs:
           enable-cache: false
 
       - name: Download all artifacts
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           pattern: "*"
           merge-multiple: true

.github/workflows/test-build.yml

@@ -191,7 +191,7 @@ jobs:
         run: uv build --sdist
 
       - name: Upload source artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: source-dist
           path: dist/*.tar.gz
@@ -222,7 +222,7 @@ jobs:
         run: uv build --wheel
 
       - name: Upload wheel artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: wheels-standard
           path: dist/*.whl
@@ -349,7 +349,7 @@ jobs:
             MYPYC_OPT_LEVEL=3 MYPYC_DEBUG_LEVEL=0 MYPYC_MULTI_FILE=1
 
       - name: Upload wheel artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: wheels-mypyc-${{ matrix.os }}-py${{ matrix.python-version }}
           path: wheelhouse/*.whl
@@ -393,13 +393,13 @@ jobs:
         run: uv python install "$PYTHON_VERSION"
 
       - name: Download standard wheel artifacts
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           name: wheels-standard
           path: dist-standard/
 
       - name: Download mypyc wheel artifacts
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           pattern: wheels-mypyc-*
           merge-multiple: true
@@ -439,7 +439,7 @@ jobs:
           cache-dependency-glob: uv.lock
 
       - name: Download all artifacts
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           pattern: "*"
           merge-multiple: true

.pre-commit-config.yaml

@@ -18,7 +18,7 @@ repos:
       - id: mixed-line-ending
       - id: trailing-whitespace
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.16.8"
+    rev: "v0.16.9"
     hooks:
       - id: ruff-check
         args: ["--fix"]

docs/changelog.rst

@@ -9,6 +9,69 @@ important operational fixes.
 Recent Updates
 ==============
 
+Unreleased
+----------
+
+**Added:**
+
+* Spanner adds a native asyncio adapter built on the async Spanner client:
+  ``SpannerAsyncConfig`` and ``SpannerAsyncDriver`` support pooled sessions,
+  read and write sessions, ``run_in_transaction()`` with ``Aborted`` retries,
+  streaming selects, Arrow import and export, and ``SpannerAsyncDataDictionary``.
+  The sync adapter keeps its existing behavior.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+* Spanner ships async extension stores: ``SpannerAsyncADKStore`` and
+  ``SpannerAsyncADKMemoryStore`` for ADK, ``SpannerAsyncStore`` for Litestar
+  sessions, and ``SpannerAsyncEventQueueStore`` for event channels.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+* Spanner binds ``datetime.timedelta`` values and lists as ``INTERVAL``,
+  keeping day and microsecond precision and allowing null list elements.
+  Declare ``FLOAT32``, ``ARRAY<FLOAT32>``, or ``VECTOR`` parameters with
+  ``TypedParameter(value, semantic_name="FLOAT32")``.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+* Spanner runs SQL and Python migrations on both adapters. DDL statements go
+  through the database ``update_ddl`` schema API, scripts apply consecutive DDL
+  as one schema change, and a begun write transaction is committed before a
+  schema change.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+
+**Changed:**
+
+* Spanner sync classes now use the ``SpannerSync*`` prefix used by other
+  adapters, and the old names are removed: ``SpannerExceptionHandler`` is now
+  ``SpannerSyncExceptionHandler``, ``SpannerDataDictionary`` is now
+  ``SpannerSyncDataDictionary``, ``SpannerConnectionContext`` is now
+  ``SpannerSyncConnectionContext``, ``SpannerSessionContext`` is now
+  ``SpannerSyncSessionContext``, and ``SpannerConnection`` is now
+  ``SpannerSyncConnection``.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+
+**Fixed:**
+
+* Spanner write sessions, sync and async, commit on a clean exit and roll
+  back on an exception. After an explicit ``commit()`` or ``rollback()`` the
+  next statement runs in a new transaction instead of failing on the finished
+  one. A rollback also discards mutations buffered before the transaction
+  began, such as rows from ``load_from_arrow()``.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+* Spanner column DDL renders unsized text and binary columns as
+  ``STRING(MAX)`` and ``BYTES(MAX)``, and column defaults in the parentheses
+  Spanner requires.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+* Spanner DML with ``THEN RETURN`` (including ``WITH ACTION``) returns its
+  rows on both adapters instead of discarding them and reporting only a row
+  count.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+* Script splitting keeps semicolons inside backtick-quoted identifiers, which
+  split MySQL, BigQuery, and Spanner scripts in the wrong place.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+* Compiled wheels build again with mypy 2.4, which failed on loops over
+  ``reversed()``.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+* ``sqlspec`` imports on SQLGlot 30.13 through 30.17 again. The ``??`` JSONB
+  operator rendering is registered only on SQLGlot releases that define it.
+  (`#831 <https://github.com/litestar-org/sqlspec/pull/831>`_)
+
 v0.65.0 - IBM Db2 adapter, dialect isolation, and native adapter hardening
 -------------------------------------------------------------------------
 

docs/extensions/adk/adapters.rst

@@ -17,10 +17,10 @@ Use async adapters for best performance with ADK runners:
 - **Oracle**: ``oracledb``
 - **DuckDB**: ``duckdb`` (analytics; reduced-scope for ADK)
 - **ADBC**: ``adbc`` (Arrow-native portability; reduced-scope for ADK)
-- **Spanner**: ``spanner`` (Google Cloud, globally distributed)
+- **Spanner**: ``spanner`` (Google Cloud, globally distributed; supports both async and sync modes)
 - **SQL Server**: ``mssql_python`` (native Arrow and BulkCopy), ``pymssql`` (FreeTDS), ``arrow_odbc`` (Arrow over Microsoft ODBC Driver 18)
 
-Sync adapters (``psycopg`` sync mode, ``sqlite``, ``mysqlconnector``,
+Sync adapters (``psycopg`` sync mode, ``spanner`` sync mode, ``sqlite``, ``mysqlconnector``,
 ``pymysql``, ``mssql_python``, ``pymssql``, ``arrow_odbc``) work but require wrapping with ``anyio`` for async
 ADK runners.
 

docs/extensions/adk/backends.rst

@@ -112,7 +112,7 @@ The table below classifies every backend by its ADK support level.
      - Supported
      - Full
      - Full
-     - Google Cloud Spanner (cloud-managed).
+     - Google Cloud Spanner (cloud-managed; supports both sync and async modes).
    * - bigquery
      - Supported (Analytics)
      - Replay / Search
@@ -329,7 +329,9 @@ Driver 18:
 Spanner
 -------
 
-Google Cloud Spanner provides globally distributed ADK storage:
+Google Cloud Spanner provides globally distributed ADK storage in both native
+async (``SpannerAsyncADKStore`` / ``SpannerAsyncADKMemoryStore``) and sync
+(``SpannerSyncADKStore`` / ``SpannerSyncADKMemoryStore``) modes:
 
 - Cloud-managed, horizontally scalable.
 - Optional hash sharding via ``shard_count`` to reduce hot spots.

docs/reference/adapters/index.rst

@@ -83,7 +83,7 @@ exports a typed config class and a driver implementation.
       :link: spanner
       :link-type: doc
 
-      Google Cloud Spanner.
+      Sync + Async Google Cloud Spanner.
 
    .. grid-item-card:: CockroachDB + AsyncPG
       :link: cockroach_asyncpg
@@ -289,9 +289,9 @@ means the parameter pipeline preserves the Python value for the driver.
      - Text
    * - spanner
      - Yes
-     -
      - Yes
-     -
+     - Yes
+     - Yes
      -
      - Yes
      - Native