dbt-subdocs

🤔 Description

This project is useful if you want to generate a dbt-docs site for a subset of the models in your DBT project. By default, in dbt-docs, all your projects gets documented :

• all the models
• all the sources
• all the tests
• and all the macros

This CLI is useful if you only want to document what your end-user will be using.

This CLI simply edits the manifest.json and catalog.json used by the dbt-docs site so they do not contain nodes you don't want to display.

✨ Features

• Configure an input and output directory
• Select the models to document using tag within DBT
• Choose to exclude nodes that are useless for your users : tests, macros, seed etc...

🏃 Getting Started

pip install -U dbt-subdocs

dbt-subdocs --help

cd DIRECTORY
dbt-subdocs --tag finance

dbt-subdocs --tag finance --tag engineering

dbt-subdocs --tag finance --exclude-node-type macros

dbt-subdocs --tag finance --exclude-node-type macros --exclude-node-type sources

🛡️ License

This project is licensed under the terms of the MIT license. See LICENSE for more details.

📃 Citation

@misc{dbt-subdocs,
  author = {jb-delafosse},
  title = {dbt-subdocs is a python CLI you can used to generate a dbt-docs for a subset of your dbt project},
  year = {2022},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{https://github.com/jb-delafosse/dbt-subdocs}}
}

Credits

This project was generated with python-package-template