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.2.tar.gz (100.4 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.2-py3-none-any.whl (138.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: dbt_bouncer-3.5.2.tar.gz
  • Upload date:
  • Size: 100.4 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.2.tar.gz
Algorithm Hash digest
SHA256 8fbb9a2edc9a0faaf7866af00bece4cde2d9c8d3b5ab2a13b0ee8c992bba1c14
MD5 fe082b0e4f261c7964caca16f579e584
BLAKE2b-256 150d2931ca3a3632336a411b07c2cc9f44354c94e4c05e51af209dd3b4b7dca7

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: dbt_bouncer-3.5.2-py3-none-any.whl
  • Upload date:
  • Size: 138.0 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c5bb5b3f7492af7bf90775b17aa84b98033ba1f309c76ef71ee650f6ae32aa27
MD5 0d4e7019d20c65769cf018cedb0af726
BLAKE2b-256 820a50d838a0501b6430e96040d75d667153ad9fe16fcbee5509d23481d63186

See more details on using hashes here.

Provenance

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