UV 환경 설정 가이드

UV란?

UV는 Rust로 작성된 빠른 Python 패키지 매니저입니다. pip보다 10-100배 빠른 설치 속도를 제공합니다.

기본 명령어

프로젝트 초기화

uv init crawler-project
cd crawler-project

pyproject.toml 파일이 생성됩니다.

패키지 추가

# 단일 패키지
uv add requests

# 여러 패키지
uv add selenium webdriver-manager beautifulsoup4 requests pandas

스크립트 실행

uv run crawler.py

UV가 자동으로 가상환경을 생성하고 의존성을 설치한 후 스크립트를 실행합니다.

환경 동기화

uv sync

pyproject.toml에 정의된 모든 의존성을 설치/동기화합니다.

크롤러 프로젝트 표준 설정

정적 페이지 크롤러

uv init static-crawler
cd static-crawler
uv add requests beautifulsoup4 pandas

동적 페이지 크롤러

uv init dynamic-crawler
cd dynamic-crawler
uv add selenium webdriver-manager pandas

API 크롤러

uv init api-crawler
cd api-crawler
uv add requests pandas

전체 기능 크롤러 (권장)

uv init crawler-project
cd crawler-project
uv add selenium webdriver-manager beautifulsoup4 requests pandas

pyproject.toml 예시

[project]
name = "crawler-project"
version = "0.1.0"
description = "Web Crawler"
requires-python = ">=3.10"
dependencies = [
    "selenium>=4.15.0",
    "webdriver-manager>=4.0.0",
    "beautifulsoup4>=4.12.0",
    "requests>=2.31.0",
    "pandas>=2.1.0",
]

추가 유용한 명령어

# 패키지 제거
uv remove 패키지명

# 패키지 업데이트
uv add --upgrade 패키지명

# 의존성 목록 확인
uv pip list

# Python 버전 지정
uv python pin 3.11