pre-commit Integration

pre-commit is the standard hook manager for dbt projects. The linter ships a .pre-commit-hooks.yaml so you can add it directly.

Setup

Add to your .pre-commit-config.yaml:

repos:
  - repo: https://github.com/IlllIIIlllIlIlIIllllIIIlI/squint
    rev: v1.0.1   # pin to a release tag
    hooks:
      - id: squint

Run pre-commit install once to register the hooks. On the first run, pre-commit builds the binary from source (requires Rust on the machine). The binary is cached for subsequent runs.

Available hooks

Hook ID	What it does
`squint`	Lint staged SQL files and exit 1 on any violations
`squint-fix`	Auto-fix staged SQL files in place

Lint only

- id: squint

Fails the commit if any violations are found. The developer must fix violations (or suppress them with -- noqa) before committing.

Auto-fix on commit

- id: squint-fix

Rewrites staged files in place before the commit. If files are modified, pre-commit will abort the commit and ask you to git add the fixed files. This is the most frictionless setup for teams.

Config file

The linter reads squint.toml from the working directory at hook execution time. Project-level config (severity overrides, line length, etc.) is applied automatically.

Pinning a version

Always pin to a tag (rev: v1.0.1) rather than a branch name. pre-commit caches the binary per rev, so floating tags like main defeat caching and force a rebuild on every run.

Keyboard shortcuts