Repolode
pallets

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. 1

    Instale o Click com pip

    pip install click
  2. 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