Gerencie Dependências em Python como um Profissional com o Poetry

O Poetry é uma ferramenta de gerenciamento de dependências e empacotamento para projetos Python. Ele simplifica a criação, organização e compartilhamento de projetos, promovendo boas práticas e controle eficiente de dependências.

Ao contrário de ferramentas tradicionais como pip e virtualenv, o Poetry fornece uma solução completa para gerenciar dependências, criar ambientes isolados e empacotar projetos para distribuição.

---

O Poetry se destaca por:

• Gerenciamento simplificado de dependências com o arquivo pyproject.toml.
• Criação automática de ambientes virtuais.
• Suporte ao empacotamento e publicação de bibliotecas Python.

---

Instalar o Poetry é simples. Basta executar o comando:

curl -sSL https://install.python-poetry.org | python3 -

Após a instalação, você pode verificar a versão instalada com:

poetry --version

---

Criar um novo projeto com o Poetry é direto:

poetry new nome-do-projeto

Isso cria uma estrutura de projeto organizada com arquivos essenciais como pyproject.toml.

Para adicionar uma dependência ao projeto, no exemplo abaixo pandas, utilize:

poetry add pandas

Isso garante que todas as dependências sejam registradas e gerenciadas eficientemente.

---

O Poetry cria automaticamente um ambiente virtual para isolar o projeto. Para ativar o ambiente, use:

poetry shell

Você também pode executar comandos diretamente no ambiente com:

poetry run python arquivo.py

---

Para publicar um pacote, primeiro configure as informações do projeto no pyproject.toml. Em seguida, execute:

poetry build

Isso gera arquivos de distribuição no diretório dist/. Publique o pacote no PyPI com:

poetry publish --repository pypi

---

O pyproject.toml é o coração do Poetry. Ele armazena informações sobre o projeto, dependências e configurações de empacotamento. Um exemplo básico:

[tool.poetry]
name = "meu-projeto"
version = "0.1.0"
description = "Um exemplo de projeto Poetry"
authors = ["Seu Nome "]

[tool.poetry.dependencies]
python = "^3.10"
requests = "^2.28.0"

[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

---

O Poetry é amplamente utilizado em projetos Python modernos devido à sua eficiência e simplicidade. Ele facilita o gerenciamento de dependências e empacotamento, permitindo que desenvolvedores se concentrem em escrever código de qualidade.

Para mais informações, confira as referências:

• Site Oficial do Poetry
• Documentação do Poetry
• Real Python: Managing Dependencies with Poetry