Metadata-Version: 2.3
Name: but-cli
Version: 0.1.0
Summary: A useful cli for Blender
Author: HoppouDev
Author-email: HoppouDev <me@hoppou.dev>
Requires-Dist: bpy>=5.2.2
Requires-Dist: typer>=0.27.2
Requires-Python: >=3.13
Description-Content-Type: text/markdown

<div align="center">

# BUT

A Blender utility built to accelerate workflows.

<br>

[![Built for Blender](https://badges.hoppou.dev/badge?title=Built%20for&label=Blender&color=E87D0D&icon=blender)](https://www.blender.org/)
[![Built with Python](https://badges.hoppou.dev/badge?title=Built%20with&label=Python&color=3776AB&icon=python)](https://www.python.org/)
[![Packaged with UV](https://badges.hoppou.dev/badge?title=Packaged%20with&label=UV&color=DE5FE9&icon=uv)](https://docs.astral.sh/uv/)
[![CI Passing](https://badges.hoppou.dev/ci/Hoppou-Legion-Gateway/but/tests.yml)](https://github.com/Hoppou-Legion-Gateway/but/actions/workflows/tests.yml)

</div>

<br>

## Install

```sh
uv tool install --python 3.13 but-cli   # bpy only ships wheels for Python 3.13
```

## Usage

```sh
# Show help for command
uv run but --help

# Test
uv run pytest

# Build
uv build
```

## Releasing

Bump the version and push to `main`. When `v<version>` doesn't exist yet, the
release workflow publishes to [PyPI](https://pypi.org/project/but-cli/) and
then creates the tag and GitHub release; other pushes skip releasing.

```sh
uv version --bump patch   # or minor / major
git commit -am "chore: release v$(uv version --short)"
git push
```

Release notes are generated by [git-cliff](https://git-cliff.org) from the
[conventional commit](https://www.conventionalcommits.org) messages since the
previous tag (config: `cliff.toml`). Preview them before bumping:

```sh
git cliff --unreleased --tag v0.2.0
```

## License

This project is licensed under the MIT license. Refer to [LICENSE.md](LICENSE.md)
