# From git (recommended during active dev)
pip install git+https://github.com/wr1/treeparse

# Or with uv (dev workflow)
uv add git+https://github.com/wr1/treeparse

cd treeparse
uv sync
uv run --with-editable . python examples/basic.py

from __future__ import annotations

from treeparse import cli, command, argument, option


def build(src: str, out: str | None = None, verbose: bool = False) -> None:
    """Build something."""
    print(f"Building {src} -> {out or 'default'} (verbose={verbose})")


app = cli(
    name="mycli",
    help="My example CLI.",
    commands=[
        command(
            name="build",
            help="Build the thing.",
            callback=build,
            arguments=[argument(name="src", arg_type=str, help="Source path.")],
            options=[
                option(flags=["--out", "-o"], arg_type=str, help="Output path."),
                option(flags=["--verbose", "-v"], flag=True, help="Verbose output."),
            ],
        ),
    ],
)

if __name__ == "__main__":
    app.run()

python mycli.py build input.txt -o dist/ -v
python mycli.py build --help

from treeparse import cli, group, command, argument

ops = group(name="ops", help="Operations.")
ops.commands.append(
    command(name="status", help="Show status.", callback=..., arguments=[...])
)

app = cli(name="app", help="Main app.")
app.subgroups.append(ops)