Instalando e Usando o Poetry
Nota prática da série sobre ambientes Python — veja o panorama completo em As 4 Formas de Gerenciar Ambientes Python.
O Poetry trata dependências de forma declarativa e reproduzível, centralizando tudo no pyproject.toml e travando versões no poetry.lock.
1. Instale o Poetry
O instalador oficial mantém o Poetry isolado do seu Python de projeto:
curl -sSL https://install.python-poetry.org | python3 -Confirme a instalação (talvez seja preciso adicionar ~/.local/bin ao PATH):
poetry --version2. Crie ou inicialize um projeto
poetry new meu-projeto # cria a estrutura do zero
# ou, em um projeto existente:
poetry init3. Adicione dependências
poetry add requests
poetry add --group dev pytest ruffCada poetry add atualiza o pyproject.toml e regenera o poetry.lock.
4. Instale e execute
poetry install # instala tudo do lockfile
poetry run python script.py # roda dentro do ambiente
poetry shell # abre um shell com o ambiente ativo5. Reproduza em outra máquina
Basta versionar pyproject.toml e poetry.lock e rodar:
poetry installIsso garante exatamente as mesmas versões — o fim do clássico "funciona na minha máquina".
Quando usar
Ótimo para bibliotecas publicadas no PyPI e projetos em equipe que exigem reprodutibilidade rigorosa. Se quer algo ainda mais rápido e unificado para projetos novos, considere migrar para uv.
