O que é pyenv e por que você precisa dele?

pyenv é uma ferramenta simples, mas poderosa, que permite gerenciar várias versões do Python em seu sistema. Como desenvolvedor Python, muitas vezes você precisa trabalhar em diferentes projetos que exigem diferentes versões do Python. O gerenciamento manual dessas versões pode ser complicado e sujeito a erros. É aqui que entra o pyenv, facilitando a alternância entre versões do Python, garantindo que seus projetos estejam sempre rodando na versão correta.

Por que usar o pyenv?

• Gerenciamento de versões: instale e alterne entre diferentes versões do Python sem esforço.

• Isolamento do projeto: certifique-se de que cada projeto use a versão correta do Python, evitando problemas de compatibilidade.

• Flexibilidade: teste facilmente seu código em várias versões do Python.

Se você já enfrentou problemas com conflitos de versão ou teve que trabalhar com Python 2.xe 3.x na mesma máquina, você apreciará como o pyenv simplifica seu fluxo de trabalho de desenvolvimento.

Integrando pyenv com Poesia

pyenv funciona excepcionalmente bem com Poetry, uma ferramenta que gerencia dependências e ambientes Python. Se você já está familiarizado com Poesia (e se não estiver, confira meu artigo sobre como começar com Poesia), você descobrirá que combiná-lo com pyenv lhe dá ainda mais controle sobre seus projetos.

Quando você cria um novo projeto com Poetry, ele usa automaticamente a versão Python que pyenv definiu para o diretório. Isso garante que as dependências do seu projeto sejam gerenciadas em um ambiente que atenda aos requisitos do seu projeto.

Instalando o pyenv

Vamos começar instalando o pyenv. O processo de instalação varia dependendo do seu sistema operacional.

No macOS

Usando Homebrew:

brew update
brew install pyenv

Para evitar que eles sejam vinculados acidentalmente a um Python fornecido pelo Pyenv, adicione a seguinte linha na configuração do seu shell interativo:

• Bash/Zsh:

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

• Peixe:

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

No Linux

• Usando curvatura:

curl https://pyenv.run | bash

Após a instalação, adicione o seguinte ao seu arquivo de configuração do shell (por exemplo, .bashrc, .zshrc):

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

• Usando o Gerenciador de Pacotes No Arch Linux pode ser instalado com a ajuda do pacman

sudo pacman -S pyenv

adicione os comandos a ~/.bashrc executando o seguinte em seu terminal:

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

Para 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

Para peixes:
Se você tiver o Fish 3.2.0 ou mais recente, execute isto de forma interativa:

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

Caso contrário, execute o snippet abaixo:

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

Agora, adicione isto a ~/.config/fish/config.fish:

pyenv init - | source

Para mais detalhes, confira o GitHub.

Usando Pyenv

1) Verificando a versão do Python

Para verificar a versão do Python atualmente em uso:

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

2) Instalando versões do Python

Com pyenv, você pode instalar qualquer versão do Python facilmente:

❯ pyenv install 3.11.9

Depois de instalar uma versão python, ela pode ser configurada global ou localmente para um projeto

3) Configurando a versão global do Python

Não recomendado, pode causar problemas no seu sistema
Você pode definir uma versão global do Python que será usada por padrão em seu sistema:

pyenv global 3.10.6 

4) Configurando a versão local do Python

Você também pode definir uma versão local do Python para um diretório de projeto específico. Esta versão substituirá a versão global quando você estiver nesse diretório:

❯ 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)

Para desativá-lo, basta executar:

❯ pyenv local --unset

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

❯ python -V
Python 3.12.5

5) Desinstalando versões do Python

Para desinstalar uma versão do Python que não é mais necessária:

pyenv uninstall 3.11.9

Conclusão

Pyenv é uma ferramenta inestimável para desenvolvedores Python, especialmente quando usado em conjunto com Poesia. Ao gerenciar versões do Python sem esforço, ele permite que você se concentre em escrever código em vez de se preocupar com conflitos de versão. Experimente em seu próximo projeto Python!