Metadata-Version: 2.5
Name: brickster
Version: 0.1.2
Summary: Install brickster.io Databricks labs into your workspace
Project-URL: Homepage, https://brickster.io
Project-URL: Source, https://github.com/pwnera/brickster
Author: Amine Kaabachi
License-Expression: MIT
Keywords: databricks,delta,labs,notebooks,spark
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Education
Requires-Python: >=3.8
Provides-Extra: sdk
Requires-Dist: databricks-sdk>=0.20; extra == 'sdk'
Description-Content-Type: text/markdown

# brickster

Pulls a [brickster.io](https://brickster.io) lab's starter notebook into your Databricks workspace.

```python
%pip install brickster
dbutils.library.restartPython()

import brickster
brickster.list_labs()
brickster.install("retail-orders")
```

The notebook and the lab's data files land in `/Users/<you>/brickster/<slug>/`, and the call
renders a card with the paths and a link to open the notebook. Pass `path=` for somewhere else,
`overwrite=True` to replace what's there.

Off a cluster the same thing downloads into a local directory:

```bash
pip install brickster
brickster list
brickster install retail-orders --path ~/labs
```

Data comes along by default. `data=False` leaves it on the web instead, as a URL the starter can
read over HTTP, and on a cluster `data="/Volumes/main/default/brickster"` stages it in a Volume,
which is the path Spark wants:

```python
brickster.install("retail-orders", data="/Volumes/main/default/brickster")
```

The CLI spells the first one `--no-data`. `BRICKSTER_URL` points the package at another instance.

## Tests

```bash
python test_brickster.py
```
