Что такое pyenv и зачем он вам нужен?

pyenv — это простой, но мощный инструмент, который позволяет вам управлять несколькими версиями Python в вашей системе. Как разработчику Python вам часто приходится работать над разными проектами, требующими разных версий Python. Управление этими версиями вручную может оказаться затруднительным и чревато ошибками. Именно здесь на помощь приходит pyenv, позволяющий легко переключаться между версиями Python и гарантирующий, что ваши проекты всегда будут работать в правильной версии.

Зачем использовать pyenv?

• Управление версиями: легко устанавливайте различные версии Python и переключайтесь между ними.

• Изоляция проекта: убедитесь, что в каждом проекте используется правильная версия Python, чтобы избежать проблем совместимости.

• Гибкость: легко тестируйте свой код на нескольких версиях Python.

Если вы когда-либо сталкивались с проблемами, связанными с конфликтом версий, или вам приходилось работать с Python 2.x и 3.x на одном компьютере, вы оцените, насколько pyenv упрощает рабочий процесс разработки.

Интеграция pyenv с Poetry

pyenv исключительно хорошо работает с Poetry, инструментом, который управляет зависимостями и средами Python. Если вы уже знакомы с Poetry (а если нет, прочтите мою статью о начале работы с Poetry), вы обнаружите, что объединение его с pyenv дает вам еще больший контроль над вашими проектами.

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

Установка pyenv

Давайте начнем с установки pyenv. Процесс установки зависит от вашей операционной системы.

На macOS

Использование Homebrew:

brew update
brew install pyenv

Чтобы избежать их случайного связывания с Python, предоставленным Pyenv, добавьте следующую строку в конфигурацию интерактивной оболочки:

• Баш/Зш:

alias brew='env PATH="${PATH//$(pyenv root)\/shims:/}" brew'

• Рыба:

alias brew="env PATH=(string replace (pyenv root)/shims '' \"\$PATH\") brew"

В Linux

• Использование завитка:

curl https://pyenv.run | bash

После установки добавьте в файл конфигурации оболочки следующее (например, .bashrc, .zshrc):

export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

• Использование диспетчера пакетов В Arch Linux его можно установить с помощью pacman.

sudo pacman -S pyenv

добавьте команды в ~/.bashrc, выполнив в терминале следующую команду:

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

Для Zsh:

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

Для рыбы:
Если у вас Fish 3.2.0 или новее, выполните это в интерактивном режиме:

set -Ux PYENV_ROOT $HOME/.pyenv
fish_add_path $PYENV_ROOT/bin

В противном случае выполните приведенный ниже фрагмент:

set -Ux PYENV_ROOT $HOME/.pyenv
set -U fish_user_paths $PYENV_ROOT/bin $fish_user_paths

Теперь добавьте это в ~/.config/fish/config.fish:

pyenv init - | source

Более подробную информацию можно найти на GitHub.

Использование Pyenv

1) Проверка версии Python

Чтобы проверить используемую в данный момент версию Python:

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)

2) Установка версий Python

С pyenv вы можете легко установить любую версию Python:

❯ pyenv install 3.11.9

После установки версии Python ее можно установить глобально или локально для проекта

3) Установка глобальной версии Python

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

pyenv global 3.10.6 

4) Установка локальной версии Python

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

❯ pyenv local 3.8.10

❯ pyenv versions
  system
* 3.11.9 (set by /home/shanu/test_folder/.python-version)

❯ python -V
Python 3.11.9 (my global version is 3.12.5)

Чтобы отключить его, просто запустите:

❯ pyenv local --unset

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)
  3.11.9

❯ python -V
Python 3.12.5

5) Удаление версий Python

Чтобы удалить версию Python, которая больше не нужна:

pyenv uninstall 3.11.9

Заключение

Pyenv — бесценный инструмент для разработчиков Python, особенно при использовании в сочетании с Poetry. Легко управляя версиями Python, вы можете сосредоточиться на написании кода, а не беспокоиться о конфликтах версий. Попробуйте это в своем следующем проекте Python!