Repolode
Предложить
fastapi

fastapi/typer

Библиотека Python для создания CLI-приложений на основе стандартных подсказок типов с автоматической справкой, проверкой аргументов и автодополнением команд в shell.

Открыть на GitHubСайт
Звёзды
20,155
Форки
1,007
Открытые issues
49
Последний коммит
6 дней назад

Что это?

Typer — библиотека Python для создания приложений с интерфейсом командной строки. Вы задаёте параметры функции с помощью стандартных подсказок типов, а Typer преобразует их в аргументы и опции CLI, обрабатывая разбор, преобразование типов и сообщения об ошибках.

Приложения автоматически получают вывод справки по команде --help и автодополнение команд в Bash, Zsh, Fish и PowerShell. Команды можно объединять в деревья подкоманд и групп любой глубины. В Typer также входит команда typer, которая позволяет запускать существующий скрипт Python как CLI без изменений.

Typer создан автором FastAPI и придерживается того же подхода, основанного на подсказках типов. Он использует rich для форматирования вывода и shellingham для определения shell, а начиная с версии 0.26.0 включает собственную копию Click.

Ключевые возможности

  • 01Создаёт аргументы и опции CLI на основе подсказок типов Python.
  • 02Автоматически генерирует вывод справки по команде --help и показывает форматированные сообщения об ошибках.
  • 03Обеспечивает автодополнение команд в Bash, Zsh, Fish и PowerShell.
  • 04Поддерживает вложенные подкоманды и группы команд.
  • 05Включает команду typer для запуска обычных скриптов Python как CLI.

Сценарии использования

  • Написание внутренних скриптов для разработчиков, которым нужны разбор аргументов и справка.
  • Создание административной утилиты с несколькими командами и подкомандами.
  • Преобразование существующего скрипта Python в утилиту командной строки без переписывания.

Быстрый старт

  1. 1

    Установите uv (см. руководство по установке, ссылка на которое есть в README)

  2. 2

    Добавьте Typer в проект

    uv add typer
  3. 3

    Запустите скрипт с помощью встроенного CLI-исполнителя Typer

    typer main.py run Camila

Темы

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

Частые вопросы

Что такое typer?
Библиотека Python для создания CLI-приложений на основе стандартных подсказок типов с автоматической справкой, проверкой аргументов и автодополнением команд в shell. Typer — библиотека Python для создания приложений с интерфейсом командной строки. Вы задаёте параметры функции с помощью стандартных подсказок типов, а Typer преобразует их в аргументы и опции CLI, обрабатывая разбор, преобразование типов и сообщения об ошибках.
typer можно использовать бесплатно? Какая у него лицензия?
typer распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
typer всё ещё поддерживается?
Активно поддерживается. Последний коммит в typer — 15 окт. 2026 г..
Для чего можно использовать typer?
Написание внутренних скриптов для разработчиков, которым нужны разбор аргументов и справка. Создание административной утилиты с несколькими командами и подкомандами. Преобразование существующего скрипта Python в утилиту командной строки без переписывания.
Как установить typer?
Установите uv (см. руководство по установке, ссылка на которое есть в README) Добавьте Typer в проект: uv add typer Запустите скрипт с помощью встроенного CLI-исполнителя Typer: typer main.py run Camila
Где скачать typer?
Исходный код и инструкции по установке — на GitHub: https://github.com/fastapi/typer

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты