Repolode
Enviar
fastapi

fastapi/typer

Biblioteca de Python para crear aplicaciones CLI a partir de anotaciones de tipos estándar, con ayuda, validación y autocompletado de shell automáticos.

Ver en GitHubSitio web
Estrellas
20,155
Forks
1,007
Issues abiertos
49
Último commit
hace 6 días

¿Qué es?

Typer es una biblioteca de Python para crear aplicaciones de interfaz de línea de comandos. Declaras los parámetros de una función con anotaciones de tipos estándar y Typer los convierte en argumentos y opciones de CLI, gestionando el análisis, la conversión de tipos y los mensajes de error.

Las aplicaciones incluyen automáticamente una salida de --help y autocompletado de shell para Bash, Zsh, Fish y PowerShell. Los comandos se pueden organizar en árboles arbitrariamente anidados de subcomandos y grupos. Typer también incluye un comando typer que permite ejecutar un script de Python existente como CLI sin modificarlo.

Typer está diseñado por el autor de FastAPI y sigue el mismo estilo basado en anotaciones de tipos. Depende de rich para dar formato a la salida y de shellingham para detectar el shell; desde la versión 0.26.0, incluye internamente su propia copia de Click.

Funciones clave

  • 01Crea argumentos y opciones de CLI a partir de anotaciones de tipos de Python.
  • 02Genera la salida de --help y muestra errores con formato automáticamente.
  • 03Ofrece autocompletado de shell para Bash, Zsh, Fish y PowerShell.
  • 04Admite subcomandos anidados y grupos de comandos.
  • 05Incluye un comando typer para ejecutar scripts de Python sin modificar como CLI.

Casos de uso

  • Escribir scripts internos para desarrolladores que necesiten analizar argumentos y mostrar texto de ayuda.
  • Crear una herramienta de administración con varios comandos y subcomandos.
  • Convertir un script de Python existente en una utilidad de línea de comandos sin tener que reescribirlo.

Inicio rápido

  1. 1

    Instala uv (consulta la guía de instalación enlazada en el README)

  2. 2

    Añade Typer a tu proyecto

    uv add typer
  3. 3

    Ejecuta tu script con el ejecutor de CLI integrado de Typer

    typer main.py run Camila

Temas

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

Preguntas frecuentes

¿Qué es typer?
Biblioteca de Python para crear aplicaciones CLI a partir de anotaciones de tipos estándar, con ayuda, validación y autocompletado de shell automáticos. Typer es una biblioteca de Python para crear aplicaciones de interfaz de línea de comandos. Declaras los parámetros de una función con anotaciones de tipos estándar y Typer los convierte en argumentos y opciones de CLI, gestionando el análisis, la conversión de tipos y los mensajes de error.
¿typer es gratuito? ¿Qué licencia tiene?
typer es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿typer sigue mantenido?
Mantenimiento activo. El último commit de typer fue el 15 oct 2026.
¿Para qué puedo usar typer?
Escribir scripts internos para desarrolladores que necesiten analizar argumentos y mostrar texto de ayuda. Crear una herramienta de administración con varios comandos y subcomandos. Convertir un script de Python existente en una utilidad de línea de comandos sin tener que reescribirlo.
¿Cómo se instala typer?
Instala uv (consulta la guía de instalación enlazada en el README) Añade Typer a tu proyecto: uv add typer Ejecuta tu script con el ejecutor de CLI integrado de Typer: typer main.py run Camila
¿Dónde consigo typer?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/fastapi/typer

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados