Metadata-Version: 2.4
Name: mimi-dbx-runner
Version: 0.2.0
Summary: CLI tool to run Databricks notebooks from local git repos
Project-URL: Homepage, https://github.com/mimilabs/mimi-dbx-runner
Project-URL: Issues, https://github.com/mimilabs/mimi-dbx-runner/issues
Author-email: Yubin Park <yubin.park@mimilabs.ai>
License-File: LICENSE
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Requires-Dist: databricks-sdk>=0.20.0
Requires-Dist: python-dotenv>=1.0.0
Description-Content-Type: text/markdown

# mimi-dbx-runner

CLI tool to run Databricks notebooks from local git repos.

## Install

```bash
pip install -e /path/to/mimi-dbx-runner
```

## Setup

Create a `.env` in your project directory (see `.env.example`):

```
DATABRICKS_HOST=https://your-workspace.cloud.databricks.com
DATABRICKS_TOKEN=dapi...
DATABRICKS_CLUSTER_ID=xxxx-xxxxxx-xxxxxxxx
DBX_UPLOAD_PATH=/Users/your.email@company.com/dbx_runner_tmp
```

## Usage

```bash
dbx-run <notebook_path> [options]

Options:
  -p, --param KEY=VALUE    Widget parameter (repeatable)
  --cluster-id ID          Override DATABRICKS_CLUSTER_ID
  --no-cleanup             Keep uploaded notebook in workspace
  --upload-path PATH       Override DBX_UPLOAD_PATH
```

### Examples

```bash
dbx-run my_notebook.py -p client_name=acme
dbx-run analysis.ipynb -p start_date=2024-01-01 --no-cleanup
python -m mimi_dbx_runner notebook.py -p key=value
```
