Управление несколькими версиями Python с помощью pyenv

«Системный Python» - это Python, который устанавливается в вашей операционной системе. Если у вас Mac или Linux, то по умолчанию, когда вы набираетеpython в своем терминале, вы получаете хороший Python REPL.

Так почему бы не использовать его? Один из способов взглянуть на это состоит в том, что этот Python действительноbelongs для операционной системы. В конце концов, он был установлен с операционной системой. Это даже отражается, когда вы запускаетеwhich:

Здесьpython доступен всем пользователям, о чем свидетельствует его местоположение/usr/bin/python. Скорее всего, это не та версия Python, которую вы хотите:

Чтобы установить пакет в Python в вашей системе, вы должны запуститьsudo pip install. Это потому, что вы устанавливаете пакет Python глобально, что является реальной проблемой, если другой пользователь приходит и хочет установить немного более старую версию пакета.

Проблемы с несколькими версиями одного и того же пакета, как правило, наполняют вас и кусают, когда вы меньше всего этого ожидаете. Один из распространенных способов решения этой проблемы - это популярный и стабильный пакет, который в своей системе неожиданно работает некорректно. После нескольких часов поиска и устранения неисправностей и поиска в Google вы можете обнаружить, что установили неправильную версию зависимости, и это разрушает ваш день.

Даже если ваша версия Python установлена ​​в/usr/local/bin/python3, вы все равно в опасности. Вы столкнетесь с теми же проблемами с разрешениями и гибкостью, которые описаны выше.

Кроме того, вы не очень контролируете, какая версия Python установлена ​​в вашей ОС. Если вы хотите использовать новейшие функции Python и, например, используете Ubuntu, вам просто не повезло. Версии по умолчанию могут быть слишком старыми, что означает, что вам просто нужно дождаться выхода новой ОС.

Наконец, некоторые операционные системы фактически используют упакованный Python для работы. Возьмем, к примеру,yum, который интенсивно использует Python для выполнения своей работы. Если вы устанавливаете новую версию Python и не будете осторожны при установке ее в свое пространство пользователя, вы можете серьезно повредить вашей способности использовать вашу ОС.

Следующее логичное место для поиска - менеджеры пакетов. Такие программы, какapt,yum,brew илиport, являются типичными следующими вариантами. В конце концов, именно так вы устанавливаете большинство пакетов в свою систему. К сожалению, вы столкнетесь с такими же проблемами, используя менеджер пакетов.

По умолчанию менеджеры пакетов обычно устанавливают свои пакеты в глобальное системное пространство, а не в пользовательское пространство. Опять же, эти пакеты системного уровня загрязняют вашу среду разработки и затрудняют совместное использование рабочего пространства с другими.

Еще раз, вы все еще не можете контролировать, какую версию Python вы можете установить. Это правда, что некоторые репозитории дают вам больший выбор, но по умолчанию вы смотрите на любую версию Python, на которой работает ваш конкретный поставщик, в любой конкретный день.

Даже если вы устанавливаете Python из менеджера пакетов, подумайте, что произойдет, если вы пишете пакет и хотите поддерживать и тестировать на Python 3.4 - 3.7.

Что произойдет в вашей системе, если вы введетеpython3? Как бы вы быстро переключались между разными версиями? Вы, конечно, можете это сделать, но это утомительно и подвержено ошибкам. Не берите в голову тот факт, что если вы хотите PyPy, Jython или Miniconda, то вам, вероятно, просто не повезло с вашим менеджером пакетов.

Имея в виду эти ограничения, давайте вспомним критерии, которые позволят вам легко и гибко устанавливать и управлять версиями Python:

pyenv позволяет делать все это и многое другое.

pyenv собирает Python из исходного кода, а это значит, что вам потребуются зависимости сборки для фактического использованияpyenv. Зависимости сборки зависят от платформы. Если вы используетеUbuntu/Debian и хотите установить зависимости сборки, вы можете использовать следующее:

Это используетApt для установки всех зависимостей сборки. Пусть это запустится, и вы будете готовы перейти на системы Debian.

Если вы используетеFedora/CentOS/RHEL, вы можете использоватьyum для установки зависимостей сборки:

Эта команда установит все зависимости сборки для Python с использованиемyum.

ПользователиmacOS могут использовать следующую команду:

Эта команда используетHomebrew и устанавливает несколько зависимостей для пользователей macOS.

Tip: При запуске Mojave или более поздней версии (10.14+) вам также потребуется установитьadditional SDK headers:

Спасибо Родриго Виере за обновление.

Если вы вместо этого используетеopenSUSE, вы должны выполнить следующее:

Еще раз, эта команда устанавливает все зависимости сборки Python для вашей системы.

Наконец, для пользователейAlpine вы можете использовать это:

Эта команда используетapk в качестве диспетчера пакетов и устанавливает все зависимости сборки для Python на Alpine.

После того, как вы установили зависимости сборки, вы готовы к установке самогоpyenv. Я рекомендую использоватьpyenv-installer project:

Это установитpyenv вместе с несколькими полезными плагинами:

Note: Приведенная выше команда аналогична загрузкеpyenv-installer script и его локальному запуску. Поэтому, если вы хотите точно увидеть, что у вас работает, вы можете просмотреть файл самостоятельно. Кроме того, если вы действительно не хотите запускать скрипт, вы можете проверитьmanual installation instructions.

В конце прогона вы должны увидеть что-то вроде этого:

Вывод будет основан на вашей оболочке. Но вы должны следовать инструкциям, чтобы добавитьpyenv к вашему пути и инициализировать автозаполнениеpyenv /pyenv-virtualenv. После того, как вы это сделали, вам нужно перезагрузить вашу оболочку:

Это оно. Теперь у вас установленыpyenv и четыре полезных плагина.

Как упоминалось ранее,pyenv работает путем сборки Python из исходного кода. Каждая установленная вами версия удобно расположена в корневом каталогеpyenv:

Все ваши версии будут расположены здесь. Это удобно, потому что удаление этих версий тривиально:

Конечно,pyenv также предоставляет команду для удаления определенной версии Python:

Теперь, когда вы установили несколько разных версий Python, давайте посмотрим, как их использовать. Сначала проверьте, какие версии Python у вас есть:

* указывает, что версия Pythonsystem активна в настоящее время. Вы также заметите, что это устанавливается файлом в корневом каталогеpyenv. Это означает, что по умолчанию вы все еще используете системный Python:

Если вы попытаетесь подтвердить это с помощьюwhich, вы увидите следующее:

Это может быть удивительно, но так работаетpyenv. pyenv вставляется в вашPATH и с точки зрения вашей ОСis вызывается исполняемый файл. Если вы хотите увидеть фактический путь, вы можете выполнить следующее:

Если, например, вы хотели использовать версию 2.7.15, вы можете использовать командуglobal:

Pro Tip: Отличный способ убедиться в том, что только что установленная версия Python работает правильно, - это запустить встроенный набор тестов:

Это запустит множество внутренних тестов Python, которые проверит вашу установку. Вы можете просто откинуться назад и посмотреть, как пройдут тесты.

Если вы когда-нибудь захотите вернуться к системной версии Python по умолчанию, вы можете запустить это:

Теперь вы можете легко переключаться между различными версиями Python. Это только начало. Если у вас есть много версий, между которыми вы хотите переключаться, последовательный ввод этих команд утомителен. В этом разделе рассматриваются основы, но лучший рабочий процесс описан вworking with multiple environments.

Вы уже видели командуinstall выше. Эта команда может использоваться для установки определенной версии Python. Например, если вы хотите установить3.6.8, вы должны использовать это:

Вывод показывает, чтоpyenv загружает и устанавливает Python. Вот некоторые из распространенных флагов, которые вы можете использовать:

Командаversions отображает все установленные на данный момент версии Python:

Этот вывод показывает не только то, что2.7.15,3.6.8,3.8-dev и ваш Pythonsystem установлены, но также показывает, что Pythonsystem активен. Если вы заботитесь только о текущей активной версии, вы можете использовать следующую команду:

Эта команда похожа наversions, но показывает только текущую активную версию Python.

Командаwhich полезна для определения полного пути к системному исполняемому файлу. Посколькуpyenv работает с использованием прокладок, эта команда позволяет вам увидеть полный путь к исполняемому файлуpyenv. Например, если вы хотите увидеть, где установленpip, вы можете запустить это:

В выходных данных отображается полный системный путь дляpip. Это может быть полезно, если вы установили приложения командной строки.

Командаglobal устанавливает глобальную версию Python. Это может быть переопределено другими командами, но полезно для гарантии того, что вы используете определенную версию Python по умолчанию. Если вы хотите использовать3.6.8 по умолчанию, вы можете запустить это:

Эта команда устанавливает~/.pyenv/version на3.6.8. Дополнительные сведения см. В разделеspecifying your Python version.

Командаlocal часто используется для установки версии Python для конкретного приложения. Вы можете использовать его, чтобы установить версию на2.7.15:

Эта команда создает файл.python-version в вашем текущем каталоге. Если в вашей среде активенpyenv, этот файл автоматически активирует эту версию для вас.

Командаshell используется для установки версии Python для конкретной оболочки. Например, если вы хотите протестировать версию Python3.8-dev, вы можете сделать это:

Эта команда активирует версию, указанную путем установки переменной средыPYENV_VERSION. Эта команда перезаписывает любые приложения или глобальные настройки, которые у вас могут быть. Если вы хотите деактивировать версию, вы можете использовать флаг--unset.

Создание виртуальной среды - это одна команда:

Технически<python_version> не является обязательным, но вы должны всегда указывать его, чтобы быть уверенным в том, какую версию Python вы используете.

<environment_name> - это просто название, которое помогает разделить среду. Хорошей практикой является присвоение вашей среде того же имени, что и ваш проект. Например, если вы работали надmyproject и хотели разработать против Python 3.6.8, вы должны запустить это:

Вывод включает сообщения, которые показывают установку пары дополнительных пакетов Python, а именноwheel,pip иsetuptools. Это сделано исключительно для удобства и просто устанавливает более полнофункциональную среду для каждой из ваших виртуальных сред.

Теперь, когда вы создали свою виртуальную среду, ее использование - следующий шаг. Обычно вы должны активировать свою среду, выполнив следующее:

Вы уже видели командуpyenv local, но на этот раз вместо указания версии Python вы указываете среду. Это создает файл.python-version в вашем текущем рабочем каталоге, и поскольку вы запускалиeval "$(pyenv virtualenv-init -)" в своей среде, среда будет автоматически активирована.

Вы можете убедиться в этом, выполнив следующее:

Вы можете видеть, что была создана новая версия с именемmyproject, и исполняемый файлpython указывает на эту версию. Если вы посмотрите на любой исполняемый файл, который предоставляет эта среда, вы увидите то же самое. Возьмем, например,pip:

Если вы не настроилиeval "$(pyenv virtualenv-init -)" для запуска в своей оболочке, вы можете вручную активировать / деактивировать свои версии Python следующим образом:

Вышеупомянутое - это то, что делаетpyenv-virtualenv, когда он входит в каталог с файлом.python-version или выходит из него.