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.
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
Instale o Gooey do PyPI usando pip
pip install Gooey - 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
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
Interface gráfica para converter scripts Python em arquivos .exe independentes, desenvolvida com base no PyInstaller.
Uma caixa de ferramentas para desktop voltada a desenvolvedores, com notas rápidas, formatação de JSON, requisições HTTP, codificação, criptografia, QR codes, cron e muito mais.
Uma biblioteca Python para criar GUIs desktop simples com poucas linhas de código, baseada em Qt.
Um aplicativo desktop com interface gráfica para gerenciar containers, pods, imagens e conexões de engine do Podman, com suporte opcional ao Docker.
Uma IDE nativa, gratuita e de código aberto para Kubernetes, criada com Tauri e Vue, que combina atalhos de teclado com uma interface refinada para vários clusters.