Repolode
fastapi

fastapi/typer

표준 타입 힌트로 CLI 애플리케이션을 만들고, 도움말·유효성 검사·셸 자동 완성을 제공하는 Python 라이브러리입니다.

스타
20,155
포크
1,007
열린 이슈
49
마지막 커밋
6일 전

어떤 프로젝트인가요?

Typer는 CLI 애플리케이션을 만들기 위한 Python 라이브러리입니다. 함수 매개변수에 표준 타입 힌트를 지정하면 Typer가 이를 CLI 인자와 옵션으로 변환하고, 파싱과 타입 변환, 오류 메시지 처리를 맡습니다.

애플리케이션에는 자동으로 --help 출력과 Bash, Zsh, Fish, PowerShell용 셸 자동 완성이 제공됩니다. 명령어를 원하는 만큼 중첩된 하위 명령어와 그룹으로 구성할 수 있습니다. Typer에는 기존 Python 스크립트를 수정하지 않고 CLI로 실행할 수 있는 typer 명령어도 포함되어 있습니다.

Typer는 FastAPI 제작자가 설계했으며, 동일한 타입 힌트 중심 스타일을 따릅니다. 서식이 적용된 출력을 위해 rich에 의존하고, 셸 감지를 위해 shellingham을 사용하며, 0.26.0 버전부터 Click 사본을 내부에 포함합니다.

핵심 기능

  • 01Python 타입 힌트에서 CLI 인자와 옵션을 구성합니다.
  • 02--help 출력을 생성하고 서식이 적용된 오류 메시지를 자동으로 표시합니다.
  • 03Bash, Zsh, Fish, PowerShell용 셸 자동 완성을 제공합니다.
  • 04중첩된 하위 명령어와 명령어 그룹을 지원합니다.
  • 05일반 Python 스크립트를 CLI로 실행하는 typer 명령어를 포함합니다.

활용 사례

  • 인자 파싱과 도움말이 필요한 내부 개발자용 스크립트 작성
  • 하위 명령어가 있는 여러 명령어로 구성된 관리 도구 구축
  • 기존 Python 스크립트를 다시 작성하지 않고 CLI 유틸리티로 전환

빠른 시작

  1. 1

    uv를 설치합니다(README에 링크된 설치 가이드를 참조하세요)

  2. 2

    프로젝트에 Typer를 추가합니다

    uv add typer
  3. 3

    Typer에 내장된 CLI 러너로 스크립트를 실행합니다

    typer main.py run Camila

토픽

자주 묻는 질문

typer은(는) 무엇인가요?
표준 타입 힌트로 CLI 애플리케이션을 만들고, 도움말·유효성 검사·셸 자동 완성을 제공하는 Python 라이브러리입니다. Typer는 CLI 애플리케이션을 만들기 위한 Python 라이브러리입니다. 함수 매개변수에 표준 타입 힌트를 지정하면 Typer가 이를 CLI 인자와 옵션으로 변환하고, 파싱과 타입 변환, 오류 메시지 처리를 맡습니다.
typer은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
typer은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
typer은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. typer의 마지막 커밋은 2026년 10월 15일입니다.
typer은(는) 어디에 사용할 수 있나요?
인자 파싱과 도움말이 필요한 내부 개발자용 스크립트 작성 하위 명령어가 있는 여러 명령어로 구성된 관리 도구 구축 기존 Python 스크립트를 다시 작성하지 않고 CLI 유틸리티로 전환
typer는 어떻게 설치하나요?
uv를 설치합니다(README에 링크된 설치 가이드를 참조하세요) 프로젝트에 Typer를 추가합니다: uv add typer Typer에 내장된 CLI 러너로 스크립트를 실행합니다: typer main.py run Camila
typer은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/fastapi/typer

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트