dbt-score

library0.16.0pypypiunverified

A linter for dbt metadata. It evaluates your dbt project against a set of rules (e.g., naming conventions, documentation coverage, test coverage) and produces a score. Currently at version 0.16.0, requires Python >=3.10.

devops testing

pip install dbt-score

package ↗

INSTALL

IMPORT

SIG · DBT-SCORE

dbt-score

devopspythonv0.16.0

Install

1.7s avg

Import

—

Disk

17MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.16.0 · 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

glibc

py 3.10

✓ —

✓ 1.9s

py 3.11

✓ —

✓ 1.7s

py 3.12

✓ —

✓ 1.6s

py 3.13

✓ —

✓ 1.6s

py 3.9

✕ build_error

17MB installed

● package 17MB

Code

Verified usage

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

evaluate

✓ from dbt_score import evaluate

✗ from dbt_score import evaluate

Evaluate the dbt project in the current directory. Requires an active dbt project and a valid profiles.yml.

from dbt_score import evaluate # Run evaluation on a dbt project (assumes dbt_project.yml in current dir) results = evaluate() print(results)

dbt-score --version

Debug

Known issues

breakingdbt-score 0.16.0 removed the `--output-format` CLI flag in favor of `--format`. All scripts using the old flag will break.

fix

Replace `--output-format json` with `--format json`.

affects: >=0.16.0

breakingThe `RulesRegistry` API changed from a class to a module-level factory function in v0.14.

fix

Use `from dbt_score.rules_registry import create_registry` instead of `RulesRegistry()`.

affects: >=0.14.0

deprecatedThe `dbt_score.models` module is deprecated. Rules should now import `dbt_score.models.Model` directly.

fix

Change `from dbt_score.models import Model` to `from dbt_score import Model`.

affects: >=0.15.0

gotchadbt-score only works with dbt Core (not dbt Cloud). Attempting to use it with a Cloud-only dbt project will fail.

fix

Ensure the project is built with dbt Core and a local profiles.yml.

affects: all

Upgrade

Version history

0.16.0latest on PyPI · released Apr 7, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/dbt-score/ ↗