Ambientes virtuais

Uma das características fundamentais do Python é a facilidade de que dispõe para instalar pacotes utilitários. Para que diferentes projetos nos nossos computadores não tenham conflitos de versões, é recomendado criar um ambiente virtual para cada um.

Existem várias ferramentas que fazem isso. Neste guia, usaremos o venv. Ele é um módulo padrão do Python, que cria uma pasta isolada dentro de um projeto. Então, podemos usar o pip para instalar as dependências dentro dessa pasta.

Criação de um projeto

Crie uma pasta dentro do diretório python chamada colors.

1
cd ~/dev/python
2
mkdir -p colors
3
cd colors

Então, abra o Visual Studio Code nessa pasta.

1
code .

Ative o perfil do Python que criamos dentro do VSCode.

Por dentro do VSCode, crie um arquivo chamado main.py e adicione o seguinte código.

1
name = input('Qual é o seu nome? ')
2
print(f'Olá, {name}!')

Este é o mesmo código que usamos no capítulo anterior. Execute-o por meio do painel lateral Run and Debug, como explicado anteriormente.

Configuração do venv

Agora, vamos criar um ambiente virtual para instalar pacotes. Podemos fazer isso tanto pela linha de comando, como também pela interface do VSCode.

Escolha uma das formas abaixo e a siga. Caso queira seguir uma e depois a outra, basta apagar a pasta .venv criada ao fim do processo.

Visual Studio Code

Abra a Command Palette com o atalho Control + Shift + PControl + Shift + P, e digite Python: Create Environment.

Então, selecione a ferramenta venv no menu que se abrir.

Menu de seleção de ferramenta de ambiente virtual no Visual Studio Code, em que se escolhe a opção "venv". — Criando um ambiente "venv" Visual Studio Code.

Em seguida, selecione o caminho do interpretador como /bin/python.

Menu de seleção do caminho do interpretador de Python pelo Visual Studio Code, em que se escolhe a opção "/bin/python". — Selecionando o interpretador na pasta "/bin/python" pelo Visual Studio Code.

O ambiente virtual será criado em uma pasta chamada .venv. No rodapé do Visual Studio Code, você poderá ver a versão do Python usada e o ambiente do venv selecionado.

Rodapé do Visual Studio Code, em que se vê o ambiente virtual criado no caminho ".venv". — Rodapé do Visual Studio Code com o venv ativado.

Linha de comando

Abra no terminal a pasta que criamos.

1
cd ~/dev/python/colors

Então, crie um ambiente virtual com o venv usando o comando a seguir.

1
python -m venv .venv

Isso criará uma pasta no seu projeto com o nome .venv.

Agora, é necessário ativar o ambiente criado. Para isso, execute o comando a seguir.

1
source .venv/bin/activate

Toda vez que você fechar e abrir o terminal nessa pasta, será necessário ativar o venv novamente por meio desse comando.

Instalando um pacote

Vamos instalar o pacote rich, que facilita colorir o texto impresso no terminal pelo nosso programa.

Abra o terminal na pasta do projeto. Pode ser o terminal integrado do VSCode, ou então um terminal externo com o venv ativado.

Então, execute o comando de instalação a seguir.

1
pip install rich

O resultado no terminal será como a seguir.

1
Collecting rich
2
  Downloading rich-15.0.0-py3-none-any.whl.metadata (18 kB)
3
Collecting markdown-it-py>=2.2.0 (from rich)
4
  Downloading markdown_it_py-4.2.0-py3-none-any.whl.metadata (7.4 kB)
5
Collecting pygments<3.0.0,>=2.13.0 (from rich)
6
  Downloading pygments-2.20.0-py3-none-any.whl.metadata (2.5 kB)
7
Collecting mdurl~=0.1 (from markdown-it-py>=2.2.0->rich)
8
  Downloading mdurl-0.1.2-py3-none-any.whl.metadata (1.6 kB)
9
Downloading rich-15.0.0-py3-none-any.whl (310 kB)
10
Downloading pygments-2.20.0-py3-none-any.whl (1.2 MB)
11
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 45.8 MB/s  0:00:00
12
Downloading markdown_it_py-4.2.0-py3-none-any.whl (91 kB)
13
Downloading mdurl-0.1.2-py3-none-any.whl (10.0 kB)
14
Installing collected packages: pygments, mdurl, markdown-it-py, rich
15
Successfully installed markdown-it-py-4.2.0 mdurl-0.1.2 pygments-2.20.0 rich-15.0.0

Agora, edite o programa no arquivo main.py para importar o pacote rich em seu topo.

1
from rich import print
2

3
name = input('Qual é o seu nome? ')
4
print(f'Olá, {name}!')

Em seguida, edite o corpo do programa para adicionar cores e negrito.

1
from rich import print
2

3
print("Qual é o seu [italic blue]nome[/italic blue]?")
4
name = input("")
5
print(f"Olá, [bold yellow]{name}[/bold yellow]!")

Execute o programa atualizado. O resultado deve ser como a seguir.

Execução do programa utilizado o pacote rich no terminal, em que o nome digitado aparece colorido. — Execução do programa.

Gerenciando dependências

Quando lidamos com pacotes, queremos que pessoas que usam nossos projetos possam instalar as mesmas dependências nas mesmas versões. Para garantir isso, podemos criar uma lista de pacotes instalados.

Abra o terminal na pasta do projeto com o venv ativado e execute o comando a seguir.

1
touch requirements.txt

Isso cria o arquivo em que listaremos os pacotes.

Agora, vamos verificar qual é a versão que instalamos do pacote rich.

Execute o comando a seguir para obter as informações do pacote.

1
pip show rich

1
Name: rich
2
Version: 15.0.0
3
Summary: Render rich text, tables, progress bars, syntax highlighting, markdown and more to the terminal
4
Home-page: https://github.com/Textualize/rich
5
Author: Will McGugan
6
Author-email: willmcgugan@gmail.com
7
License: MIT
8
Location: /home/gabriel/dev/python/colors/.venv/lib64/python3.14/site-packages
9
Requires: markdown-it-py, pygments
10
Required-by:

Na data de escrita deste guia, o rich está na versão 15.0.0.

Edite o arquivo requirements.txt para adicionar o pacote. Podemos ignorar o último número de versão, pois ele tende a representar atualizações de pouco impacto na funcionalidade. Ele deve ficar como a seguir.

1
rich>=15.0

Se quiser instalar outros pacotes, você pode listá-los abaixo nesse mesmo arquivo. Por exemplo, adicione uma linha para o pacote cowsay.

1
rich>=15.0
2
cowsay>=6.1

Para instalar os pacotes descritos nessa lista, execute o comando a seguir.

1
pip install -r requirements.txt

1
Requirement already satisfied: rich>=15.0 in ./.venv/lib64/python3.14/site-packages (from -r requirements.txt (line 1)) (15.0.0)
2
Collecting cowsay>=6.1 (from -r requirements.txt (line 2))
3
  Downloading cowsay-6.1-py3-none-any.whl.metadata (5.6 kB)
4
Requirement already satisfied: markdown-it-py>=2.2.0 in ./.venv/lib64/python3.14/site-packages (from rich>=15.0->-r requirements.txt (line 1)) (4.2.0)
5
Requirement already satisfied: pygments<3.0.0,>=2.13.0 in ./.venv/lib64/python3.14/site-packages (from rich>=15.0->-r requirements.txt (line 1)) (2.20.0)
6
Requirement already satisfied: mdurl~=0.1 in ./.venv/lib64/python3.14/site-packages (from markdown-it-py>=2.2.0->rich>=15.0->-r requirements.txt (line 1)) (0.1.2)
7
Downloading cowsay-6.1-py3-none-any.whl (25 kB)
8
Installing collected packages: cowsay
9
Successfully installed cowsay-6.1

Vamos entrar no ambiente do interpretador do Python (REPL).

1
python

Agora, execute os seguintes comandos para importar o pacote cowsay e executá-lo.

1
import cowsay
2
cowsay.cow('Olá, Mundo!')

A execução será como a seguir.

Execução de uma função do pacote "cowsay" no console do interpretador do Python. — Execução do pacote "cowsay" no console do interpretador do Python.

Para fechar o console do interpretador, pressione Control + DControl + D.