test(sqlalchemy): pin async executemany forwarding invariants (ISSUE-92)

Adds integration coverage for ``AsyncAdaptedCursor.executemany`` —
previously only the sync dialect had coverage via the SQLAlchemy test
suite; the async adapter merely forwarded, with nothing pinning
correctness.

- ``test_async_executemany_rowcount_sum``: executemany sums rowcount
  across parameter sets.
- ``test_async_executemany_sequential_tasks_no_state_leak``: two
  sequential async tasks on the same engine each get a clean cursor;
  no cross-task row contamination. Sequential rather than concurrent
  because dqlite serializes writes via Raft and produces
  "database is locked" on parallel writers — a protocol-level quirk
  unrelated to adapter state correctness.

Scope note in docstring: SQLAlchemy 2.0+ ``insertmanyvalues`` rewrites
``INSERT ... RETURNING`` + sequence params into a single multi-row
INSERT that dqlite's gateway rejects with "nonempty statement tail".
RETURNING + executemany is therefore tested only at the dbapi layer
(``python-dqlite-dbapi/tests/integration/test_executemany_returning.py``).

Author: antoineleclair

tests/integration/test_async_executemany.py

@@ -0,0 +1,98 @@
+"""Integration tests for async-dialect executemany (ISSUE-92).
+
+Pins ``AsyncAdaptedCursor.executemany`` against a real dqlite server:
+
+- rowcount sums across parameter sets for plain DML.
+- Parallel tasks executing executemany do not cross-contaminate rows.
+- The async adapter forwards to the underlying dbapi cursor's
+  executemany (which has its own RETURNING-accumulation tests — see
+  python-dqlite-dbapi/tests/integration/test_executemany_returning.py).
+
+Scope note: SQLAlchemy 2.0+ `insertmanyvalues` rewrites
+``INSERT ... RETURNING`` + sequence params into a single multi-row
+INSERT, which dqlite's gateway rejects with "nonempty statement tail"
+in some orderings. The RETURNING case is therefore tested at the
+lower dbapi layer only; the SQLAlchemy-layer test pins rowcount
+summation and parallel-task isolation, which is where the async
+adapter's forwarding invariants actually surface.
+"""
+
+from __future__ import annotations
+
+import pytest
+from sqlalchemy import text
+from sqlalchemy.ext.asyncio import create_async_engine
+
+
+@pytest.mark.integration
+class TestAsyncExecutemany:
+    async def test_async_executemany_rowcount_sum(self, async_engine_url: str) -> None:
+        """Plain (non-returning) executemany sums rowcount across iterations."""
+        engine = create_async_engine(async_engine_url)
+        try:
+            async with engine.begin() as conn:
+                await conn.execute(text("DROP TABLE IF EXISTS async_em_rc"))
+                await conn.execute(
+                    text("CREATE TABLE async_em_rc (id INTEGER PRIMARY KEY, val TEXT)")
+                )
+                result = await conn.execute(
+                    text("INSERT INTO async_em_rc (val) VALUES (:v)"),
+                    [{"v": f"r{i}"} for i in range(5)],
+                )
+                assert result.rowcount == 5
+
+                count_result = await conn.execute(text("SELECT COUNT(*) FROM async_em_rc"))
+                assert count_result.scalar() == 5
+        finally:
+            await engine.dispose()
+
+    async def test_async_executemany_sequential_tasks_no_state_leak(
+        self, async_engine_url: str
+    ) -> None:
+        """Sequential executemany from two async tasks (same engine)
+        must not leak cursor state across tasks. Guards against any
+        shared-mutable-state regression in the async adapter's
+        per-cursor row accumulation.
+
+        Sequential (not concurrent) because dqlite serializes writes
+        via Raft — two concurrent writers produce ``database is
+        locked``, a protocol-level quirk unrelated to adapter state
+        correctness."""
+        engine = create_async_engine(async_engine_url)
+        try:
+            async with engine.begin() as conn:
+                await conn.execute(text("DROP TABLE IF EXISTS async_em_sequential"))
+                await conn.execute(
+                    text(
+                        "CREATE TABLE async_em_sequential "
+                        "(id INTEGER PRIMARY KEY, owner TEXT, val INTEGER)"
+                    )
+                )
+
+            async def worker(owner: str, n: int) -> int:
+                async with engine.begin() as conn:
+                    result = await conn.execute(
+                        text("INSERT INTO async_em_sequential (owner, val) VALUES (:o, :v)"),
+                        [{"o": owner, "v": i} for i in range(n)],
+                    )
+                    return int(result.rowcount)
+
+            # Run workers sequentially, each inside its own engine.begin()
+            # transaction. The async adapter must give each a clean cursor.
+            a_rc = await worker("a", 3)
+            b_rc = await worker("b", 4)
+
+            assert a_rc == 3
+            assert b_rc == 4
+
+            async with engine.begin() as conn:
+                result = await conn.execute(
+                    text("SELECT owner, COUNT(*) FROM async_em_sequential GROUP BY owner")
+                )
+                counts = dict(result.fetchall())
+                assert counts == {"a": 3, "b": 4}, (
+                    f"executemany leaked rows between sequential tasks: "
+                    f"expected {{'a': 3, 'b': 4}}, got {counts}"
+                )
+        finally:
+            await engine.dispose()