sqlanvil-sqlx-lint 0.2.0__tar.gz

sqlanvil_sqlx_lint-0.2.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Acuantia (original dataform-sqlx-lint)
+Copyright (c) 2026 Ivan Histand / SQLAnvil (sqlanvil-sqlx-lint fork)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sqlanvil_sqlx_lint-0.2.0/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: sqlanvil-sqlx-lint
+Version: 0.2.0
+Summary: Convention linter for SQLAnvil .sqlx files — config-block, project-convention, and sqlanvil-delta checks that SQL linters and compile cannot see
+Author-email: Ivan Histand <ivan@histand.net>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/SQLAnvil/sqlanvil-sqlx-lint
+Project-URL: Documentation, https://sqlanvil.com/docs
+Project-URL: Upstream, https://github.com/acuantia/dataform-sqlx-lint
+Keywords: sqlanvil,sqlx,lint,postgres,supabase,mysql,bigquery,dataform,pre-commit
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# sqlanvil-sqlx-lint
+
+A convention linter for [SQLAnvil](https://sqlanvil.com) `.sqlx` files. SQL
+linters (sqlfluff) check the SQL body; `sqlanvil compile` checks syntax and
+`sqlanvil validate` checks against the warehouse. None of them see the
+**config-block and project conventions** that keep a sqlanvil repo healthy, and
+several Dataform habits that sqlanvil silently ignores or fails on at run time.
+This tool does, in milliseconds, with no warehouse connection.
+
+Zero dependencies (Python ≥ 3.11 standard library only). Designed for
+[pre-commit](https://pre-commit.com). Warehouse-aware: PostgreSQL, Supabase,
+MySQL/MariaDB, and BigQuery-target projects.
+
+```bash
+pip install sqlanvil-sqlx-lint
+```
+
+Forked from [acuantia/dataform-sqlx-lint](https://github.com/acuantia/dataform-sqlx-lint)
+(MIT), which was extracted from a production Dataform repository.
+
+## Rules
+
+### Conventions
+
+| Code | Default | Checks |
+|------|---------|--------|
+| E001 | on | `config {}` block present and balanced |
+| E002 | on | non-empty `columns: {}` on tables/views/incrementals/declarations (declarations may carry `columnTypes: {}` from `sqlanvil introspect` instead) |
+| E003 | on | `schema:` must not hardcode an environment suffix (`_prod`/`_dev`/`_test` by default) — `--schema-suffix` and `environments.<name>.schemaSuffix` append it, so a literal doubles up (`analytics_test_test`) |
+| E004 | on | `name:` matching the filename is redundant (declarations exempt) |
+| E005 | opt-in | operations/assertions must not set `schema:` (`hasOutput: true` operations exempt — schema+name define `${self()}`) |
+| E006 | on | hardcoded table paths instead of `${ref()}` — these silently break the dependency graph. Warehouse-aware: `public.orders`, `"schema"."table"`, `` `db`.`table` ``, `` `project.dataset.table` `` |
+| E007 | on* | configurable per-directory naming/type policies (*no-op until policies are configured) |
+| W008 | opt-in | `post_operations {}` placed before the main SELECT (style preference) |
+| E010 | on | every determinable output column appears in `columns: {}` — parses the main SELECT conservatively (unparseable expressions are skipped, never false-flagged) and follows `select *` through a single plain `${ref()}` into the upstream file |
+
+Why E002/E010 matter: sqlanvil writes `description:` and `columns: {}` into the
+warehouse catalog (`COMMENT ON TABLE` / `COMMENT ON COLUMN` on Postgres, table
+and column descriptions on BigQuery). That is the metadata data catalogs, BI
+tools, and AI analytics agents read. Partial blocks leave silent gaps.
+
+### sqlanvil deltas
+
+The places where a Dataform/BigQuery habit produces a sqlanvil project that
+compiles but does the wrong thing. The first three are failures no compiler
+catches.
+
+| Code | Default | Checks | `sqlanvil compile` catches it? |
+|------|---------|--------|-------------------------------|
+| S101 | on | `bigquery: {}`, `partitionBy`, `clusterBy`, `bigqueryPolicyTags` on a non-BigQuery warehouse — ignored silently, never applied | no |
+| S102 | on | `;` separating statements in `operations` / `pre_operations` / `post_operations` — sqlanvil splits on a `---` line, so the block runs as one statement and fails at run time | no |
+| S105 | on | `ADD PRIMARY KEY` / `ADD CONSTRAINT` in an incremental's operations block not wrapped in `${when(!incremental(), …)}` — runs on every append and errors the second time | no |
+| S103 | on | `postgres.indexes[].method` given as a string — it is a numeric enum (`BTREE=0, HASH=1, GIN=2, GIST=3, BRIN=4`) | yes |
+| S104 | on | `incrementalStrategy` on a non-BigQuery warehouse | yes (≥1.29) |
+| S106 | on | `assertions:` sets both `uniqueKey` and `uniqueKeys` | yes |
+| S108 | on | `.jitCode()` / `jitData()` — no runtime in sqlanvil | yes (≥1.30) |
+
+## Usage
+
+```bash
+sqlanvil-sqlx-lint definitions/outputs/my_table.sqlx [...]
+# exit 0 = clean or warnings only; 1 = errors; 2 = bad config
+```
+
+Run from the project root. The target warehouse is read from
+`workflow_settings.yaml` there (`warehouse: postgres|supabase|mysql|bigquery`),
+and `--definitions-root` (default `./definitions`) is indexed so `${ref()}`
+targets resolve for E010's star-resolution. Override with `--warehouse` or the
+`warehouse` config key; the default with nothing configured is `postgres`.
+
+### pre-commit
+
+```yaml
+repos:
+  - repo: https://github.com/SQLAnvil/sqlanvil-sqlx-lint
+    rev: v0.2.0
+    hooks:
+      - id: sqlanvil-sqlx-lint
+```
+
+### Configuration
+
+`.sqlx-lint.toml` in the project root, or a `[tool.sqlx-lint]` table in
+`pyproject.toml` (the standalone file wins). All keys optional:
+
+```toml
+warehouse = "postgres"                     # else workflow_settings.yaml, else postgres
+schema_suffixes = ["_prod", "_dev", "_test"]  # E003 suffix list ([] disables)
+documented_types = ["table", "view", "incremental", "declaration"]  # E002
+coverage_paths = ["definitions/outputs/"]  # E010 scope; empty = everywhere
+allowed_schemas = ["extensions"]           # E006 may reference these directly
+enable = ["E005", "W008"]                  # switch on opt-in rules
+disable = ["E004"]                         # switch off default rules
+
+[[dir_policies]]                           # E007 (repeatable)
+path_contains = "definitions/outputs/"
+require_prefix = "rpt_"
+require_types = ["table", "incremental"]
+severity = "error"                         # or "warning"
+```
+
+See [`examples/sqlx-lint.toml`](examples/sqlx-lint.toml) for a complete
+sources → intermediate → outputs layout. System catalogs (`pg_catalog`,
+`information_schema`, `mysql`, `sys`, …) are always allowed.
+
+### Adopting on an existing project
+
+A migrated repository will be loud on the first run: E002 on every undocumented
+model and E010 wherever documentation is partial. Adopt in layers rather than
+suppressing:
+
+1. Start with `disable = ["E002", "E010"]` so the S-series and E006 findings,
+   which are actual defects, land first.
+2. Re-enable E002 and scope E010 with `coverage_paths` to the BI-facing layer.
+3. Widen `coverage_paths` as documentation catches up.
+
+### Suppressing findings
+
+```sql
+from public.legacy_events -- sqlx-lint: disable=E006 (declaration repoints at cutover)
+```
+
+or file-wide, anywhere in the file:
+
+```sql
+-- sqlx-lint: disable-file=E006
+```
+
+Suppress with a reason, sparingly — the convention is usually the fix.
+
+## Design notes
+
+- **Conservative by construction**: the SQL projection parser only claims
+  column names it can determine (aliases, simple identifiers, resolvable
+  `select *`); anything ambiguous is skipped, so E010 never false-flags.
+- **E006 looks only at table positions** (`FROM`, `JOIN`, `INTO`, `UPDATE`),
+  ignores `FROM` used as function syntax (`extract(dow from d.date)`), function
+  calls (`public.my_func(1)`), and anything inside `${…}`.
+- **S102 understands sqlanvil's text**: `;` inside string literals, `$$`
+  dollar-quoted PL/pgSQL bodies, and `${…}` JavaScript regions never count; a
+  single trailing `;` is fine.
+- **Declarations are exempt** from E003/E004 deliberately: raw source schemas
+  legitimately carry environment-suffixed names, and `name:` is required.
+- Rule codes are stable; gaps in the numbering are historical.
+
+## Agent Skill
+
+The `sqlanvil-sqlx-lint` Agent Skill teaches AI coding agents (Claude Code,
+Codex CLI, Cursor, or any tool supporting the open
+[Agent Skills](https://agentskills.io/) format) to run this linter on every
+`.sqlx` file they create or modify. It lives with the other SQLAnvil skills:
+
+```bash
+npx skills add SQLAnvil/agent-skills
+```
+
+Source: https://github.com/SQLAnvil/agent-skills
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install -e . pytest
+.venv/bin/pytest        # 103 tests
+```
+
+## License
+
+MIT — see [LICENSE](https://github.com/SQLAnvil/sqlanvil-sqlx-lint/blob/main/LICENSE).

sqlanvil_sqlx_lint-0.2.0/README.md

@@ -0,0 +1,168 @@
+# sqlanvil-sqlx-lint
+
+A convention linter for [SQLAnvil](https://sqlanvil.com) `.sqlx` files. SQL
+linters (sqlfluff) check the SQL body; `sqlanvil compile` checks syntax and
+`sqlanvil validate` checks against the warehouse. None of them see the
+**config-block and project conventions** that keep a sqlanvil repo healthy, and
+several Dataform habits that sqlanvil silently ignores or fails on at run time.
+This tool does, in milliseconds, with no warehouse connection.
+
+Zero dependencies (Python ≥ 3.11 standard library only). Designed for
+[pre-commit](https://pre-commit.com). Warehouse-aware: PostgreSQL, Supabase,
+MySQL/MariaDB, and BigQuery-target projects.
+
+```bash
+pip install sqlanvil-sqlx-lint
+```
+
+Forked from [acuantia/dataform-sqlx-lint](https://github.com/acuantia/dataform-sqlx-lint)
+(MIT), which was extracted from a production Dataform repository.
+
+## Rules
+
+### Conventions
+
+| Code | Default | Checks |
+|------|---------|--------|
+| E001 | on | `config {}` block present and balanced |
+| E002 | on | non-empty `columns: {}` on tables/views/incrementals/declarations (declarations may carry `columnTypes: {}` from `sqlanvil introspect` instead) |
+| E003 | on | `schema:` must not hardcode an environment suffix (`_prod`/`_dev`/`_test` by default) — `--schema-suffix` and `environments.<name>.schemaSuffix` append it, so a literal doubles up (`analytics_test_test`) |
+| E004 | on | `name:` matching the filename is redundant (declarations exempt) |
+| E005 | opt-in | operations/assertions must not set `schema:` (`hasOutput: true` operations exempt — schema+name define `${self()}`) |
+| E006 | on | hardcoded table paths instead of `${ref()}` — these silently break the dependency graph. Warehouse-aware: `public.orders`, `"schema"."table"`, `` `db`.`table` ``, `` `project.dataset.table` `` |
+| E007 | on* | configurable per-directory naming/type policies (*no-op until policies are configured) |
+| W008 | opt-in | `post_operations {}` placed before the main SELECT (style preference) |
+| E010 | on | every determinable output column appears in `columns: {}` — parses the main SELECT conservatively (unparseable expressions are skipped, never false-flagged) and follows `select *` through a single plain `${ref()}` into the upstream file |
+
+Why E002/E010 matter: sqlanvil writes `description:` and `columns: {}` into the
+warehouse catalog (`COMMENT ON TABLE` / `COMMENT ON COLUMN` on Postgres, table
+and column descriptions on BigQuery). That is the metadata data catalogs, BI
+tools, and AI analytics agents read. Partial blocks leave silent gaps.
+
+### sqlanvil deltas
+
+The places where a Dataform/BigQuery habit produces a sqlanvil project that
+compiles but does the wrong thing. The first three are failures no compiler
+catches.
+
+| Code | Default | Checks | `sqlanvil compile` catches it? |
+|------|---------|--------|-------------------------------|
+| S101 | on | `bigquery: {}`, `partitionBy`, `clusterBy`, `bigqueryPolicyTags` on a non-BigQuery warehouse — ignored silently, never applied | no |
+| S102 | on | `;` separating statements in `operations` / `pre_operations` / `post_operations` — sqlanvil splits on a `---` line, so the block runs as one statement and fails at run time | no |
+| S105 | on | `ADD PRIMARY KEY` / `ADD CONSTRAINT` in an incremental's operations block not wrapped in `${when(!incremental(), …)}` — runs on every append and errors the second time | no |
+| S103 | on | `postgres.indexes[].method` given as a string — it is a numeric enum (`BTREE=0, HASH=1, GIN=2, GIST=3, BRIN=4`) | yes |
+| S104 | on | `incrementalStrategy` on a non-BigQuery warehouse | yes (≥1.29) |
+| S106 | on | `assertions:` sets both `uniqueKey` and `uniqueKeys` | yes |
+| S108 | on | `.jitCode()` / `jitData()` — no runtime in sqlanvil | yes (≥1.30) |
+
+## Usage
+
+```bash
+sqlanvil-sqlx-lint definitions/outputs/my_table.sqlx [...]
+# exit 0 = clean or warnings only; 1 = errors; 2 = bad config
+```
+
+Run from the project root. The target warehouse is read from
+`workflow_settings.yaml` there (`warehouse: postgres|supabase|mysql|bigquery`),
+and `--definitions-root` (default `./definitions`) is indexed so `${ref()}`
+targets resolve for E010's star-resolution. Override with `--warehouse` or the
+`warehouse` config key; the default with nothing configured is `postgres`.
+
+### pre-commit
+
+```yaml
+repos:
+  - repo: https://github.com/SQLAnvil/sqlanvil-sqlx-lint
+    rev: v0.2.0
+    hooks:
+      - id: sqlanvil-sqlx-lint
+```
+
+### Configuration
+
+`.sqlx-lint.toml` in the project root, or a `[tool.sqlx-lint]` table in
+`pyproject.toml` (the standalone file wins). All keys optional:
+
+```toml
+warehouse = "postgres"                     # else workflow_settings.yaml, else postgres
+schema_suffixes = ["_prod", "_dev", "_test"]  # E003 suffix list ([] disables)
+documented_types = ["table", "view", "incremental", "declaration"]  # E002
+coverage_paths = ["definitions/outputs/"]  # E010 scope; empty = everywhere
+allowed_schemas = ["extensions"]           # E006 may reference these directly
+enable = ["E005", "W008"]                  # switch on opt-in rules
+disable = ["E004"]                         # switch off default rules
+
+[[dir_policies]]                           # E007 (repeatable)
+path_contains = "definitions/outputs/"
+require_prefix = "rpt_"
+require_types = ["table", "incremental"]
+severity = "error"                         # or "warning"
+```
+
+See [`examples/sqlx-lint.toml`](examples/sqlx-lint.toml) for a complete
+sources → intermediate → outputs layout. System catalogs (`pg_catalog`,
+`information_schema`, `mysql`, `sys`, …) are always allowed.
+
+### Adopting on an existing project
+
+A migrated repository will be loud on the first run: E002 on every undocumented
+model and E010 wherever documentation is partial. Adopt in layers rather than
+suppressing:
+
+1. Start with `disable = ["E002", "E010"]` so the S-series and E006 findings,
+   which are actual defects, land first.
+2. Re-enable E002 and scope E010 with `coverage_paths` to the BI-facing layer.
+3. Widen `coverage_paths` as documentation catches up.
+
+### Suppressing findings
+
+```sql
+from public.legacy_events -- sqlx-lint: disable=E006 (declaration repoints at cutover)
+```
+
+or file-wide, anywhere in the file:
+
+```sql
+-- sqlx-lint: disable-file=E006
+```
+
+Suppress with a reason, sparingly — the convention is usually the fix.
+
+## Design notes
+
+- **Conservative by construction**: the SQL projection parser only claims
+  column names it can determine (aliases, simple identifiers, resolvable
+  `select *`); anything ambiguous is skipped, so E010 never false-flags.
+- **E006 looks only at table positions** (`FROM`, `JOIN`, `INTO`, `UPDATE`),
+  ignores `FROM` used as function syntax (`extract(dow from d.date)`), function
+  calls (`public.my_func(1)`), and anything inside `${…}`.
+- **S102 understands sqlanvil's text**: `;` inside string literals, `$$`
+  dollar-quoted PL/pgSQL bodies, and `${…}` JavaScript regions never count; a
+  single trailing `;` is fine.
+- **Declarations are exempt** from E003/E004 deliberately: raw source schemas
+  legitimately carry environment-suffixed names, and `name:` is required.
+- Rule codes are stable; gaps in the numbering are historical.
+
+## Agent Skill
+
+The `sqlanvil-sqlx-lint` Agent Skill teaches AI coding agents (Claude Code,
+Codex CLI, Cursor, or any tool supporting the open
+[Agent Skills](https://agentskills.io/) format) to run this linter on every
+`.sqlx` file they create or modify. It lives with the other SQLAnvil skills:
+
+```bash
+npx skills add SQLAnvil/agent-skills
+```
+
+Source: https://github.com/SQLAnvil/agent-skills
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install -e . pytest
+.venv/bin/pytest        # 103 tests
+```
+
+## License
+
+MIT — see [LICENSE](https://github.com/SQLAnvil/sqlanvil-sqlx-lint/blob/main/LICENSE).

sqlanvil_sqlx_lint-0.2.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sqlanvil-sqlx-lint"
+version = "0.2.0"
+description = "Convention linter for SQLAnvil .sqlx files — config-block, project-convention, and sqlanvil-delta checks that SQL linters and compile cannot see"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Ivan Histand", email = "ivan@histand.net" }]
+keywords = ["sqlanvil", "sqlx", "lint", "postgres", "supabase", "mysql", "bigquery", "dataform", "pre-commit"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development :: Quality Assurance",
+]
+
+[project.scripts]
+sqlanvil-sqlx-lint = "sqlanvil_sqlx_lint.cli:entrypoint"
+
+[project.urls]
+Homepage = "https://github.com/SQLAnvil/sqlanvil-sqlx-lint"
+Documentation = "https://sqlanvil.com/docs"
+Upstream = "https://github.com/acuantia/dataform-sqlx-lint"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

sqlanvil_sqlx_lint-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sqlanvil_sqlx_lint-0.2.0/src/sqlanvil_sqlx_lint/__init__.py

@@ -0,0 +1,16 @@
+"""sqlanvil-sqlx-lint: convention linter for SQLAnvil .sqlx files."""
+
+from .config import Config, DirPolicy, detect_warehouse, load_config, load_config_file
+from .linter import Finding, lint_file, lint_text
+
+__all__ = [
+    "Config",
+    "DirPolicy",
+    "Finding",
+    "detect_warehouse",
+    "lint_file",
+    "lint_text",
+    "load_config",
+    "load_config_file",
+]
+__version__ = "0.2.0"

sqlanvil_sqlx_lint-0.2.0/src/sqlanvil_sqlx_lint/cli.py

@@ -0,0 +1,93 @@
+"""Command-line interface.
+
+Usage: sqlanvil-sqlx-lint [--config PATH] [--warehouse NAME]
+                          [--definitions-root DIR] FILE [FILE ...]
+Exit codes: 0 = clean or warnings only, 1 = errors found, 2 = usage error.
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from dataclasses import replace
+from pathlib import Path
+
+from .config import WAREHOUSES, Config, load_config, load_config_file, with_detected_warehouse
+from .linter import lint_file
+
+
+def _repo_resolver(root: Path):
+    """Resolve an action name to the text of <root>/**/<name>.sqlx.
+    Used to follow `select *` through ${ref()} for E010."""
+    if not root.is_dir():
+        return lambda name: None
+    index = {p.stem: p for p in root.rglob("*.sqlx")}
+
+    def resolve(name):
+        p = index.get(name)
+        try:
+            return p.read_text(encoding="utf-8") if p else None
+        except OSError:
+            return None
+
+    return resolve
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="sqlanvil-sqlx-lint",
+        description="Convention linter for SQLAnvil .sqlx files",
+    )
+    parser.add_argument("files", nargs="+", help=".sqlx files to lint")
+    parser.add_argument(
+        "--config",
+        help="path to a TOML config file (default: .sqlx-lint.toml or "
+        "[tool.sqlx-lint] in ./pyproject.toml)",
+    )
+    parser.add_argument(
+        "--warehouse",
+        choices=WAREHOUSES,
+        help="target warehouse (default: `warehouse` in the config, else "
+        "workflow_settings.yaml in the working directory, else postgres)",
+    )
+    parser.add_argument(
+        "--definitions-root",
+        default="definitions",
+        help="directory indexed to resolve ${ref()} targets for the E010 "
+        "coverage rule (default: ./definitions)",
+    )
+    args = parser.parse_args(argv)
+
+    try:
+        if args.config:
+            cfg: Config = with_detected_warehouse(load_config_file(args.config), ".")
+        else:
+            cfg = load_config(".")
+    except (OSError, ValueError) as exc:
+        print(f"sqlx-lint: bad config: {exc}", file=sys.stderr)
+        return 2
+    if args.warehouse:
+        cfg = replace(cfg, warehouse=args.warehouse)
+    resolver = _repo_resolver(Path(args.definitions_root))
+
+    errors = warnings = 0
+    for path in args.files:
+        try:
+            findings = lint_file(path, config=cfg, resolver=resolver)
+        except OSError as exc:
+            print(f"{path}: cannot read: {exc}")
+            errors += 1
+            continue
+        for f in sorted(findings, key=lambda f: f.line):
+            print(f"{path}:{f.line}: {f.code} [{f.severity}] {f.message}")
+            if f.severity == "error":
+                errors += 1
+            else:
+                warnings += 1
+    if errors or warnings:
+        print(f"sqlx-lint: {errors} error(s), {warnings} warning(s)")
+    return 1 if errors else 0
+
+
+def entrypoint() -> None:
+    sys.exit(main())