aiskillstore/marketplace / skills/0xdarkmatter/python-cli-patterns
python-cli-patterns
UnverifiedCLI application patterns for Python. Triggers on: cli, command line, typer, click, argparse, terminal, rich, console, terminal ui.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.0 KB |
| assets/cli-template.py | script | 6.4 KB |
| references/configuration.md | markdown | 7.2 KB |
| references/rich-output.md | markdown | 5.9 KB |
| references/typer-patterns.md | markdown | 6.6 KB |
| skill-report.json | config | 54.9 KB |
assets/cli-template.py
View on GitHub"""
CLI Application Template
A production-ready CLI application structure.
Usage:
python cli.py --help
python cli.py greet "World"
python cli.py config init
"""
import sys
from pathlib import Path
from typing import Annotated, Optional
import typer
from rich.console import Console
from rich.table import Table
from rich.panel import Panel
from rich.progress import track
# =============================================================================
# App Setup
# =============================================================================
app = typer.Typer(
name="myapp",
help="My awesome CLI application",
no_args_is_help=True,
add_completion=True,
rich_markup_mode="rich",
)
console = Console()
err_console = Console(stderr=True)
# Sub-applications
config_app = typer.Typer(help="Configuration commands")
app.add_typer(config_app, name="config")
# =============================================================================
# State and Configuration
# =============================================================================
class AppState:
"""Application state shared across commands."""
def __init__(self):
self.verbose: bool = False
self.config_dir: Path = Path.home() / ".config" / "myapp"
self.config_file: Path = self.config_dir / "config.toml"
state = AppState()
@app.callback()
def main(
verbose: bool = typer.Option(False, "--verbose", "-v", help="Verbose output"),
config: Optional[Path] = typer.Option(
None, "--config", "-c", help="Config file path"
),
):
"""
[bold blue]MyApp[/bold blue] - A sample CLI application.
Use [green]--help[/green] on any command for more info.
"""
state.verbose = verbose
if config:
state.config_file = config
# =============================================================================
# Utility Functions
# =============================================================================
def log(message: str, style: str = ""):
"""Log message if verbose mode is enabled."""
if state.verbose:
console.print(f"[dim]{message}[/dim]", style=style)
def error(message: str, code: int = 1) -> None:
"""Print error and exit."""
err_console.print(f"[red]Error:[/red] {message}")
raise typer.Exit(code)
def success(message: str) -> None:
"""Print success message."""
console.print(f"[green]✓[/green] {message}")
# =============================================================================
# Commands
# =============================================================================
@app.command()
def greet(
name: Annotated[str, typer.Argument(help="Name to greet")],
count: Annotated[int, typer.Option("--count", "-n", help="Times to greet")] = 1,
loud: Annotated[bool, typer.Option("--loud", "-l", help="Uppercase")] = False,
):
"""
Say hello to someone.
Example:
myapp greet World
myapp greet World --count 3 --loud
"""
message = f"Hello, {name}!"
if loud:
message = message.upper()
for _ in range(count):
console.print(message)
@app.command()
def process(
files: Annotated[
list[Path],
typer.Argument(
help="Files to process",
exists=True,
readable=True,
),
],
output: Annotated[
Optional[Path],
typer.Option("--output", "-o", help="Output file"),
] = None,
):
"""
Process one or more files.
Example:
myapp process file1.txt file2.txt -o output.txt
"""
log(f"Processing {len(files)} files")
results = []
for file in track(files, description="Processing..."):
log(f"Processing: {file}")
# Simulate processing
results.append(f"Processed: {file.name}")
if output:
output.write_text("\n".join(results))
success(f"Results written to {output}")
else:
for result in results:
console.print(result)
@app.command()
def status():
"""Show application status."""
table = Table(title="Application Status")
table.add_column("Setting", style="cyan")
table.add_column("Value", style="green")
table.add_row("Config Dir", str(state.config_dir))
table.add_row("Config File", str(state.config_file))
table.add_row("Verbose", str(state.verbose))
table.add_row(
"Config Exists",
"✓" if state.config_file.exists() else "✗"
)
console.print(table)
# =============================================================================
# Config Subcommands
# =============================================================================
@config_app.command("init")
def config_init(
force: Annotated[
bool,
typer.Option("--force", "-f", help="Overwrite existing"),
] = False,
):
"""Initialize configuration file."""
if state.config_file.exists() and not force:
if not typer.confirm(f"Config exists at {state.config_file}. Overwrite?"):
raise typer.Abort()
state.config_dir.mkdir(parents=True, exist_ok=True)
default_config = """
# MyApp Configuration
# See documentation for all options
[general]
verbose = false
[server]
host = "localhost"
port = 8080
""".strip()
state.config_file.write_text(default_config)
success(f"Created config: {state.config_file}")
@config_app.command("show")
def config_show():
"""Show current configuration."""
if not state.config_file.exists():
error(f"Config not found: {state.config_file}")
content = state.config_file.read_text()
console.print(Panel(content, title=str(state.config_file), border_style="blue"))
@config_app.command("path")
def config_path():
"""Print config file path."""
typer.echo(state.config_file)
# =============================================================================
# Version
# =============================================================================
def version_callback(value: bool):
if value:
console.print("myapp version [bold]1.0.0[/bold]")
raise typer.Exit()
@app.callback()
def version_option(
version: Annotated[
bool,
typer.Option(
"--version",
callback=version_callback,
is_eager=True,
help="Show version",
),
] = False,
):
pass
# =============================================================================
# Entry Point
# =============================================================================
if __name__ == "__main__":
app()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |