Descubra como gerenciar versões Python com pyenv, e como configurar no VS Code para usar a versão correta, evitando conflitos globais.

Gerenciar diferentes versões do Python em um mesmo ambiente pode ser um desafio. Este artigo apresenta o Pyenv, uma ferramenta que simplifica o gerenciamento de versões do Python, similar ao NVM para Node.js.

O que é Pyenv?

Pyenv é um gerenciador de versões do Python que permite instalar e alternar entre diferentes versões do Python de forma isolada em cada projeto, resolvendo principalmente os problemas relacionados a esse gerenciamento em uma mesma máquina.

• Permite instalar múltiplas versões do Python, incluindo distribuições como Anaconda e Miniconda.
• Possibilita isolar os pacotes de cada projeto, evitando conflitos entre dependências de diferentes versões. Isso é feito através da criação de um ambiente virtual (venv) para cada projeto, onde os pacotes são instalados localmente, sem afetar o ambiente global.
• Ajuda a evitar problemas com a versão global do Python ao permitir especificar qual versão deve ser usada em um projeto específico.
• Simplifica a ativação do ambiente virtual do projeto, garantindo que os pacotes instalados sejam usados corretamente.

Instalação e Configuração:

1. Acesse o repositório GitHub do Pyenv para obter instruções de instalação específicas para o seu sistema operacional.

2. Após a instalação, liste as versões do Python disponíveis para instalação com o comando Pyenv install --list.

3. Instale a versão desejada do Python usando o comando Penv install <versão_do_python>. Por exemplo: Pyenv install 3.9.0.

4. Especifique a versão do Python para o seu projeto com Pyenv use <versão_do_python>. Isso cria um arquivo .python-version no seu projeto, indicando a versão do Python a ser utilizada.

Isolando Pacotes com Venv:

Para evitar conflitos de pacotes entre projetos, utilize o Pyenv em conjunto com o Venv para isolar os pacotes de cada projeto.

1. Crie um ambiente virtual com o comando PV e exec Python -m venv .venv. Onde .venv é o nome da pasta que armazenará os pacotes do projeto.

2. Para ativar o ambiente virtual, execute o comando source .venv/bin/activate. O nome do ambiente virtual aparecerá no início da linha de comando, indicando que o ambiente virtual está ativo.

3. Com o ambiente virtual ativo, instale os pacotes necessários para o seu projeto. Os pacotes serão instalados dentro da pasta do ambiente virtual, sem afetar o ambiente global do sistema.

Integrando com o VS Code:

Para utilizar o Pyenv e o Venv com o VS Code, você pode configurar o Code Runner para usar a versão do Python do seu ambiente virtual.

1. Instale a extensão Code Runner no VS Code.

2. No arquivo settings.json do seu projeto, adicione a seguinte configuração para sobrescrever a configuração global do Code Runner:

{
    "code-runner.executorMap": {
        "python": ".venv/bin/python"
    }
}

O Pyenv, combinado com o Venv, oferece uma solução robusta para o gerenciamento de diferentes versões do Python e seus pacotes, evitando conflitos e garantindo a reprodutibilidade dos seus projetos.