발행: (2025년 12월 1일 오전 06:30 GMT+9)
3 min read

Source: Hacker News

시작하기

온라인 플레이그라운드를 사용해 보거나 uvxty 를 실행하여 빠르게 시작하세요:

uvx ty

ty 를 설치하는 다른 방법은 설치 문서를 참고하세요.

하위 명령을 제공하지 않으면 ty 가 사용 가능한 명령을 나열합니다 — 명령줄 옵션에 대한 자세한 내용은 CLI 레퍼런스를 확인하세요.

check 명령을 사용해 타입 체커를 실행합니다:

uvx ty check

ty 는 작업 디렉터리와 하위 디렉터리의 모든 Python 파일을 검사합니다. 프로젝트 내에서 사용하면 pyproject.toml 파일이 있는 디렉터리를 시작점으로 프로젝트의 모든 Python 파일을 검사합니다.

특정 경로만 검사하도록 지정할 수도 있습니다:

uvx ty check example.py

타입 검사를 수행할 때 ty 는 활성 가상 환경(VIRTUAL_ENV 통해)에서 설치된 패키지를 찾거나 프로젝트 루트 또는 작업 디렉터리에서 .venv 라는 이름의 가상 환경을 탐색합니다. --python 옵션으로 대상 경로를 지정하지 않으면 비가상 환경에 있는 패키지는 찾지 못합니다. 자세한 내용은 모듈 탐색 문서를 참고하세요.

사용법

프로젝트 최상위 디렉터리에서 ty check 를 실행하면 ty 의 기본 설정을 사용해 프로젝트의 타입 오류를 검사합니다. 오류가 연쇄적으로 발생하고 표준 라이브러리 venv 모듈을 가상 환경으로 사용 중이라면, .gitignore 혹은 .ignore 파일에 venv 디렉터리를 추가한 뒤 다시 시도하세요.

Back to Blog

관련 글

더 보기 »