philiprehberger-cli-builder

Decorator-based CLI framework with rich output.

Installation

pip install philiprehberger-cli-builder

Usage

from philiprehberger_cli_builder import CLI, arg, option

cli = CLI(name="myapp", version="1.0.0")

@cli.command()
@arg("name", help="Your name")
@option("--greeting", "-g", default="Hello", help="Greeting to use")
def greet(name: str, greeting: str):
    """Greet someone by name."""
    cli.success(f"{greeting}, {name}!")

@cli.command()
@option("--format", "-f", default="table", choices=["json", "table"])
def status(format: str):
    """Show system status."""
    data = [{"service": "api", "status": "up"}, {"service": "db", "status": "up"}]
    if format == "json":
        cli.json(data)
    else:
        cli.table(data, headers=["Service", "Status"])

cli.run()

Output Helpers

cli.success("Done!")       # ✓ Done!
cli.error("Failed")       # ✗ Failed
cli.warn("Careful")       # ! Careful
cli.info("Note")          # ℹ Note
cli.json(data)            # Pretty-printed JSON
cli.table(data, headers)  # Rich table
cli.progress(items)       # Progress bar

Command Aliases

@cli.command(name="list", aliases=["ls", "l"])
def list_things():
    """List all things."""
    ...

# All three invocations call list_things:
# myapp list
# myapp ls
# myapp l

Introspecting registered commands

cli = CLI(name="myapp")

@cli.command()
def foo():
    ...

@cli.command(aliases=["b"])
def bar():
    ...

cli.list_commands()       # ["bar", "foo"] — sorted primary names, aliases excluded
cli.has_command("foo")    # True
cli.has_command("b")      # True — alias match
cli.has_command("missing")  # False

Decorators

API

Development

pip install -e .
python -m pytest tests/ -v

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT