Metadata-Version: 2.4
Name: oaknut-cli
Version: 12.14.0
Summary: Shared CLI toolkit for the oaknut family: the contributed-command axis and report-rendering helpers a disc command needs, below the filesystem packages.
Author-email: Robert Smallshire <robert@smallshire.org.uk>
License-Expression: MIT
Project-URL: Homepage, https://github.com/rob-smallshire/oaknut/tree/master/packages/oaknut-cli
Project-URL: Repository, https://github.com/rob-smallshire/oaknut
Project-URL: Issues, https://github.com/rob-smallshire/oaknut/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Filesystems
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: oaknut-exception>=10.0
Requires-Dist: oaknut-extension>=10.0
Requires-Dist: oaknut-file>=10.0
Requires-Dist: click>=8.1.7
Requires-Dist: asyoulikeit>=1.5.1
Dynamic: license-file

# oaknut-cli

[![PyPI version](https://img.shields.io/pypi/v/oaknut-cli)](https://pypi.org/project/oaknut-cli/)
[![CI](https://github.com/rob-smallshire/oaknut/actions/workflows/ci.yml/badge.svg)](https://github.com/rob-smallshire/oaknut/actions/workflows/ci.yml)
[![Python versions](https://img.shields.io/pypi/pyversions/oaknut-cli)](https://pypi.org/project/oaknut-cli/)
[![License: MIT](https://img.shields.io/pypi/l/oaknut-cli)](https://github.com/rob-smallshire/oaknut/blob/master/packages/oaknut-cli/LICENSE)

Shared CLI toolkit for the [oaknut](https://github.com/rob-smallshire/oaknut)
family. It sits *below* the filesystem packages so that both the `disc`
CLI (`oaknut-disc`) and a filesystem's own contributed commands can
depend on it without a dependency cycle.

It provides the **contributed-command axis** — discovery of Click
commands a filesystem package registers on the `oaknut.command`
entry-point namespace — and report-rendering helpers shared between the
generic `disc` commands and the contributed ones.

See `docs/dev/contributed-commands.md` for the design.

Part of the [oaknut](https://github.com/rob-smallshire/oaknut) monorepo.

## Installation

```sh
uv add oaknut-cli    # or: pip install oaknut-cli
```

## License

MIT — see [LICENSE](LICENSE).
