sqlty 0.3.0__tar.gz → 0.5.1__tar.gz

{sqlty-0.3.0 → sqlty-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlty
-Version: 0.3.0
+Version: 0.5.1
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -12,6 +12,7 @@ Classifier: Programming Language :: Rust
 Classifier: Programming Language :: SQL
 Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Database
 Classifier: Typing :: Typed
 Requires-Dist: pathspec>=0.12.1
@@ -19,19 +20,24 @@ Requires-Dist: typing-extensions>=4.15.0 ; python_full_version < '3.15'
 Requires-Dist: psycopg>=3.2.12 ; extra == 'psycopg'
 Provides-Extra: psycopg
 License-File: LICENSE
-Summary: Type-safe SQL queries for Python
-Keywords: sql,type-hints,mypy,type-safety,static-analysis,code-generation
+Summary: Type-safe raw SQL for Python: row and parameter types inferred from your SQL and schema, no ORM or database needed
+Keywords: sql,raw-sql,type-safety,type-checking,type-hints,static-analysis,linter,mypy,pyright,ty,postgresql,sqlite,mysql,psycopg,migrations,code-generation,orm-alternative
 Author-email: Jiri Kuncar <jiri.kuncar@gmail.com>
 License-Expression: MIT
 Requires-Python: >=3.14
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 Project-URL: Changelog, https://github.com/jirikuncar/sqlty/releases
-Project-URL: Documentation, https://jirikuncar.github.io/sqlty/
-Project-URL: Homepage, https://github.com/jirikuncar/sqlty
+Project-URL: Documentation, https://sqlty.kuncar.dev/
+Project-URL: Homepage, https://sqlty.kuncar.dev/
 Project-URL: Issues, https://github.com/jirikuncar/sqlty/issues
 Project-URL: Repository, https://github.com/jirikuncar/sqlty
 
-# SQLTy
+<h1>
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jirikuncar/sqlty/main/docs/assets/sqlty-wordmark-dark.svg">
+    <img src="https://raw.githubusercontent.com/jirikuncar/sqlty/main/docs/assets/sqlty-wordmark-light.svg" alt="SQLTy" width="300">
+  </picture>
+</h1>
 
 [![PyPI](https://img.shields.io/pypi/v/sqlty.svg)](https://pypi.org/project/sqlty/)
 [![Python 3.14+](https://img.shields.io/badge/python-3.14+-blue.svg)](https://www.python.org/downloads/)
@@ -51,13 +57,13 @@ migration that changes a column is caught in review, not in production.
   (<a href="https://github.com/jirikuncar/sqlty/blob/main/docs/assets/demo.tape">view source</a>)
 </p>
 
-**Documentation: [jirikuncar.github.io/sqlty](https://jirikuncar.github.io/sqlty/)**
+**Documentation: [sqlty.kuncar.dev](https://sqlty.kuncar.dev/)**
 
 **Fits if** you write SQL as string literals on Python 3.14+, against
 PostgreSQL, SQLite or MySQL, with a schema dump or SQL migrations in the
 repository. Rows are typed end to end with psycopg 3; with other drivers sqlty
 checks the query and its parameters, and you annotate what the cursor returns
-([Drivers](https://jirikuncar.github.io/sqlty/guide/drivers-and-orms/)).
+([Drivers](https://sqlty.kuncar.dev/guide/drivers-and-orms/)).
 
 > **Beta.** APIs and configuration may change before 1.0. Feedback welcome in
 > [GitHub Issues](https://github.com/jirikuncar/sqlty/issues).
@@ -119,10 +125,10 @@ query = SQL[tuple[int, str]]("--sql\nSELECT id, email FROM users")
 caller that now needs a `None` check. `narrow-type` is an error, so CI fails on
 it; an annotation that is only wider than the rows, such as `str | None` for a
 column made `NOT NULL`, is a `stale-type` warning
-([CI](https://jirikuncar.github.io/sqlty/recipes/ci/)). For rolling deploys,
+([CI](https://sqlty.kuncar.dev/recipes/ci/)). For rolling deploys,
 `sqlty breaking --against origin/main` exits 1 when old code breaks on the new
 schema or new code on the old one
-([Breaking schema changes](https://jirikuncar.github.io/sqlty/guide/breaking-changes/)).
+([Breaking schema changes](https://sqlty.kuncar.dev/guide/breaking-changes/)).
 
 ### A row type that doesn't match its query
 
@@ -139,7 +145,7 @@ query = SQL[User]("--sql\nSELECT id::INTEGER, name::TEXT FROM users")
 ```
 
 `TypedDict`, `NamedTuple`, dataclasses and Pydantic models are all checked
-([Row types](https://jirikuncar.github.io/sqlty/guide/row-types/)).
+([Row types](https://sqlty.kuncar.dev/guide/row-types/)).
 
 ### Wrong parameters, misspelled columns
 
@@ -171,11 +177,11 @@ conn.execute(SQL[tuple[str | None]]("--sql\nSELECT email FROM users WHERE id = ?
 conn.execute("--sql\nSELECT emial FROM users")
 ```
 
-`?`, `$1`, `%s` and `:name` placeholders are checked on sqlite3, psycopg and
-asyncpg calls ([Parameters](https://jirikuncar.github.io/sqlty/guide/parameters/)).
+`?`, `$1`, `%s` and `:name` placeholders are checked on sqlite3, aiosqlite,
+psycopg and asyncpg calls ([Parameters](https://sqlty.kuncar.dev/guide/parameters/)).
 These are the mistakes coding agents make: every problem is one
 `file:line: [rule] message` line and a non-zero exit code they can act on, and
-the [sqlty skills](https://jirikuncar.github.io/sqlty/recipes/agents/) teach
+the [sqlty skills](https://sqlty.kuncar.dev/recipes/agents/) teach
 them the conventions. In Claude Code, `/plugin install sqlty --marketplace jirikuncar/sqlty`
 installs them.
 
@@ -191,13 +197,13 @@ sqlty strip .                  # undo: back to plain strings
 
 `rewrite` and `strip` only touch the wrapper, never the SQL, so you can adopt
 sqlty one module at a time and back out. New project:
-[Quickstart](https://jirikuncar.github.io/sqlty/quickstart/). Existing codebase:
-[Migration](https://jirikuncar.github.io/sqlty/recipes/migration/), starting
+[Quickstart](https://sqlty.kuncar.dev/quickstart/). Existing codebase:
+[Migration](https://sqlty.kuncar.dev/recipes/migration/), starting
 with `pg_dump --schema-only app > schema.sql`. In the editor:
-[VS Code](https://jirikuncar.github.io/sqlty/recipes/vscode/).
+[VS Code](https://sqlty.kuncar.dev/recipes/vscode/).
 
 Not a fit for ORMs, SQL built at runtime, or runtime validation;
-[Why SQLTy?](https://jirikuncar.github.io/sqlty/motivation/) compares it with
+[Why SQLTy?](https://sqlty.kuncar.dev/motivation/) compares it with
 sqlc, sqlx, PgTyped and others.
 
 ## About
@@ -208,6 +214,6 @@ developed with AI coding agents, mainly Claude Code; every change is reviewed by
 a maintainer (see the
 [AI-assisted contributions](https://github.com/jirikuncar/sqlty/blob/main/CONTRIBUTING.md#ai-assisted-contributions)
 policy). [Contributing](https://github.com/jirikuncar/sqlty/blob/main/CONTRIBUTING.md) ·
-[Credits](https://jirikuncar.github.io/sqlty/credits/) ·
+[Credits](https://sqlty.kuncar.dev/credits/) ·
 MIT [License](https://github.com/jirikuncar/sqlty/blob/main/LICENSE).
 

{sqlty-0.3.0 → sqlty-0.5.1}/README.md

@@ -1,4 +1,9 @@
-# SQLTy
+<h1>
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jirikuncar/sqlty/main/docs/assets/sqlty-wordmark-dark.svg">
+    <img src="https://raw.githubusercontent.com/jirikuncar/sqlty/main/docs/assets/sqlty-wordmark-light.svg" alt="SQLTy" width="300">
+  </picture>
+</h1>
 
 [![PyPI](https://img.shields.io/pypi/v/sqlty.svg)](https://pypi.org/project/sqlty/)
 [![Python 3.14+](https://img.shields.io/badge/python-3.14+-blue.svg)](https://www.python.org/downloads/)
@@ -18,13 +23,13 @@ migration that changes a column is caught in review, not in production.
   (<a href="https://github.com/jirikuncar/sqlty/blob/main/docs/assets/demo.tape">view source</a>)
 </p>
 
-**Documentation: [jirikuncar.github.io/sqlty](https://jirikuncar.github.io/sqlty/)**
+**Documentation: [sqlty.kuncar.dev](https://sqlty.kuncar.dev/)**
 
 **Fits if** you write SQL as string literals on Python 3.14+, against
 PostgreSQL, SQLite or MySQL, with a schema dump or SQL migrations in the
 repository. Rows are typed end to end with psycopg 3; with other drivers sqlty
 checks the query and its parameters, and you annotate what the cursor returns
-([Drivers](https://jirikuncar.github.io/sqlty/guide/drivers-and-orms/)).
+([Drivers](https://sqlty.kuncar.dev/guide/drivers-and-orms/)).
 
 > **Beta.** APIs and configuration may change before 1.0. Feedback welcome in
 > [GitHub Issues](https://github.com/jirikuncar/sqlty/issues).
@@ -86,10 +91,10 @@ query = SQL[tuple[int, str]]("--sql\nSELECT id, email FROM users")
 caller that now needs a `None` check. `narrow-type` is an error, so CI fails on
 it; an annotation that is only wider than the rows, such as `str | None` for a
 column made `NOT NULL`, is a `stale-type` warning
-([CI](https://jirikuncar.github.io/sqlty/recipes/ci/)). For rolling deploys,
+([CI](https://sqlty.kuncar.dev/recipes/ci/)). For rolling deploys,
 `sqlty breaking --against origin/main` exits 1 when old code breaks on the new
 schema or new code on the old one
-([Breaking schema changes](https://jirikuncar.github.io/sqlty/guide/breaking-changes/)).
+([Breaking schema changes](https://sqlty.kuncar.dev/guide/breaking-changes/)).
 
 ### A row type that doesn't match its query
 
@@ -106,7 +111,7 @@ query = SQL[User]("--sql\nSELECT id::INTEGER, name::TEXT FROM users")
 ```
 
 `TypedDict`, `NamedTuple`, dataclasses and Pydantic models are all checked
-([Row types](https://jirikuncar.github.io/sqlty/guide/row-types/)).
+([Row types](https://sqlty.kuncar.dev/guide/row-types/)).
 
 ### Wrong parameters, misspelled columns
 
@@ -138,11 +143,11 @@ conn.execute(SQL[tuple[str | None]]("--sql\nSELECT email FROM users WHERE id = ?
 conn.execute("--sql\nSELECT emial FROM users")
 ```
 
-`?`, `$1`, `%s` and `:name` placeholders are checked on sqlite3, psycopg and
-asyncpg calls ([Parameters](https://jirikuncar.github.io/sqlty/guide/parameters/)).
+`?`, `$1`, `%s` and `:name` placeholders are checked on sqlite3, aiosqlite,
+psycopg and asyncpg calls ([Parameters](https://sqlty.kuncar.dev/guide/parameters/)).
 These are the mistakes coding agents make: every problem is one
 `file:line: [rule] message` line and a non-zero exit code they can act on, and
-the [sqlty skills](https://jirikuncar.github.io/sqlty/recipes/agents/) teach
+the [sqlty skills](https://sqlty.kuncar.dev/recipes/agents/) teach
 them the conventions. In Claude Code, `/plugin install sqlty --marketplace jirikuncar/sqlty`
 installs them.
 
@@ -158,13 +163,13 @@ sqlty strip .                  # undo: back to plain strings
 
 `rewrite` and `strip` only touch the wrapper, never the SQL, so you can adopt
 sqlty one module at a time and back out. New project:
-[Quickstart](https://jirikuncar.github.io/sqlty/quickstart/). Existing codebase:
-[Migration](https://jirikuncar.github.io/sqlty/recipes/migration/), starting
+[Quickstart](https://sqlty.kuncar.dev/quickstart/). Existing codebase:
+[Migration](https://sqlty.kuncar.dev/recipes/migration/), starting
 with `pg_dump --schema-only app > schema.sql`. In the editor:
-[VS Code](https://jirikuncar.github.io/sqlty/recipes/vscode/).
+[VS Code](https://sqlty.kuncar.dev/recipes/vscode/).
 
 Not a fit for ORMs, SQL built at runtime, or runtime validation;
-[Why SQLTy?](https://jirikuncar.github.io/sqlty/motivation/) compares it with
+[Why SQLTy?](https://sqlty.kuncar.dev/motivation/) compares it with
 sqlc, sqlx, PgTyped and others.
 
 ## About
@@ -175,5 +180,5 @@ developed with AI coding agents, mainly Claude Code; every change is reviewed by
 a maintainer (see the
 [AI-assisted contributions](https://github.com/jirikuncar/sqlty/blob/main/CONTRIBUTING.md#ai-assisted-contributions)
 policy). [Contributing](https://github.com/jirikuncar/sqlty/blob/main/CONTRIBUTING.md) ·
-[Credits](https://jirikuncar.github.io/sqlty/credits/) ·
+[Credits](https://sqlty.kuncar.dev/credits/) ·
 MIT [License](https://github.com/jirikuncar/sqlty/blob/main/LICENSE).

{sqlty-0.3.0 → sqlty-0.5.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "sqlty"
 dynamic = ["version"]
-description = "Type-safe SQL queries for Python"
+description = "Type-safe raw SQL for Python: row and parameter types inferred from your SQL and schema, no ORM or database needed"
 readme = "README.md"
 requires-python = ">=3.14"
 license = "MIT"
@@ -9,11 +9,22 @@ license-files = ["LICENSE"]
 authors = [{ name = "Jiri Kuncar", email = "jiri.kuncar@gmail.com" }]
 keywords = [
     "sql",
-    "type-hints",
-    "mypy",
+    "raw-sql",
     "type-safety",
+    "type-checking",
+    "type-hints",
     "static-analysis",
+    "linter",
+    "mypy",
+    "pyright",
+    "ty",
+    "postgresql",
+    "sqlite",
+    "mysql",
+    "psycopg",
+    "migrations",
     "code-generation",
+    "orm-alternative",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -27,6 +38,7 @@ classifiers = [
     "Programming Language :: SQL",
     "Topic :: Software Development :: Code Generators",
     "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Quality Assurance",
     "Topic :: Database",
     "Typing :: Typed",
 ]
@@ -36,8 +48,8 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/jirikuncar/sqlty"
-Documentation = "https://jirikuncar.github.io/sqlty/"
+Homepage = "https://sqlty.kuncar.dev/"
+Documentation = "https://sqlty.kuncar.dev/"
 Repository = "https://github.com/jirikuncar/sqlty"
 Changelog = "https://github.com/jirikuncar/sqlty/releases"
 Issues = "https://github.com/jirikuncar/sqlty/issues"
@@ -45,6 +57,9 @@ Issues = "https://github.com/jirikuncar/sqlty/issues"
 [project.scripts]
 sqlty = "sqlty._cli:main"
 
+[project.entry-points."pygments.lexers"]
+sqlty = "sqlty.lexer:SQLTyLexer"
+
 [project.optional-dependencies]
 psycopg = ["psycopg>=3.2.12"]
 
@@ -81,11 +96,16 @@ dev = [
     "vale>=3.22.0.0",
     "zizmor>=1.31.1",
     "pydantic[email]>=2.14.1",
+    "jsonschema>=4.26.0",
+    "pytest-xdist>=3.8.0",
+    "types-pygments>=2.19",
 ]
 cli = ["rich>=15.0.0"]
 # Only the DuckDB type tests need it, and it has no wheel for every Python.
 duckdb = ["duckdb>=1.4.0"]
 psycopg = ["psycopg>=3.2.12"]
+# The aiosqlite calls sqlty checks, run against aiosqlite (tests/test_aiosqlite.py).
+aiosqlite = ["aiosqlite>=0.22.1"]
 fuzz = [
     "hypothesis>=6.140",
 ]
@@ -94,7 +114,8 @@ bench = [
 ]
 
 [tool.pytest.ini_options]
-addopts = ["-p", "tests._mdtest.plugin", "-p", "tests._no_exec", "--cov-report=term-missing", "--cov-report=html", "-v"]
+# In parallel and in random order; `make test-timing` runs the `timing` tests alone.
+addopts = ["-p", "tests._mdtest.plugin", "-p", "tests._no_exec", "--cov-report=term-missing", "--cov-report=html", "-v", "-n", "auto", "-m", "not timing"]
 pythonpath = ["."]
 testpaths = ["tests", "docs", "src/sqlty/rules", "README.md"]
 mdtest_paths = ["tests/mdtest", "docs", "src/sqlty/rules", "README.md", "skills"]
@@ -102,6 +123,7 @@ markers = [
     "e2e: end-to-end tests (subprocess + inline-snapshot)",
     "slow: slow tests that can be skipped with -m 'not slow'",
     "pg: needs a PostgreSQL server (SQLTY_PG_DSN); skipped without it",
+    "timing: measures wall time, so runs alone: `make test-timing`",
 ]
 
 [tool.coverage.run]
@@ -172,5 +194,7 @@ disable = ["MD013", "MD038"]
 exclude = ["site", ".vale", ".github", "tests", "scripts/compat/reports", "plans/2026-02-13-future.md", "rust/target", "proofs/.lake"]
 
 [tool.rumdl.per-file-ignores]
-# The demo GIF needs HTML for its width and centering.
+# The logo and demo GIF need HTML for light/dark variants, width and centering.
 "README.md" = ["MD033"]
+# The editors and panels of the playground are HTML that its script fills in.
+"docs/playground.md" = ["MD033"]