Optional integrations

The core base-cli install has no Rich or OpenTelemetry dependency. Install only the integration you use:

python -m pip install 'base-cli[rich]'
python -m pip install 'base-cli[telemetry]'

Rich human tables

Pass rich=True when constructing an app and pass the active context's flag to the shared record renderer:

import base_cli

app = base_cli.App(name="catalog", rich=True)

@app.command()
def list_items(ctx: base_cli.Context) -> None:
    base_cli.render_records(
        ({"name": "base", "path": "/work/base"},),
        requested_format="text",
        columns=(("NAME", "name"), ("PATH", "path")),
        rich=ctx.rich,
    )

Rich is used only for interactive human text. Redirected text remains TSV, and CSV, TSV, JSON, and YAML contracts do not change. If Rich is missing or its renderer fails, the deterministic built-in table is used automatically.

OpenTelemetry lifecycle spans

Telemetry is opt-in and can use the application's configured global provider or an explicitly supplied tracer:

import base_cli

app = base_cli.App(
    name="catalog",
    telemetry=base_cli.TelemetryOptions(),
)

Each invocation emits a base_cli.run span with a start event and a finish event. Safe attributes include the run ID, CLI name, environment, dry-run flag, outcome, exit code, and duration. Raw argv, configuration values, filesystem paths, and secrets are never attached. A missing API package, invalid provider, or failing exporter is logged at debug level and treated as a no-op; it cannot change the command's exit status or cleanup behavior.