Файл зависимостей Python: требования и способы его формирования

Когда и зачем использовать ручное создание requirements.txt?

Ручное написание файла оправдано, когда нужно указать только ключевые пакеты без точных версий (например, Django>=3.2, requests) или когда проект очень маленький. Также это полезно для демонстрации минимальных требований.

# requirements.txt
Django>=3.2,<4
requests>=2.25
numpy
pandas

Python requirements file (файл requirements.txt в python)

При установке через pip install -r requirements.txt pip сам подберёт подходящие версии. Минусы: возможные конфликты версий при установке и отсутствие воспроизводимости без заморозки.

Как создать requirements.txt только из импортов проекта с помощью pipreqs?

Инструмент pipreqs анализирует исходный код проекта (файлы .py) и определяет, какие пакеты реально импортируются, а затем генерирует requirements.txt только для них. Это избавляет от лишних зависимостей, попавших через pip freeze.

pip install pipreqs
pipreqs /путь/к/проекту --force

Python get requirements (получение списка зависимостей requirements.txt в python)

После выполнения будет создан файл requirements.txt только с используемыми пакетами и их текущими версиями (из установленных).

Цель использования: когда нужно получить чистый список зависимостей, не содержащий тестовых или разовых пакетов. Подходит для CI/CD, когда важно минимизировать количество пакетов.

Как управлять зависимостями с помощью pip-tools (requirements.in и pip-compile)?

pip-tools предлагает двухэтапный подход: вы пишете файл requirements.in с основными зависимостями (без версий или с верхними границами), а затем команда pip-compile генерирует из него полный requirements.txt с замкнутыми подзависимостями и точными версиями.

# requirements.in
Django>=3.2,<4
requests

# Команда:
pip-compile requirements.in --output-file requirements.txt

сделать requirements python (создание requirements.txt для python)

# Результат в requirements.txt
#
# This file is autogenerated by pip-compile
# To update, run:
#    pip-compile requirements.in
#
Django==3.2.18
    # via -r requirements.in
asgiref==3.5.2
    # via django
pytz==2022.7
    # via django
requests==2.28.2
    # via -r requirements.in
certifi==2022.12.7
    # via requests
charset-normalizer==2.1.1
    # via requests
idna==3.4
    # via requests
urllib3==1.26.14
    # via requests

Python uv install (установка пакетов с помощью uv в python)

Такой подход обеспечивает полную воспроизводимость: при обновлении основных зависимостей достаточно изменить requirements.in и повторно запустить pip-compile. Также можно использовать pip-sync для приведения окружения в соответствие с requirements.txt.

Случаи использования: средние и крупные проекты, где важно контролировать версии каждой подзависимости; ситуации, когда требуется совместимость между разными окружениями (dev/staging/prod).

Как использовать Poetry для формирования requirements.txt?

Poetry - современный менеджер зависимостей, который хранит информацию в pyproject.toml и poetry.lock. Для экспорта в классический requirements.txt существует команда poetry export.

poetry export -f requirements.txt --output requirements.txt --without-hashes

Requests python versions (проверка версии библиотеки requests в python)

Эта команда создаёт requirements.txt на основе poetry.lock с точными версиями, пригодными для pip install. Флаг --without-hashes убирает хэши, что упрощает чтение файла.

Цель: если проект уже использует Poetry для управления зависимостями, но требуется совместимость с инструментами, основанными на requirements.txt (например, Docker).

Как Pipenv помогает в создании requirements.txt?

Pipenv также автоматизирует управление зависимостями через Pipfile и Pipfile.lock. Для генерации requirements.txt используется команда pipenv lock -r.

pipenv lock -r > requirements.txt

Эта команда извлекает зависимости из Pipfile.lock и выводит их в формате, совместимом с pip install -r. Обычно включаются только production-пакеты; для dev-зависимостей можно использовать --dev.

Случай использования: проекты, где уже используется Pipenv, но требуется передать окружение в среду, поддерживающую только requirements.txt.