Registry / data / dbt-coverage

dbt-coverage

JSON →
library0.4.2pypypi✓ verified 86d ago

One-stop-shop for docs and test coverage of dbt projects. v0.4.1 supports dbt up to 1.9, with commands to measure column documentation, test, and model coverage, and compare coverage reports. Frequent patch releases.

datadevops
pip install dbt-coverage
github ↗package ↗docs ↗
INSTALL
IMPORT
SIG · DBT-COVERAGE
D
dbt-coverage
datapythonv0.4.2
Install
2.8s avg
Import
169ms
Disk
30MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v0.4.2 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.178s · 31.3MB
glibc
py 3.10–3.95 runs
installs and imports cleanly · install 2.8s · import 0.160s · 32MB
30MB installed
● package 30MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

CoverageReport
✓ from dbt_coverage import CoverageReport
✗ from dbt_coverage.report import CoverageReport
CoverageReport is exposed at package level, not in a submodule.
get_coverage_report
✓ from dbt_coverage import CoverageReport
✗ from dbt_coverage import get_coverage_report
No standalone function; instantiate CoverageReport and call .report()

Generate a coverage report from compiled dbt manifest and catalog.

from dbt_coverage import CoverageReport import json # Point to a dbt project with compiled manifest and catalog report = CoverageReport( manifest_json='target/manifest.json', catalog_json='target/catalog.json' ) result = report.report() print(json.dumps(result, indent=2))
dbt-coverage --version
Debug
Known issues
breakingv0.4.0 changed how test hits are counted (feat!(test): count number of hits). Existing workflows expecting the old test counting may see different totals.
fix
Review test coverage numbers after upgrade; adjust thresholds if needed.
affects: >=0.4.0,<0.4.1
gotchamanifest and catalog must be compiled before running CoverageReport. Running from a fresh dbt project without `dbt docs generate` will cause errors.
fix
Run `dbt docs generate` or `dbt compile` and `dbt docs generate` before using dbt-coverage.
affects: all
gotchaWhen using model aliases, the coverage nodes may be incorrectly matched. Fixed in v0.3.3, but still possible with unconventional alias usage.
fix
Upgrade to >=0.3.3.
affects: <0.3.3
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'dbt_coverage'
dbt-coverage not installed in the current Python environment.
fix
pip install dbt-coverage
KeyError: 'nodes'
The manifest JSON file is missing the 'nodes' key, likely an old dbt or incorrect file path.
fix
Ensure you run `dbt docs generate` and point to the correct manifest.json (e.g., target/manifest.json).
Upgrade
Version history
0.4.2latest on PyPI · released Apr 29, 2026
Audit
Dependencies
dbt-corerequiredRequired to parse dbt manifest and catalog
Agent activity
10 hits · last 30 days
node
8
Amazon
1
OpenAI (training)
1
Resources
githubhttps://github.com/slidoapp/dbt-coverage ↗
packagehttps://pypi.org/project/dbt-coverage/ ↗
docshttps://github.com/slidoapp/dbt-coverage ↗
dbt-coverage — pip install dbt-coverage · libregistry