Iniciando o ambiente com as dependências
Resumindo, para criar um ambiente isolado para trabalhar com um projeto com as dependências definidas, basta seguir os passos:
Criar o novo ambiente:
virtualenv ENV
Acessar o diretório do ambiente:
cd ENV
Copiar o projeto para o diretório do ambiente, incluindo o arquivo requirements.txt
;
Ativar o ambiente:
bin/activate
Instalar as dependências do projeto:
pip install -r requirements.txt
Trabalhar com o projeto, com todas as dependências instaladas no ambiente isolado;
Ao finalizar, desativar o ambiente:
deactivate
Segue abaixo uma descrição mais detalhada de como funciona o virtualenv
e os principais comandos para se trabalhar com um projeto em um ambiente isolado.
Instalação
Utilizando o PIP, a instalação do VirtualEnv pode ser feita com um simples comando:
pip install virtualenv
Se instalado com sucesso, uma mensagem semelhante aparecerá:
Successfully installed virtualenv-15.1.0
Criação do ambiente
Para criar um ambiente isolado com o virtualenv
, basta executar o comando:
virtualenv ENV
Sendo ENV
o nome do ambiente a ser criado.
No Windows, o comando é levemente alterado para virtualenv.exe ENV
.
O resultado deste comando será um diretório de nome ENV
no caminho atual, contendo as seguintes pastas:
bin/
include/
lib/
No Windows, será:
Include/
Lib/
Scripts/
Os diretórios lib
e include
armazenarão as bibliotecas instaladas no ambiente, enquanto o diretório bin
armazena os executáveis que controlam o ambiente. No Windows, os diretórios Lib
e Include
são os equivalentes aos lib
e include
, respectivamente, enquanto o diretório Scripts
é equivalente ao bin
. As bibliotecas pip
e setuptools
já serão instaladas por padrão no ambiente criado.
Instalando pacotes
Para adicionar os pacotes ao novo ambiente, é necessário fazer a instalação a partir do pip
do ambiente e não mais do original do computador. O executável do pip
do ambiente se encontra no diretório bin
, portanto, para instalar um pacote, Django, por exemplo, é necessário fazer:
bin/pip install django
Ou, no Windows:
Scripts/pip install django
Ativando o ambiente
Para evitar qualquer confusão entre o ambiente global, o próprio computador, e o ambiente isolado criado, é possível ativar o ambiente através do comando:
source bin/activate
Ou, no Windows:
Scripts/activate.bat
Este comando altera o valor da variável de ambiente $PATH
para o diretório bin
ou Scripts
, no Windows. Desta forma, se o ambiente estiver ativado, para instalar um pacote, basta executar o comando padrão:
pip install django
Se executado tudo corretamente, apareceria uma mensagem dizendo que o pacote Django já está instalado, pois instalamo-o através do Scripts/pip
.
É importante, ao terminar o trabalho no ambiente isolado que foi ativado, que o mesmo seja desativado para que seja restaurado o valor da variável de ambiente $PATH
. Para isso, basta executar o comando:
deactivate
Ou, no Windows:
deactivate.bat
Dependências do projeto
Com o ambiente isolado ativado, é possível gerar o arquivo de dependências a partir do comando:
pip freeze > requirements.txt
O resultado deste comando será o arquivo requirements.txt
com a descrição das dependências do projeto. Neste caso:
Django==1.11.2
Para instalar as dependências de um projeto no ambiente isolado, basta executar:
pip install -r requirements.txt