Help Rendering

Milo providesHelpRenderer, a drop-in argparse.HelpFormattersubclass that renders help output through Kida templates for styled terminal output.

CLIrenders root and group help from registration metadata, without building every leaf parser or resolving lazy command schemas. Leaf help resolves only the selected command.

Usage

import argparse
from milo import HelpRenderer

parser = argparse.ArgumentParser(
    prog="myapp",
    description="My CLI tool",
    formatter_class=HelpRenderer,
)
parser.add_argument("--verbose", help="Enable verbose output")
parser.add_argument("command", help="Command to run")
parser.parse_args()

When the user runs myapp --help, the output is rendered through the help.kidaKida template instead of argparse's default plain-text formatter.

Customization

Override the built-inhelp.kidatemplate by placing your own in your template directory. The template receives the full argparse structure as context.

Custom CLI renderers can read Milo's root options without copying built-in flag definitions:

from milo import CLI, RootOptionSpec

cli = CLI(name="myapp", version="1.0.0")
cli.global_option("profile", short="-p", default="dev")

for spec in cli.root_option_specs():
    assert isinstance(spec, RootOptionSpec)
    print(", ".join(spec.flags), spec.metavar, spec.description)

Each immutable spec includes flags, dest, description, action, default, option_type, choices, and metavar. Milo's full parser, metadata-only navigation parser, root help, and generated all-command help use the same definitions.

Fallback