Metadata-Version: 2.4
Name: aclip
Version: 0.2.3
Summary: Synchronized alias package for rendo-aclip
Author: Rendo Studio
License-Expression: MIT
Keywords: aclip,alias,rendo,sdk
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: rendo-aclip==0.2.3

# aclip

`aclip` is the official short-name Python package for ACLIP.

It is published in lockstep with `rendo-aclip` and installs the same SDK release.

Use `aclip` if you want the shortest install command.
Use `rendo-aclip` if you want the canonical dependency name in project manifests.

## Install

Short-name install:

```bash
pip install aclip
```

Canonical install:

```bash
pip install rendo-aclip
```

Either way, the import path is:

```python
from aclip import AclipApp
```

## What ACLIP gives you

- natural CLI invocation
- progressive Markdown help
- structured result and error envelopes
- sidecar manifests for distribution metadata
- packaging helpers for shipping binary CLIs

## First Working CLI

```python
from aclip import AclipApp, run_cli


def create_app() -> AclipApp:
    app = AclipApp(
        name="notes",
        version="0.2.3",
        summary="A minimal notes CLI.",
        description="Create and list notes from a small local CLI.",
    )

    app.group(
        "note",
        summary="Manage notes",
        description="Create and inspect notes.",
    ).command(
        "create",
        summary="Create a note",
        examples=["notes note create --title hello --body world"],
        handler=lambda title, body: {"note": {"title": title, "body": body}},
    )

    return app


run_cli("notes_cli.app:create_app")
```

Typical usage:

```bash
notes --help
notes note --help
notes note create --help
notes note create --title hello --body world
```

Installing `aclip` installs `rendo-aclip==0.2.3`.
