sqlspec 0.42.0__tar.gz → 0.43.0__tar.gz

{sqlspec-0.42.0 → sqlspec-0.43.0}/.pre-commit-config.yaml

@@ -17,7 +17,7 @@ repos:
       - id: mixed-line-ending
       - id: trailing-whitespace
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: "v0.15.7"
+    rev: "v0.15.9"
     hooks:
       - id: ruff
         args: ["--fix"]

{sqlspec-0.42.0 → sqlspec-0.43.0}/Makefile

@@ -79,10 +79,6 @@ upgrade:                                            ## Upgrade all dependencies
 	@uv run pre-commit autoupdate
 	@echo "${OK} Updated Pre-commit hooks 🔄"
 	@uv lock >/dev/null 2>&1
-	@echo ""
-	@echo "${WARN} mysql-connector-python is pinned via [tool.uv] exclude-newer-package in pyproject.toml"
-	@echo "${INFO} Check https://pypi.org/project/mysql-connector-python/#files for Python 3.12+ wheels."
-	@echo "${INFO} Once Oracle fixes their packaging, remove the constraint from pyproject.toml."
 
 .PHONY: lock
 lock:                                              ## Rebuild lockfiles from scratch

{sqlspec-0.42.0 → sqlspec-0.43.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlspec
-Version: 0.42.0
+Version: 0.43.0
 Summary: SQL Experiments in Python
 Project-URL: Discord, https://discord.gg/litestar
 Project-URL: Issue, https://github.com/litestar-org/sqlspec/issues/

{sqlspec-0.42.0 → sqlspec-0.43.0}/pyproject.toml

@@ -24,7 +24,7 @@ maintainers = [{ name = "Litestar Developers", email = "hello@litestar.dev" }]
 name = "sqlspec"
 readme = "README.md"
 requires-python = ">=3.10, <4.0"
-version = "0.42.0"
+version = "0.43.0"
 
 [project.urls]
 Discord = "https://discord.gg/litestar"
@@ -70,7 +70,7 @@ uuid = ["uuid-utils"]
 
 [dependency-groups]
 benchmarks = ["sqlalchemy[asyncio]", "psutil", "types-psutil", "duckdb-engine>=0.17.0"]
-build = ["bump-my-version", "hatch-mypyc", "pydantic-settings"]
+build = ["bump-my-version", "hatch-mypyc", "mypy>=1.19.1", "pydantic-settings"]
 dev = [
   { include-group = "extras" },
   { include-group = "lint" },
@@ -94,7 +94,6 @@ doc = [
   "sphinxcontrib-mermaid>=0.9.2",
   "sphinx-paramlinks>=0.6.0",
   "sphinx-togglebutton>=0.3.2",
-  "sphinx-toolbox>=3.8.1",
   "myst-parser",
   "sphinx-autodoc-typehints",
   "numpydoc",
@@ -115,7 +114,7 @@ extras = [
   "dishka",
 ]
 lint = [
-  "mypy>=1.13.0",
+  "mypy>=1.19.1",
   "pre-commit>=3.5.0",
   "pyright>=1.1.386",
   "ruff>=0.7.1",
@@ -147,12 +146,6 @@ test = [
   "pytest-timeout>=2.3.1",
 ]
 
-[tool.uv]
-# NOTE: mysql-connector-python 9.6.0 (released 2026-01-21) removed Python 3.12+ wheels.
-# This is an Oracle packaging bug. Pinning to versions before that date until fixed.
-# Check https://pypi.org/project/mysql-connector-python/#files for updates.
-exclude-newer-package = { mysql-connector-python = "2026-01-20" }
-
 [project.scripts]
 sqlspec = "sqlspec.__main__:run_cli"
 
@@ -176,7 +169,7 @@ packages = ["sqlspec"]
 
 
 [tool.hatch.build.targets.wheel.hooks.mypyc]
-dependencies = ["hatch-mypyc", "hatch-cython"]
+dependencies = ["hatch-mypyc", "hatch-cython", "mypy>=1.19.1"]
 enable-by-default = false
 exclude = [
   "tests/**",                                 # Test files
@@ -187,21 +180,17 @@ exclude = [
   "sqlspec/**/_typing.py",                    # Type aliases (mypyc-incompatible)
   "sqlspec/config.py",                        # Main config
   "sqlspec/extensions/**",                    # All extensions
+  "sqlspec/dialects/**/*.py",                 # Keep SQLGlot dialect subclasses interpreted
   "sqlspec/**/__init__.py",                   # Init files (usually just imports)
   "sqlspec/protocols.py",                     # Protocol definitions
   "sqlspec/adapters/mock/**",                 # Mock adapter (testing only)
   "sqlspec/migrations/commands.py",           # Migration command CLI (dynamic imports)
   "sqlspec/data_dictionary/_loader.py",       # Loader relies on __file__ which fails in compiled modules
-  "sqlspec/dialects/postgres/_pgvector.py",   # Dialect shell patches compiled sqlglot parser/generator registries
-  "sqlspec/dialects/postgres/_paradedb.py",   # Dialect shell patches compiled sqlglot parser/generator registries
-  "sqlspec/dialects/spanner/_spanner.py",     # Dialect shell patches compiled sqlglot parser hooks and post-processes DDL
-  "sqlspec/dialects/spanner/_spangres.py",    # Dialect shell patches compiled sqlglot parser hooks
   "sqlspec/extensions/fastapi/providers.py",  # Uses SingletonMeta metaclass
   "sqlspec/extensions/litestar/providers.py", # Uses SingletonMeta metaclass
   "sqlspec/adapters/**/data_dictionary.py",   # Cross-module inheritance causes mypyc segfaults
   "sqlspec/observability/_formatting.py",     # Inherits from non-compiled logging.Formatter
   "sqlspec/utils/arrow_helpers.py",           # Arrow operations cause segfaults when compiled
-  "sqlspec/storage/backends/_iterators.py",   # Async __anext__ + asyncio.to_thread causes mypyc segfault
 ]
 include = [
   "sqlspec/core/**/*.py",                  # Core module
@@ -212,7 +201,7 @@ include = [
   "sqlspec/driver/**/*.py",                # Driver module
   "sqlspec/storage/registry.py",           # Safe storage registry/runtime routing
   "sqlspec/storage/errors.py",             # Safe storage error normalization
-  "sqlspec/storage/backends/base.py",      # Storage backend runtime base classes (iterators in _iterators.py)
+  "sqlspec/storage/backends/base.py",      # Storage backend runtime base classes
   "sqlspec/data_dictionary/**/*.py",       # Data dictionary mixin (required for adapter inheritance)
   "sqlspec/adapters/**/core.py",           # Adapter compiled helpers
   "sqlspec/adapters/**/type_converter.py", # All adapters type converters
@@ -254,7 +243,7 @@ opt_level = "3"   # Maximum optimization (0-3)
 allow_dirty = true
 commit = false
 commit_args = "--no-verify"
-current_version = "0.42.0"
+current_version = "0.43.0"
 ignore_missing_files = false
 ignore_missing_version = false
 message = "chore(release): bump to v{new_version}"
@@ -409,11 +398,7 @@ warn_unused_ignores = true
 ignore_missing_imports = true
 module = [
   "orjson",
-  "re2",
-  "re2.*",
   "uvicorn.*",
-  "googleapiclient",
-  "googleapiclient.*",
   "uvloop.*",
   "asyncmy",
   "asyncmy.*",
@@ -428,8 +413,6 @@ module = [
   "fsspec.*",
   "sqlglot",
   "sqlglot.*",
-  "pgvector",
-  "pgvector.*",
   "minio",
 ]
 

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/adbc/__init__.py

@@ -1,5 +1,13 @@
 from sqlspec.adapters.adbc._typing import AdbcConnection
-from sqlspec.adapters.adbc.config import AdbcConfig, AdbcConnectionParams
+from sqlspec.adapters.adbc.config import AdbcConfig, AdbcConnectionParams, AdbcDriverFeatures
 from sqlspec.adapters.adbc.driver import AdbcCursor, AdbcDriver, AdbcExceptionHandler
 
-__all__ = ("AdbcConfig", "AdbcConnection", "AdbcConnectionParams", "AdbcCursor", "AdbcDriver", "AdbcExceptionHandler")
+__all__ = (
+    "AdbcConfig",
+    "AdbcConnection",
+    "AdbcConnectionParams",
+    "AdbcCursor",
+    "AdbcDriver",
+    "AdbcDriverFeatures",
+    "AdbcExceptionHandler",
+)

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/adbc/config.py

@@ -171,6 +171,14 @@ class AdbcConfig(NoPoolSyncConfig[AdbcConnection, AdbcDriver]):
 
     Supports multiple database backends including PostgreSQL, SQLite, DuckDB,
     BigQuery, and Snowflake with automatic driver detection and loading.
+
+    Example::
+
+        config = AdbcConfig(
+            connection_config=AdbcConnectionParams(
+                uri="postgresql://user:pass@localhost/db"
+            )
+        )
     """
 
     driver_type: ClassVar[type[AdbcDriver]] = AdbcDriver

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/aiosqlite/config.py

@@ -137,7 +137,14 @@ class AiosqliteConnectionContext(AsyncPoolConnectionContext):
 
 @mypyc_attr(native_class=False)
 class AiosqliteConfig(AsyncDatabaseConfig["AiosqliteConnection", AiosqliteConnectionPool, AiosqliteDriver]):
-    """Database configuration for AioSQLite engine."""
+    """Database configuration for AioSQLite engine.
+
+    Example::
+
+        config = AiosqliteConfig(
+            connection_config=AiosqlitePoolParams(database="app.db")
+        )
+    """
 
     driver_type: "ClassVar[type[AiosqliteDriver]]" = AiosqliteDriver
     connection_type: "ClassVar[type[AiosqliteConnection]]" = AiosqliteConnection

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/asyncmy/config.py

@@ -148,7 +148,16 @@ class AsyncmyConnectionContext(AsyncPoolConnectionContext):
 
 @mypyc_attr(native_class=False)
 class AsyncmyConfig(AsyncDatabaseConfig[AsyncmyConnection, "AsyncmyPool", AsyncmyDriver]):  # pyright: ignore
-    """Configuration for Asyncmy database connections."""
+    """Configuration for Asyncmy database connections.
+
+    Example::
+
+        config = AsyncmyConfig(
+            connection_config=AsyncmyPoolParams(
+                host="localhost", user="root", database="mydb"
+            )
+        )
+    """
 
     driver_type: ClassVar[type[AsyncmyDriver]] = AsyncmyDriver
     connection_type: "ClassVar[type[Any]]" = cast("type[Any]", AsyncmyConnection)

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/asyncmy/events/store.py

@@ -9,7 +9,7 @@ MySQL requires:
 
 from typing import Final
 
-from sqlspec.adapters.asyncmy import AsyncmyConfig
+from sqlspec.adapters.asyncmy.config import AsyncmyConfig
 from sqlspec.extensions.events import BaseEventQueueStore
 
 __all__ = ("AsyncmyEventQueueStore",)
@@ -32,7 +32,7 @@ class AsyncmyEventQueueStore(BaseEventQueueStore[AsyncmyConfig]):
         - queue_table: Table name (default: "sqlspec_event_queue")
 
     Example:
-        from sqlspec.adapters.asyncmy import AsyncmyConfig
+        from sqlspec.adapters.asyncmy.config import AsyncmyConfig
         from sqlspec.adapters.asyncmy.events import AsyncmyEventQueueStore
 
         config = AsyncmyConfig(

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/asyncpg/__init__.py

@@ -1,7 +1,12 @@
 """AsyncPG adapter for SQLSpec."""
 
 from sqlspec.adapters.asyncpg._typing import AsyncpgConnection, AsyncpgCursor, AsyncpgPool, AsyncpgPreparedStatement
-from sqlspec.adapters.asyncpg.config import AsyncpgConfig, AsyncpgConnectionConfig, AsyncpgPoolConfig
+from sqlspec.adapters.asyncpg.config import (
+    AsyncpgConfig,
+    AsyncpgConnectionConfig,
+    AsyncpgDriverFeatures,
+    AsyncpgPoolConfig,
+)
 from sqlspec.adapters.asyncpg.core import default_statement_config
 from sqlspec.adapters.asyncpg.driver import AsyncpgDriver, AsyncpgExceptionHandler
 from sqlspec.dialects import postgres  # noqa: F401
@@ -12,6 +17,7 @@ __all__ = (
     "AsyncpgConnectionConfig",
     "AsyncpgCursor",
     "AsyncpgDriver",
+    "AsyncpgDriverFeatures",
     "AsyncpgExceptionHandler",
     "AsyncpgPool",
     "AsyncpgPoolConfig",

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/asyncpg/config.py

@@ -246,7 +246,16 @@ class AsyncpgConnectionContext(AsyncPoolConnectionContext):
 
 @mypyc_attr(native_class=False)
 class AsyncpgConfig(AsyncDatabaseConfig[AsyncpgConnection, "Pool[Record]", AsyncpgDriver]):
-    """Configuration for AsyncPG database connections using TypedDict."""
+    """Configuration for AsyncPG database connections using TypedDict.
+
+    Example::
+
+        config = AsyncpgConfig(
+            connection_config=AsyncpgPoolConfig(
+                dsn="postgresql://user:pass@localhost/db"
+            )
+        )
+    """
 
     driver_type: "ClassVar[type[AsyncpgDriver]]" = AsyncpgDriver
     connection_type: "ClassVar[type[AsyncpgConnection]]" = type(AsyncpgConnection)  # type: ignore[assignment]

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/bigquery/__init__.py

@@ -1,5 +1,5 @@
 from sqlspec.adapters.bigquery._typing import BigQueryConnection, BigQueryCursor
-from sqlspec.adapters.bigquery.config import BigQueryConfig, BigQueryConnectionParams
+from sqlspec.adapters.bigquery.config import BigQueryConfig, BigQueryConnectionParams, BigQueryDriverFeatures
 from sqlspec.adapters.bigquery.core import default_statement_config
 from sqlspec.adapters.bigquery.driver import BigQueryDriver, BigQueryExceptionHandler
 
@@ -9,6 +9,7 @@ __all__ = (
     "BigQueryConnectionParams",
     "BigQueryCursor",
     "BigQueryDriver",
+    "BigQueryDriverFeatures",
     "BigQueryExceptionHandler",
     "default_statement_config",
 )

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/bigquery/config.py

@@ -151,6 +151,14 @@ class BigQueryConfig(NoPoolSyncConfig[BigQueryConnection, BigQueryDriver]):
     """BigQuery configuration.
 
     Configuration for Google Cloud BigQuery connections.
+
+    Example::
+
+        config = BigQueryConfig(
+            connection_config=BigQueryConnectionParams(
+                project="my-gcp-project"
+            )
+        )
     """
 
     driver_type: ClassVar[type[BigQueryDriver]] = BigQueryDriver

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/duckdb/__init__.py

@@ -4,7 +4,9 @@ from sqlspec.adapters.duckdb._typing import DuckDBConnection, DuckDBCursor
 from sqlspec.adapters.duckdb.config import (
     DuckDBConfig,
     DuckDBConnectionParams,
+    DuckDBDriverFeatures,
     DuckDBExtensionConfig,
+    DuckDBPoolParams,
     DuckDBSecretConfig,
 )
 from sqlspec.adapters.duckdb.core import default_statement_config
@@ -18,8 +20,10 @@ __all__ = (
     "DuckDBConnectionPool",
     "DuckDBCursor",
     "DuckDBDriver",
+    "DuckDBDriverFeatures",
     "DuckDBExceptionHandler",
     "DuckDBExtensionConfig",
+    "DuckDBPoolParams",
     "DuckDBSecretConfig",
     "default_statement_config",
 )

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/oracledb/__init__.py

@@ -23,6 +23,7 @@ from sqlspec.adapters.oracledb._uuid_handlers import (
 from sqlspec.adapters.oracledb.config import (
     OracleAsyncConfig,
     OracleConnectionParams,
+    OracleDriverFeatures,
     OraclePoolParams,
     OracleSyncConfig,
 )
@@ -42,6 +43,7 @@ __all__ = (
     "OracleAsyncDriver",
     "OracleAsyncExceptionHandler",
     "OracleConnectionParams",
+    "OracleDriverFeatures",
     "OraclePoolParams",
     "OracleSyncConfig",
     "OracleSyncConnection",

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/oracledb/config.py

@@ -176,7 +176,18 @@ class _OracleSyncSessionConnectionHandler(SyncPoolSessionFactory):
 
 
 class OracleSyncConfig(SyncDatabaseConfig[OracleSyncConnection, "OracleSyncConnectionPool", OracleSyncDriver]):
-    """Configuration for Oracle synchronous database connections."""
+    """Configuration for Oracle synchronous database connections.
+
+    Example::
+
+        config = OracleSyncConfig(
+            connection_config=OraclePoolParams(
+                dsn="localhost:1521/XEPDB1",
+                user="app",
+                password="secret",
+            )
+        )
+    """
 
     __slots__ = ("_user_connection_hook",)
 
@@ -338,7 +349,18 @@ class _OracleAsyncSessionConnectionHandler(AsyncPoolSessionFactory):
 
 @mypyc_attr(native_class=False)
 class OracleAsyncConfig(AsyncDatabaseConfig[OracleAsyncConnection, "OracleAsyncConnectionPool", OracleAsyncDriver]):
-    """Configuration for Oracle asynchronous database connections."""
+    """Configuration for Oracle asynchronous database connections.
+
+    Example::
+
+        config = OracleAsyncConfig(
+            connection_config=OraclePoolParams(
+                dsn="localhost:1521/XEPDB1",
+                user="app",
+                password="secret",
+            )
+        )
+    """
 
     __slots__ = ("_user_connection_hook",)
 

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/psqlpy/config.py

@@ -177,7 +177,16 @@ class PsqlpyConnectionContext(AsyncPoolConnectionContext):
 
 @mypyc_attr(native_class=False)
 class PsqlpyConfig(AsyncDatabaseConfig[PsqlpyConnection, ConnectionPool, PsqlpyDriver]):
-    """Configuration for Psqlpy asynchronous database connections."""
+    """Configuration for Psqlpy asynchronous database connections.
+
+    Example::
+
+        config = PsqlpyConfig(
+            connection_config=PsqlpyPoolParams(
+                dsn="postgresql://user:pass@localhost/db"
+            )
+        )
+    """
 
     driver_type: ClassVar[type[PsqlpyDriver]] = PsqlpyDriver
     connection_type: "ClassVar[type[PsqlpyConnection]]" = PsqlpyConnection

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/psycopg/__init__.py

@@ -7,6 +7,7 @@ from sqlspec.adapters.psycopg._typing import (
 from sqlspec.adapters.psycopg.config import (
     PsycopgAsyncConfig,
     PsycopgConnectionParams,
+    PsycopgDriverFeatures,
     PsycopgPoolParams,
     PsycopgSyncConfig,
 )
@@ -26,6 +27,7 @@ __all__ = (
     "PsycopgAsyncDriver",
     "PsycopgAsyncExceptionHandler",
     "PsycopgConnectionParams",
+    "PsycopgDriverFeatures",
     "PsycopgPoolParams",
     "PsycopgSyncConfig",
     "PsycopgSyncConnection",

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/psycopg/_typing.py

@@ -8,6 +8,9 @@ from typing import TYPE_CHECKING, Any, Protocol
 
 from psycopg import AsyncConnection, AsyncCursor, Connection, Cursor
 from psycopg.rows import DictRow as PsycopgDictRow
+from psycopg.sql import SQL as PsycopgSQL  # noqa: N811
+from psycopg.sql import Composed as PsycopgComposed
+from psycopg.sql import Identifier as PsycopgIdentifier
 
 if TYPE_CHECKING:
     from collections.abc import Callable
@@ -203,8 +206,11 @@ __all__ = (
     "PsycopgAsyncCursor",
     "PsycopgAsyncRawCursor",
     "PsycopgAsyncSessionContext",
+    "PsycopgComposed",
     "PsycopgDictRow",
+    "PsycopgIdentifier",
     "PsycopgPipelineDriver",
+    "PsycopgSQL",
     "PsycopgSyncConnection",
     "PsycopgSyncCursor",
     "PsycopgSyncRawCursor",

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/psycopg/config.py

@@ -182,7 +182,16 @@ class _PsycopgSyncSessionConnectionHandler(SyncPoolSessionFactory):
 
 
 class PsycopgSyncConfig(SyncDatabaseConfig[PsycopgSyncConnection, ConnectionPool, PsycopgSyncDriver]):
-    """Configuration for Psycopg synchronous database connections with direct field-based configuration."""
+    """Configuration for Psycopg synchronous database connections with direct field-based configuration.
+
+    Example::
+
+        config = PsycopgSyncConfig(
+            connection_config=PsycopgPoolParams(
+                conninfo="postgresql://user:pass@localhost/db"
+            )
+        )
+    """
 
     driver_type: "ClassVar[type[PsycopgSyncDriver]]" = PsycopgSyncDriver
     connection_type: "ClassVar[type[PsycopgSyncConnection]]" = PsycopgSyncConnection
@@ -454,7 +463,16 @@ class _PsycopgAsyncSessionConnectionHandler(AsyncPoolSessionFactory):
 
 @mypyc_attr(native_class=False)
 class PsycopgAsyncConfig(AsyncDatabaseConfig[PsycopgAsyncConnection, AsyncConnectionPool, PsycopgAsyncDriver]):
-    """Configuration for Psycopg asynchronous database connections with direct field-based configuration."""
+    """Configuration for Psycopg asynchronous database connections with direct field-based configuration.
+
+    Example::
+
+        config = PsycopgAsyncConfig(
+            connection_config=PsycopgPoolParams(
+                conninfo="postgresql://user:pass@localhost/db"
+            )
+        )
+    """
 
     driver_type: ClassVar[type[PsycopgAsyncDriver]] = PsycopgAsyncDriver
     connection_type: "ClassVar[type[PsycopgAsyncConnection]]" = PsycopgAsyncConnection

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/psycopg/core.py

@@ -4,9 +4,9 @@ import datetime
 from collections.abc import Sized
 from typing import TYPE_CHECKING, Any, NamedTuple, cast
 
-from psycopg import sql as psycopg_sql
 from typing_extensions import LiteralString
 
+from sqlspec.adapters.psycopg._typing import PsycopgComposed, PsycopgIdentifier, PsycopgSQL
 from sqlspec.core import (
     SQL,
     DriverParameterProfile,
@@ -88,7 +88,7 @@ class PreparedStackOperation(NamedTuple):
     operation_index: int
     operation: "StackOperation"
     statement: "SQL"
-    sql: "LiteralString | psycopg_sql.SQL"
+    sql: "LiteralString | PsycopgSQL | PsycopgComposed"
     parameters: "tuple[Any, ...] | dict[str, Any] | None"
 
 
@@ -113,23 +113,23 @@ def pipeline_supported() -> bool:
         return False
 
 
-def _compose_table_identifier(table: str) -> "psycopg_sql.Composed":
+def _compose_table_identifier(table: str) -> "PsycopgComposed":
     parts = [part for part in table.split(".") if part]
     if not parts:
         msg = "Table name must not be empty"
         raise SQLSpecError(msg)
-    identifiers = [psycopg_sql.Identifier(part) for part in parts]
-    return psycopg_sql.SQL(".").join(identifiers)
+    identifiers = [PsycopgIdentifier(part) for part in parts]
+    return PsycopgSQL(".").join(identifiers)
 
 
-def build_copy_from_command(table: str, columns: "list[str]") -> "psycopg_sql.Composed":
+def build_copy_from_command(table: str, columns: "list[str]") -> "PsycopgComposed":
     table_identifier = _compose_table_identifier(table)
-    column_sql = psycopg_sql.SQL(", ").join([psycopg_sql.Identifier(column) for column in columns])
-    return psycopg_sql.SQL("COPY {} ({}) FROM STDIN").format(table_identifier, column_sql)
+    column_sql = PsycopgSQL(", ").join([PsycopgIdentifier(column) for column in columns])
+    return PsycopgSQL("COPY {} ({}) FROM STDIN").format(table_identifier, column_sql)
 
 
-def build_truncate_command(table: str) -> "psycopg_sql.Composed":
-    return psycopg_sql.SQL("TRUNCATE TABLE {}").format(_compose_table_identifier(table))
+def build_truncate_command(table: str) -> "PsycopgComposed":
+    return PsycopgSQL("TRUNCATE TABLE {}").format(_compose_table_identifier(table))
 
 
 def _identity(value: Any) -> Any:

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/psycopg/driver.py

@@ -5,13 +5,14 @@ from contextlib import AsyncExitStack, ExitStack
 from typing import TYPE_CHECKING, Any, cast
 
 import psycopg
-from psycopg import sql as psycopg_sql
 from typing_extensions import LiteralString
 
 from sqlspec.adapters.psycopg._typing import (
     PsycopgAsyncConnection,
     PsycopgAsyncCursor,
     PsycopgAsyncSessionContext,
+    PsycopgComposed,
+    PsycopgSQL,
     PsycopgSyncConnection,
     PsycopgSyncCursor,
     PsycopgSyncSessionContext,
@@ -111,7 +112,7 @@ class PsycopgPipelineMixin:
                     operation_index=index,
                     operation=operation,
                     statement=sql_statement,
-                    sql=cast("LiteralString | psycopg_sql.SQL", sql_text),
+                    sql=cast("LiteralString | PsycopgSQL | PsycopgComposed", sql_text),
                     parameters=prepared_parameters,
                 )
             )
@@ -396,7 +397,7 @@ class PsycopgSyncDriver(PsycopgPipelineMixin, SyncDriverAdapterBase):
                         cursor = resource_stack.enter_context(self.with_cursor(self.connection))
 
                         try:
-                            sql = cast("LiteralString | psycopg_sql.SQL", prepared.sql)  # type: ignore[redundant-cast]
+                            sql = cast("LiteralString | PsycopgSQL | PsycopgComposed", prepared.sql)  # type: ignore[redundant-cast]
                             if prepared.parameters:
                                 cursor.execute(sql, prepared.parameters)
                             else:
@@ -855,7 +856,7 @@ class PsycopgAsyncDriver(PsycopgPipelineMixin, AsyncDriverAdapterBase):
                         cursor = await resource_stack.enter_async_context(self.with_cursor(self.connection))
 
                         try:
-                            sql = cast("LiteralString | psycopg_sql.SQL", prepared.sql)  # type: ignore[redundant-cast]
+                            sql = cast("LiteralString | PsycopgSQL | PsycopgComposed", prepared.sql)  # type: ignore[redundant-cast]
                             if prepared.parameters:
                                 await cursor.execute(sql, prepared.parameters)
                             else:

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/adapters/sqlite/config.py

@@ -83,7 +83,16 @@ class _SqliteSessionConnectionHandler(SyncPoolSessionFactory):
 
 
 class SqliteConfig(SyncDatabaseConfig[SqliteConnection, SqliteConnectionPool, SqliteDriver]):
-    """SQLite configuration with thread-local connections."""
+    """SQLite configuration with thread-local connections.
+
+    Example::
+
+        config = SqliteConfig(
+            connection_config=SqliteConnectionParams(
+                database="app.db"
+            )
+        )
+    """
 
     driver_type: "ClassVar[type[SqliteDriver]]" = SqliteDriver
     connection_type: "ClassVar[type[SqliteConnection]]" = SqliteConnection

{sqlspec-0.42.0 → sqlspec-0.43.0}/sqlspec/builder/_base.py

@@ -28,6 +28,7 @@ from sqlspec.core import (
     get_cache_config,
     hash_optimized_expression,
 )
+from sqlspec.core.filters import StatementFilter
 from sqlspec.exceptions import SQLBuilderError
 from sqlspec.utils.logging import get_logger
 from sqlspec.utils.type_guards import has_expression_and_parameters, has_name, has_with_method, is_expression
@@ -792,6 +793,26 @@ class QueryBuilder(ABC):
 
         return sql_statement
 
+    def apply_filters(self, *filters: StatementFilter, config: "StatementConfig | None" = None) -> "SQL":
+        """Apply statement filters to this query builder.
+
+        Converts the builder to a SQL statement, then applies each filter's
+        ``append_to_statement`` method to produce the final SQL with all
+        WHERE clauses, ORDER BY, LIMIT/OFFSET, etc.
+
+        Args:
+            *filters: Statement filters (e.g., InCollectionFilter, SearchFilter, OrderByFilter).
+            config: Optional SQL configuration.
+
+        Returns:
+            SQL statement with all filters applied.
+
+        """
+        sql_statement = self.to_statement(config)
+        for filter_obj in filters:
+            sql_statement = filter_obj.append_to_statement(sql_statement)
+        return sql_statement
+
     def _to_statement(self, config: "StatementConfig | None" = None) -> "SQL":
         """Internal method to create SQL statement.