10 and 11

Author: euri10

docs/examples/usage/conftest.py

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

docs/examples/usage/test_drivers_and_querying_10.py

@@ -5,6 +5,27 @@
 
 
 def test_example_10_duckdb_config() -> None:
-    DuckDBConfig()
-    config_persistent = DuckDBConfig(pool_config={"database": "analytics.duckdb"})
-    assert config_persistent.pool_config["database"] == "analytics.duckdb"
+    from sqlspec import SQLSpec
+
+    spec = SQLSpec()
+    # In-memory
+    config = DuckDBConfig()
+
+    # Persistent
+    config = DuckDBConfig(pool_config={"database": "analytics.duckdb"})
+
+    with spec.provide_session(config) as session:
+        # Create table from Parquet
+        session.execute("""
+           CREATE TABLE users AS
+           SELECT * FROM read_parquet('users.parquet')
+       """)
+
+        # Analytical query
+        session.execute("""
+           SELECT date_trunc('day', created_at) as day,
+                  count(*) as user_count
+           FROM users
+           GROUP BY day
+           ORDER BY day
+       """)

docs/examples/usage/test_drivers_and_querying_11.py

@@ -1,9 +1,33 @@
 # Test module converted from docs example - code-block 11
 """Minimal smoke test for drivers_and_querying example 11."""
 
-from sqlspec.adapters.oracledb import OracleDBConfig
+from pytest_databases.docker.oracle import OracleService
 
 
-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
+def test_example_11_oracledb_config(oracle_service: OracleService) -> None:
+    from sqlspec import SQLSpec
+    from sqlspec.adapters.oracledb import OracleSyncConfig
+
+    spec = SQLSpec()
+    config = OracleSyncConfig(
+        pool_config={
+            "user": oracle_service.user,
+            "password": oracle_service.password,
+            "host": oracle_service.host,
+            "port": oracle_service.port,
+            "service_name": oracle_service.service_name,
+        }
+    )
+
+    with spec.provide_session(config) as session:
+        create_table_sql = """CREATE TABLE employees (
+           employee_id NUMBER PRIMARY KEY,
+           first_name VARCHAR2(50),
+           last_name VARCHAR2(50)
+       )"""
+        session.execute(create_table_sql)
+        session.execute("""
+           INSERT INTO employees (employee_id, first_name, last_name) VALUES (100, 'John', 'Doe')
+       """)
+
+        session.execute("SELECT * FROM employees WHERE employee_id = :id", id=100)

docs/usage/drivers_and_querying.rst

@@ -185,33 +185,10 @@ DuckDB (Analytical Database)
 
 In-process analytical database optimized for OLAP workloads.
 
-.. code-block:: python
-
-   from sqlspec.adapters.duckdb import DuckDBConfig
-
-   # In-memory
-   config = DuckDBConfig()
-
-   # Persistent
-   config = DuckDBConfig(
-       pool_config={"database": "analytics.duckdb"}
-   )
-
-   with spec.provide_session(config) as session:
-       # Create table from Parquet
-       session.execute("""
-           CREATE TABLE users AS
-           SELECT * FROM read_parquet('users.parquet')
-       """)
-
-       # Analytical query
-       result = session.execute("""
-           SELECT date_trunc('day', created_at) as day,
-                  count(*) as user_count
-           FROM users
-           GROUP BY day
-           ORDER BY day
-       """)
+.. literalinclude:: /examples/test_drivers_and_querying_10.py
+   :language: python
+   :lines: 8-34
+   :dedent: 2
 
 **Features**:
 
@@ -225,23 +202,10 @@ Oracle Database
 
 Oracle database support with python-oracledb.
 
-.. code-block:: python
-
-   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
-       )
+.. literalinclude:: /examples/test_drivers_and_querying_11.py
+   :language: python
+   :lines: 8-33
+   :dedent: 2
 
 **Features**: