Aprenda a criar um ambiente virtual Python

Um ambiente virtual Python é uma ferramenta que permite criar um espaço isolado para desenvolver projetos em Python. Cada ambiente virtual tem sua própria instalação do interpretador Python, além de seus próprios pacotes e dependências. Isso significa que você pode ter diferentes versões de pacotes e bibliotecas instaladas para diferentes projetos, evitando conflitos e problemas de compatibilidade.

As principais vantagens em criar um ambiente virtual Python incluem:

1. Isolamento de Projetos: Cada projeto pode ter suas próprias dependências, evitando que alterações em um projeto afetem outros.
2. Facilidade de Gerenciamento: Você pode instalar, atualizar ou remover pacotes em um ambiente virtual sem interferir em outras instalações do Python no sistema.
3. Ambientes Reproduzíveis: É possível criar um ambiente que replica exatamente as versões de pacotes e dependências necessárias para um projeto, facilitando a colaboração com outras pessoas e a implantação em servidores.
4. Evita Poluição do Sistema: Com ambientes virtuais, você não precisa instalar pacotes globalmente, o que mantém o sistema mais limpo e organizado.

Portanto, criar um ambiente virtual Python sempre será uma boa prática para quem trabalha com múltiplos projetos em Python ou até mesmo para quem está iniciando na programação. O Python é uma linguagem poderosa e versátil, utilizada em diversos sistemas operacionais, incluindo Linux, macOS e Windows.

Agora que você compreende a importância de utilizar ambientes virtuais para proteger seus projetos e o sistema operacional, é hora de dar o primeiro passo para criar um ambiente virtual Python corretamente. Embora o Python já venha pré-instalado na maioria dos sistemas que serão citados nesse post, pode ser necessário ajustar algumas configurações ou até mesmo atualizar para uma versão mais recente. A seguir, vamos explicar o processo de instalação, garantindo que você esteja pronto para criar e gerenciar seus ambientes virtuais de forma segura e eficiente. Juntamente com o tutorial a seguir, criarei também um ambiente virtual Python para futuros projetos do blog Tecnosob, atualmente estou usando o sistema Linux.

Passo 1: Navegando para o diretório do projeto

Para criar um ambiente virtual Python, o primeiro passo é garantir que você está no diretório correto onde deseja configurar o seu projeto. Isso é importante porque o ambiente virtual Python será criado dentro do diretório de trabalho atual, isolando as dependências específicas para esse projeto.

Abra o terminal ou prompt de comando no seu sistema. Para criar um ambiente virtual Python, você deve usar o comando cd para navegar até o diretório desejado. Por exemplo:

cd /caminho/para/seu/ambiente/virtual

Caso o diretório ainda não exista, você pode criá-lo diretamente no terminal, digitando o comando:

mkdir /caminho/para/seu/ambiente/virtual
cd /caminho/para/seu/ambiente/virtual

No meu caso decidi criar um diretório com o nome de tecnosob:

Depois, mudei para o diretório tecnosob que acabei de criar utilizando o comando cd (change directory):

Passo 2: Verificando a instalação do Python

Ainda no terminal ou prompt de comando, verifique se o Python está instalado e qual versão você possui com o seguinte comando:

python3 --version

Você verá algo como Python 3.x.x. Certifique-se de que você está usando o Python 3, já que o suporte para o Python 2 foi descontinuado.

Aqui no meu sistema, a saída do comando python3 --version é apresentada da seguinte maneira:

Passo 3: Instalando o Python 3 (caso não esteja instalado)

No Linux

Como existem várias distribuições Linux disponíveis atualmente, escolhi três grandes distribuições para incluir nesse tutorial, Arch Linux, Debian e Fedora.

Distribuições baseadas no Debian/Ubuntu:

sudo apt update
sudo apt upgrade
sudo apt install python3

Distribuições baseadas no Fedora/Red Hat:

sudo dnf upgrade
sudo dnf install python3

Distribuições baseadas no Arch Linux:

sudo pacman -Syu
sudo pacman -S python

No macOs

Para o macOS basta usar o Homebrew:

brew install python

No Windows

Baixe o instalador do site oficial do Python e siga as instruções.

Passo 4: Instalando o venv (caso não esteja instalado)

O módulo venv é necessário para criar um ambiente virtual Python. Ele normalmente já vem incluído junto com o Python 3, mas se não estiver, veja como instalá-lo:

No Linux

Distribuições baseadas no Debian/Ubuntu:

sudo apt install python3-venv

Distribuições baseadas no Fedora/Red Hat:

sudo dnf install python3-venv

Distribuições baseadas no Arch Linux:

O venv já vem incluso com o pacote Python no Arch Linux, então não é necessário instalar separadamente.

No macOs e Windows

O venv já está incluído na instalação padrão do Python 3.

Passo 5: Criando o Ambiente Virtual Python

Agora que o Python 3 e o venv estão instalados, e considerando que você já concluiu o Passo 1 deste tutorial, estando no diretório onde deseja criar o ambiente virtual, você pode criar o ambiente virtual Python com o seguinte comando:

python3 -m venv nome_do_ambiente_virtual_python

Por exemplo, vamos criar um ambiente virtual Python chamado “meu_projeto”.Para isso, basta digitar o comando abaixo (certifique-se que já está no diretório desejado):

python3 -m venv meu_projeto

Isso criará uma pasta chamada meu_projeto dentro do diretório do projeto, onde todas as dependências específicas do projeto são armazenadas.

Juntamente com este tutorial, também criei um ambiente virtual Python com o comando: python -m venv meu_projeto, mas observe que eu já tinha mudado para o diretório desejado antes de executar o comando:

Após criar o ambiente virtual, digite ls no terminal. Você verá que existe um novo diretório com o nome meu_projeto. Neste diretório estão todos os arquivos que compõe o ambiente virtual Python. Ou seja, agora temos uma instalação do Python totalmente independente e isolada para desenvolvermos nossos projetos, podendo instalar novos módulos de acordo com a necessidade dos programas a serem desenvolvidos.

Passo 6: Ativando o ambiente virtual Python

Para começar a trabalhar no ambiente virtual Python, você precisa ativá-lo. considerando que você já está no diretório onde o ambiente virtual Python foi criado, para ativá-lo use um dos comandos abaixo de acordo com seu sistema.

No Linux e macOS

source /meu_projeto/bin/activate

No Windows

meu_projeto\Scripts\activate

Após a ativação, você verá o nome do ambiente virtual Python entre parênteses no início da linha do terminal, por exemplo:

(meu_projeto) usuario@linux:~/caminho/para/seu/projeto$

Isso significa que o ambiente virtual Python está ativo.

Para ativar aqui no meu sistema, simplesmente digitei o comando abaixo, já que eu estava dentro do diretório do projeto:

Após a ativação do ambiente virtual, aparecerá do lado esquerdo do prompt o nome do mesmo indicando que você está “dentro” do ambiente virtual Python. Observe que desta vez eu tive que digitar o caminho absoluto, pois não estava dentro do diretório do projeto.

A partir deste momento, podemos usar normalmente o comando python3 para executarmos algum programa escrito em Python:

python3 meu_programa.py

Passo 8: Executando um programa Python sem ativar o ambiente virtual

Você também pode executar um programa escrito em Python sem que faça a ativação do ambiente virtual, isso é muito útil por exemplo, para criarmos arquivos .desktop, responsáveis pela integração dos programas criados com menu do sistema operacional, ou para executá-los através de outros scripts. Para isso, precisamos saber qual é o caminho absoluto do executável do Python que foi instalado no ambiente virtual, conseguimos essa informação da seguinte forma:

No Linux e macOS

Com o ambiente virtual Python ativo, digite:

which python

No Windows

Com o ambiente virtual Python ativo, digite:

where python

Ao executar comando acima, de acordo com o seu sistema, será exibido o caminho completo do executável Python.

Por exemplo, aqui no meu sistema, a saída do comando which python apresenta o seguinte caminho:

Com essa informação, você pode agora executar programas Python sem a necessidade de fazer a ativação do ambiente virtual. Ao invés de digitar no terminal python3 programa.py para executar um arquivo escrito em Python, você digitará: /caminho/absoluto/meu_projeto/bin/python programa.py. Logo, para o meu caso, se eu quiser executar algum programa Python que eu esteja desenvolvendo, posso usar o caminho completo da saída do comando which python seguido do nome do arquivo.py. Veja abaixo o comando:

/home/sob/tecnosob/meu_projeto/bin/python /caminho/para/arquivo.py

Passo 7: Instalando pacotes com pip

Uma vez que o ambiente virtual Python está ativado, você pode começar a instalar pacotes necessários para o seu projeto usando o pip. Mas o que é exatamente o pip?

O pip é o gerenciador de pacotes do Python. Ele permite que você instale, atualize e remova bibliotecas e módulos de terceiros que não estão incluídos na instalação padrão do Python. Essas bibliotecas podem fornecer funcionalidades adicionais, como acessar APIs, lidar com bancos de dados, processar dados, entre outras. Um dos grandes benefícios de usar o pip dentro de um ambiente virtual é que ele isola essas bibliotecas dentro do diretório do ambiente, sem afetar as bibliotecas globais instaladas no sistema. Isso ajuda a evitar conflitos entre diferentes projetos, que podem exigir versões diferentes de uma mesma biblioteca.

Por exemplo, suponha que você esteja desenvolvendo um projeto que requer a biblioteca requests, amplamente utilizada para fazer requisições HTTP. Para instalar essa biblioteca no seu ambiente virtual, basta executar:

pip install requests

Cada projeto pode exigir um conjunto específico de bibliotecas, e o uso de um ambiente virtual Python garante que essas dependências não interfiram umas nas outras. Assim, se um projeto exige a versão 1.0 de uma biblioteca e outro projeto exige a versão 2.0 da mesma biblioteca, você pode gerenciar essas versões separadamente, sem causar conflitos.

Lembre-se de que, ao instalar qualquer biblioteca, você está adicionando uma funcionalidade ao projeto em que está trabalhando, e o ambiente virtual Python garante que isso seja feito de forma organizada e segura.

Se desejar mais informações sobre o pip, por favor acesse o nosso post: Guia prático: Guia prático: Como usar o pip em ambientes virtuais Python .

Passo 8: Desativando o ambiente virtual Python

Quando terminar de desenvolver seus projetos, desative o ambiente virtual com o comando:

deactivate

O terminal voltará ao seu estado normal, onde o Python global do sistema é utilizado.

Passo 9: Reativando o ambiente virtual Python

Sempre que você quiser voltar a trabalhar no projeto, navegue até o diretório do projeto e ative o ambiente virtual normalmente:

No Linux e macOS

source meu_projeto/bin/activate

Ou se preferir ativar sem que tenha que navegar até o diretório do projeto, use o caminho absoluto do ambiente virtual Python:

source /caminho/absoluto/meu_projeto/bin/activate

No Windows

No prompt de comando, navegue até o diretório onde foi criado o ambiente virtual Python e digite o comando:

meu_projeto\Scripts\activate

Conclusão

A criação de um ambiente virtual Python é uma prática essencial para qualquer desenvolvedor que busca eficiência e segurança em seus projetos. Ao adotar essa abordagem, você não apenas protege o seu sistema operacional de potenciais conflitos de pacotes, mas também garante que cada projeto tenha o ambiente ideal.

Agora que você está ciente das etapas necessárias para configurar seu ambiente virtual Python, está pronto para embarcar em um novo nível de desenvolvimento. A flexibilidade e o controle proporcionados por ambientes virtuais permitirão que você experimente, aprenda e crie sem medo de comprometer seu sistema. Lembre-se: um ambiente virtual bem gerido é a chave para um fluxo de trabalho mais organizado e produtivo.

Sobre o Autor

Eduardo Moura

https://tecnosob.com/about/