Tell us about your new package!data-diving/dbt_diving is a free to use dbt package with helper macros. Currently it includes macro get_refs_recursive() that mimics the behaviour of dbt ls -s CLI selector
This checklist is a cut down version of the best practices that we have identified as the package hub has grown. Although meeting these checklist items is not a prerequisite to being added to the Hub, we have found that packages which don't conform provide a worse user experience.
[X] The package includes a README which explains how to get started with the package and customise its behaviour
[ ] The README indicates which data warehouses/platforms are expected to work with this package
Customisability
[X] The package uses ref or source, instead of hard-coding table references.
Dependencies
Dependencies on dbt Core
[X] The package has set a supported require-dbt-version range in dbt_project.yml. Example: A package which depends on functionality added in dbt Core 1.2 should set its require-dbt-version property to [">=1.2.0", "<2.0.0"].
Dependencies on other packages defined in packages.yml:
[X] Dependencies are imported from the dbt Package Hub when available, as opposed to a git installation.
[X] Dependencies contain the widest possible range of supported versions, to minimise issues in dependency resolution.
[X] In particular, dependencies are not pinned to a patch version unless there is a known incompatibility.
Interoperability
[X] The package does not override dbt Core behaviour in such a way as to impact other dbt resources (models, tests, etc) not provided by the package.
[X] The package uses the cross-database macros built into dbt Core where available, such as {{ dbt.except() }} and {{ dbt.type_string() }}.
[X] The package disambiguates its resource names to avoid clashes with nodes that are likely to already exist in a project. For example, packages should not provide a model simply called users.
Versioning
[X] (Required): The package's git tags validates against the regex defined in version.py
[X] The package's version follows the guidance of Semantic Versioning 2.0.0. (Note in particular the recommendation for production-ready packages to be version 1.0.0 or above)
Description
Tell us about your new package!
data-diving/dbt_diving
is a free to use dbt package with helper macros. Currently it includes macroget_refs_recursive()
that mimics the behaviour ofdbt ls -s
CLI selectorLink to your package's repository: https://github.com/data-diving/dbt_diving
Checklist
This checklist is a cut down version of the best practices that we have identified as the package hub has grown. Although meeting these checklist items is not a prerequisite to being added to the Hub, we have found that packages which don't conform provide a worse user experience.
First run experience
Customisability
Dependencies
Dependencies on dbt Core
require-dbt-version
range indbt_project.yml
. Example: A package which depends on functionality added in dbt Core 1.2 should set itsrequire-dbt-version
property to[">=1.2.0", "<2.0.0"]
.Dependencies on other packages defined in packages.yml:
Interoperability
{{ dbt.except() }}
and{{ dbt.type_string() }}
.users
.Versioning