Metadata-Version: 2.4
Name: vorpal-sdk
Version: 0.3.0
Summary: Python SDK for building Vorpal artifacts.
Project-URL: Homepage, https://github.com/ALT-F4-LLC/vorpal/tree/main/sdk/python
Project-URL: Repository, https://github.com/ALT-F4-LLC/vorpal
Project-URL: Bug Tracker, https://github.com/ALT-F4-LLC/vorpal/issues
License: Apache-2.0
Keywords: sdk,vorpal
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: <3.14,>=3.13
Requires-Dist: grpcio>=1.73.0
Requires-Dist: protobuf<7.0.0,>=6.33.5
Description-Content-Type: text/markdown

# vorpal-sdk

Python SDK for building Vorpal artifacts.

Mirrors [`@altf4llc/vorpal-sdk`](https://www.npmjs.com/package/@altf4llc/vorpal-sdk) (TypeScript) and the Go SDK (`github.com/ALT-F4-LLC/vorpal/sdk/go`) in structure and public surface. Authors use this SDK to define build artifacts in Python via a `Vorpal.py.toml` config.

## Installation

```
pip install vorpal-sdk
```

Or with uv:

```
uv add vorpal-sdk
```

## Usage

```python
# vorpal.py
from vorpal_sdk import ConfigContext, Artifact

# (Phase 5+) Build your artifact graph and hand it to ConfigContext.
```

## Requirements

- Python 3.13 (pinned via `.python-version` + `requires-python`)
- Runtime dependencies: `grpcio`, `protobuf`

## Development

```bash
uv sync --frozen
uv run pytest
```

## License

Apache-2.0 — see [LICENSE](https://github.com/ALT-F4-LLC/vorpal/blob/main/LICENSE).
