Uv(파이썬) 편집하기 (부분)

=== 프로젝트 관리 (Poetry 대체) ===

Poetry와 유사한 방식으로 프로젝트 전체의 생명주기를 관리한다.

==== 프로젝트 초기화 ====

<syntaxhighlight lang="bash">
# 새 프로젝트 생성
uv init my-project
cd my-project

# 생성되는 파일 구조:
# my-project/
# ├── .git/
# ├── .venv/
# ├── .python-version
# ├── pyproject.toml
# ├── README.md
# └── src/
#     └── my_project/
#         └── __init__.py
</syntaxhighlight>

==== 의존성 추가/제거 ====

<syntaxhighlight lang="bash">
# 패키지 추가 (pyproject.toml에 자동 기록 + 설치)
uv add requests
uv add "fastapi>=0.100"
uv add "numpy>=1.24,<2.0"

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

# 특정 그룹에 추가
uv add --group lint ruff

# 패키지 제거
uv remove requests

# 의존성 업그레이드
uv add requests --upgrade
</syntaxhighlight>

==== Lock 파일 관리 ====

<syntaxhighlight lang="bash">
# uv.lock 생성/업데이트
uv lock

# lock 파일 기반으로 환경 동기화
uv sync

# 개발 의존성 포함 동기화
uv sync --all-extras

# 특정 그룹만 동기화
uv sync --group lint
</syntaxhighlight>

==== 프로젝트 실행 ====

<syntaxhighlight lang="bash">
# 가상환경 활성화 없이 바로 실행 (uv가 자동으로 처리)
uv run python main.py
uv run python -m pytest
uv run ruff check .

# 환경변수와 함께 실행
uv run --env-file .env python main.py
</syntaxhighlight>

`uv run`의 가장 큰 장점은 '''가상환경을 수동으로 활성화하지 않아도 된다'''는 점이다. uv가 알아서 `.venv`를 찾고 올바른 환경에서 실행시켜 준다.