Poetry: O Maestro dos Projetos Python 🎩✨
Tags: poetry, python, programming
Published: 2024-06-24 20:04:25

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](https://python-poetry.org/) 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](https://pipx.pypa.io/stable/installation/#installing-pipx)

Começamos com o comando:

```
pip install pipx
```

Agora usamos:

```
pipx ensurepath
```
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
```
Depois de instalar, você pode verificar a instalação executando:

```
pipx --version
```

#### 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
```
Isso cria a seguinte estrutura de diretórios:

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

```

#### 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"

```
#### 4. Adicionar Dependências
Para adicionar uma dependência ao seu projeto, use o comando poetry add:

```
poetry add requests

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

```
poetry add --dev pytest
```
#### 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
```

#### 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
```
<br>
#### 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.
<br>

- Novo Projeto: Crie novos projetos rapidamente com `poetry new nome_do_projeto`.
<br>

- Dependências: Adicione dependências usando `poetry add` e `poetry add --dev` para dependências de desenvolvimento.
<br>

- Ambiente Virtual: Ative o ambiente virtual do projeto com `poetry shell` para trabalhar em um ambiente isolado.
<br>

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!
<br>

Até a próxima 👋