Repolode
Enviar
fastapi

fastapi/typer

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.

Ver no GitHubSite
Estrelas
20,155
Forks
1,007
Issues abertas
49
Último commit
há 6 dias

O que é?

Typer é uma biblioteca Python para criar aplicações de linha de comando. Você declara os parâmetros de uma função usando type hints padrão, e o Typer os transforma em argumentos e opções da CLI, cuidando do parsing, da conversão de tipos e das mensagens de erro.

As aplicações recebem automaticamente a saída de --help e a conclusão de comandos no Bash, Zsh, Fish e PowerShell. Os comandos podem ser organizados em árvores de subcomandos e grupos com qualquer nível de aninhamento. O Typer também inclui o comando typer, que permite executar um script Python existente como CLI sem modificá-lo.

Typer foi criado pelo autor do FastAPI e segue o mesmo estilo baseado em type hints. Ele depende do rich para formatar a saída e do shellingham para detectar o shell, e desde a versão 0.26.0 inclui internamente uma cópia própria do Click.

Recursos principais

  • 01Cria argumentos e opções de CLI a partir de type hints do Python.
  • 02Gera a saída de --help e exibe mensagens de erro formatadas automaticamente.
  • 03Oferece conclusão de comandos no Bash, Zsh, Fish e PowerShell.
  • 04Dá suporte a subcomandos aninhados e grupos de comandos.
  • 05Inclui o comando typer para executar scripts Python comuns como CLIs.

Casos de uso

  • Criar scripts internos para desenvolvedores que precisam de parsing de argumentos e texto de ajuda.
  • Desenvolver uma ferramenta administrativa com vários comandos e subcomandos.
  • Transformar um script Python existente em um utilitário de linha de comando sem reescrevê-lo.

Início rápido

  1. 1

    Instale o uv (consulte o guia de instalação vinculado no README)

  2. 2

    Adicione o Typer ao seu projeto

    uv add typer
  3. 3

    Execute seu script com o executor de CLI integrado do Typer

    typer main.py run Camila

Tópicos

#cli#python#type-hints#terminal#shell-completion#command-line#click#python3#shell#typehints

Perguntas frequentes

O que é typer?
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. Typer é uma biblioteca Python para criar aplicações de linha de comando. Você declara os parâmetros de uma função usando type hints padrão, e o Typer os transforma em argumentos e opções da CLI, cuidando do parsing, da conversão de tipos e das mensagens de erro.
typer é gratuito? Qual é a licença?
typer é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
typer ainda é mantido?
Manutenção ativa. O último commit de typer foi em 15 de out. de 2026.
Para que posso usar typer?
Criar scripts internos para desenvolvedores que precisam de parsing de argumentos e texto de ajuda. Desenvolver uma ferramenta administrativa com vários comandos e subcomandos. Transformar um script Python existente em um utilitário de linha de comando sem reescrevê-lo.
Como instalar typer?
Instale o uv (consulte o guia de instalação vinculado no README) Adicione o Typer ao seu projeto: uv add typer Execute seu script com o executor de CLI integrado do Typer: typer main.py run Camila
Onde consigo typer?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/fastapi/typer

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

Projetos relacionados