aclip 0.1.2

Synchronized alias package for rendo-aclip

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:

pip install aclip

Canonical install:

pip install rendo-aclip

Either way, the import path is:

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

from __future__ import annotations

import sys

from aclip import AclipApp


app = AclipApp(
    name="notes",
    version="0.1.2",
    summary="A minimal notes CLI.",
    description="Create and list notes from a small local CLI.",
)

note = app.group(
    "note",
    summary="Manage notes",
    description="Create and inspect notes.",
)


@note.command(
    "create",
    summary="Create a note",
    examples=["notes note create --title hello --body world"],
)
def create(title: str, body: str) -> dict:
    """Create a note.

    Args:
        title: Title for the note.
        body: Body text for the note.
    """
    return {"note": {"title": title, "body": body}}


if __name__ == "__main__":
    raise SystemExit(app.run(sys.argv[1:]))

Typical usage:

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

Installing aclip installs rendo-aclip==0.1.2.