uv или pip: управление пакетами и зависимостями Python

[project]
name = "my-app"
version = "1.0.0"
dependencies = [
    "django>=4.2,<5.0",
    "psycopg2-binary>=2.9",
    "redis>=4.5.0"
]
 
[project.optional-dependencies]
dev = [
    "pytest>=7.0",
    "black>=23.0",
    "mypy>=1.0"
]

error: Requirements conflict
  fastapi 0.109.0 requires pydantic>=2.0
  alembic 1.13.1 requires sqlalchemy>=1.4.0,<2.0
  sqlalchemy 2.0.25 requires pydantic<2.0

FROM python:3.11-slim
 
# Устанавливаем uv
RUN curl -LsSf https://astral.sh/uv/install.sh | sh
ENV PATH="/root/.cargo/bin:${PATH}"
 
WORKDIR /app

# Стадия сборки
FROM python:3.11-slim as builder
 
RUN curl -LsSf https://astral.sh/uv/install.sh | sh
ENV PATH="/root/.cargo/bin:${PATH}"
 
WORKDIR /app
COPY requirements.txt .
RUN uv venv /opt/venv && \
    . /opt/venv/bin/activate && \
    uv pip install -r requirements.txt
 
# Финальный образ  
FROM python:3.11-slim
 
COPY --from=builder /opt/venv /opt/venv
ENV PATH="/opt/venv/bin:${PATH}"
 
WORKDIR /app
COPY . .
 
CMD ["python", "main.py"]

[[tool.uv.index]]
url = "https://pypi.company.com/simple"
name = "corporate"
 
[[tool.uv.index]]
url = "https://pypi.org/simple"
name = "public"
default = true

[tool.uv.workspace]
members = [
  "services/auth",
  "services/billing", 
  "shared/common"
]

# Классический подход с pip
mkdir myproject && cd myproject
python -m venv .venv
source .venv/bin/activate
pip install django psycopg2-binary python-dotenv
pip freeze > requirements.txt
django-admin startproject config .

# Современный подход с uv
mkdir myproject && cd myproject
uv init
uv add django psycopg2-binary python-dotenv
django-admin startproject config .

# pip подход для data science
python -m venv ds_env
source ds_env/bin/activate
pip install jupyter pandas matplotlib scikit-learn seaborn
# Ждем 4-5 минут...
jupyter notebook

# uv подход для data science
uv venv ds_env
source ds_env/bin/activate
uv pip install jupyter pandas matplotlib scikit-learn seaborn
# Готово через 15 секунд
jupyter notebook

# Базовый FastAPI сервис с pip
mkdir auth-service && cd auth-service
python -m venv .venv && source .venv/bin/activate
pip install "fastapi[all]" sqlalchemy alembic pydantic-settings
pip freeze > requirements.txt
 
# Тот же сервис с uv
mkdir auth-service && cd auth-service  
uv init --name auth-service
uv add "fastapi[all]" sqlalchemy alembic pydantic-settings

# Обновление через pip
pip install --upgrade fastapi
pip freeze > requirements.txt  # Не забыть!
git add requirements.txt
git commit -m "Update fastapi to 0.109.0"

# Обновление через uv
uv add --upgrade fastapi
# Lock-файл обновлен автоматически
git add pyproject.toml uv.lock
git commit -m "Update fastapi to 0.109.0"

# Пытаемся воспроизвести окружение пользователя
python -m venv debug_env && source debug_env/bin/activate
pip install -r user_requirements.txt
# Может установиться с другими транзитивными зависимостями
# Если user_requirements.txt неполный - вообще непонятно что установлено

  
# Точное воспроизведение через uv
uv venv debug_env && source debug_env/bin/activate
uv sync --frozen  # Установит точно версии из uv.lock
# Окружение byte-in-byte идентично исходному

# Тестирование на разных версиях через pip
python3.9 -m venv .venv39 && source .venv39/bin/activate
pip install -r requirements.txt && pytest
deactivate
 
python3.10 -m venv .venv310 && source .venv310/bin/activate  
pip install -r requirements.txt && pytest
deactivate
 
# И так далее для каждой версии...

# Тестирование на разных версиях через uv
for py_version in 3.9 3.10 3.11 3.12; do
  uv venv .venv${py_version//.} --python $py_version
  source .venv${py_version//.}/bin/activate
  uv pip install -r requirements.txt && pytest
  deactivate
done

[project]
name = "mylib"
version = "0.1.0"
requires-python = ">=3.9"
dependencies = [
    "requests>=2.28.0",
    "pydantic>=2.0.0",
]
 
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

# Быстрый тест с pip - медленно
python -m venv /tmp/test_env && source /tmp/test_env/bin/activate
pip install some-new-library
python -c "import some_new_library; print(some_new_library.__version__)"
deactivate && rm -rf /tmp/test_env
 
# Быстрый тест с uv - действительно быстро  
uv venv /tmp/test_env && source /tmp/test_env/bin/activate
uv pip install some-new-library
python -c "import some_new_library; print(some_new_library.__version__)"
deactivate && rm -rf /tmp/test_env

# pip не может найти решение
$ pip install "pandas<2.0" some-api-wrapper
ERROR: Cannot install pandas<2.0 and some-api-wrapper because these package 
versions have conflicting dependencies.

  
$ uv pip install "pandas<2.0" some-api-wrapper
error: Failed to resolve requirements
  some-api-wrapper 1.2.0 requires pandas>=2.0.0
  but you requested pandas<2.0

# pip подход с двумя файлами
# requirements.txt - продакшен
django==5.0
psycopg2-binary==2.9.9
 
# requirements-dev.txt - разработка
-r requirements.txt
pytest==7.4.3
black==23.12.0
mypy==1.7.1

[project]
dependencies = [
    "django>=5.0",
    "psycopg2-binary>=2.9",
]
 
[project.optional-dependencies]
dev = [
    "pytest>=7.4",
    "black>=23.12",
    "mypy>=1.7",
]

# Структура монорепо
# /shared/common - общая библиотека
[H2]/services/api - микросервис использующий common[/H2]
 
cd services/api
pip install -e ../../shared/common
pip install -r requirements.txt

.PHONY: install test lint
 
install:
    uv sync --extra dev
 
test:
    pytest tests/
 
lint:
    black --check .
    mypy src/