Metadata-Version: 2.4
Name: weevr-cli
Version: 2.0.1
Summary: CLI for managing weevr projects — scaffolding, validation, and deployment to Microsoft Fabric.
Keywords: weevr,fabric,onelake,cli,yaml,deployment,data-pipeline
Author: Pierre LaFromboise
Author-email: Pierre LaFromboise <44212292+DataInsightPro@users.noreply.github.com>
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Dist: typer>=0.15.0
Requires-Dist: rich>=13.0.0
Requires-Dist: pyyaml>=6.0,<7.0
Requires-Dist: weevr-core>=1.20.0,<2.0
Requires-Dist: azure-storage-file-datalake>=12.0.0
Requires-Dist: azure-identity>=1.0.0
Requires-Dist: pathspec>=0.12.0
Requires-Dist: packaging>=23.0
Requires-Python: >=3.11, <3.12
Project-URL: Repository, https://github.com/ardent-data/weevr-cli
Project-URL: Issues, https://github.com/ardent-data/weevr-cli/issues
Project-URL: Changelog, https://github.com/ardent-data/weevr-cli/blob/main/CHANGELOG.md
Description-Content-Type: text/markdown

# weevr-cli

[![PyPI version](https://img.shields.io/pypi/v/weevr-cli)](https://pypi.org/project/weevr-cli/)
[![Python](https://img.shields.io/pypi/pyversions/weevr-cli)](https://pypi.org/project/weevr-cli/)
[![License](https://img.shields.io/github/license/ardent-data/weevr-cli)](LICENSE)
[![CI](https://img.shields.io/github/actions/workflow/status/ardent-data/weevr-cli/code-quality.yaml?label=CI)](https://github.com/ardent-data/weevr-cli/actions)

CLI for managing [weevr](https://github.com/ardent-data/weevr) projects — scaffolding, validation, and deployment to Microsoft Fabric.

**[Documentation](https://ardent-data.github.io/weevr-cli/)** · **[Getting Started](https://ardent-data.github.io/weevr-cli/getting-started/)** · **[CLI Reference](https://ardent-data.github.io/weevr-cli/cli/)**

## What it does

The weevr engine runs inside Fabric notebooks; the CLI runs on your workstation and in CI/CD pipelines.

- **`weevr init`** — scaffold a new project
- **`weevr new`** — generate thread, weave, loom, and warp files from templates
- **`weevr validate`** — check files with the weevr engine's own loader and planner
- **`weevr deploy`** — sync files to a Fabric Lakehouse via the OneLake API
- **`weevr status`** — diff local files against deployed state
- **`weevr list`** — view project structure, dependencies, and execution plans
- **`weevr plugins`** — manage CLI plugins

## Installation

```bash
# With uv (recommended)
uv tool install weevr-cli

# With pipx
pipx install weevr-cli

# With pip
pip install weevr-cli
```

## Quick Start

```bash
weevr init my-project --examples
cd my-project.weevr

weevr new thread orders
weevr validate
weevr deploy --target dev
```

See the [Getting Started guide](https://ardent-data.github.io/weevr-cli/getting-started/) for a full walkthrough.

## Configuration

The CLI reads `.weevr/cli.yaml` for deploy targets. See the [Configuration Reference](https://ardent-data.github.io/weevr-cli/configuration/) for details.

## Requirements

- Python 3.11 (matches Fabric Runtime 1.3)
- Azure CLI (`az login`) or equivalent credential for deploy/status commands

## Development

See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development guide.

## License

Apache 2.0 — see [LICENSE](LICENSE) for details.
