Skip to main content

Configure and enforce conventions for your dbt project.

Project description

dbt-bouncer logo

dbt-bouncer

Configure and enforce conventions for your dbt project.


Documentation

All documentation can be found on dbt-bouncer documentation website.

TLDR

  1. Install dbt-bouncer:

    pip install dbt-bouncer
    
  2. dbt-bouncer requires a manifest.json file. If not already present, run:

    dbt parse
    
  3. Create a dbt-bouncer.yml config file:

    dbt-bouncer init
    
  4. Run dbt-bouncer:

    $ dbt-bouncer run
    Running dbt-bouncer (X.X.X)...
    Loaded config from dbt-bouncer-example.yml...
    Validating conf...
    
                Parsed artifacts for
              'dbt_bouncer_test_project'
    ╭──────────────────┬─────────────────┬───────╮
    │ Artifact         │ Category        │ Count │
    ├──────────────────┼─────────────────┼───────┤
    │ manifest.json    │ Exposures       │     2 │
    │                  │ Macros          │     3 │
    │                  │ Nodes           │    12 │
    │                  │ Seeds           │     3 │
    │                  │ Semantic Models │     1 │
    │                  │ Snapshots       │     2 │
    │                  │ Sources         │     4 │
    │                  │ Tests           │    36 │
    │                  │ Unit Tests      │     3 │
    │ catalog.json     │ Nodes           │    13 │
    │                  │ Sources         │     0 │
    │ run_results.json │ Results         │    51 │
    ╰──────────────────┴─────────────────┴───────╯
    Assembled 463 checks, running...
    Running checks... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100%
    `dbt-bouncer` failed. Please see below for more details or run `dbt-bouncer` with the `-v` flag.
    Failed checks
    ╭────────────────────────────────────┬────────────┬──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
    │ Check name                         │  Severity  │ Failure message                                                                                                          │
    ├────────────────────────────────────┼────────────┼──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤
    │ check_model_names:48:orders        │   ERROR    │ Models in the staging layer should always start with "stg_". - `orders` does not match the supplied regex `^stg_`.       │
    ╰────────────────────────────────────┴────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
    Done. SUCCESS=462 WARN=0 ERROR=1
    

Reporting bugs and contributing code

  • Want to report a bug or request a feature? Let us know and open an issue.
  • Want to help us build dbt-bouncer? Check out the Contributing Guide.

Code of Conduct

Everyone interacting in dbt-bouncer's codebase, issue trackers, chat rooms, and mailing lists is expected to follow the Code of Conduct.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dbt_bouncer-3.5.1.tar.gz (100.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dbt_bouncer-3.5.1-py3-none-any.whl (137.7 kB view details)

Uploaded Python 3

File details

Details for the file dbt_bouncer-3.5.1.tar.gz.

File metadata

  • Download URL: dbt_bouncer-3.5.1.tar.gz
  • Upload date:
  • Size: 100.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dbt_bouncer-3.5.1.tar.gz
Algorithm Hash digest
SHA256 5c278c2e4295c604cb5248aed65f61fe6e20233c3e43617583c68d0f7fda6630
MD5 e2e4d03a9cfd4500c8d108ac2498fa62
BLAKE2b-256 6c55b87c5f2731e4609ae01a2ee46a23ebb4553f31ab1eef91c257862a11a96f

See more details on using hashes here.

Provenance

The following attestation bundles were made for dbt_bouncer-3.5.1.tar.gz:

Publisher: release_pipeline.yml on godatadriven/dbt-bouncer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dbt_bouncer-3.5.1-py3-none-any.whl.

File metadata

  • Download URL: dbt_bouncer-3.5.1-py3-none-any.whl
  • Upload date:
  • Size: 137.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dbt_bouncer-3.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c8a89ba3e4f688e62e3c83b44ab0fba6951b8f36f42436eff4f371b4281d1462
MD5 a25a621e441f9959ee686693084d74cc
BLAKE2b-256 4cd14c7bd9f2b89836633685a69d7a33f8efbb01ee9bc4417732bc4430ed00c7

See more details on using hashes here.

Provenance

The following attestation bundles were made for dbt_bouncer-3.5.1-py3-none-any.whl:

Publisher: release_pipeline.yml on godatadriven/dbt-bouncer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page