fix(query builder): correct edge cases and typing of query builder (#250)

Usages updates & bug fixes

Author: euri10

.gemini/bootstrap.md

@@ -106,7 +106,10 @@ jobs:
         run: uv sync --all-extras --dev
 
       - name: Test
-        run: uv run pytest -n 2 --dist=loadgroup
+        env:
+          PYTHONFAULTHANDLER: "1"
+          PYTEST_ADDOPTS: "--max-worker-restart=0 -s"
+        run: timeout 900s uv run pytest -n 2 --dist=loadgroup
 
   # test-windows:
   #   runs-on: windows-latest

.github/workflows/ci.yml

@@ -17,7 +17,7 @@ repos:
       - id: mixed-line-ending
       - id: trailing-whitespace
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: "v0.14.5"
+    rev: "v0.14.6"
     hooks:
       - id: ruff
         args: ["--fix"]
@@ -40,7 +40,7 @@ repos:
       - id: slotscheck
         exclude: "docs|.github"
   - repo: https://github.com/sphinx-contrib/sphinx-lint
-    rev: "v1.0.1"
+    rev: "v1.0.2"
     hooks:
       - id: sphinx-lint
         args: ["--jobs", "1"]

.pre-commit-config.yaml

@@ -2,6 +2,8 @@
 
 import pytest
 
+pytestmark = pytest.mark.xdist_group("postgres")
+
 __all__ = ("test_quickstart_5",)
 
 

AGENTS.md

@@ -2,6 +2,7 @@
 
 
 def test_sqlite_memory_db() -> None:
+    from rich import print
 
     # start-example
     from sqlspec import SQLSpec
@@ -15,6 +16,7 @@ def test_sqlite_memory_db() -> None:
 
     # Use the database
     with db_manager.provide_session(db) as session:
-        result = session.execute("SELECT 1")
+        value = session.select_value("SELECT 1")
+        print(value)
         # end-example
-        assert result[0] == {"1": 1}
+        assert value == 1

docs/examples/quickstart/quickstart_5.py

@@ -1,3 +1,7 @@
+import pytest
+
+pytestmark = pytest.mark.xdist_group("postgres")
+
 __all__ = ("test_manual_pool",)
 
 

docs/examples/usage/usage_configuration_1.py

@@ -1,3 +1,7 @@
+import pytest
+
+pytestmark = pytest.mark.xdist_group("postgres")
+
 __all__ = ("test_basic_statement_config",)
 
 

docs/examples/usage/usage_configuration_10.py

@@ -1,5 +1,9 @@
 """Test configuration example: Binding multiple database configurations."""
 
+import pytest
+
+pytestmark = pytest.mark.xdist_group("postgres")
+
 __all__ = ("test_binding_multiple_configs",)
 
 

docs/examples/usage/usage_configuration_12.py

@@ -1,5 +1,9 @@
 """Test configuration example: Named database bindings."""
 
+import pytest
+
+pytestmark = pytest.mark.xdist_group("postgres")
+
 __all__ = ("test_named_bindings",)