Как настроить файл requirements.txt для нескольких сред?

У меня два филиала: разработка и производство. У каждого есть зависимости, некоторые из которых различны. Разработка указывает на зависимости, которые сами находятся в разработке. То же самое и с производством. Мне нужно выполнить развертывание в Heroku, который ожидает зависимости каждой ветки в одном файле с именем «requirements.txt».

Как лучше всего организовать?

Что я подумал:

• Поддерживайте отдельные файлы требований, по одному в каждой ветке (должны выдерживать частые слияния!)
• Скажите Heroku, какой файл требований я хочу использовать (переменная среды?)
• Написание сценариев развертывания (создание временной ветки, изменение файла требований, фиксация, развертывание, удаление временной ветки)

Вы можете каскадировать файлы требований и использовать флаг «-r», чтобы указать pip, что нужно включить содержимое одного файла в другой. Вы можете разбить свои требования на модульную иерархию папок следующим образом:

`-- django_project_root
|-- requirements
|   |-- common.txt
|   |-- dev.txt
|   `-- prod.txt
`-- requirements.txt

Содержимое файлов будет выглядеть так:

common.txt:

# Contains requirements common to all environments
req1==1.0
req2==1.0
req3==1.0
...

dev.txt:

# Specifies only dev-specific requirements
# But imports the common ones too
-r common.txt
dev_req==1.0
...

prod.txt:

# Same for prod...
-r common.txt
prod_req==1.0
...

За пределами Heroku теперь вы можете настроить такие среды, как это:

pip install -r requirements/dev.txt

или

pip install -r requirements/prod.txt

Поскольку Heroku специально ищет "requirements.txt" в корне проекта, он должен просто отражать prod, например:

requirements.txt:

# Mirrors prod
-r requirements/prod.txt

На сегодняшний день жизнеспособный вариант, которого не существовало, когда были опубликованы исходный вопрос и ответ, - это использовать pipenv вместо pip для управления зависимостями.

С помощью pipenv ручное управление двумя отдельными файлами требований, например с помощью pip, больше не требуется, и вместо этого pipenv управляет самими пакетами разработки и производства посредством взаимодействия в командной строке.

Чтобы установить пакет для использования в производстве и разработке:

pipenv install <package>

Чтобы установить пакет только для среды разработки:

pipenv install <package> --dev

С помощью этих команд pipenv сохраняет конфигурацию среды и управляет ею в двух файлах (Pipfile и Pipfile.lock). Текущий пакет сборки Python от Heroku изначально поддерживает pipenv и будет настраивать себя из Pipfile.lock, если он существует, вместо файла requirements.txt.

См. Ссылку pipenv для получения полной документации по инструменту.

Если вы хотите иметь возможность переключаться между средами на одном компьютере, может потребоваться создать разные папки virtualenv для каждой среды, на которую необходимо переключиться.

python3 -m venv venv_dev
source venv_dev/bin/activate
pip install -r pip/common.txt
pip install -r pip/dev.txt
exit
python3 -m venv venv_prod
source venv_prod/bin/activate
pip install -r pip/common.txt
exit
source venv_dev/bin/activate
# now we are in dev environment so your code editor and build systems will work.

# let's install a new dev package:
# pip install awesome
# pip freeze -r pip/temp.txt
# find that package, put it into pip/dev.txt
# rm pip/temp.txt

# pretty cumbersome, but it works.