Repolode
chriskiehl

chriskiehl/Gooey

Biblioteca Python que transforma um programa de linha de comando baseado em argparse em uma interface gráfica com um único decorator.

Estrelas
21,896
Forks
1,047
Issues abertas
172
Último commit
há 18 horas

O que é?

Gooey envolve um programa Python de console que usa argparse e gera uma interface gráfica a partir das declarações de argumentos. Basta adicionar o decorator @Gooey à função que cria o parser para obter uma janela com campos de entrada, caixas de seleção, menus suspensos e outros controles, enquanto o script continua funcionando como antes.

Por padrão, Gooey associa cada ação do argparse a um widget adequado. Usar GooeyParser no lugar de ArgumentParser permite escolher os widgets explicitamente, como seletores de arquivos e diretórios, seletores de data e hora, controles deslizantes, campos de senha e caixas de listagem. É possível configurar o layout, o tamanho da janela, uma tela de configuração (básica ou avançada), menus e barras de progresso acionadas por expressões regulares na saída do programa usando os argumentos do decorator.

Gooey é compatível com Python 3, e o README observa que usuários do Python 2 precisam fixar uma versão mais antiga. O projeto inclui traduções para vários idiomas e pode ser empacotado como executável com PyInstaller.

Recursos principais

  • 01Adiciona uma interface gráfica a um programa argparse com um único decorator @Gooey.
  • 02Associa automaticamente ações do argparse a widgets, com GooeyParser para escolher widgets explicitamente.
  • 03Oferece widgets para arquivos, diretórios, datas, horários, cores e controles deslizantes.
  • 04Exibe barras de progresso acionadas por correspondências de regex na saída do programa, com opção de mostrar o tempo restante.
  • 05Oferece uma barra de menus com diálogos de informações, mensagens, links e HTML.
  • 06Dá suporte à internacionalização por meio de arquivos de idioma JSON.

Casos de uso

  • Criar uma interface visual com cliques para que colegas sem conhecimentos de programação usem um script Python interno.
  • Envolver um utilitário de processamento de dados ou conversão de arquivos para que os usuários possam selecionar entradas visualmente.
  • Empacotar uma ferramenta Python de linha de comando como um executável independente para Windows ou desktop, com uma interface baseada em formulário.

Início rápido

  1. 1

    Instale o Gooey do PyPI usando pip

    pip install Gooey
  2. 2

    Aplique o decorador @Gooey à função principal do argparse

Antes de usar

  • Python 2 não é mais compatível; quem usa Python 2 precisa fixar uma versão anterior e instalar o wxPython manualmente.
  • O Gooey depende do wxPython, que não pode ser instalado como parte da instalação via pip no Python 2.

Em coleções

Tópicos

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

Perguntas frequentes

O que é Gooey?
Biblioteca Python que transforma um programa de linha de comando baseado em argparse em uma interface gráfica com um único decorator. Gooey envolve um programa Python de console que usa argparse e gera uma interface gráfica a partir das declarações de argumentos. Basta adicionar o decorator @Gooey à função que cria o parser para obter uma janela com campos de entrada, caixas de seleção, menus suspensos e outros controles, enquanto o script continua funcionando como antes.
Gooey é gratuito? Qual é a licença?
Gooey é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Gooey ainda é mantido?
Manutenção ativa. O último commit de Gooey foi em 7 de nov. de 2026.
Para que posso usar Gooey?
Criar uma interface visual com cliques para que colegas sem conhecimentos de programação usem um script Python interno. Envolver um utilitário de processamento de dados ou conversão de arquivos para que os usuários possam selecionar entradas visualmente. Empacotar uma ferramenta Python de linha de comando como um executável independente para Windows ou desktop, com uma interface baseada em formulário.
Como instalar Gooey?
Instale o Gooey do PyPI usando pip: pip install Gooey Aplique o decorador @Gooey à função principal do argparse
Onde consigo Gooey?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/chriskiehl/Gooey

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados

Uma biblioteca Python que simplifica a criação de janelas GUI com tkinter, Qt, wxPython e Remi por meio de uma API compacta e acessível para iniciantes.

13,8 mil1,8 milPythonLGPL-3.0Bem mantidoAtualizado há 5 dias