Biblioteca Python para criar aplicações CLI a partir de type hints padrão, com ajuda, validação e conclusão de comandos no shell automáticas.
pallets/click
Toolkit Python para criar interfaces de linha de comando compostas, com comandos aninhados, páginas de ajuda automáticas e subcomandos carregados sob demanda.
- Estrelas
- 17,817
- Forks
- 3,296
- Issues abertas
- 89
- Último commit
- há 18 horas
O que é?
Click é um pacote Python para criar ferramentas de linha de comando. Os desenvolvedores declaram comandos, opções e argumentos com decorators, e o Click cuida do parsing, da validação, das solicitações de entrada e do texto de ajuda. Os comandos podem ser aninhados em qualquer nível, e os subcomandos podem ser carregados sob demanda durante a execução.
A biblioteca é configurável, mas já vem com padrões que funcionam sem ajustes. Um programa básico precisa apenas de uma função decorada e de uma chamada ao objeto de comando, e o tratamento de opções inclui recursos como valores padrão, solicitações interativas e geração automática da saída de ajuda.
O Click é desenvolvido pela organização Pallets e distribuído sob a licença BSD-3-Clause. É voltado a desenvolvedores Python que querem criar CLIs sem escrever o parsing de argumentos manualmente.
Recursos principais
- 01Definição de comandos, opções e argumentos baseada em decorators
- 02Aninhamento de comandos e subcomandos em qualquer nível
- 03Geração automática de páginas de ajuda
- 04Carregamento sob demanda de subcomandos durante a execução
- 05Solicitações interativas para valores de opções ausentes
Casos de uso
- Criar uma ferramenta Python de linha de comando com vários subcomandos
- Criar scripts que solicitam dados aos usuários quando faltam argumentos
- Substituir código argparse escrito manualmente por um estilo mais conciso baseado em decorators
Início rápido
- 1
Instale o Click com pip
pip install click - 2
Salve o exemplo como hello.py e execute-o
python hello.py --count=3
Em coleções
Tópicos
Perguntas frequentes
- O que é click?
- Toolkit Python para criar interfaces de linha de comando compostas, com comandos aninhados, páginas de ajuda automáticas e subcomandos carregados sob demanda. Click é um pacote Python para criar ferramentas de linha de comando. Os desenvolvedores declaram comandos, opções e argumentos com decorators, e o Click cuida do parsing, da validação, das solicitações de entrada e do texto de ajuda. Os comandos podem ser aninhados em qualquer nível, e os subcomandos podem ser carregados sob demanda durante a execução.
- click é gratuito? Qual é a licença?
- click é open source sob a licença BSD-3-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
- click ainda é mantido?
- Manutenção ativa. O último commit de click foi em 6 de nov. de 2026.
- Para que posso usar click?
- Criar uma ferramenta Python de linha de comando com vários subcomandos Criar scripts que solicitam dados aos usuários quando faltam argumentos Substituir código argparse escrito manualmente por um estilo mais conciso baseado em decorators
- Como instalar click?
- Instale o Click com pip: pip install click Salve o exemplo como hello.py e execute-o: python hello.py --count=3
- Onde consigo click?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/pallets/click
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Pacote declarativo em Go para criar ferramentas de linha de comando, com subcomandos, flags, conclusão no shell e geração de ajuda.
Uma biblioteca Rust completa para criar parsers de argumentos de linha de comando, de forma declarativa ou procedural.
Framework Java para criar aplicativos de linha de comando com annotations ou uma API programática, com suporte a subcomandos, cores ANSI e autocompletar no shell.
Biblioteca Swift com segurança de tipos para declarar e interpretar argumentos, opções e flags de linha de comando, com ajuda gerada automaticamente.
Ferramenta de linha de comando para ver lado a lado o status de vários repositórios Git e executar comandos Git ou shell em todos eles.