Python CLI Development

Subcommands

app = typer.Typer()
config_app = typer.Typer(help="Manage configuration")
app.add_typer(config_app, name="config")

@config_app.command("show")
def config_show() -> None:
    """Show current configuration."""
    config = load_config()
    print_config(config)

@config_app.command("set")
def config_set(key: str, value: str) -> None:
    """Set a configuration value."""
    config = load_config()
    config[key] = value
    save_config(config)

Output Patterns

Colorized Output

from rich.console import Console

console = Console()

def success(message: str) -> None:
    console.print(f"[green]✓[/green] {message}")

def error(message: str) -> None:
    console.print(f"[red]✗[/red] {message}", style="red")

def warn(message: str) -> None:
    console.print(f"[yellow]⚠[/yellow] {message}")

Tables

from rich.table import Table

def list_items(items: list[Item]) -> None:
    table = Table(title="Items")
    table.add_column("ID", style="cyan")
    table.add_column("Name")
    table.add_column("Status", style="green")
    for item in items:
        table.add_row(item.id, item.name, item.status)
    console.print(table)

Progress Bars

from rich.progress import track

def process_files(files: list[Path]) -> None:
    for file in track(files, description="Processing..."):
        process(file)

Configuration

TOML Config Files

from pathlib import Path
import tomllib
import tomli_w

CONFIG_PATH = Path.home() / ".config" / "myapp" / "config.toml"

def load_config() -> dict:
    if not CONFIG_PATH.exists():
        return {}
    return tomllib.loads(CONFIG_PATH.read_text())

def save_config(config: dict) -> None:
    CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
    CONFIG_PATH.write_text(tomli_w.dumps(config))

Environment Variables (Pydantic)

from pydantic_settings import BaseSettings

class Settings(BaseSettings):
    api_key: str
    debug: bool = False
    timeout: int = 30

    class Config:
        env_prefix = "MYAPP_"
        env_file = ".env"

settings = Settings()

Error Handling

@app.command()
def process(file: Path) -> None:
    try:
        result = processor.run(file)
        success(f"Processed {file}")
    except FileNotFoundError:
        error(f"File not found: {file}")
        raise typer.Exit(1)
    except ProcessingError as e:
        error(str(e))
        raise typer.Exit(1)
    except KeyboardInterrupt:
        warn("Aborted")
        raise typer.Exit(130)

Interactive Prompts

from rich.prompt import Prompt, Confirm

api_key = Prompt.ask("API Key", password=True)
env = Prompt.ask("Environment", choices=["dev", "staging", "prod"], default="dev")

if Confirm.ask("Save configuration?"):
    save_config(...)

pyproject.toml Setup

[project]
name = "myapp"
version = "0.1.0"

[project.scripts]
myapp = "myapp.cli:app"

[project.dependencies]
typer = ">=0.9"
rich = ">=13"
tomli-w = ">=1.0"

[project.optional-dependencies]
dev = ["pytest>=8.0", "pytest-cov>=4.1"]

Project Structure

myapp/
├── src/
│   └── myapp/
│       ├── __init__.py      # __version__
│       ├── cli.py           # Typer app
│       ├── config.py        # Configuration handling
│       └── commands/        # Complex command implementations
├── tests/
│   ├── test_cli.py
│   └── test_process.py
└── pyproject.toml

Testing CLIs

from typer.testing import CliRunner
from myapp.cli import app

runner = CliRunner()

def test_version():
    result = runner.invoke(app, ["--version"])
    assert result.exit_code == 0
    assert "myapp" in result.stdout

def test_process_file(tmp_path):
    test_file = tmp_path / "input.txt"
    test_file.write_text("test content")
    result = runner.invoke(app, ["process", str(test_file)])
    assert result.exit_code == 0

Summary