Metadata-Version: 2.4
Name: dbt-dvt
Version: 0.1.2
Summary: dbt Visualisation Tool — visualize your dbt runs on the timeline.
Project-URL: Homepage, https://github.com/pif/dvt
Project-URL: Issues, https://github.com/pif/dvt/issues
Author: pif
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: dbt,gantt,performance,timeline,visualisation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development
Requires-Python: >=3.9
Requires-Dist: pandas>=1.5
Requires-Dist: plotly>=5.0
Description-Content-Type: text/markdown

# dvt = dbt Visualisation Tool

Visualize the timeline of your [dbt](https://www.getdbt.com/) runs. 

![dvt output screenshot](./dvt-demo.png)

- just run `dvt` after `dbt run/test/build`
- generates an HTML page in `target/` directory with the timeline of your run and opens it immediately
- helps spot run bottlenecks, long-running models, and where to spend most of your time optimising things
- colorize executions by type (models/tests/ops), path (staging/abc, marts/), prefix (stg_, int_, mart_)

## Install

```bash
pip install dbt-dvt
```

## Usage

From inside a dbt project:

```bash
dbt run     # produces target/run_results.json
dvt         # writes & opens target/run_results_timeline.html
```

### Options

```
-i, --input PATH    path to run_results.json (default: target/run_results.json)
-o, --output PATH   where to write the HTML (default: target/run_results_timeline.html)
-m, --manifest      path to dbt's manifest.json (optional; unlocks folder/materialization color modes)
--no-open           don't open the chart in a browser
--static            produce a single self-contained HTML with plotly.js embedded 
--version
```
