83/ 100 · B
Popular and well-maintained. A little polish away from elite status.
dbt enables data analysts and engineers to transform their data using the same practices that software engineers use to build applications.
Rust12,991 starsApache-2.0updated 2d ago
DocumentationREADME, setup, examples, license
EngineeringTests, CI, linting, lockfiles
Project healthDescription, activity, stars, deps
What to fix first
The highest-impact improvements for this repo.
- 1CI/CDEngineeringInfo
Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.
- 2CI/CDEngineeringInfo
Upload coverage to Codecov, Coveralls, or report it with `--coverage` flags.
- 3READMEDocumentationInfo
Show a quick-start snippet so contributors can see what using your project looks like.
Detailed breakdown
Documentation
85- README75
- README is present.
- README is well structured with multiple sections.
- README includes screenshots or visuals. Great for first impressions.
- README has no code examples (−15 pts).Show a quick-start snippet so contributors can see what using your project looks like.
- README links to a live demo or deployed app.
- No status badges in the README (−10 pts).Add CI/build status badges from shields.io or your CI provider to signal project health.
- Install and run instructions90
- README documents how to install the project.
- README documents how to run the project.
- If your project uses environment variables, add a .env.example listing them (+10 pts).Add a .env.example listing all required environment variables so contributors know what to set up.
- License100
- Licensed under Apache-2.0.
- Contributing guide82
- Contributing guide is detailed and thorough.
- Contributing guide includes setup/install instructions.
- Contributing guide lacks a code style section (−8 pts).Describe your linting/formatting rules and how to run them (e.g. npm run lint, ruff check .).
- Contributing guide lacks a testing section (−8 pts).Show contributors how to run the test suite (e.g. npm test, pytest, cargo test).
- Contributing guide describes the PR/review workflow.
- Contributing guide includes code examples.
- Optional: add a Code of Conduct (+5 pts).A CODE_OF_CONDUCT.md signals that your project is welcoming. GitHub has a template you can add in one click.
Engineering
76- Tests60
- Test files detected (crates/dbt-adapter/tests).
- CI/CD100
Not applicable?
- CI is configured (.github/workflows/test-repeater.yml).
- CI workflow runs tests.
- CI runs on pull requests, not just on pushes to main.
- CI workflow runs a lint or format check.
- Optional: add type checking to CI.Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.
- Optional: report test coverage in CI.Upload coverage to Codecov, Coveralls, or report it with `--coverage` flags.
- CI tests across multiple environments or versions.
- Linting and formatting40
- No linter or type checker configured in pyproject.toml (−80 pts).Add [tool.ruff] for linting and [tool.mypy] for type checking to pyproject.toml.
- Rust projects have clippy available. Run `cargo clippy` for linting.
- CI does not appear to run `cargo clippy` (−40 pts vs enforcing it in CI).Add `cargo clippy -- -D warnings` and `cargo fmt --check` as CI steps.
- No rustfmt.toml found.Add a rustfmt.toml to enforce a consistent code style across contributors.
- Reproducibility80
- No Cargo.lock committed. Correct for Rust library crates (Rust ecosystem convention).For Rust binaries/applications, commit Cargo.lock. For library-only crates, omitting it is the recommended practice per the Cargo guide.
- Environment pinned via .github/actions/latest-wrangler/Dockerfile.
- Dependabot covers 5 ecosystems (pip, pip, docker, docker, github-actions). Dependencies stay current.
- Issue and PR templates90
- Issue or PR templates present.
- Optional: add a SECURITY.md.A SECURITY.md explains how to responsibly disclose vulnerabilities. Worth adding once the project has real users.
Project health
100- Dependency manifest100
- Dependency manifest found (Cargo.toml).
- pyproject.toml has a [project] table with package metadata.
- pyproject.toml includes a description.
- pyproject.toml specifies requires-python, preventing installs on incompatible versions.
- Repository metadata100
- Repository has a description.
- Primary language detected: Rust.
- pyproject.toml [project] metadata is complete (description, authors, urls).
- Activity100
- Actively maintained (pushed within the last month).
- 12,991 stars.
- Housekeeping100
- .gitignore present.
Repository files17 root entries
- .cargo
- .changes
- .githubGood: Contributing guide is detailed and thorough.Good: Contributing guide includes setup/install instructions.Info: Contributing guide lacks a code style section (−8 pts).Fix: Describe your linting/formatting rules and how to run them (e.g. npm run lint, ruff check .).Info: Contributing guide lacks a testing section (−8 pts).Fix: Show contributors how to run the test suite (e.g. npm test, pytest, cargo test).Good: Contributing guide describes the PR/review workflow.Good: Contributing guide includes code examples.Good: CI is configured (.github/workflows/test-repeater.yml).Good: Environment pinned via .github/actions/latest-wrangler/Dockerfile.Good: Dependabot covers 5 ecosystems (pip, pip, docker, docker, github-actions). Dependencies stay current.Good: Issue or PR templates present.
- assets
- certificates
- cratesGood: Test files detected (crates/dbt-adapter/tests).
- docs
- lib
- .changie.yaml
- .gitignoreGood: .gitignore present.
- Cargo.tomlGood: Dependency manifest found (Cargo.toml).
- CHANGELOG.md
- CONTRIBUTING.md
- LICENSEGood: Licensed under Apache-2.0.
- pyproject.toml
- README.mdGood: README is present.Good: README is well structured with multiple sections.Good: README includes screenshots or visuals. Great for first impressions.Info: README has no code examples (−15 pts).Fix: Show a quick-start snippet so contributors can see what using your project looks like.Good: README links to a live demo or deployed app.Info: No status badges in the README (−10 pts).Fix: Add CI/build status badges from shields.io or your CI provider to signal project health.Good: README documents how to install the project.Good: README documents how to run the project.
- rust-toolchain.toml