libsyntaqlite for Python
libsyntaqlite is a fast, embeddable parser, formatter, and static analyzer for SQLite SQL. The syntaqlite package provides its Python API.
Docs · Playground · GitHub
pip install syntaqlite
The package requires Python 3.10 or later. Wheels are available for Linux (x86_64, aarch64), macOS (x86_64, arm64), and Windows (x86_64).
API
Everything goes through a Syntaqlite instance. Create one and reuse it across many calls:
import syntaqlite
with syntaqlite.Syntaqlite() as sq:
print(sq.format_sql("select 1"))
Formatting
sql = "select u.id, u.name, p.title from users u join posts p on u.id = p.user_id where u.active = 1 and p.published = true order by p.created_at desc limit 10"
print(sq.format_sql(sql))
SELECT u.id, u.name, p.title
FROM users AS u
JOIN posts AS p ON u.id = p.user_id
WHERE
u.active = 1
AND p.published = true
ORDER BY
p.created_at DESC
LIMIT 10;
Raises syntaqlite.FormatError on invalid input.
Parsing
sq.parse() returns a full AST as typed Python objects, one per statement:
stmts = sq.parse("SELECT 1 + 2 FROM foo")
stmt = stmts[0] # SelectStmt
print(type(stmt).__name__) # SelectStmt
print(stmt.columns[0].expr) # BinaryExpr(...)
print(stmt.from_clause) # TableRef(...)
print(stmt.where_clause) # None
Every node type is a __slots__ class with typed attributes, which supports
IDE completion and isinstance checks:
from syntaqlite.nodes import SelectStmt, BinaryExpr
assert isinstance(stmt, SelectStmt)
assert isinstance(stmt.columns[0].expr, BinaryExpr)
Enum and flag fields are IntEnum/IntFlag from syntaqlite.enums:
from syntaqlite.enums import BinaryOp
expr = stmt.columns[0].expr
print(expr.op) # BinaryOp.PLUS
For performance-sensitive code, use sq.parse_raw() to get plain dicts
instead of typed objects.
Tokenizing
for tok in sq.tokenize("SELECT 1 + 2"):
print(tok["text"], tok["category"])
SELECT keyword
other
1 number
other
+ operator
other
2 number
Each token is a dict with text, offset, length, type, and category fields.
Analysis
Check SQL against a schema without touching a database. Catches unknown tables, columns, functions, CTE column mismatches, and more.
schema = syntaqlite.Schema(
tables=[syntaqlite.Table("users", columns=["id", "name", "email"])],
)
result = sq.analyze("SELECT nme FROM users", schema)
for d in result.diagnostics:
print(f"{d.severity}: {d.message}")
error: unknown column 'nme'
Switch output to get formatted diagnostics with source locations and suggestions:
print(sq.analyze(
"SELECT nme FROM users", schema,
output=syntaqlite.AnalysisOutput.TEXT,
))
error: unknown column 'nme'
--> <input>:1:8
|
1 | SELECT nme FROM users
| ^~~
= help: did you mean 'name'?
Schema also accepts raw DDL:
schema = syntaqlite.Schema(ddl="CREATE TABLE orders (id INTEGER, total REAL);")
result = sq.analyze("SELECT * FROM orders", schema)
Column lineage
For query-bearing statements, the result includes column lineage:
schema = syntaqlite.Schema(
tables=[syntaqlite.Table("users", columns=["id", "name", "email"])],
)
result = sq.analyze("SELECT id, name FROM users", schema)
for col in result.lineage.columns:
print(f"{col.name} <- {col.origin}")
id <- users.id
name <- users.name
CLI
The pip package also bundles the syntaqlite binary:
syntaqlite fmt -e "select 1, 2, 3"
syntaqlite analyze query.sql
syntaqlite parse -e "SELECT * FROM users"
The CLI supports pinning to a specific SQLite version or enabling compile-time flags to match your target environment:
syntaqlite --sqlite-version 3.32.0 analyze query.sql
syntaqlite --sqlite-cflag SQLITE_ENABLE_MATH_FUNCTIONS analyze query.sql
See the CLI reference for all commands and flags.
License
Apache 2.0. SQLite components are public domain under the SQLite blessing.
1 maintainer
Metadata
1 maintainer
Release files for syntaqlite 0.12.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| syntaqlite-0.12.1-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| syntaqlite-0.12.1-py3-none-pyemscripten_2026_0_wasm32.whl | Python 3 | none | PyEmscripten 2026.0+ WebAssembly | Details |
| syntaqlite-0.12.1-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details |
| syntaqlite-0.12.1-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details |
| syntaqlite-0.12.1-py3-none-macosx_11_0_universal2.whl | Python 3 | none | macOS 11.0+ universal2 (ARM64, x86-64) | Details |
| syntaqlite-0.12.1-py3-none-macosx_10_13_universal2.whl | Python 3 | none | macOS 10.13+ universal2 (ARM64, x86-64) | Details |
Total release size: 15.2 MB
Release files / syntaqlite-0.12.1-py3-none-win_amd64.whl
| Download URL | syntaqlite-0.12.1-py3-none-win_amd64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f1f510419117258285b3522acca780c7d318146817801e47207784e45ded41a5
|
|
BLAKE2b-256 checksum How to use checksums |
c3af68e3ce7c347318c032373882d1a21e600a0727b3e7f727037330c6d5b8e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logRelease files / syntaqlite-0.12.1-py3-none-pyemscripten_2026_0_wasm32.whl
| Download URL | syntaqlite-0.12.1-py3-none-pyemscripten_2026_0_wasm32.whl |
|---|---|
| Size | 271.2 kB |
| Tags | PyEmscripten 2026.0+ WebAssembly Python 3 |
|
SHA-256 checksum How to use checksums |
2768e68072e4b3012606d69256d1e6cb0e86956ddf6af1a13c0edec1242f28c4
|
|
BLAKE2b-256 checksum How to use checksums |
60af3bbbef67d54e21dc1161df902597afb0b1148e9e665e27db8f431ac93709
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logRelease files / syntaqlite-0.12.1-py3-none-manylinux_2_28_x86_64.whl
| Download URL | syntaqlite-0.12.1-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
789e1755a95699dee0cf04931c2a068913110fdb4736768f5a8986ae5d77a0a6
|
|
BLAKE2b-256 checksum How to use checksums |
21d24a6f2c45f9c7773561634ecfc07f356392b8fa374097c1d993c10deee4a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logRelease files / syntaqlite-0.12.1-py3-none-manylinux_2_28_aarch64.whl
| Download URL | syntaqlite-0.12.1-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
5717dcae7890e01e6bf8740bf5744b18e883c525e125a94d84ba8623417fa412
|
|
BLAKE2b-256 checksum How to use checksums |
9e9ffd22f755cdcef03c75448eda7fd7fbf37ed364a04236c1d7c95e86b85234
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logRelease files / syntaqlite-0.12.1-py3-none-macosx_11_0_universal2.whl
| Download URL | syntaqlite-0.12.1-py3-none-macosx_11_0_universal2.whl |
|---|---|
| Size | 2.9 MB |
| Tags | Python 3 macOS 11.0+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
58e1793e3be3de8ca2e3870cdcfa52feab9b9ed08df08c7805245640cbabf2cd
|
|
BLAKE2b-256 checksum How to use checksums |
207195b96815cb5405481a46a7e0f3b70766cc9f4206d0ad25f140ac017dcbb3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logRelease files / syntaqlite-0.12.1-py3-none-macosx_10_13_universal2.whl
| Download URL | syntaqlite-0.12.1-py3-none-macosx_10_13_universal2.whl |
|---|---|
| Size | 3.0 MB |
| Tags | Python 3 macOS 10.13+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
1a01a947383b446cfff92e3a023842ae91a1027ca23a55d5abfc5c21c7a7ccf1
|
|
BLAKE2b-256 checksum How to use checksums |
ce2976347752093173e0cb714c57f6a642d9b857a818b478abfe170e67bc72a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency log
