sqlspec 0.14.1__tar.gz → 0.15.0__tar.gz

{sqlspec-0.14.1 → sqlspec-0.15.0}/.gitignore

@@ -54,3 +54,10 @@ requirements/*
 tools/*.json
 benchmarks/
 .benchmark
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+*.duckdb
+.crush
+CRUSH.md

{sqlspec-0.14.1 → sqlspec-0.15.0}/.pre-commit-config.yaml

@@ -7,7 +7,7 @@ repos:
       - id: conventional-pre-commit
         stages: [commit-msg]
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: check-ast
       - id: check-case-conflict
@@ -17,7 +17,7 @@ repos:
       - id: mixed-line-ending
       - id: trailing-whitespace
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: "v0.12.2"
+    rev: "v0.12.8"
     hooks:
       - id: ruff
         args: ["--fix"]

{sqlspec-0.14.1 → sqlspec-0.15.0}/Makefile

@@ -48,6 +48,18 @@ install: destroy clean                              ## Install the project, depe
 	@uv sync --all-extras --dev
 	@echo "${OK} Installation complete! 🎉"
 
+.PHONY: install-compiled
+install-compiled: destroy clean                  ## Install with mypyc compilation for performance
+	@echo "${INFO} Starting fresh installation with mypyc compilation..."
+	@uv python pin 3.12 >/dev/null 2>&1
+	@uv venv >/dev/null 2>&1
+	@echo "${INFO} Installing in editable mode with mypyc compilation..."
+	@HATCH_BUILD_HOOKS_ENABLE=1 uv pip install -e .
+	@uv sync --all-extras --dev
+	@echo "${OK} Performance installation complete! 🚀"
+	@echo "${INFO} Verifying compilation..."
+	@find sqlspec -name "*.so" | wc -l | xargs -I {} echo "${OK} Compiled {} modules"
+
 .PHONY: destroy
 destroy:                                            ## Destroy the virtual environment
 	@echo "${INFO} Destroying virtual environment... 🗑️"
@@ -83,6 +95,22 @@ build:                                             ## Build the package
 	@uv build >/dev/null 2>&1
 	@echo "${OK} Package build complete"
 
+.PHONY: build-performance
+build-performance:                                 ## Build package with mypyc compilation
+	@echo "${INFO} Building package with mypyc compilation... 📦"
+	@HATCH_BUILD_HOOKS_ENABLE=1 uv build >/dev/null 2>&1
+	@echo "${OK} Performance package build complete 🚀"
+
+.PHONY: test-mypyc
+test-mypyc:                                        ## Test mypyc compilation on individual modules
+	@echo "${INFO} Testing mypyc compilation... 🔧"
+	@uv run mypyc --check-untyped-defs sqlspec/utils/statement_hashing.py
+	@uv run mypyc --check-untyped-defs sqlspec/utils/text.py
+	@uv run mypyc --check-untyped-defs sqlspec/utils/sync_tools.py
+	@uv run mypyc --check-untyped-defs sqlspec/statement/cache.py
+	@echo "${OK} Mypyc compilation tests passed ✨"
+
+
 .PHONY: release
 release:                                           ## Bump version and create release tag
 	@echo "${INFO} Preparing for release... 📦"
@@ -108,6 +136,8 @@ clean:                                              ## Cleanup temporary build a
 	@find . -name '*~' -exec rm -f {} + >/dev/null 2>&1
 	@find . -name '__pycache__' -exec rm -rf {} + >/dev/null 2>&1
 	@find . -name '.ipynb_checkpoints' -exec rm -rf {} + >/dev/null 2>&1
+	@find . -name '*.so' -exec rm -f {} + >/dev/null 2>&1
+	@find . -name '*.c' -exec rm -f {} + >/dev/null 2>&1
 	@echo "${OK} Working directory cleaned"
 	$(MAKE) docs-clean
 
@@ -215,6 +245,49 @@ docs-linkcheck-full:                               ## Run full documentation lin
 	@uv run sphinx-build -b linkcheck ./docs ./docs/_build -D linkcheck_anchors=0
 	@echo "${OK} Full link check complete"
 
+# =============================================================================
+# Development Infrastructure
+# =============================================================================
+
+.PHONY: infra-up
+infra-up:                                              ## Start development infrastructure (databases, storage)
+	@echo "${INFO} Starting development infrastructure..."
+	@./tools/local-infra.sh up
+	@echo "${OK} Development infrastructure ready ✨"
+
+.PHONY: infra-down
+infra-down:                                            ## Stop development infrastructure
+	@echo "${INFO} Stopping development infrastructure..."
+	@./tools/local-infra.sh down --quiet
+	@echo "${OK} Development infrastructure stopped"
+
+.PHONY: infra-status
+infra-status:                                          ## Show development infrastructure status
+	@./tools/local-infra.sh status
+
+.PHONY: infra-cleanup
+infra-cleanup:                                         ## Clean up development infrastructure
+	@echo "${WARN} This will remove all development containers and volumes"
+	@./tools/local-infra.sh cleanup
+
+.PHONY: infra-postgres
+infra-postgres:                                        ## Start only PostgreSQL
+	@echo "${INFO} Starting PostgreSQL..."
+	@./tools/local-infra.sh up postgres --quiet
+	@echo "${OK} PostgreSQL ready on port 5433"
+
+.PHONY: infra-oracle
+infra-oracle:                                          ## Start only Oracle
+	@echo "${INFO} Starting Oracle..."
+	@./tools/local-infra.sh up oracle --quiet
+	@echo "${OK} Oracle ready on port 1522"
+
+.PHONY: infra-mysql
+infra-mysql:                                           ## Start only MySQL
+	@echo "${INFO} Starting MySQL..."
+	@./tools/local-infra.sh up mysql --quiet
+	@echo "${OK} MySQL ready on port 3307"
+
 # =============================================================================
 # End of Makefile
 # =============================================================================

{sqlspec-0.14.1 → sqlspec-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlspec
-Version: 0.14.1
+Version: 0.15.0
 Summary: SQL Experiments in Python
 Project-URL: Discord, https://discord.gg/litestar
 Project-URL: Issue, https://github.com/litestar-org/sqlspec/issues/
@@ -11,8 +11,9 @@ License-Expression: MIT
 License-File: LICENSE
 License-File: NOTICE
 Requires-Python: <4.0,>=3.9
-Requires-Dist: click
 Requires-Dist: eval-type-backport; python_version < '3.10'
+Requires-Dist: mypy-extensions
+Requires-Dist: rich-click
 Requires-Dist: sqlglot>=19.9.0
 Requires-Dist: typing-extensions
 Provides-Extra: adbc
@@ -28,6 +29,9 @@ Provides-Extra: asyncmy
 Requires-Dist: asyncmy; extra == 'asyncmy'
 Provides-Extra: asyncpg
 Requires-Dist: asyncpg; extra == 'asyncpg'
+Provides-Extra: attrs
+Requires-Dist: attrs; extra == 'attrs'
+Requires-Dist: cattrs; extra == 'attrs'
 Provides-Extra: bigquery
 Requires-Dist: google-cloud-bigquery; extra == 'bigquery'
 Provides-Extra: cli
@@ -44,6 +48,7 @@ Provides-Extra: litestar
 Requires-Dist: litestar; extra == 'litestar'
 Provides-Extra: msgspec
 Requires-Dist: msgspec; extra == 'msgspec'
+Provides-Extra: mypyc
 Provides-Extra: nanoid
 Requires-Dist: fastnanoid>=0.4.1; extra == 'nanoid'
 Provides-Extra: obstore

{sqlspec-0.14.1 → sqlspec-0.15.0}/pyproject.toml

@@ -1,13 +1,19 @@
 [project]
 authors = [{ name = "Cody Fincher", email = "cody@litestar.dev" }]
-dependencies = ["typing-extensions", "eval_type_backport; python_version < \"3.10\"", "click", "sqlglot>=19.9.0"]
+dependencies = [
+  "typing-extensions",
+  "eval_type_backport; python_version < \"3.10\"",
+  "sqlglot>=19.9.0",
+  "mypy-extensions",
+  "rich-click",
+]
 description = "SQL Experiments in Python"
 license = "MIT"
 maintainers = [{ name = "Litestar Developers", email = "hello@litestar.dev" }]
 name = "sqlspec"
 readme = "README.md"
 requires-python = ">=3.9, <4.0"
-version = "0.14.1"
+version = "0.15.0"
 
 [project.urls]
 Discord = "https://discord.gg/litestar"
@@ -21,6 +27,7 @@ aiosql = ["aiosql"]
 aiosqlite = ["aiosqlite"]
 asyncmy = ["asyncmy"]
 asyncpg = ["asyncpg"]
+attrs = ["attrs", "cattrs"]
 bigquery = ["google-cloud-bigquery"]
 cli = ["rich-click"]
 duckdb = ["duckdb"]
@@ -29,6 +36,7 @@ flask = ["flask"]
 fsspec = ["fsspec"]
 litestar = ["litestar"]
 msgspec = ["msgspec"]
+mypyc = []
 nanoid = ["fastnanoid>=0.4.1"]
 obstore = ["obstore"]
 opentelemetry = ["opentelemetry-instrumentation"]
@@ -46,10 +54,9 @@ pymysql = ["pymysql"]
 spanner = ["google-cloud-spanner"]
 uuid = ["uuid-utils"]
 
-
 [dependency-groups]
-benchmarks = ["sqlalchemy", "psutil", "types-psutil"]
-build = ["bump-my-version"]
+benchmarks = ["sqlalchemy[asyncio]", "psutil", "types-psutil", "rich", "rich-click", "duckdb"]
+build = ["bump-my-version", "hatch-mypyc", "pydantic-settings"]
 dev = [
   { include-group = "extras" },
   { include-group = "lint" },
@@ -76,6 +83,7 @@ doc = [
 ]
 extras = [
   "adbc_driver_manager",
+  "pgvector",
   "pyarrow",
   "polars",
   "adbc_driver_sqlite",
@@ -95,8 +103,11 @@ lint = [
   "types-protobuf",
   "asyncpg-stubs",
   "pyarrow-stubs",
+
 ]
 test = [
+  "aiohttp",
+  "requests",
   "anyio",
   "coverage>=7.6.1",
   "pytest>=8.0.0",
@@ -113,7 +124,7 @@ sqlspec = "sqlspec.__main__:run_cli"
 
 [build-system]
 build-backend = "hatchling.build"
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-mypyc"]
 
 [tool.hatch.build.targets.sdist]
 dev-mode-dirs = ["."]
@@ -127,11 +138,57 @@ include = ["NOTICE"]
 packages = ["sqlspec"]
 
 
+[tool.hatch.build.targets.wheel.hooks.mypyc]
+dependencies = ["hatch-mypyc", "hatch-cython"]
+enable-by-default = false
+exclude = [
+  "tests/**",                      # Test files
+  "sqlspec/__main__.py",           # Entry point (can't run directly when compiled)
+  "sqlspec/cli.py",                # CLI module (not performance critical)
+  "sqlspec/typing.py",             # Type aliases
+  "sqlspec/_typing.py",            # Type aliases
+  "sqlspec/config.py",             # Main config
+  "sqlspec/adapters/**/config.py", # Adapter configurations
+  "sqlspec/adapters/**/_types.py", # Type definitions (mypyc incompatible)
+  "sqlspec/extensions/**",         # All extensions
+  "sqlspec/**/__init__.py",        # Init files (usually just imports)
+  "sqlspec/protocols.py",          # Protocol definitions
+  "sqlspec/builder/**/*.py",       # Builder (not performance critical)
+
+]
+include = [
+  "sqlspec/core/**/*.py", # Core module
+  "sqlspec/loader.py",    # Loader module
+
+  # === UTILITY MODULES ===
+  "sqlspec/utils/text.py",        # Text utilities
+  "sqlspec/utils/sync_tools.py",  # Synchronous utility functions
+  "sqlspec/utils/type_guards.py", # Type guard utilities
+  "sqlspec/utils/fixtures.py",    # File fixture loading
+]
+mypy-args = [
+  "--ignore-missing-imports",
+  "--allow-untyped-defs",
+  "--allow-untyped-globals",
+  "--no-implicit-reexport",
+  "--no-warn-redundant-casts",
+  "--no-warn-unused-ignores",
+  "--follow-imports=skip",
+]
+require-runtime-dependencies = true
+require-runtime-features = ["mypyc"]
+
+[tool.hatch.build.targets.wheel.hooks.mypyc.options]
+debug_level = "0" # No debug info in production (0-2)
+multi_file = true # Enable cross-module optimization
+opt_level = "3"   # Maximum optimization (0-3)
+
+
 [tool.bumpversion]
 allow_dirty = true
 commit = false
 commit_args = "--no-verify"
-current_version = "0.14.1"
+current_version = "0.15.0"
 ignore_missing_files = false
 ignore_missing_version = false
 message = "chore(release): bump to v{new_version}"
@@ -281,6 +338,8 @@ module = [
   "fsspec.*",
   "sqlglot",
   "sqlglot.*",
+  "pgvector",
+  "pgvector.*",
 ]
 
 [[tool.mypy.overrides]]
@@ -302,7 +361,8 @@ reportPrivateImportUsage = false
 reportPrivateUsage = false
 reportTypedDictNotRequiredAccess = false
 reportUnknownArgumentType = false
-reportUnnecessaryTypeIgnoreComments = "information"
+reportUnnecessaryCast = false
+reportUnnecessaryTypeIgnoreComments = false
 root = "."
 venv = ".venv"
 
@@ -376,6 +436,8 @@ ignore = [
   "S608",    # ruff - Possible sql injection
   "PLR0904", # too many public methods
   "PLR6301", # method could be static or class method
+  "B903",    # class could be a dataclass or named tuple
+  "PLW0603", # Using the global statement to update is discouraged
 ]
 select = ["ALL"]
 
@@ -402,7 +464,7 @@ split-on-trailing-comma = false
 [tool.ruff.lint.per-file-ignores]
 "docs/**/*.*" = ["S", "B", "DTZ", "A", "TC", "ERA", "D", "RET", "PLW0127"]
 "docs/examples/**" = ["T201"]
-"sqlspec/statement/builder/mixins/**/*.*" = ["SLF001"]
+"sqlspec/builder/mixins/**/*.*" = ["SLF001"]
 "tests/**/*.*" = [
   "A",
   "ARG",

sqlspec-0.15.0/sqlspec/__init__.py

@@ -0,0 +1,92 @@
+"""SQLSpec: Safe and elegant SQL query building for Python."""
+
+from sqlspec import adapters, base, builder, core, driver, exceptions, extensions, loader, migrations, typing, utils
+from sqlspec.__metadata__ import __version__
+from sqlspec._sql import SQLFactory, sql
+from sqlspec.base import SQLSpec
+from sqlspec.builder import (
+    Column,
+    ColumnExpression,
+    CreateTable,
+    Delete,
+    DropTable,
+    FunctionColumn,
+    Insert,
+    Merge,
+    QueryBuilder,
+    Select,
+    Update,
+)
+from sqlspec.config import AsyncDatabaseConfig, SyncDatabaseConfig
+from sqlspec.core import (
+    SQL,
+    ArrowResult,
+    CacheConfig,
+    CacheStats,
+    ParameterConverter,
+    ParameterProcessor,
+    ParameterStyle,
+    ParameterStyleConfig,
+    SQLResult,
+    Statement,
+    StatementConfig,
+)
+from sqlspec.core import filters as filters
+from sqlspec.driver import AsyncDriverAdapterBase, ExecutionResult, SyncDriverAdapterBase
+from sqlspec.loader import SQLFile, SQLFileLoader
+from sqlspec.typing import ConnectionT, DictRow, ModelDTOT, ModelT, RowT, StatementParameters, SupportedSchemaModel
+
+__all__ = (
+    "SQL",
+    "ArrowResult",
+    "AsyncDatabaseConfig",
+    "AsyncDriverAdapterBase",
+    "CacheConfig",
+    "CacheStats",
+    "Column",
+    "ColumnExpression",
+    "ConnectionT",
+    "CreateTable",
+    "Delete",
+    "DictRow",
+    "DropTable",
+    "ExecutionResult",
+    "FunctionColumn",
+    "Insert",
+    "Merge",
+    "ModelDTOT",
+    "ModelT",
+    "ParameterConverter",
+    "ParameterProcessor",
+    "ParameterStyle",
+    "ParameterStyleConfig",
+    "QueryBuilder",
+    "RowT",
+    "SQLFactory",
+    "SQLFile",
+    "SQLFileLoader",
+    "SQLResult",
+    "SQLSpec",
+    "Select",
+    "Statement",
+    "StatementConfig",
+    "StatementParameters",
+    "SupportedSchemaModel",
+    "SyncDatabaseConfig",
+    "SyncDriverAdapterBase",
+    "Update",
+    "__version__",
+    "adapters",
+    "base",
+    "builder",
+    "core",
+    "driver",
+    "exceptions",
+    "extensions",
+    "filters",
+    "loader",
+    "migrations",
+    "sql",
+    "typing",
+    "utils",
+)

{sqlspec-0.14.1 → sqlspec-0.15.0}/sqlspec/__main__.py

@@ -4,7 +4,7 @@ __all__ = ("run_cli",)
 
 
 def run_cli() -> None:  # pragma: no cover
-    """SQLSpec CLI"""
+    """SQLSpec CLI."""
     build_cli_interface()()
 
 

{sqlspec-0.14.1 → sqlspec-0.15.0}/sqlspec/__metadata__.py

@@ -1,4 +1,4 @@
-"""Metadata for the Project."""
+"""Metadata for the project."""
 
 from importlib.metadata import PackageNotFoundError, metadata, version
 
@@ -6,9 +6,7 @@ __all__ = ("__project__", "__version__")
 
 try:
     __version__ = version("sqlspec")
-    """Version of the project."""
     __project__ = metadata("sqlspec")["Name"]
-    """Name of the project."""
 except PackageNotFoundError:  # pragma: no cover
     __version__ = "0.0.1"
     __project__ = "SQLSpec"

{sqlspec-0.14.1 → sqlspec-0.15.0}/sqlspec/_serialization.py

@@ -15,10 +15,9 @@ def _type_to_string(value: Any) -> str:  # pragma: no cover
     if PYDANTIC_INSTALLED and isinstance(value, BaseModel):
         return value.model_dump_json()
     try:
-        val = str(value)
+        return str(value)
     except Exception as exc:
         raise TypeError from exc
-    return val
 
 
 try: