/export_dbt_docs_to_md

export dbt docs to markdown file

Primary LanguagePython

How to use

$ python src/export_dbt_docs_to_md/export_dbt_docs_to_md.py --help
usage: export_dbt_docs_to_md.py [-h] [-m MANIFEST_JSON] [-c CATALOG_JSON] [-o OUTPUT_DIR]

options:
  -h, --help            show this help message and exit
  -m MANIFEST_JSON, --manifest_json MANIFEST_JSON
  -c CATALOG_JSON, --catalog_json CATALOG_JSON
  -o OUTPUT_DIR, --output_dir OUTPUT_DIR

$ python src/export_dbt_docs_to_md/export_dbt_docs_to_md.py --manifest_json=tmp_dummy_data/manifest_facebook.json --catalog_json=tmp_dummy_data/catalog_facebook.json --output_dir=output_dir

TODO

  • put explanation for output dir structure in README or/and args help str.
  • write test
  • export_dbt_docs_to_md.py:96: # TODO: Currently, I cannot find a way to extract referenced_by info from manifest.json and catalog.json
  • export_dbt_docs_to_md.py:163: # TODO: deal with other nodes property analysis, exposure, metric and docs.
  • export_dbt_docs_to_md.py:181: # TODO: Refactor. This is too complex to understand what is doing here.
  • format_parsed_data.py:34: # TODO: separate nodes and source function because nodes and source docs are slightly different format.