Metadata-Version: 2.1
Name: dbt-docs-publisher
Version: 0.1.0
Summary: A CLI tool for publishing dbt docs to Azure Blob Storage
Home-page: https://github.com/yourusername/dbt-docs-publisher
Author: 
Author-email: 
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: azure-storage-blob>=12.0.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: black>=20.8b1; extra == "dev"
Requires-Dist: flake8>=3.8.0; extra == "dev"
Requires-Dist: twine>=3.4.0; extra == "dev"
Provides-Extra: databricks
Requires-Dist: dbt-databricks>=1.0.0; extra == "databricks"

# dbt-docs-publisher

A CLI tool for publishing dbt documentation to Azure Blob Storage.

## Features

- Automatically runs `dbt docs generate --static`
- Finds generated docs in temp directories
- Uploads all documentation files to Azure Blob Storage
- Organizes files by environment (dev, prod, etc.)
- Provides info on enabling static website hosting in Azure

## Installation

```bash
pip install dbt-docs-publisher
```

For use in Databricks:

```bash
pip install dbt-docs-publisher[databricks]
```

## Usage

```bash
ddp send-report \
  --profile-target=dev \
  --env=dev \
  --azure-container-name=dbt-docs \
  --azure-connection-string="your_azure_connection_string" \
  --update-bucket-website
```

### Arguments

- `--profile-target`: The dbt profile target to use
- `--env`: Environment name (dev, prod, etc.) - used for organizing files in storage
- `--azure-container-name`: Azure Blob Storage container name
- `--azure-connection-string`: Azure Blob Storage connection string
- `--update-bucket-website`: (Optional) Display information about enabling static website hosting

## Using in Databricks

Add to your Databricks job:

```yaml
libraries:
  - pypi:
      package: dbt-docs-publisher[databricks]
commands:
  - ddp send-report --profile-target=${bundle.target} --env=prod --azure-container-name=dbt-docs --azure-connection-string="$dl_conn_str"
```

## Development

### Setup

```bash
git clone https://github.com/yourusername/dbt-docs-publisher.git
cd dbt-docs-publisher
pip install -e ".[dev]"
```

### Building and Publishing

```bash
# Build the package
python setup.py sdist bdist_wheel

# Publish to PyPI
twine upload dist/*
```

## License

MIT 
