Ir para o conteúdo

Gerenciadores de Pacotes e Ambiente Virtual

← Voltar ao guia

Poetry

Pré-requisito

Este comando utiliza o pipx para instalar o Poetry. Verifique se ele está instalado na sua máquina:

pipx --version

Dica

Caso não tenha o pipx, veja a seção Pipx deste guia. Existem também outras formas de instalar o Poetry conforme a documentação oficial.

Instala o Poetry (feito uma única vez): 

pipx install poetry

Instala as dependências do projeto listadas no pyproject.toml: 

poetry install

Dica

Execute poetry install sempre que clonar um repositório pela primeira vez.

Adiciona um pacote ao projeto: 

poetry add <nome-do-pacote>

Remove um pacote do projeto: 

poetry remove <nome-do-pacote>

Atualiza as dependências para as versões mais recentes permitidas pelo pyproject.toml: 

poetry update

Atualiza o poetry.lock sem instalar nada (útil após editar o pyproject.toml manualmente): 

poetry lock

Executa um comando dentro do ambiente virtual sem precisar ativá-lo: 

poetry run <comando>

Ativa o ambiente virtual do projeto:

eval $(poetry env activate)

eval (poetry env activate)

Invoke-Expression (poetry env activate)

poetry env activate

Atenção

No CMD, copie e cole manualmente o caminho retornado pelo comando acima e execute-o diretamente.

Desativa o ambiente virtual do projeto: 

deactivate

Pip

Instala um pacote: 

pip install <nome-do-pacote>

Instala uma versão específica de um pacote: 

pip install <nome-do-pacote>==<versão>

Atualiza um pacote: 

pip install --upgrade <nome-do-pacote>

Remove um pacote: 

pip uninstall <nome-do-pacote>

Lista os pacotes instalados: 

pip list

Exibe detalhes de um pacote instalado: 

pip show <nome-do-pacote>

Instala dependências a partir de um arquivo requirements.txt: 

pip install -r requirements.txt

Gera um requirements.txt com os pacotes instalados no ambiente atual: 

pip freeze > requirements.txt

Pip ou Poetry?

No repositório do Trilha Dev, curso python e exercícios-python, use o Poetry. Use o pip quando estiver fora de um projeto com pyproject.toml e siga as orientações de setup disponíveis no readme de cada projeto.

Pipx

Instala uma ferramenta globalmente: 

pipx install <nome-da-ferramenta>

Atualiza uma ferramenta instalada: 

pipx upgrade <nome-da-ferramenta>

Atualiza todas as ferramentas instaladas: 

pipx upgrade-all

Remove uma ferramenta instalada: 

pipx uninstall <nome-da-ferramenta>

Lista as ferramentas instaladas: 

pipx list

Exemplo do Trilha Dev

pipx install poetry

Venv

Cria um ambiente virtual na pasta .venv: 

python -m venv .venv

Informação

O nome .venv é apenas uma convenção. Você pode usar qualquer nome ao criar o ambiente virtual, por exemplo:

python -m venv .<meu-ambiente>
Lembre-se de substituir .venv pelo nome escolhido nos comandos de ativação.

Ativa o ambiente virtual:

source .venv/bin/activate

.venv\Scripts\Activate.ps1

.venv\Scripts\activate.bat

Instala as dependências após ativar o ambiente: 

pip install -r requirements.txt

Desativa o ambiente virtual: 

deactivate

Por que usar ambiente virtual?

Isola as dependências do projeto, evitando conflitos entre versões de pacotes de projetos diferentes.