byteforce

CPN 한국어 자습서 · 외부 문서 한국어 미러

UV 문서 · The pip interface

패키지 관리하기

Managing packages · 원문: docs.astral.sh/uv/pip/packages/

아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.

패키지 설치

가상환경에 패키지를 추가하려면 uv pip install 뒤에 패키지 이름을 입력합니다.

코드 · 명령
$ uv pip install flask

선택적 의존성(extras)

괄호 표기법을 사용해 특정 선택적 의존성(optional dependency)을 활성화합니다.

코드 · 명령
$ uv pip install "flask[dotenv]"

여러 패키지

한 번에 여러 패키지를 설치합니다.

코드 · 명령
$ uv pip install flask ruff

버전 제약

표준 pip 문법으로 버전 요구사항을 지정합니다.

코드 · 명령
$ uv pip install 'ruff>=0.2.0'

정확한 버전에 고정합니다.

코드 · 명령
$ uv pip install 'ruff==0.3.0'

대체 소스에서 설치

로컬 디렉터리에서 설치합니다.

코드 · 명령
$ uv pip install "ruff @ ./projects/ruff"

GitHub에서 직접 설치합니다.

코드 · 명령
$ uv pip install "git+https://github.com/astral-sh/ruff"

특정 Git 참조(태그, 커밋, 브랜치)에서 설치합니다.

코드 · 명령
$ uv pip install "git+https://github.com/astral-sh/ruff@0.3.0"
$ uv pip install "git+https://github.com/astral-sh/ruff@1fadefa67b26508cc59cf38e6130bde2243c929d"
$ uv pip install "git+https://github.com/astral-sh/ruff@main"

비공개 저장소의 경우 Git 인증 문서를 참조하세요.

편집 가능한 패키지(editable packages)

편집 가능한 패키지(editable package)는 소스 코드를 변경해도 재설치 없이 변경 사항이 즉시 반영됩니다.

현재 프로젝트를 편집 가능한 상태로 설치합니다.

코드 · 명령
$ uv pip install -e .

다른 프로젝트 디렉터리를 편집 가능한 상태로 설치합니다.

코드 · 명령
$ uv pip install -e "ruff @ ./project/ruff"

파일에서 패키지 설치

요구사항 파일

requirements.txt에서 모든 의존성을 설치합니다.

코드 · 명령
$ uv pip install -r requirements.txt

프로젝트 설정 파일

pyproject.toml에서 설치합니다.

코드 · 명령
$ uv pip install -r pyproject.toml

특정 선택적 의존성을 포함해 설치합니다.

코드 · 명령
$ uv pip install -r pyproject.toml --extra foo

모든 선택적 의존성을 포함해 설치합니다.

코드 · 명령
$ uv pip install -r pyproject.toml --all-extras

의존성 그룹

현재 프로젝트 설정에서 그룹을 설치합니다.

코드 · 명령
$ uv pip install --group foo

다른 프로젝트 디렉터리를 지정합니다.

코드 · 명령
$ uv pip install --project some/path/ --group foo --group bar

각 그룹에 특정 pyproject.toml 파일을 참조합니다.

코드 · 명령
$ uv pip install --group some/path/pyproject.toml:foo --group other/pyproject.toml:bar

참고: --group 플래그는 현재 프로젝트에만 적용되며, -r 또는 -e 플래그로 지정한 소스에는 적용되지 않습니다.

패키지 제거

단일 패키지를 제거합니다.

코드 · 명령
$ uv pip uninstall flask

여러 패키지를 제거합니다.

코드 · 명령
$ uv pip uninstall flask ruff

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

원문(영어): https://docs.astral.sh/uv/pip/packages/