Python
July 2018 6

Управление окружением Python c Pipenv

Tutorial

Привет, мой друг!


Предположу, что для управления Python окружением в вашем проекте до сих пор используется pip и virtualenv.


Если это так, то позвольте рассказать о таком инструменте, как Pipenv.


Pipenv — это современный инструмент для управления рабочим окружением в Python.


Основные возможности pipenv:


  • Создание и управление виртуальным окружением
  • Синхронизация пакетов в Pipfile при установке и удалении пакетов
  • Автоматическая подгрузка переменных окружения из .env файла

В качестве показательного примера сравним использование pip и virtualenv с pipenv для создания виртуального окружения:


  1. pip и virtualenv


    $ virtualenv venv
    $ source venv/bin/activte
    $ pip install Flask gunicorn
    $ pip freeze > requirements.txt

  2. pipenv


    $ pipenv install Flask gunicorn


Начало работы


Установим последнюю версию pipenv:


$ pip install pipenv

Управление рабочим окружением


Перейдем в каталог с Python проектом и создадим виртуальное окружение указав версию интерпретатор:


$ cd yourproject
$ pipenv --python 3.7

Команда автоматически создаст новое виртуальное окружение для вашего проекта, если он еще не существует.


Активировать виртуальное окружение проекта можно выполнив команду shell:


$ pipenv shell

Выход из оболочки виртуального окружения осуществляется с помощью команды exit:


$ exit

Управление зависимостями приложения


Для установки пакетов воспользуемся командой install:


$ pipenv install Flask

Pipenv установит последнюю версию пакета Flask и автоматически добавит его в Pipfile.


При установке можем задать конкретную версию пакета:


$ pipenv install Flask==1.0.2

Разработчики данного инструмента позаботились и о работе со средой разработки — пакетами, которые необходимы на этапе сборки или тестирования приложений.


При указании флага --dev, пакет будет установлен как часть среды разработки:


$ pipenv install pytest --dev

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


$ pipenv install --dev

Для удаление пакетов существует команда uninstall:


$ pipenv uninstall Flask

Сведения об установленных пакетах и их зависимостях хранятся в файле Pipfile.lock, который генерируется автоматически и не должен быть изменен пользователем.


Запуск исходного кода


Существует возможность запуска исходного кода внутри оболочки virtualenv:


$ pipenv run python yourapplication.py

При наличии файла .env команды $ pipenv shell и $ pipenv run, автоматически подгрузят из него переменные окружения:


$ cat .env
DEBUG=1

$ echo $DEBUG
1

Развертывание приложения


Pipenv позволяет устанавливать зависимости в родительскую систему при указании флага --system:


$ pipenv install --system

Это полезно при развертывания приложений в Docker.


При указании флага --deploy — pipenv выдаст ошибку, если Pipfile.lock устарел или версия Python не соответсвует указанной.


Пример Dockerfile для работы с pipenv:


FROM python:3.7

RUN pip3 install pipenv

WORKDIR /usr/src/app

COPY Pipfile ./
COPY Pipfile.lock ./

RUN set -ex && pipenv install --deploy --system

COPY . .

Пример приложения на Flask с использованием возможностей Pipenv: github.com/fdhadzh/flask-pipenv-example.


+13
30.5k 118
Comments 35
Top of the day