This content originally appeared on DEV Community and was authored by José Guilherme Lins
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 addepoetry add --devpara dependĂȘncias de desenvolvimento.
Ambiente Virtual: Ative o ambiente virtual do projeto com
poetry shellpara 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 đ
This content originally appeared on DEV Community and was authored by José Guilherme Lins
JosĂ© Guilherme Lins | Sciencx (2024-06-24T20:04:25+00:00) Poetry: O Maestro dos Projetos Python đ©âš. Retrieved from https://www.scien.cx/2024/06/24/poetry-o-maestro-dos-projetos-python-%f0%9f%8e%a9%e2%9c%a8/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.