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:
Comentários
Postar um comentário