Primeiro você precisa instalar poesia em seu computador. Há muitas maneiras de fazer isso, baixei usando brew (brew install poesia). Você pode baixá-lo do próprio site da Poesia da maneira apropriada.

Mas vamos primeiro dar uma breve olhada no que é poesia e como ela difere do virtualenv

Poetry é uma ferramenta para gerenciar projetos e dependências Python, facilitando o gerenciamento de pacotes e a estrutura do projeto. Ele permite que os desenvolvedores definam e gerenciem dependências, criem ambientes virtuais e administrem o controle de versão do projeto, tudo de maneira direta.

Diferença do venv:

• VirtualEnv: venv é um módulo Python padrão para criação de ambientes virtuais isolados, onde as dependências são instaladas separadamente do ambiente global. No entanto, o venv não gerencia as dependências do projeto por si só; normalmente você precisa usar algo como pip para instalar dependências e rastreá-las manualmente.

• Poesia: A poesia, por outro lado, não apenas cria ambientes virtuais, mas também automatiza o gerenciamento de dependências. Ele usa um arquivo pyproject.toml para rastrear dependências, versões e configurações do projeto. Poesia também simplifica a publicação de pacotes Python, lidando com controle de versão e empacotamento.

Em resumo, enquanto venv cria ambientes isolados, Poetry fornece uma solução de gerenciamento de projetos mais abrangente, incluindo resolução de dependências e ferramentas de empacotamento.

Depois de instalar o Poetry, vamos criar o projeto Django:

thehormat@Pawn Desktop % mdkir DjangoPoetry
thehormat@Pawn DjangoPoetry % cd DjangoPoetry 
thehormat@Pawn DjangoPoetry % poetry init

This command will guide you through creating your pyproject.toml config.

Package name [djangopoetry]:  DjangoPoetry 
Version [0.1.0]:  
Description []:  We learn Poetry
Author [HormatHamidov , n to skip]:  TheHormat
License []:  
Compatible Python versions [^3.12]:  

Would you like to define your main dependencies interactively? (yes/no) [yes] no
Would you like to define your development dependencies interactively? (yes/no) [yes] no 
Generated file

[tool.poetry]
name = "djangopoetry"
version = "0.1.0"
description = "We learn Poetry"
authors = ["TheHormat"]
readme = "README.md"

[tool.poetry.dependencies]
python = "^3.12"


[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"


Do you confirm generation? (yes/no) [yes]  

Então teremos um arquivo como este:

Ótimo, agora vamos em frente. Precisamos adicionar Django ao nosso projeto. Mas antes disso, precisamos primeiro ativar a poesia, assim como a lógica do virtualenv:

thehormat@Pawn DjangoPoetry % poetry shell
Creating virtualenv djangopoetry-5djS955q-py3.12 in /Users/thehormat/Library/Caches/pypoetry/virtualenvs
Spawning shell within /Users/thehormat/Library/Caches/pypoetry/virtualenvs/djangopoetry-5djS955q-py3.12
thehormat@Pawn DjangoPoetry % emulate bash -c '. /Users/thehormat/Library/Caches/pypoetry/virtualenvs/djangopoetry-5djS955q-py3.12/bin/activate'
(djangopoetry-py3.12) thehormat@Pawn DjangoPoetry % 

(djangopoetry-py3.12) thehormat@Pawn DjangoPoetry %

⬆️ Se você vir este resultado em seu terminal, a poesia está ativa.

Então vamos adicionar Django ao projeto:

(djangopoetry-py3.12) hormathamidov@Pawn DjangoPoetry % poetry add django
Using version ^5.1.2 for django

Updating dependencies
Resolving dependencies... (0.3s)

Package operations: 3 installs, 0 updates, 0 removals

  - Installing asgiref (3.8.1)
  - Installing sqlparse (0.5.1)
  - Installing django (5.1.2)

Writing lock file

Veremos essa novidade em nosso arquivo toml. Isso significa que configuramos com sucesso o django:

[tool.poetry.dependencies]
python = "^3.12"
django = "^5.1.2"

E agora, finalmente, podemos instalar e executar o django da maneira normal:

(djangopoetry-py3.12) thehormat@Pawn DjangoPoetry % django-admin startproject core .
(djangopoetry-py3.12) thehormat@Pawn DjangoPoetry % python manage.py runserver
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
October 14, 2024 - 18:22:05
Django version 5.1.2, using settings 'core.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Aqui está o resultado incrível:

Queria dar uma ajudinha para Poesia, e você pode aprender mais na documentação do próprio Poesia.

Conclusão

? Você não precisa entrar em pânico com isso, você pode encontrá-lo facilmente e corrigi-lo após uma pesquisa detalhada.

?️ Antes de ir… Se você tiver alguma dúvida/sugestão/opinião, deixe-me um comentário abaixo.

E se você gostou, conte-nos como você se sentiu com um belo emoji(?❤️‍?) e não se esqueça de seguir para atualizações futuras.

É isso de mim. Conversaremos em breve!

— TheHormat ♟️