Why should I use explicit parameters instead of environment variables?

Explicit parameters in command functions improve type safety, make dependencies discoverable via IDEs, and allow for easier unit testing without mocking the global environment.

What is the Command Dispatcher pattern for CLIs?

It is a design pattern where a single entry point (like __main__.py) parses arguments and routes execution to specific, isolated command functions based on the user's input.

Does this skill work with existing Python CLI frameworks?

Yes, while the skill uses argparse for its examples, the architectural principles and folder structures are compatible with Click, Typer, and other popular libraries.

How does this help with error handling?

It establishes a pattern where the command layer orchestrates business logic, catches exceptions, provides user-friendly output, and returns standardized exit codes.

CLI Architecture Pattern

Name: CLI Architecture Pattern
Author: gestrich

bygestrich

0•

Herramientas para Desarrolladores

Implements a structured command dispatcher pattern for scalable, maintainable Python CLI applications.

This skill provides a comprehensive framework for architecting Python-based command-line interfaces using the command dispatcher pattern. It guides the creation of a clean separation between entry points, argument parsing, and command execution, ensuring that commands use explicit parameters rather than environment variables for better testability and type safety. It is ideal for developers refactoring monolithic CLI scripts or building complex, multi-command tools that require a professional, modular structure.

Características Principales

01Centralized argument parsing and command routing

02Modular CLI directory structure organization

03Standardized command dispatcher pattern implementation

040 GitHub stars

05Best practices for error handling and exit codes

06Explicit parameter passing for improved testability

Casos de Uso

01Building a multi-command CLI tool from scratch

02Decoupling environment variables from core command logic

03Refactoring a monolithic script into a modular CLI structure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gestrich/python-architecture cli-architecture

For use in Claude.ai and ChatGPT

Características Principales

01Centralized argument parsing and command routing

02Modular CLI directory structure organization

03Standardized command dispatcher pattern implementation

040 GitHub stars

05Best practices for error handling and exit codes

06Explicit parameter passing for improved testability

Casos de Uso

01Building a multi-command CLI tool from scratch

02Decoupling environment variables from core command logic

03Refactoring a monolithic script into a modular CLI structure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gestrich/python-architecture cli-architecture

For use in Claude.ai and ChatGPT