O Pyenv é uma ferramenta utilizada para gerenciar múltiplas instalações do interpretador Python no mesmo sistema.

Com o pyenv, você pode facilmente instalar diferentes versões do Python e alternar entre elas conforme necessário em um ambiente de desenvolvimento.

Isso é útil quando você precisa trabalhar em diferentes projetos que podem exigir versões específicas do Python ou quando precisa testar seu código em diferentes ambientes Python.

Além disso, o pyenv permite instalar e usar diferentes versões do Python em um nível de usuário, sem a necessidade de privilégios de superusuário (root), o que é útil quando você está trabalhando em sistemas onde não tem permissões de administração.

O pyenv também pode ser combinado com outras ferramentas, como o poetry, PDM, pipenv ou o virtualenv, para gerenciar não apenas as versões do Python, mas também as dependências dos projetos de forma isolada e organizada.

Instalação

Repositórios

Arch Linux

sudo pacman -S \
pyenv

openSUSE Tumbleweed

sudo zypper install \
pyenv

macOS

brew install pyenv

Instalador oficial do pyenv

Para realizar a instalação através do instalado oficial do pyenv, abra um terminal e digite o comando:

curl https://pyenv.run | bash

Após a instalação abra o arquivo .bashrc e adicione:

export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)" 

Para recarregar o arquivo .bashrc utilize o comando:

source ~/.bashrc

Utilizando o pyenv

Verificando as versões do Python

Para verificar todas as versões da linguagem de programação Python que estão disponíveis utilize o comando:

pyenv install -l

Instalando o Python

Após definir a versão da linguagem de programação Python que será instalada execute no terminal:

pyenv install 3.12.1

📝 Para instalar outras versões adapte o comando. Exemplo: pyenv install 3.11.7.

📝 Também é possível instalar mais de uma versão em um único comando. Exemplo: pyenv install 3.11.7 3.12.1.

🚨 Para a instalação da linguagem de programação Python, o pyenv realiza o download e compilação da linguagem, caso seja exibido algum erro, veja a seção extra onde são listadas possíveis dependências.

Definindo a versão global

Para trocar entre as versões da linguagem de programação Python que estão instaladas no sistema operacional utilize o comando:

pyenv global 3.12.1

Já para verificar qual é versão da linguagem de programação Python está sendo utilizada pelo sistema operacional:

pyenv version

Removendo uma versão

Antes de realizar a remoção de uma versão da linguagem de programação Python do sistema operacional devemos verificar todas as versões que estão instaladas, isso é feito através do comando:

pyenv versions

Em seguida para realizar a remoção utilize o comando:

pyenv uninstall 3.12.1

Conclusão

O pyenv é uma ferramenta excelente para quem precisa utilizar mais de uma versão da linguagem de programação Python no sistema operacional (Linux, macOS e Windows).

A sua utilização juntamente com um ambiente virtual (venv, PDM, Poetry, Pipenv, etc), torna o desenvolvimento com a linguagem de programação Python muito mais simples e intuitivo.

Extra

ChromeOS

Para que o pyenv consiga realizar a compilação da linguagem de programação Python no ChromeOS as seguintes dependências devem estar instaladas:

sudo apt install \
build-essential \
curl \
libbz2-dev \
libffi-dev \
liblzma-dev \
libncursesw5-dev \
libreadline-dev \
libsqlite3-dev \
libssl-dev \
libxml2-dev \
libxmlsec1-dev \
llvm \
make \
tk-dev \
wget \
xz-utils \
zlib1g-dev

Após a instalação das dependências é possível utilizar o pyenv sem problemas no ChromeOS 😊.