CPN 한국어 자습서 · 외부 문서 한국어 미러
UV 문서 · Concepts
Exporting a lockfile · 원문: docs.astral.sh/uv/concepts/projects/export/
아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.
uv는 외부 도구 및 워크플로와의 통합을 위해 프로젝트 락파일(lockfile)을 여러 형식으로 내보낼 수 있습니다. uv export 명령어는 각 사용 사례에 맞게 설계된 세 가지 출력 옵션을 제공합니다.
세 가지 형식이 있습니다:
pip 호환 requirements 파일 형식--format 플래그로 형식을 지정합니다:
$ uv export --format requirements.txt $ uv export --format pylock.toml $ uv export --format cyclonedx1.5
팁: 기본적으로
uv export는 stdout으로 출력합니다.--output-file을 사용하면 파일로 저장합니다:
$ uv export --format requirements.txt --output-file requirements.txt $ uv export --format pylock.toml --output-file pylock.toml $ uv export --format cyclonedx1.5 --output-file sbom.json
requirements.txt 형식은 Python 의존성에 가장 널리 지원되는 방식으로, pip 및 다른 패키지 관리자와 호환됩니다.
$ uv export --format requirements.txt
결과 파일은 uv pip install 또는 유사한 도구로 설치할 수 있습니다.
참고: 일반적으로
uv.lock과requirements.txt파일을 동시에 사용하는 것은 권장하지 않습니다. 락 형식은 requirements 형식으로 표현할 수 없는 더 정교한 기능을 제공합니다.
PEP 751은 Python을 위한 TOML 기반 락파일 사양을 제정했습니다. uv는 프로젝트 락파일을 이 표준화된 형식으로 내보내는 것을 지원합니다.
$ uv export --format pylock.toml
uv는 보안 평가, 규정 준수, 공급망 문서화에 유용한 포괄적인 컴포넌트 인벤토리를 제공하는 CycloneDX 형식의 소프트웨어 자재 명세서(SBOM)로 프로젝트 락파일을 내보낼 수 있습니다.
중요: CycloneDX 내보내기 지원은 현재 프리뷰(preview) 단계이며 변경될 수 있습니다.
CycloneDX는 머신 판독 가능하며 보안 분석 도구, 취약점 시스템, 소프트웨어 구성 분석 플랫폼에서 지원하는 산업 표준 SBOM 형식입니다.
$ uv export --format cyclonedx1.5
이 명령어는 프로젝트와 모든 의존성이 포함된 JSON 형식의 CycloneDX v1.5 문서를 생성합니다.
생성된 SBOM은 CycloneDX 사양을 준수하며 컴포넌트에 사용자 정의 속성을 포함합니다:
uv:package:marker: 환경 마커(예: python_version >= "3.8")uv:workspace:path: 워크스페이스 멤버의 상대 경로락파일과 내보내기 기능에 대한 자세한 내용은 락 및 동기화 문서와 명령어 참조를 검토하십시오.
원문(영어): https://docs.astral.sh/uv/concepts/projects/export/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.