rendo-aclip 0.1.0

Python reference SDK for the Agent Command Line Interface Protocol

rendo-aclip

rendo-aclip is the Python reference adapter for ACLIP.

It does not define the ACLIP protocol.

It implements the shared protocol contracts maintained at the repository root and provides Python authoring, runtime, and packaging helpers for ACLIP-compatible CLIs.

What it provides

• AclipApp tree-shaped authoring
• CommandSpec, CommandGroupSpec, and ArgumentSpec
• canonical ACLIP Markdown help rendering
• structured result and error envelopes
• binary packaging through package_binary()
• packaging CLI through aclip-package

Install

pip install rendo-aclip

Short-name compatibility alias:

pip install aclip

aclip is published as a synchronized alias package and should always resolve to the same SDK release as rendo-aclip.

Quick Start

from aclip import AclipApp, ArgumentSpec

app = AclipApp(
    name="demo",
    version="0.1.0",
    summary="Demo CLI",
    description="Demo CLI.",
)

app.command_groups.append(...)

The recommended higher-level authoring path is to use AclipApp.group() and @group.command() from your own module entrypoint.

Packaging

from pathlib import Path

from aclip import package_binary

artifact = package_binary(
    app=app,
    binary_name="demo",
    entry_script=Path("src/demo_cli/__main__.py"),
    project_root=Path(".").resolve(),
    source_root=Path("src").resolve(),
)

Local Development

python -m venv .venv
.\.venv\Scripts\python -m pip install -e .[dev]
.\.venv\Scripts\python -m pytest tests -q

Release

..\..\..\.venv\Scripts\python.exe .\scripts\publish.py check
..\..\..\.venv\Scripts\python.exe .\scripts\publish.py publish

Required environment:

• PYPI_TOKEN