미리보기 기능

uv는 광범위한 출시 전에 커뮤니티 피드백을 수집하여 개선 사항을 검증하는 데 도움이 되는 선택적 미리보기(preview) 기능을 제공합니다.

미리보기 기능 활성화

--preview 플래그 또는 UV_PREVIEW=1 환경 변수를 사용하여 모든 미리보기 기능을 활성화합니다. 특정 기능의 경우 --preview-features foo 또는 UV_PREVIEW_FEATURES=foo,bar를 사용합니다.

uv.toml 또는 pyproject.toml에서 설정:

preview-features = ["foo", "bar"]

preview-features = true로 설정하면 모든 옵션이 활성화됩니다. 일부 기능은 설정 로드 전에 동작에 영향을 미치므로 설정 파일을 통해 활성화할 수 없습니다.

미리보기 기능 사용

많은 미리보기 기능은 사용자 작업에 의해 트리거될 때 명시적인 설정 없이 작동합니다. 예를 들어, pylock.toml 지원은 추가 설정 없이 uv pip install과 함께 작동하지만 경고가 표시됩니다. 기능을 활성화하면 이 경고가 사라집니다.

사용 가능한 미리보기 기능

• add-bounds: uv add 호출에 대한 기본 경계 설정
• json-output: 다양한 명령에 대해 --output-format json 활성화
• package-conflicts: 패키지 수준에서 워크스페이스 충돌 정의
• pylock: pylock.toml 파일에서 설치
• python-install-default: python 및 python3 실행 파일 설치
• format: uv format 사용
• index-exclude-newer: 패키지 인덱스에 exclude-newer 설정
• azure-endpoint: 자격증명으로 Azure Blob Storage 요청 서명
• native-auth: 시스템 네이티브 위치에 자격증명 저장
• auth-helper: 자격증명 도우미로 uv auth helper 사용
• workspace-metadata: uv workspace metadata 사용
• workspace-dir: uv workspace dir 사용
• workspace-list: uv workspace list 사용
• target-workspace-discovery: 프로젝트 탐색에 대상 디렉터리 사용
• project-directory-must-exist: 유효하지 않은 --project 경로 거부
• malware-check: 설치 전 OSV를 사용하여 악성코드 확인

미리보기 기능 비활성화

미리보기 기능을 비활성화하려면 --no-preview를 사용합니다.

원문(영어): https://docs.astral.sh/uv/concepts/preview/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.

원문(영어): https://docs.astral.sh/uv/concepts/preview/