add testfiles

Author: euri10

docs/examples/usage/test_drivers_and_querying_1.py

@@ -0,0 +1,17 @@
+# Example from docs/usage/drivers_and_querying.rst - code-block 1
+# Typical driver usage
+from sqlspec import SQLSpec
+from sqlspec.adapters.asyncpg import AsyncpgConfig
+
+async def example():
+    spec = SQLSpec()
+    db = spec.add_config(AsyncpgConfig(pool_config={}))
+
+    async with spec.provide_session(db) as session:
+        result = await session.execute("SELECT 1")
+        print(result)
+
+if __name__ == "__main__":
+    import asyncio
+    asyncio.run(example())
+

docs/examples/usage/test_drivers_and_querying_10.py

@@ -0,0 +1,14 @@
+# Example from docs/usage/drivers_and_querying.rst - code-block 10
+from sqlspec.adapters.duckdb import DuckDBConfig
+
+# In-memory
+config_inmemory = DuckDBConfig()
+
+# Persistent
+config_persistent = DuckDBConfig(
+    pool_config={"database": "analytics.duckdb"}
+)
+
+# with spec.provide_session(config) as session:
+#    session.execute(...) etc.
+

docs/examples/usage/test_drivers_and_querying_11.py

@@ -0,0 +1,14 @@
+# Example from docs/usage/drivers_and_querying.rst - code-block 11
+from sqlspec.adapters.oracledb import OracleDBConfig
+
+config = OracleDBConfig(
+    pool_config={
+        "user": "myuser",
+        "password": "mypassword",
+        "dsn": "localhost:1521/ORCLPDB",
+    }
+)
+
+# with spec.provide_session(config) as session:
+#     result = session.execute("SELECT * FROM employees WHERE employee_id = :id", id=100)
+

docs/examples/usage/test_drivers_and_querying_12.py

@@ -0,0 +1,14 @@
+# Example from docs/usage/drivers_and_querying.rst - code-block 12
+from sqlspec.adapters.bigquery import BigQueryConfig
+import datetime
+
+config = BigQueryConfig(
+    pool_config={
+        "project": "my-project",
+        "credentials": None,
+    }
+)
+
+# 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))
+

docs/examples/usage/test_drivers_and_querying_13.py

@@ -0,0 +1,24 @@
+# Example from docs/usage/drivers_and_querying.rst - code-block 13
+# SELECT query example
+# result = session.execute("SELECT * FROM users WHERE id = ?", 1)
+
+# 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.
+

docs/examples/usage/test_drivers_and_querying_14.py

@@ -0,0 +1,22 @@
+# 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"),
+#     ]
+# )
+
+# Batch update example
+# session.execute_many(
+#     "UPDATE users SET status = ? WHERE id = ?",
+#     [
+#         ("active", 1),
+#         ("inactive", 2),
+#     ]
+# )
+
+# Examples require a session object to run.
+

docs/examples/usage/test_drivers_and_querying_15.py

@@ -0,0 +1,7 @@
+# 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
+
+# Placeholder only
+

docs/examples/usage/test_drivers_and_querying_16.py

@@ -0,0 +1,8 @@
+# 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
+
+# Placeholder only
+

docs/examples/usage/test_drivers_and_querying_17.py

@@ -0,0 +1,8 @@
+# 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
+
+# Placeholder only
+

docs/examples/usage/test_drivers_and_querying_18.py

@@ -0,0 +1,7 @@
+# Example from docs/usage/drivers_and_querying.rst - code-block 18
+# select_value example
+# count = session.select_value("SELECT COUNT(*) FROM users")
+# latest_id = session.select_value("SELECT MAX(id) FROM users")
+
+# Placeholder only
+