DEV Community

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

Posted on

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 👋

Top comments (0)