feat: improve COPY detection

.claude/agents/expert.md

@@ -109,7 +109,7 @@ from sqlspec.protocols import SupportsWhere
 from sqlspec.utils.type_guards import supports_where
 
 if TYPE_CHECKING:
-    from sqlspec.core.statement import Statement
+    from sqlspec.core import Statement
 
 def execute_query(stmt: "Statement", params: dict[str, Any] | None = None) -> list[dict[str, Any]]:
     """Execute SQL query with optional parameters.

.claude/agents/testing.md

@@ -64,7 +64,7 @@ Read("docs/guides/testing/testing.md")
 # tests/unit/test_core/test_statement.py
 
 import pytest
-from sqlspec.core.statement import Statement
+from sqlspec.core import Statement
 
 
 def test_statement_creation():

AGENTS.md

@@ -1310,7 +1310,7 @@ SQLSpec implements Apache Arrow support through a dual-path architecture: native
 Override `select_to_arrow()` in adapter's driver class:
 
 ```python
-from sqlspec.core.result import create_arrow_result
+from sqlspec.core import create_arrow_result
 from sqlspec.utils.module_loader import ensure_pyarrow
 
 class NativeArrowDriver(AsyncDriverAdapterBase):
@@ -1416,7 +1416,7 @@ UUID → utf8 (converted to string)
 Use `create_arrow_result()` for consistent result wrapping:
 
 ```python
-from sqlspec.core.result import create_arrow_result
+from sqlspec.core import create_arrow_result
 
 # Create ArrowResult from Arrow Table
 result = create_arrow_result(arrow_table, rows_affected=arrow_table.num_rows)

docs/examples/adapters/psycopg/connect_sync.py

@@ -3,7 +3,7 @@
 import os
 
 from sqlspec.adapters.psycopg import PsycopgSyncConfig
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 
 __all__ = ("main",)
 

docs/examples/frameworks/fastapi/aiosqlite_app.py

@@ -8,7 +8,7 @@
 from docs.examples.shared.configs import aiosqlite_registry
 from docs.examples.shared.data import ARTICLES, CREATE_ARTICLES
 from sqlspec.adapters.aiosqlite import AiosqliteConfig, AiosqliteDriver
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 
 __all__ = ("get_session", "list_articles", "main", "on_startup", "seed_database")
 

docs/examples/frameworks/fastapi/sqlite_app.py

@@ -9,7 +9,7 @@
 from docs.examples.shared.configs import sqlite_registry
 from docs.examples.shared.data import ARTICLES, CREATE_ARTICLES
 from sqlspec.adapters.sqlite import SqliteConfig, SqliteDriver
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 
 __all__ = ("get_session", "list_articles", "main", "on_startup", "seed_database")
 

docs/examples/frameworks/flask/sqlite_app.py

@@ -5,7 +5,7 @@
 from docs.examples.shared.configs import sqlite_registry
 from docs.examples.shared.data import ARTICLES, CREATE_ARTICLES
 from sqlspec.adapters.sqlite import SqliteConfig
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 
 __all__ = ("list_articles", "main", "seed_database")
 

docs/examples/frameworks/litestar/aiosqlite_app.py

@@ -8,7 +8,7 @@
 from docs.examples.shared.configs import aiosqlite_registry
 from docs.examples.shared.data import ARTICLES, CREATE_ARTICLES
 from sqlspec.adapters.aiosqlite import AiosqliteConfig, AiosqliteDriver
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 from sqlspec.extensions.litestar import SQLSpecPlugin
 
 registry = aiosqlite_registry()

docs/examples/frameworks/litestar/duckdb_app.py

@@ -7,7 +7,7 @@
 from docs.examples.shared.configs import duckdb_registry
 from docs.examples.shared.data import ARTICLES, CREATE_ARTICLES
 from sqlspec.adapters.duckdb import DuckDBConfig, DuckDBDriver
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 from sqlspec.extensions.litestar import SQLSpecPlugin
 
 registry = duckdb_registry()

docs/examples/frameworks/litestar/sqlite_app.py

@@ -7,7 +7,7 @@
 from docs.examples.shared.configs import sqlite_registry
 from docs.examples.shared.data import ARTICLES, CREATE_ARTICLES
 from sqlspec.adapters.sqlite import SqliteConfig, SqliteDriver
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 from sqlspec.extensions.litestar import SQLSpecPlugin
 
 registry = sqlite_registry()

docs/examples/frameworks/starlette/aiosqlite_app.py

@@ -10,7 +10,7 @@
 from docs.examples.shared.configs import aiosqlite_registry
 from docs.examples.shared.data import ARTICLES, CREATE_ARTICLES
 from sqlspec.adapters.aiosqlite import AiosqliteConfig
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 
 __all__ = ("list_articles", "main", "seed_database")
 

docs/examples/patterns/multi_tenant/router.py

@@ -1,7 +1,7 @@
 """Dispatch requests to dedicated SQLite configs per tenant."""
 
 from sqlspec.adapters.sqlite import SqliteConfig
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 
 __all__ = ("TenantRouter", "main")
 

docs/examples/shared/data.py

@@ -1,6 +1,6 @@
 """Shared schema and sample rows for documentation examples."""
 
-from sqlspec.core.statement import SQL
+from sqlspec.core import SQL
 
 __all__ = ("ARTICLES", "CREATE_ARTICLES")
 

docs/guides/adapters/parameter-profile-registry.md

@@ -30,7 +30,7 @@ Refer to [AGENTS.md](../../AGENTS.md) for the full checklist when touching the r
 ```python
 import sqlspec.adapters.duckdb  # Triggers profile registration
 
-from sqlspec.core.parameters import get_driver_profile, build_statement_config_from_profile
+from sqlspec.core import get_driver_profile, build_statement_config_from_profile
 
 profile = get_driver_profile("duckdb")
 config = build_statement_config_from_profile(profile)

docs/guides/architecture/architecture.md

@@ -223,7 +223,7 @@ The current parameter processing system uses `ParameterStyleConfig` integrated w
 
 ```python
 # Current parameter configuration
-from sqlspec.core.parameters import ParameterStyle, ParameterStyleConfig
+from sqlspec.core import ParameterStyle, ParameterStyleConfig
 
 parameter_config = ParameterStyleConfig(
     default_parameter_style=ParameterStyle.QMARK,

docs/guides/architecture/data-flow.md

@@ -361,8 +361,8 @@ To add support for a new database using the enhanced architecture:
 
 ```python
 from sqlspec.driver import SyncDriverAdapterBase  # or AsyncDriverAdapterBase
-from sqlspec.core.parameters import ParameterStyle, ParameterStyleConfig
-from sqlspec.core.statement import StatementConfig
+from sqlspec.core import ParameterStyle, ParameterStyleConfig
+from sqlspec.core import StatementConfig
 
 class MyDatabaseDriver(SyncDriverAdapterBase):
     dialect = "mydatabase"

docs/guides/performance/mypyc.md

@@ -704,7 +704,7 @@ class SQLiteDriver(SyncStorageMixin["sqlite3.Connection", "sqlite3.Row"]):
 
 ```python
 # ✅ DO: Use TypedParameter for type preservation
-from sqlspec.core.parameters.types import TypedParameter
+from sqlspec.core import TypedParameter
 
 class TypedParameter:
     __slots__ = ("name", "value", "type")
@@ -850,11 +850,11 @@ def safe_operation(items: list[Any]) -> None:
 
 ```python
 # ✅ DO: Import from compiled modules
-from sqlspec.core.result import SQLResult  # Compiled module
+from sqlspec.core import SQLResult  # Compiled module
 
 # ❌ DON'T: Use circular imports or dynamic imports
 def get_result_class():
-    from sqlspec.core.result import SQLResult  # Late import
+    from sqlspec.core import SQLResult  # Late import
     return SQLResult
 ```
 

docs/guides/quick-reference/quick-reference.md

@@ -31,8 +31,8 @@ orphan: true
 
 ```python
 from typing import Union, Optional
-from sqlspec.core.filters import StatementFilter
-from sqlspec.core.statement import SQL, Statement, StatementConfig
+from sqlspec.core import StatementFilter
+from sqlspec.core import SQL, Statement, StatementConfig
 from sqlspec.builder import QueryBuilder
 from sqlspec.typing import StatementParameters, ModelDTOT
 
@@ -155,9 +155,9 @@ class SQLTransformContext:
 ```python
 from typing import Optional, Any
 from sqlspec.driver import SyncDriverAdapterBase
-from sqlspec.core.parameters import ParameterStyle, ParameterStyleConfig
-from sqlspec.core.statement import SQL, StatementConfig
-from sqlspec.core.result import SQLResult
+from sqlspec.core import ParameterStyle, ParameterStyleConfig
+from sqlspec.core import SQL, StatementConfig
+from sqlspec.core import SQLResult
 
 class MyDriver(SyncDriverAdapterBase):
     """Example driver implementation."""
@@ -412,7 +412,7 @@ from sqlspec.typing import (
 Statement = Union[str, exp.Expression, SQL]
 
 # Filter types
-from sqlspec.core.statement.filters import StatementFilter
+from sqlspec.core import StatementFilter
 ```
 
 ### StatementFilter Protocol
@@ -434,7 +434,7 @@ class StatementFilter(ABC):
 ### Common Filters
 
 ```python
-from sqlspec.core.statement.filters import (
+from sqlspec.core import (
     LimitOffsetFilter,     # .limit(10).offset(20)
     OrderByFilter,         # .order_by("name", "created_at DESC")
     InCollectionFilter,    # WHERE col IN (...)
@@ -534,8 +534,8 @@ def _get_row_count(self, cursor: Any) -> int:
 **StatementConfig with ParameterStyleConfig:**
 
 ```python
-from sqlspec.core.parameters import ParameterStyle, ParameterStyleConfig
-from sqlspec.core.statement import StatementConfig
+from sqlspec.core import ParameterStyle, ParameterStyleConfig
+from sqlspec.core import StatementConfig
 
 # Create parameter configuration
 parameter_config = ParameterStyleConfig(
@@ -569,8 +569,8 @@ statement_config = StatementConfig(
 
 ```python
 from sqlspec.driver import SyncDriverAdapterBase
-from sqlspec.core.parameters import ParameterStyle, ParameterStyleConfig
-from sqlspec.core.statement import StatementConfig
+from sqlspec.core import ParameterStyle, ParameterStyleConfig
+from sqlspec.core import StatementConfig
 
 class SqliteDriver(SyncDriverAdapterBase):
     """Reference implementation for SQLite."""

docs/reference/builder.rst

@@ -521,7 +521,7 @@ The builder integrates with SQLSpec's filter system:
 
 .. code-block:: python
 
-   from sqlspec.core.filters import LimitOffsetFilter, SearchFilter, OrderByFilter
+   from sqlspec.core import LimitOffsetFilter, SearchFilter, OrderByFilter
 
    # Base query
    query = sql.select("*").from_("users")
@@ -543,7 +543,7 @@ Convert builder to executable SQL:
 
 .. code-block:: python
 
-   from sqlspec.core.statement import SQL
+   from sqlspec.core import SQL
 
    # Build query
    query = sql.select("*").from_("users").limit(10)

docs/reference/core.rst

@@ -42,7 +42,7 @@ SQL Statement
 
    .. code-block:: python
 
-      from sqlspec.core.statement import SQL
+      from sqlspec.core import SQL
 
       # Simple SQL
       stmt = SQL("SELECT * FROM users")
@@ -213,8 +213,8 @@ SQL Compilation
 
    .. code-block:: python
 
-      from sqlspec.core.statement import StatementConfig
-      from sqlspec.core.compiler import SQLProcessor
+      from sqlspec.core import StatementConfig
+      from sqlspec.core import SQLProcessor
 
       config = StatementConfig(dialect="postgres")
       processor = SQLProcessor(config)
@@ -307,7 +307,7 @@ Built-in Filters
 
    .. code-block:: python
 
-      from sqlspec.core.filters import LimitOffsetFilter
+      from sqlspec.core import LimitOffsetFilter
 
       filter = LimitOffsetFilter(limit=10, offset=20)
       filtered_sql = filter.append_to_statement(base_sql)
@@ -322,7 +322,7 @@ Built-in Filters
 
    .. code-block:: python
 
-      from sqlspec.core.filters import OrderByFilter
+      from sqlspec.core import OrderByFilter
 
       filter = OrderByFilter(field_name="created_at", sort_order="desc")
       filtered_sql = filter.append_to_statement(base_sql)
@@ -337,7 +337,7 @@ Built-in Filters
 
    .. code-block:: python
 
-      from sqlspec.core.filters import SearchFilter
+      from sqlspec.core import SearchFilter
 
       filter = SearchFilter(field_name="name", value="John", operator="ILIKE")
       filtered_sql = filter.append_to_statement(base_sql)
@@ -350,12 +350,12 @@ Filters can be composed and chained:
 
 .. code-block:: python
 
-   from sqlspec.core.filters import (
+   from sqlspec.core import (
        LimitOffsetFilter,
        OrderByFilter,
        SearchFilter
    )
-   from sqlspec.core.statement import SQL
+   from sqlspec.core import SQL
 
    base_sql = SQL("SELECT * FROM users")
 
@@ -393,9 +393,9 @@ Statement Analysis
 
 .. code-block:: python
 
-   from sqlspec.core.compiler import SQLCompiler
+   from sqlspec.core import SQLProcessor
 
-   compiler = SQLCompiler(dialect="postgres")
+   compiler = SQLProcessor(dialect="postgres")
 
    analysis = compiler.analyze("""
        SELECT u.name, COUNT(o.id) as order_count
@@ -421,10 +421,10 @@ Create custom filters for specific needs:
 
 .. code-block:: python
 
-   from sqlspec.core.filters import SQLFilter
-   from sqlspec.core.statement import SQL
+   from sqlspec.core import StatementFilter
+   from sqlspec.core import SQL
 
-   class TenantFilter(SQLFilter):
+   class TenantFilter(StatementFilter):
        def __init__(self, tenant_id: int):
            self.tenant_id = tenant_id