Python 패키지 관리의 혁신 - uv 소개

안녕하세요! 오토씨입니다.

Python 패키지 관리의 새로운 강자로 떠오르고 있는 uv가 주목받는 이유는 무엇일까요? 빠른 속도, 크로스 플랫폼 지원, 그리고 직관적인 인터페이스 덕분에 많은 개발자들이 관심을 갖고 있습니다. 오늘은 이러한 uv에 대해 자세히 알아보겠습니다. 그동안 Python 패키지 관리에는 pip, venv, poetry 등이 주로 사용되어 왔지만, 최근 uv가 주목을 받고 있습니다. 특히 poetry, venv, pip에서 uv로의 전환을 고민 중인 분들을 위해 이 글이 도움이 되었으면 합니다.

 

Python 패키지 관리의 혁신 - uv 소개

 

uv란 무엇인가요?

uv는 Python 개발 환경에서 더욱 편리한 패키지 관리를 제공하는 도구로, 고속성, 크로스 플랫폼 지원, 전용 인터페이스 등 다양한 장점을 가지고 있습니다. Rust로 구현되어 있어 매우 빠른 동작을 자랑합니다. Rust의 높은 성능과 메모리 안전성 덕분에 의존성 해결이 매우 빠릅니다. 또한 효율적인 캐시 관리를 통해 개발 속도를 크게 향상시킬 수 있습니다.

 

uv의 주요 특징

1. 고속의 동작 및 메모리 안전성: uv는 Rust로 작성되어 뛰어난 성능을 제공합니다. 의존성 해결이 매우 빠르며, 메모리 안전성을 보장합니다.
2. 효율적인 캐시 관리: 이미 다운로드된 패키지나 빌드된 wheel 파일 등을 캐시하여 재사용성을 높이고, 처리 시간을 단축시킵니다. 이 캐시는 스레드 세이프(Thread-safe)하게 관리되어 여러 명령을 동시에 실행해도 안전합니다.
3. 크로스플랫폼 지원: uv는 여러 플랫폼에서 일관된 락 파일을 사용하여 모든 개발자가 동일한 환경을 유지할 수 있도록 합니다.
4. 전용 인터페이스 제공: uv는 Python 개발에 필요한 여러 도구들을 하나의 전용 인터페이스로 통합하여 관리할 수 있도록 합니다. 이를 통해 개발자는 보다 직관적으로 의존성 및 환경을 관리할 수 있습니다.

반응형

uv의 설치와 셋업

uv를 설치하는 방법은 여러 가지가 있습니다. 공식 스탠드얼론 설치 프로그램을 이용하거나, pip, Homebrew, Cargo와 같은 패키지 매니저를 통해 설치할 수 있습니다.

 

설치 방법

macOS/Linux:

export _force_install_dir="/설치/디렉토리/경로"
curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

또는 pip, Homebrew, Cargo 명령어로 설치 가능합니다.

# pip
pip install uv

# Homebrew
brew install uv

# Cargo
cargo install --git https://github.com/astral-sh/uv uv

설치 후 uv generate-shell-completion 명령어를 실행하여 쉘 자동 완성 기능을 추가할 수 있습니다. 쉘 자동 완성은 명령어 입력 시 가능한 옵션들을 자동으로 제안해 주는 기능으로, 생산성을 높이고 명령어 입력 오류를 줄여줍니다.

 

uv의 업그레이드 및 제거

• 업그레이드: uv self update 명령어를 사용하여 uv를 최신 버전으로 업그레이드할 수 있습니다.
• 제거: 설치 디렉토리에서 uv의 바이너리를 삭제하면 됩니다.

uv의 기본적인 사용법

Python 버전 관리

uv는 다양한 Python 버전을 관리할 수 있습니다. 원하는 버전을 쉽게 설치하고, 프로젝트마다 별도의 Python 버전을 사용할 수 있게 해줍니다.

uv python install 3.10 3.11 3.12

설치된 Python 버전은 다음과 같이 확인할 수 있습니다:

uv python list

프로젝트에 사용할 Python 버전은 .python-version 파일에 명시하여 지정합니다. 또한 자동으로 Python 버전을 다운로드하도록 설정할 수 있으며, 필요에 따라 이를 비활성화할 수도 있습니다.

 

스크립트 실행

uv는 독립적인 스크립트 실행을 지원하며, 필요한 의존성을 명시하여 실행할 수 있습니다.

uv run example.py

필요한 패키지가 있을 경우 --with 옵션을 사용합니다:

uv run --with requests example.py

또한 스크립트에 인라인 메타데이터를 사용해 의존성을 선언할 수도 있습니다.

# /// script
# dependencies = ["requests"]
# ///

import requests
# ...

특정 날짜 이전에 릴리스된 패키지만 사용하도록 제한하여 재현성을 높일 수도 있습니다.

도구 실행 및 설치

uv는 Python 패키지가 제공하는 명령줄 도구의 실행 및 설치도 지원합니다. uvx 명령어를 사용하여 도구를 실행할 수 있으며, 필요에 따라 일시적인 격리 환경에 설치하거나 영구적인 환경에 설치할 수 있습니다.

uvx ruff

영구적인 환경에 설치하려면 다음과 같이 명령어를 실행합니다:

uv tool install ruff

프로젝트와 의존성 관리

프로젝트 생성 및 초기화

uv는 Python 프로젝트를 쉽게 초기화하고 관리할 수 있는 도구를 제공합니다. uv init 명령어를 통해 새로운 프로젝트를 생성할 수 있으며, 애플리케이션 혹은 라이브러리 프로젝트로 구분할 수 있습니다.

uv init my-project

애플리케이션 프로젝트:

uv init --app my-app

라이브러리 프로젝트:

uv init --lib my-lib

 

의존성 추가 및 제거

• 의존성 추가: uv add 명령어로 의존성을 추가합니다.

  uv add requests
  

• 의존성 제거: uv remove 명령어로 의존성을 제거할 수 있습니다.

  uv remove requests
  

Docker 및 CI/CD와의 연동

uv는 Docker 및 GitHub Actions, GitLab CI/CD와 같은 CI/CD 도구와도 쉽게 연동할 수 있습니다.

uv의 장단점

장점

• 고속의 성능: Rust로 작성되어 빠른 의존성 해결
• 크로스플랫폼 락 파일: 모든 개발자가 동일한 환경을 유지 가능

단점

• 에코시스템의 미성숙: 일부 패키지가 uv에서 지원되지 않을 수 있음

마무리하며

uv는 Python의 패키지 관리에서 새로운 가능성을 제시하는 도구입니다. 빠르고 효율적인 개발 환경을 원한다면 uv를 고려해 보세요.

 

uv 공식문서: https://docs.astral.sh/uv/

 

감사합니다. 오토씨였습니다!