dbt-tester 0.1.0

Static analysis and health report generator for dbt projects

dbt-tester

dbt-tester is a lightweight static analysis tool that inspects dbt projects without running dbt itself. It scans your models, schema YAML files, and compiled manifest metadata to catch missing documentation, test coverage gaps, naming inconsistencies, and lineage issues. The CLI outputs results in the terminal or exports shareable HTML/JSON reports, making it easy to embed into CI pipelines.

Features

• Discovers all models, sources, and tests in a dbt project directory
• Plug-in style check engine grouped by models, tests, docs, lineage, and sources
• Console, HTML, and JSON reporters with severity levels
• Configurable failure threshold for CI/CD
• Simple to extend with custom checks

Quick start

python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
dbt-tester run path/to/dbt_project --format console

• Quotes are required when the project path contains spaces: dbt-tester run "/home/me/dbt project" --format console.
• Use --format html --output report.html to produce a shareable artifact (.html), or --format json --output findings.json for automation payloads.
• Control CI failure behavior with --fail-on error|warning; defaults to error.

Common commands

Purpose	Command
Install for development	pip install -e .[dev]
Run unit tests	pytest
Scan current directory	dbt-tester run . --format console
Export HTML report	dbt-tester run . --format html --output dbt_report.html
Export JSON report	dbt-tester run . --format json --output dbt_report.json
Enforce zero warnings in CI	dbt-tester run . --fail-on warning

Development

python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
pytest

To ship the package:

python -m build
twine upload dist/*

License

MIT