[Python] 🚀 uv로 프로젝트 & 패키지 관리 완벽 가이드

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

pip install uv

uv --version

# 현재 디렉토리에 새로운 파이썬 프로젝트 환경을 초기화하는 기본적인 파일과 폴더 구조가 자동으로 생성
uv init

# 기본 프로젝트 생성
uv init my-project

# 설정 파일만 필요하다면
uv init --bare

# 특정 Python 버전으로 생성
uv init my-project --python 3.11

# 가상환경 없이 생성
uv init my-project --no-venv

# 패키지 추가
uv add requests

# 특정 버전 추가
uv add requests==2.31.0

# 개발 의존성 추가
uv add --dev pytest

# 로컬 패키지 (editable 모드)
uv add -e ./localpackage

uv remove requests
uv remove --dev pytest

uv sync                 # 전체 설치
uv sync --dev           # 개발 의존성 포함
uv sync --no-dev        # 개발 의존성 제외

uv lock
uv lock --dev
uv lock --no-dev

uv pip install requests

uv pip install "requests==2.31.0"
uv pip install "requests>=2.31.0"
uv pip install "requests<3.0.0"

uv pip install --dev pytest
uv pip install --dev black isort mypy

uv pip uninstall requests
uv pip uninstall -y requests

uv pip install --upgrade requests
uv pip install --upgrade pip

uv pip search "data science"
uv pip show requests
uv pip list
uv pip list outdated
uv pip freeze               # 현재 환경의 의존성 requirements 형식으로 출력

uv venv
uv venv --python 3.11
uv venv --name myenv
uv venv --clear

source .venv/bin/activate
source myenv/bin/activate

.venv\Scripts\activate
myenv\Scripts\activate

deactivate

uv python install 3.11
uv python install 3.11.0
uv python install 3.11 --force

uv python list
uv python remove 3.11
uv python pin 3.11

uv run --python 3.11 script.py
uv run --python 3.11 -m pytest

uv run script.py
uv run -m module

uv run --with-deps script.py
uv run --no-deps script.py

uv run script.py --arg1 value1 --arg2 value2
uv run -m pytest tests/ --verbose

uv run --env VAR1=value1 --env VAR2=value2 script.py

uv init data-science-project --python 3.11
cd data-science-project
uv add pandas numpy matplotlib scikit-learn
uv add --dev jupyter notebook
uv run jupyter notebook

uv init web-api --python 3.11
cd web-api
uv add fastapi uvicorn sqlalchemy pydantic
uv add --dev pytest black mypy
uv run uvicorn src.main:app --reload

uv init ml-project --python 3.11
cd ml-project
uv add torch torchvision transformers datasets
uv add --dev jupyter wandb tensorboard
uv run python src/train.py