Cli Craft Pro

I have scaffolded a production-ready Python CLI using Typer and Rich. The architecture ensures that API data is sent to stdout while the spinner and logs are directed to stderr, keeping the tool pipe-friendly.

User Data CLI

# user_cli.py
import sys
import json
import time
from typing import Optional
import typer
from rich.console import Console
from rich.progress import Progress, SpinnerColumn, TextColumn

app = typer.Typer(help="Industrial User Management CLI")
err_console = Console(stderr=True)
out_console = Console()

@app.command()
def search(
    query: str = typer.Argument(..., help="Username or ID to search for"),
    json_output: bool = typer.Option(False, "--json", help="Output results in JSON format"),
    verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable verbose logging")
):
    """Search for users with a live progress indicator."""
    
    with Progress(
        SpinnerColumn(),
        TextColumn("[progress.description]{task.description}"),
        console=err_console,
        transient=True
    ) as progress:
        progress.add_task(description=f"Fetching user: {query}...", total=None)
        # Simulate API Latency
        time.sleep(1.5)
        
        # Mock Data
        user_data = {"id": 101, "username": query, "role": "admin", "status": "active"}

    if json_output:
        # Direct data to stdout only
        print(json.dumps(user_data, indent=2))
    else:
        out_console.print(f"[bold green]✓[/bold green] Found user: [cyan]{user_data['username']}[/cyan] (ID: {user_data['id']})")

if __name__ == "__main__":
    try:
        app()
    except Exception as e:
        err_console.print(f"[bold red]Error:[/bold red] {e}")
        sys.exit(1)

# pyproject.toml
[project]
name = "user-cli"
version = "0.1.0"
dependencies = [
    "typer[all]>=0.9.0",
    "rich>=13.0.0"
]

[project.scripts]
user-tool = "user_cli:app"

Next steps

1. Install dependencies: pip install typer[all] rich
2. Run the tool: python user_cli.py search "jdoe"
3. Test pipe hygiene: python user_cli.py search "jdoe" --json | jq .id