dltlint 0.3.8

Linter for Databricks DLT pipelines

dltlint

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

Why

The Asset Bundle validate does not check actual configuration values inside pipeline definitions. This library fills that gap and provides clear actionable errors and warning messages.

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

Add to your repo’s .pre-commit-config.yaml:

repos:
  - repo: https://github.com/dan1elt0m/dltlint
    rev: v0.3.4        
    hooks:
      - id: dltlint

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.