패키지 관리

패키지 설치

가상 환경에 패키지를 설치하려면, 예를 들어 Flask를 설치하려면:

$ uv pip install flask

옵션 의존성을 활성화하여 패키지를 설치하려면, 예를 들어 "dotenv" 추가 기능이 포함된 Flask를 설치하려면:

$ uv pip install "flask[dotenv]"

여러 패키지를 설치하려면, 예를 들어 Flask와 Ruff를 설치하려면:

$ uv pip install flask ruff

제약 조건을 지정하여 패키지를 설치하려면, 예를 들어 Ruff v0.2.0 이상을 설치하려면:

$ uv pip install 'ruff>=0.2.0'

특정 버전의 패키지를 설치하려면, 예를 들어 Ruff v0.3.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"

GitHub에서 특정 참조를 사용하여 패키지를 설치하려면:

$ # 태그 설치
$ uv pip install "git+https://github.com/astral-sh/ruff@v0.2.0"

$ # 커밋 설치
$ uv pip install "git+https://github.com/astral-sh/ruff@1fadefa67b26508cc59cf38e6130bde2243c929d"

$ # 브랜치 설치
$ uv pip install "git+https://github.com/astral-sh/ruff@main"

프라이빗 저장소에서 설치하는 방법은 Git 인증 문서를 참고한다.

수정 가능한 패키지

수정 가능한 패키지는 소스 코드를 변경해도 재설치할 필요가 없다. 변경 사항이 즉시 반영된다.

현재 프로젝트를 수정 가능한 패키지로 설치하려면 다음 명령을 실행한다:

$ uv pip install -e .

다른 디렉터리에 있는 프로젝트를 수정 가능한 패키지로 설치하려면 다음과 같이 실행한다:

$ uv pip install -e "ruff @ ./project/ruff"

파일에서 패키지 설치하기

표준 파일 형식을 사용해 여러 패키지를 한 번에 설치할 수 있다.

requirements.txt 파일에서 설치하기:

$ uv pip install -r requirements.txt

requirements.txt 파일에 대한 자세한 내용은 uv pip compile 문서를 참고한다.

pyproject.toml 파일에서 설치하기:

$ uv pip install -r pyproject.toml

pyproject.toml 파일에서 선택적 의존성을 활성화하여 설치하기, 예를 들어 "foo" 추가 기능:

$ uv pip install -r pyproject.toml --extra foo

pyproject.toml 파일에서 모든 선택적 의존성을 활성화하여 설치하기:

$ uv pip install -r pyproject.toml --all-extras

패키지 제거하기

패키지를 제거하려면, 예를 들어 Flask를 제거하려면:

$ uv pip uninstall flask

여러 패키지를 제거하려면, 예를 들어 Flask와 Ruff를 제거하려면:

$ uv pip uninstall flask ruff