A collection of utilities and tools for teams and organizations using dbt.
This project is in an ALPHA stage. Internal and external APIs might change between minor versions.
Please reach out if you try this at your own organization. Feedback is very appreciated, and we would love to hear if you had any issues setting this up at your own.
- Propagates the documentation of columns that have the same name on downstream models, improving documentation coverage while reducing manual repeated work
More information can be found on the package's README.
- Retrieve artifacts from a dbt Cloud project. Useful for building reports (such as test and documentation coverage)
More information can be found on the package's README.
This project requires Python 3.8+. You can install the latest version of this package from PyPI by running the command below.
$ pip install dbt-toolkitWe are open and would love to have contributions, both in Pull Requests but also in ideas and feedback. Don't hesitate to create an Issue on this repository if you are trying this project in your organization or have anything to share.
Remember to run make lint, make type and make test before committing.
Run make install-dev to install it locally in editable mode. This is necessary for running the tests.
Groups of functionalities are encapsulated together in top-level packages, such as dbt_cloud/ or documentation/.
Each package that exposes CLI commands should contain an actions sub-package.
More information can be found on the tests' README.
There is a GitHub Action that will trigger a release of this package on PyPI based on releases created on GitHub. Steps:
- Loosely follow semantic versioning
- Remember to prefix the tag name with
v - Use the tag name as the release title on GitHub
- Use the auto-generated release notes from GitHub
- Append a link at the end of the release notes to the released version on PyPI
This project is licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0.