A necessidade de ambientes virtuais e reprodutibilidade

Projetos Python geralmente dependem de inúmeras bibliotecas e pacotes externos. À medida que os projetos crescem e evoluem, o gerenciamento dessas dependências pode se tornar complexo. Dois aspectos críticos do desenvolvimento Python são:

1. Ambientes virtuais: espaços isolados que mantêm as dependências do projeto separadas das instalações Python em todo o sistema.

2. Reprodutibilidade: Garantir que um projeto possa ser facilmente configurado e executado de forma consistente em diferentes máquinas ou ambientes.

Ferramentas tradicionais como venv e pip são usadas há muito tempo para esses fins, mas geralmente exigem várias etapas e intervenção manual. É aqui que entra a Poesia, oferecendo uma solução mais ágil e robusta.

Por que escolher a poesia?

A poesia oferece diversas vantagens sobre as ferramentas tradicionais:

1. Fluxo de trabalho simplificado: combina gerenciamento de dependências, empacotamento e publicação em uma única ferramenta.

2. Resolução de dependências: resolve automaticamente dependências e possíveis conflitos.

3. Construções reproduzíveis: garantem ambientes consistentes em diferentes máquinas.

4. Arquivo de bloqueio: gera um arquivo de bloqueio para controle de versão exato de todas as dependências.

5. Isolamento de projeto: cria e gerencia ambientes virtuais automaticamente.

6. Comandos intuitivos: oferece uma CLI amigável para tarefas comuns.

Instalando e configurando poesia

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

Após a instalação, adicione Poetry ao seu PATH adicionando a seguinte linha ao seu arquivo de configuração do shell (por exemplo, ~/.bashrc ou ~/.zshrc):

export PATH="$HOME/.local/bin:$PATH"

Reinicie seu terminal ou execute source ~/.bashrc (ou o arquivo apropriado) para aplicar as alterações.

Verifique a instalação executando:

poetry --version

Habilite o preenchimento de guias para Bash, Fish ou Zsh

poetry suporta a geração de scripts de conclusão para Bash, Fish e Zsh.

Bash

poetry completions bash >> ~/.bash_completion

Peixe

poetry completions fish > ~/.config/fish/completions/poetry.fish

Zsh

poetry completions zsh > ~/.zfunc/_poetry

Usando Poesia

Criando um novo projeto

Para criar um novo projeto Python com Poetry:

poetry new my-project
cd my-project

Isso cria um novo diretório com uma estrutura básica de projeto, incluindo um arquivo pyproject.toml.

Adicionando Dependências

Para adicionar uma nova dependência:

poetry add requests

Isso adiciona o pacote ao seu arquivo pyproject.toml e o instala no ambiente virtual.

Gerenciando Dependências

Ver pacotes instalados:

poetry show

Atualizar todos os pacotes:

poetry update

Remover um pacote:

poetry remove requests

Executando scripts

Execute scripts Python dentro do ambiente virtual do projeto:

poetry run python your_script.py

Gerenciando o ambiente virtual

Ative o ambiente virtual:

poetry shell

Desative-o:

exit

Construção e Publicação

Crie seu projeto:

poetry build

Publicar no PyPI:

poetry publish

Requisitos de exportação

Gere um arquivo requisitos.txt:

poetry export -f requirements.txt --output requirements.txt

Conclusão

Poetry simplifica o gerenciamento de projetos Python, fornecendo uma ferramenta unificada para gerenciamento de dependências, ambientes virtuais e empacotamento. Sua interface intuitiva e recursos poderosos o tornam uma excelente escolha para desenvolvedores Python que buscam agilizar seu fluxo de trabalho e garantir a reprodutibilidade do projeto.