La herramienta CLI: zerofee-cli

Stripe tiene stripe-cli. Toda plataforma de pagos que se toma en serio la experiencia del desarrollador ofrece una interfaz de línea de comandos. Para 0fee.dev, construimos zerofee-cli -- una herramienta de terminal basada en Python que permite a los desarrolladores autenticarse, crear pagos, reenviar webhooks a localhost, transmitir logs de eventos y gestionar configuración sin abrir un navegador.

Stack tecnológico

Elegimos cuatro bibliotecas Python: Typer para el framework CLI, Rich para salida de terminal bonita, httpx para HTTP async, y websockets para streaming de eventos en tiempo real.

Estructura del proyecto

Cuatro archivos: config.py (gestión de configuración en ~/.zerofee/), api.py (cliente HTTP con auth y manejo de errores), main.py (todos los comandos) y __init__.py. La simplicidad es intencional.

Comandos

• login/logout/status -- autenticación con validación inmediata de clave
• payments create/list/get/cancel -- operaciones de pago con tablas Rich
• listen -- reenvío de webhooks con WebSocket primario y polling como respaldo
• logs tail -- streaming de logs de eventos en tiempo real
• trigger -- disparo de eventos webhook de prueba
• config show/set -- gestión de configuración

Reenvío de webhooks: listen

El comando listen es la funcionalidad más interesante técnicamente. Conecta la máquina local del desarrollador al flujo de eventos de 0fee.dev, reenviando cada evento webhook a una URL local. El enfoque de doble estrategia -- WebSocket primario, polling como respaldo -- asegura que el CLI funcione en todo entorno de red, incluyendo firewalls corporativos y conexiones inestables en África.

Lecciones aprendidas

Typer elimina el código repetitivo. WebSocket con polling como respaldo es el patrón correcto. Las tablas Rich superan a los volcados JSON. Cuatro archivos es suficiente -- sin sistema de plugins, sin cadena de middleware, sin clases abstractas base.

Este artículo es parte de la serie "Cómo construimos 0fee.dev". 0fee.dev es un orquestador de pagos que cubre más de 53 proveedores en más de 200 países, construido por Juste Thales Gnimavo y Claude desde Abiyán sin ingenieros humanos. Sigue la serie para conocer la historia completa de la construcción.