Repolode
Enviar
chriskiehl

chriskiehl/Gooey

Biblioteca de Python que convierte un programa de línea de comandos basado en argparse en una GUI de escritorio con un solo decorador.

Ver en GitHub
Estrellas
21,897
Forks
1,046
Issues abiertos
172
Último commit
anteayer

¿Qué es?

Gooey envuelve un programa de consola de Python que usa argparse y genera una interfaz gráfica a partir de las declaraciones de sus argumentos. Basta con añadir el decorador @Gooey a la función que crea el parser para obtener una ventana con campos de entrada, casillas de verificación, menús desplegables y otros controles, mientras el script sigue ejecutándose como antes.

De forma predeterminada, Gooey asigna a cada acción de argparse un widget adecuado. Si usas GooeyParser en lugar de ArgumentParser, puedes elegir los widgets explícitamente, como selectores de archivos y directorios, selectores de fecha y hora, deslizadores, campos de contraseña y listas. Los argumentos del decorador permiten configurar el diseño, el tamaño de la ventana, una pantalla de configuración (básica o avanzada), menús y barras de progreso basadas en expresiones regulares que se aplican a la salida del programa.

Gooey es compatible con Python 3 y el README indica que quienes usan Python 2 deben fijar una versión anterior. Incluye traducciones a muchos idiomas y puede empaquetarse como ejecutable con PyInstaller.

Funciones clave

  • 01Añade una GUI a un programa con argparse mediante un único decorador @Gooey.
  • 02Asigna automáticamente widgets a las acciones de argparse y permite elegirlos explícitamente con GooeyParser.
  • 03Ofrece widgets para archivos, directorios, fechas, horas, colores y controles deslizantes.
  • 04Muestra barras de progreso basadas en coincidencias de regex en la salida del programa, con la opción de indicar el tiempo restante.
  • 05Ofrece una barra de menús con diálogos de información, mensajes, enlaces y HTML.
  • 06Admite la internacionalización mediante archivos de idioma JSON.

Casos de uso

  • Ofrecer a colegas sin conocimientos de programación una interfaz de apuntar y hacer clic para un script interno de Python.
  • Envolver una utilidad de procesamiento de datos o conversión de archivos para que los usuarios puedan seleccionar visualmente las entradas.
  • Empaquetar una herramienta CLI de Python como ejecutable independiente para Windows o escritorio, con una interfaz de formulario.

Inicio rápido

  1. 1

    Instala Gooey desde PyPI con pip

    pip install Gooey
  2. 2

    Aplica el decorador @Gooey a la función principal de argparse

Antes de usarlo

  • Python 2 ya no es compatible; quienes lo usen deben fijar una versión anterior e instalar wxPython manualmente.
  • Gooey depende de wxPython, que no se puede instalar como parte de la instalación con pip en Python 2.

En colecciones

Herramientas de CLI y terminalAplicaciones GUI de escritorio y frameworks

Temas

#python#gui#argparse#cli#desktop-app#wxpython

Preguntas frecuentes

¿Qué es Gooey?
Biblioteca de Python que convierte un programa de línea de comandos basado en argparse en una GUI de escritorio con un solo decorador. Gooey envuelve un programa de consola de Python que usa argparse y genera una interfaz gráfica a partir de las declaraciones de sus argumentos. Basta con añadir el decorador @Gooey a la función que crea el parser para obtener una ventana con campos de entrada, casillas de verificación, menús desplegables y otros controles, mientras el script sigue ejecutándose como antes.
¿Gooey es gratuito? ¿Qué licencia tiene?
Gooey es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Gooey sigue mantenido?
Mantenimiento activo. El último commit de Gooey fue el 5 nov 2026.
¿Para qué puedo usar Gooey?
Ofrecer a colegas sin conocimientos de programación una interfaz de apuntar y hacer clic para un script interno de Python. Envolver una utilidad de procesamiento de datos o conversión de archivos para que los usuarios puedan seleccionar visualmente las entradas. Empaquetar una herramienta CLI de Python como ejecutable independiente para Windows o escritorio, con una interfaz de formulario.
¿Cómo se instala Gooey?
Instala Gooey desde PyPI con pip: pip install Gooey Aplica el decorador @Gooey a la función principal de argparse
¿Dónde consigo Gooey?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/chriskiehl/Gooey

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados