dltlint 0.1.0

Linter for Databricks DLT pipelines

dltlint

Lint Databricks Lakeflow (DLT) pipeline YAML/JSON files.

Installation

pip install dltlint

Usage CLI

# Lint current repo recursively
dltlint 

# JSON output for tooling
dltlint --format json .

# Fail build on warnings or worse
dltlint --fail-on warning .

# Print a success message when clean (otherwise silent on success)
dltlint --ok .

Exit codes

• 0 → clean OR no matching files
• 1 → findings at/above threshold (--fail-on)
• 2 → fatal error (e.g., unreadable file)

dltlint discovers:

• *.pipeline.yml,
• *.pipeline.yaml
• *.pipeline.yml.resources,
• *.pipeline.yaml.resources

Pre-commit

A) Use the repo’s published hook Add to your repo’s .pre-commit-config.yaml: repos:

• repo: https://github.com/dan1elt0m/dltlint rev: v0.0.1 # tag or commit hooks:
  • id: dltlint

    By default the hook runs from repo root and scans recursively.

    If you prefer to pass staged files only, uncomment:

    pass_filenames: true

    args: ["--fail-on", "error"]

Config (pyproject.toml)

[tool.dltlint]
fail_on = "warning"                       # default: "error"
ignore = ["DLT010", "DLT400"]             # suppress specific rules
require = ["catalog", "schema"]           # fields that must be present
inline_disable_token = "dltlint: disable" # comment token (see below)

[tool.dltlint.severity_overrides]
DLT400 = "info"

Inline suppressions

Add a comment anywhere in a file to suppress rules for that file:

# dltlint: disable=DLT010,DLT400
resources:
  pipelines:
    my_pipe:
      name: n
      catalog: c
      schema: s

Line-scoped suppressions require YAML line tracking and are not supported yet.