[파이썬 의존성 관리] UV 설치 및 사용

 

Rust 기반의 강력한 파이썬 의존 패키지가 나왔다고 합니다.

 

• 사용해야하는 이유
  • PIP 보다 10 ~ 100배 빠른 패키지 설치 및 의존성 해결 속도
  • 올인원 패키지 (pip, pipx, pyenv, twine, virtualenv ...)
  • 완전한 PEP 지원

 

설치

• Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

# 업데이트
uv self update

• 그 외

uv docs 참고 (https://docs.astral.sh/uv/getting-started/installation/#standalone-installer)

 

 

UV 파이썬 설치 및 가상환경

• 원하는 파이썬 버전 설치

uv python install 3.10 3.11 3.12

 

• 파이썬 설치 버전 확인

uv python list

 

• 가상 환경 생성

uv venv --python 3.10

 

 

UV 프로젝트 관리

• 프로젝트 생성
  • init 뒤에 프로젝트 명 넣어주면 해당 프로젝트로 레포 만들어주고, 안넣어주면 uv init 실행한 위치에다가 toml 파일 등을 만들어줍니다.

uv init

# `error: Failed to discover parent workspace;` 가 발생 시
uv init --no-workspace

# python 버전 명시하고 싶다면
uv init --python 3.10

 

• 생성되는 파일 구조
  • 다시 만들고 싶다면, toml 파일 지워주면 됩니다.

.
├── README.md
├── .python-version
├── main.py
└── pyproject.toml

 

 

• 라이브러리 추가 설치

uv add fastapi==0.111

# 개발 시만 설치한다면 dev 옵션 추가
uv add --dev ruff

 

* 가상환경 활성화는 기존 가상환경과 동일하게 activate 진행시켜주면 됩니다.

 

 

Reference

- https://docs.astral.sh/uv/getting-started/features/#projects

- https://www.0x00.kr/development/python/python-uv-simple-usage-and-example