DEV Community: José Guilherme Lins

Poetry: O Maestro dos Projetos Python 🎩✨

José Guilherme Lins — Mon, 24 Jun 2024 20:04:25 +0000

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

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

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 👋

Pyenv para Iniciantes.

José Guilherme Lins — Mon, 17 Jun 2024 01:19:47 +0000

O Pyenv é uma ferramenta que simplifica o uso do Python no seu computador, especialmente quando você trabalha em diferentes projetos que podem exigir versões distintas do Python.

Com apenas alguns comandos no terminal, você pode instalar várias versões do Python e alternar facilmente entre elas. Isso garante mais consistência e estabilidade em seus projetos, permitindo que cada projeto utilize a versão específica do Python necessária.

COMO INSTALAR:

Para começar, abra o PowerShell como administrador e certifique-se de que o Windows permita a execução de scripts. Cole este comando no PowerShell:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Agora vamos instalar o Pyenv. Cole o seguinte comando:

Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; .\install-pyenv-win.ps1

Em alguns computadores Windows, pode surgir uma mensagem de erro dizendo que o Windows não conseguiu adicionar as variáveis de ambiente. Caso isso aconteça, cole este comando:

$pyenvPath = "$HOME\.pyenv\pyenv-win\bin"
$shimsPath = "$HOME\.pyenv\pyenv-win\shims"

[System.Environment]::SetEnvironmentVariable('PYENV', "$HOME\.pyenv\pyenv-win\", [System.EnvironmentVariableTarget]::User)

Pronto, feche o PowerShell e abra novamente. Verifique se o Pyenv foi instalado corretamente com o comando:

pyenv --version

Ele irá retornar a versão atual do Pyenv se estiver tudo funcionando corretamente.

Para atualizar o Pyenv e seus plugins, primeiro use:

pyenv update

Agora podemos listar todas as versões do Python disponíveis para download:

pyenv install --list

Isso retornará algo semelhante a isso:

:: [Info] ::  Mirror: https://www.python.org/ftp/python
3.12.1
3.12.2-win32
3.12.2-arm
3.12.2
3.12.3-win32
3.12.3-arm
3.12.3
3.13.0a1-win32
3.13.0a1-arm
3.13.0a1
3.13.0a2-win32
3.13.0a2-arm
3.13.0a2

Para instalar uma versão específica, use:

pyenv install 3.12.3

Para usar esta versão globalmente:

pyenv global 3.12.3

Ou, se quiser definir uma versão apenas para seu projeto específico, entre na raiz do projeto e use o comando:

pyenv local 3.12.3

Para ver as vesões que você ja baixou:

pyenv versions

Nesse link você encontra a documentação completa do Pyenv caso tenha mais dúvidas:

https://pypi.org/project/pyenv-win/

E é isso, até a proxima e bons estudos.