1 to 9 manually tested

Author: euri10

docs/examples/usage/conftest.py

@@ -0,0 +1 @@
+pytest_plugins = ["pytest_databases.docker.postgres", "pytest_databases.docker.mysql"]

docs/examples/usage/test_drivers_and_querying_1.py

@@ -1,17 +1,25 @@
-# Example from docs/usage/drivers_and_querying.rst - code-block 1
-# Typical driver usage
-from sqlspec import SQLSpec
-from sqlspec.adapters.asyncpg import AsyncpgConfig
+# Test module converted from docs example - code-block 1
+"""Minimal smoke test for drivers_and_querying example 1."""
 
-async def example():
-    spec = SQLSpec()
-    db = spec.add_config(AsyncpgConfig(pool_config={}))
+from pytest_databases.docker.postgres import PostgresService
 
-    async with spec.provide_session(db) as session:
-        result = await session.execute("SELECT 1")
-        print(result)
+from sqlspec import SQLSpec
+from sqlspec.adapters.asyncpg import AsyncpgConfig, AsyncpgPoolConfig
 
-if __name__ == "__main__":
-    import asyncio
-    asyncio.run(example())
 
+async def test_importable_1(postgres_service: PostgresService) -> None:
+    # Typical driver usage
+    spec = SQLSpec()
+    db = spec.add_config(
+        AsyncpgConfig(
+            pool_config=AsyncpgPoolConfig(
+                host=postgres_service.host,
+                port=postgres_service.port,
+                user=postgres_service.user,
+                password=postgres_service.password,
+                database=postgres_service.database,
+            )
+        )
+    )  # Config layer, registers pool
+    async with spec.provide_session(db) as session:  # Session layer
+        await session.execute("SELECT 1")  # Driver layer

docs/examples/usage/test_drivers_and_querying_10.py

@@ -1,14 +1,10 @@
-# Example from docs/usage/drivers_and_querying.rst - code-block 10
-from sqlspec.adapters.duckdb import DuckDBConfig
-
-# In-memory
-config_inmemory = DuckDBConfig()
+# Test module converted from docs example - code-block 10
+"""Minimal smoke test for drivers_and_querying example 10."""
 
-# Persistent
-config_persistent = DuckDBConfig(
-    pool_config={"database": "analytics.duckdb"}
-)
+from sqlspec.adapters.duckdb import DuckDBConfig
 
-# with spec.provide_session(config) as session:
-#    session.execute(...) etc.
 
+def test_example_10_duckdb_config() -> None:
+    DuckDBConfig()
+    config_persistent = DuckDBConfig(pool_config={"database": "analytics.duckdb"})
+    assert config_persistent.pool_config["database"] == "analytics.duckdb"

docs/examples/usage/test_drivers_and_querying_11.py

@@ -1,14 +1,9 @@
-# Example from docs/usage/drivers_and_querying.rst - code-block 11
-from sqlspec.adapters.oracledb import OracleDBConfig
+# Test module converted from docs example - code-block 11
+"""Minimal smoke test for drivers_and_querying example 11."""
 
-config = OracleDBConfig(
-    pool_config={
-        "user": "myuser",
-        "password": "mypassword",
-        "dsn": "localhost:1521/ORCLPDB",
-    }
-)
+from sqlspec.adapters.oracledb import OracleDBConfig
 
-# with spec.provide_session(config) as session:
-#     result = session.execute("SELECT * FROM employees WHERE employee_id = :id", id=100)
 
+def test_example_11_oracledb_config() -> None:
+    config = OracleDBConfig(pool_config={"user": "myuser", "password": "mypassword", "dsn": "localhost:1521/ORCLPDB"})
+    assert "dsn" in config.pool_config

docs/examples/usage/test_drivers_and_querying_12.py

@@ -1,14 +1,9 @@
-# Example from docs/usage/drivers_and_querying.rst - code-block 12
-from sqlspec.adapters.bigquery import BigQueryConfig
-import datetime
+# Test module converted from docs example - code-block 12
+"""Minimal smoke test for drivers_and_querying example 12."""
 
-config = BigQueryConfig(
-    pool_config={
-        "project": "my-project",
-        "credentials": None,
-    }
-)
+from sqlspec.adapters.bigquery import BigQueryConfig
 
-# with spec.provide_session(config) as session:
-#     result = session.execute("SELECT DATE(timestamp) as date, COUNT(*) as events FROM `project.dataset.events` WHERE timestamp >= @start_date GROUP BY date", start_date=datetime.date(2025,1,1))
 
+def test_example_12_bigquery_config() -> None:
+    config = BigQueryConfig(pool_config={"project": "my-project", "credentials": None})
+    assert config.pool_config["project"] == "my-project"

docs/examples/usage/test_drivers_and_querying_13.py

@@ -1,24 +1,7 @@
-# Example from docs/usage/drivers_and_querying.rst - code-block 13
-# SELECT query example
-# result = session.execute("SELECT * FROM users WHERE id = ?", 1)
+# Test module converted from docs example - code-block 13
+"""Minimal smoke test for drivers_and_querying example 13."""
 
-# INSERT query example
-# result = session.execute(
-#     "INSERT INTO users (name, email) VALUES (?, ?)",
-#     "Alice",
-#     "alice@example.com"
-# )
-
-# UPDATE example
-# result = session.execute(
-#     "UPDATE users SET email = ? WHERE id = ?",
-#     "newemail@example.com",
-#     1
-# )
-# print(f"Updated {result.rows_affected} rows")
-
-# DELETE example
-# result = session.execute("DELETE FROM users WHERE id = ?", 1)
-
-# These lines are examples and require a session object to run.
 
+def test_example_13_placeholder() -> None:
+    # Examples are documentation snippets; ensure module importable
+    assert True

docs/examples/usage/test_drivers_and_querying_14.py

@@ -1,22 +1,7 @@
-# Example from docs/usage/drivers_and_querying.rst - code-block 14
-# Batch insert example
-# session.execute_many(
-#     "INSERT INTO users (name, email) VALUES (?, ?)",
-#     [
-#         ("Alice", "alice@example.com"),
-#         ("Bob", "bob@example.com"),
-#         ("Charlie", "charlie@example.com"),
-#     ]
-# )
+# Test module converted from docs example - code-block 14
+"""Minimal smoke test for drivers_and_querying example 14."""
 
-# Batch update example
-# session.execute_many(
-#     "UPDATE users SET status = ? WHERE id = ?",
-#     [
-#         ("active", 1),
-#         ("inactive", 2),
-#     ]
-# )
-
-# Examples require a session object to run.
 
+def test_example_14_placeholder() -> None:
+    # Batch examples are documentation-only
+    assert True

docs/examples/usage/test_drivers_and_querying_15.py

@@ -1,7 +1,6 @@
-# Example from docs/usage/drivers_and_querying.rst - code-block 15
-# SELECT and all() example
-# users = session.execute("SELECT * FROM users WHERE status = ?", "active")
-# returns list of dicts
+# Test module converted from docs example - code-block 15
+"""Minimal smoke test for drivers_and_querying example 15."""
 
-# Placeholder only
 
+def test_example_15_placeholder() -> None:
+    assert True

docs/examples/usage/test_drivers_and_querying_16.py

@@ -1,8 +1,6 @@
-# Example from docs/usage/drivers_and_querying.rst - code-block 16
-# select_one example
-# user = session.select_one("SELECT * FROM users WHERE id = ?", 1)
-# Raises NotFoundError if no results
-# Raises MultipleResultsFoundError if multiple results
+# Test module converted from docs example - code-block 16
+"""Minimal smoke test for drivers_and_querying example 16."""
 
-# Placeholder only
 
+def test_example_16_placeholder() -> None:
+    assert True

docs/examples/usage/test_drivers_and_querying_17.py

@@ -1,8 +1,6 @@
-# Example from docs/usage/drivers_and_querying.rst - code-block 17
-# select_one_or_none example
-# user = session.select_one_or_none("SELECT * FROM users WHERE email = ?", "nobody@example.com")
-# Returns dict or None
-# Raises MultipleResultsFoundError if multiple results
+# Test module converted from docs example - code-block 17
+"""Minimal smoke test for drivers_and_querying example 17."""
 
-# Placeholder only
 
+def test_example_17_placeholder() -> None:
+    assert True