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

This version

3.2.2

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.2.2.tar.gz (91.0 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.2.2-py3-none-any.whl (127.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: dbt_bouncer-3.2.2.tar.gz
  • Upload date:
  • Size: 91.0 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.2.2.tar.gz
Algorithm Hash digest
SHA256 7112b1b71897ee828af4c101f0f20bf3ead0d0c22073e52360e575bb504e6a93
MD5 abb57a1c636323837403d4a0bd6dcbf5
BLAKE2b-256 440d706650ae0a935b8c816a84c0fd13b6763d723d677c00baa491579534845b

See more details on using hashes here.

Provenance

The following attestation bundles were made for dbt_bouncer-3.2.2.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.2.2-py3-none-any.whl.

File metadata

  • Download URL: dbt_bouncer-3.2.2-py3-none-any.whl
  • Upload date:
  • Size: 127.8 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.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ca00b5e763d4d6c36aae9d57dae6513fe6327db3e09ab448cd4588b3818fbb2b
MD5 7097f34627a31e338c8700d07035de8a
BLAKE2b-256 a6f8358348835389cf2e55de0c1d526a5106df7665c9f6c1fc23278e42ad4c37

See more details on using hashes here.

Provenance

The following attestation bundles were made for dbt_bouncer-3.2.2-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