DEV Community

Cover image for Poetry: O Maestro dos Projetos Python đŸŽ©âœš
José Guilherme Lins
José Guilherme Lins

Posted on

4

Poetry: O Maestro dos Projetos Python đŸŽ©âœš

O Poetry Ă© uma ferramenta de gerenciamento de dependĂȘncias e empacotamento para projetos Python. Ele simplifica a criação e manutenção de projetos Python, gerenciando dependĂȘncias e versĂ”es. Vamos passar por um guia passo a passo para começar a usar o Poetry em um novo projeto Python.

1. Para Instalar

Para instalar o Poetry, vocĂȘ pode seguir as instruçÔes presentes na documentação oficial do Poetry para o seu sistema operacional. Nesse tutorial vamos usar o pipx para instalar o Poetry

O pipx Ă© uma forma de instalar pacotes de forma global no seu sistema sem que eles interfiram no seu ambiente global do python. Ele cria um ambiente virtual isolado para cada ferramenta.

O guia de instalação do pipx contempla diversos sistemas operacionais: guia

Começamos com o comando:

pip install pipx
Enter fullscreen mode Exit fullscreen mode

Agora usamos:

pipx ensurepath
Enter fullscreen mode Exit fullscreen mode

O comando pipx ensurepath Ă© usado garantir que os pacotes instalados via pipx possam ser executados diretamente do terminal.

Agora que ja temos o pipx instalado, podemos baixar o poetry.

pipx install poetry
Enter fullscreen mode Exit fullscreen mode

Depois de instalar, vocĂȘ pode verificar a instalação executando:

pipx --version
Enter fullscreen mode Exit fullscreen mode

2. Criar um Novo Projeto

Para criar um novo projeto com o Poetry, navegue até o diretório onde deseja criar o projeto e execute:

poetry new nome_do_projeto
Enter fullscreen mode Exit fullscreen mode

Isso cria a seguinte estrutura de diretĂłrios:

nome_do_projeto/
├── pyproject.toml
├── README.rst
├── nome_do_projeto
│   └── __init__.py
└── tests
    └── __init__.py

Enter fullscreen mode Exit fullscreen mode

3. Entender o pyproject.toml

O arquivo pyproject.toml Ă© onde vocĂȘ define as dependĂȘncias do seu projeto, scripts de build e outras configuraçÔes. Aqui estĂĄ um exemplo bĂĄsico de como ele se parece:

[tool.poetry]
name = "nome_do_projeto"
version = "0.1.0"
description = ""
authors = ["Seu Nome <seu_email@example.com>"]

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

[tool.poetry.dev-dependencies]
pytest = "^6.2"

Enter fullscreen mode Exit fullscreen mode

4. Adicionar DependĂȘncias

Para adicionar uma dependĂȘncia ao seu projeto, use o comando poetry add:

poetry add requests

Enter fullscreen mode Exit fullscreen mode

Para adicionar uma dependĂȘncia de desenvolvimento (por exemplo, para testes), use:

poetry add --dev pytest
Enter fullscreen mode Exit fullscreen mode

5. Instalar DependĂȘncias

Para instalar todas as dependĂȘncias listadas em pyproject.toml, navegue atĂ© o diretĂłrio do seu projeto e execute:

poetry install
Enter fullscreen mode Exit fullscreen mode

6. Ativar o Ambiente Virtual

O Poetry cria e gerencia um ambiente virtual para o seu projeto. Para ativĂĄ-lo, vocĂȘ pode usar:

poetry shell
Enter fullscreen mode Exit fullscreen mode

ConclusĂŁo

Usar o Poetry facilita muito a gestĂŁo de projetos Python. Com ele, vocĂȘ pode criar novos projetos, adicionar dependĂȘncias e configurar tudo de forma simples e organizada.

  • Instalação: VocĂȘ pode instalar o Poetry facilmente com pip ou pipx.

  • Novo Projeto: Crie novos projetos rapidamente com poetry new nome_do_projeto.

  • DependĂȘncias: Adicione dependĂȘncias usando poetry add e poetry add --dev para dependĂȘncias de desenvolvimento.

  • Ambiente Virtual: Ative o ambiente virtual do projeto com poetry shell para trabalhar em um ambiente isolado.

Seguindo esses passos, vocĂȘ mantĂ©m seu projeto organizado e focado no desenvolvimento de cĂłdigo de qualidade. O Poetry cuida do gerenciamento de dependĂȘncias e versĂ”es, permitindo que vocĂȘ se concentre no que realmente importa: programar!

AtĂ© a prĂłxima 👋

Image of Docusign

đŸ› ïž Bring your solution into Docusign. Reach over 1.6M customers.

Docusign is now extensible. Overcome challenges with disconnected products and inaccessible data by bringing your solutions into Docusign and publishing to 1.6M customers in the App Center.

Learn more

Top comments (0)

A Workflow Copilot. Tailored to You.

Pieces.app image

Our desktop app, with its intelligent copilot, streamlines coding by generating snippets, extracting code from screenshots, and accelerating problem-solving.

Read the docs