Resumen de aspectos destacados de las herramientas CLI

Cada viñeta destacada de las 9 páginas de esta sección, reunida en una sola página y agrupada por la página de la que proviene.

Diseño de CLI en Go: Binario único, inicio rápido

Go compila a un binario estático sin dependencia en tiempo de ejecución del host
El inicio en frío se mantiene en milisegundos porque no hay calentamiento de VM ni intérprete
La compilación cruzada GOOS y GOARCH envía una única base de código a muchas plataformas
El paquete flag de la biblioteca estándar cubre herramientas simples; cobra y urfave/cli escalan a árboles al estilo de kubectl
Las CLIs comparten módulos y tipos con los servicios que operan

Conceptos básicos de las herramientas CLI

Las flags desconocidas salen con un valor distinto de cero; proporcione valores predeterminados para las flags mediante el registro de flag.String
Analice todas las flags antes de leer flag.Args() para los argumentos posicionales
Valide explícitamente el número de argumentos; flag.Args() devuelve tokens sin analizar
Escriba la ayuda en stderr para mantener stdout canalizable para scripts de shell
Use flag.NewFlagSet por subcomando para evitar colisiones de flags
Salga con un valor distinto de cero para señalar un error a los scripts de shell y los sistemas de CI

Paquete flag y Flags estilo POSIX

flag.FlagSet aísla el análisis por subcomando
Se admiten las formas estilo POSIX -flag=valor y las booleanas -v
Usage y ContinueOnError personalizados controlan la experiencia del operador
Visit y NFlag ayudan a introspeccionar las flags registradas para las pruebas

Árboles de comandos cobra y urfave/cli

cobra potencia kubectl, hugo y muchas CLIs de operadores
PersistentFlags se heredan a los subcomandos hijos sin redeclaración
urfave/cli v2 ofrece una API más plana con soporte de subcomandos similar
La finalización de shell generada reduce la fricción del operador

kingpin y UX avanzada de CLI

kingpin modela la estructura de la CLI como cadenas fluidas de aplicación, comando y argumento
Los enums y las flags tipadas validan antes de que se ejecuten las devoluciones de llamada Run
El repositorio original de kingpin está archivado; prefiera cobra para nuevos proyectos
Los patrones aún enseñan cómo aplicar contratos de CLI de forma temprana

Configuración: Viper, Env y Archivos de Configuración

viper fusiona valores predeterminados, archivos, variables de entorno y flags de CLI en una única cadena de precedencia
AutomaticEnv mapea MYAPP_DB_HOST a db.host con reglas de reemplazo
Los mismos patrones sirven para CLIs y servicios Go de larga ejecución
La documentación explícita de precedencia evita sorpresas al operador

UI de terminal bubbletea y Barras de progreso

bubbletea implementa la arquitectura Elm para interfaces de usuario de terminal
bubbles proporciona barras de progreso, spinners y entradas de texto
lipgloss da estilo a los componentes sin un spaghetti de escape ANSI
Prefiera el progreso stderr simple para CI; las TUI para herramientas interactivas del operador

Salida de color y Errores fáciles de usar

Stdout transporta datos legibles por máquina; stderr transporta diagnósticos humanos
fatih/color y lipgloss añaden estilo ANSI cuando se detecta TTY
errors.Join y fmt.Errorf con %w preservan las cadenas de error para los registros
Los códigos de salida estables permiten a los scripts ramificarse según la clase de error

Mejores prácticas para herramientas CLI

Reserve stdout para la salida legible por máquina; mantenga la prosa y el progreso en stderr
Documente la precedencia como flags > entorno > archivo > valores predeterminados para la previsibilidad
Falle rápidamente en errores de configuración y flags antes de I/O para evitar mutaciones parciales
Use un framework de análisis por binario; nunca mezcle cobra, kingpin, stdlib
Pruebe la función run con argumentos en lugar de argumentos del sistema reales para seguridad en paralelo
Estampe la versión en CI con ldflags para que los informes de errores se mapeen de forma fiable a las compilaciones

Diseño de CLI en Go: Binario único, inicio rápido

Go compila a un binario estático sin dependencia en tiempo de ejecución del host

El inicio en frío se mantiene en milisegundos porque no hay calentamiento de VM ni intérprete

La compilación cruzada GOOS y GOARCH envía una única base de código a muchas plataformas

El paquete flag de la biblioteca estándar cubre herramientas simples; cobra y urfave/cli escalan a árboles al estilo de kubectl

Las CLIs comparten módulos y tipos con los servicios que operan

Conceptos básicos de las herramientas CLI

Las flags desconocidas salen con un valor distinto de cero; proporcione valores predeterminados para las flags mediante el registro de flag.String

Analice todas las flags antes de leer flag.Args() para los argumentos posicionales

Valide explícitamente el número de argumentos; flag.Args() devuelve tokens sin analizar

Escriba la ayuda en stderr para mantener stdout canalizable para scripts de shell

Use flag.NewFlagSet por subcomando para evitar colisiones de flags

Salga con un valor distinto de cero para señalar un error a los scripts de shell y los sistemas de CI

kingpin y UX avanzada de CLI

kingpin modela la estructura de la CLI como cadenas fluidas de aplicación, comando y argumento

Los enums y las flags tipadas validan antes de que se ejecuten las devoluciones de llamada Run

El repositorio original de kingpin está archivado; prefiera cobra para nuevos proyectos

Los patrones aún enseñan cómo aplicar contratos de CLI de forma temprana

Configuración: Viper, Env y Archivos de Configuración

viper fusiona valores predeterminados, archivos, variables de entorno y flags de CLI en una única cadena de precedencia

AutomaticEnv mapea MYAPP_DB_HOST a db.host con reglas de reemplazo

Los mismos patrones sirven para CLIs y servicios Go de larga ejecución

La documentación explícita de precedencia evita sorpresas al operador

UI de terminal bubbletea y Barras de progreso

bubbletea implementa la arquitectura Elm para interfaces de usuario de terminal

bubbles proporciona barras de progreso, spinners y entradas de texto

lipgloss da estilo a los componentes sin un spaghetti de escape ANSI

Prefiera el progreso stderr simple para CI; las TUI para herramientas interactivas del operador

Salida de color y Errores fáciles de usar

Stdout transporta datos legibles por máquina; stderr transporta diagnósticos humanos

fatih/color y lipgloss añaden estilo ANSI cuando se detecta TTY

errors.Join y fmt.Errorf con %w preservan las cadenas de error para los registros

Los códigos de salida estables permiten a los scripts ramificarse según la clase de error

Mejores prácticas para herramientas CLI

Reserve stdout para la salida legible por máquina; mantenga la prosa y el progreso en stderr

Documente la precedencia como flags > entorno > archivo > valores predeterminados para la previsibilidad

Falle rápidamente en errores de configuración y flags antes de I/O para evitar mutaciones parciales

Use un framework de análisis por binario; nunca mezcle cobra, kingpin, stdlib

Pruebe la función run con argumentos en lugar de argumentos del sistema reales para seguridad en paralelo

Estampe la versión en CI con ldflags para que los informes de errores se mapeen de forma fiable a las compilaciones

Resumen de aspectos destacados de las herramientas CLI

Buscar en la documentación

Resumen de aspectos destacados de las herramientas CLI