أولا تحتاج إلى تثبيت الشعر على جهاز الكمبيوتر الخاص بك. هناك العديد من الطرق للقيام بذلك، لقد قمت بتنزيلها باستخدام Brew (Brew Install Poetry). يمكنك تحميله من موقع الشعر الخاص بالطريقة المناسبة.

ولكن دعونا أولاً نلقي نظرة سريعة على ماهية الشعر وكيف يختلف عن البيئة الافتراضية

Poetry هي أداة لإدارة مشاريع Python وتبعياتها، مما يسهل التعامل مع إدارة الحزم وهيكل المشروع. فهو يسمح للمطورين بتحديد التبعيات وإدارتها، وإنشاء بيئات افتراضية، والتعامل مع إصدارات المشروع، كل ذلك بطريقة مباشرة.

الفرق عن venv:

• VirtualEnv: venv هي وحدة Python قياسية لإنشاء بيئات افتراضية معزولة، حيث يتم تثبيت التبعيات بشكل منفصل عن البيئة العامة. ومع ذلك، لا يقوم venv بإدارة تبعيات المشروع بنفسه؛ تحتاج عادةً إلى استخدام شيء مثل النقطة لتثبيت التبعيات وتتبعها يدويًا.

• الشعر : الشعر، من ناحية أخرى، لا يخلق بيئات افتراضية فحسب، بل يقوم أيضًا بأتمتة إدارة التبعيات. ويستخدم ملف pyproject.toml لتتبع التبعيات والإصدارات وتكوينات المشروع. يعمل الشعر أيضًا على تبسيط نشر حزم بايثون من خلال التعامل مع الإصدارات والتعبئة.

باختصار، بينما تقوم venv بإنشاء بيئات معزولة، فإن Poetry توفر حلاً أكثر شمولاً لإدارة المشاريع، بما في ذلك حل التبعيات وأدوات التعبئة والتغليف.

بعد تثبيت تطبيق Poetry، لنقم بإنشاء مشروع 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]  

ثم سيكون لدينا ملف مثل هذا:

رائع، الآن دعونا ننتقل. نحن بحاجة إلى إضافة جانغو لمشروعنا. لكن قبل ذلك نحتاج لتفعيل الشعر أولا، تماما مثل منطق 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 %

⬆️ إذا رأيت هذه النتيجة في جهازك، فالشعر نشط.

ثم دعونا نضيف جانغو إلى المشروع:

(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

سنرى مثل هذه الحداثة في ملف toml الخاص بنا. هذا يعني أننا نجحنا في إعداد جانغو:

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

والآن، أخيرًا، يمكننا تثبيت وتشغيل Django بالطريقة العادية:

(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.

إليكم النتيجة المذهلة:

أردت تقديم القليل من المساعدة للشعر، ويمكنك معرفة المزيد من وثائق الشعر الخاصة.

خاتمة

؟ لا داعي للذعر بشأن ذلك، يمكنك العثور عليه بسهولة وإصلاحه بعد بحث مفصل.

️ قبل أن تذهب... إذا كان لديك أي أسئلة / اقتراحات / أفكار، فلا تتردد في مراسلتي أدناه.

وإذا استمتعت بهذا، أخبرنا بما شعرت به باستخدام رمز تعبيري لطيف (؟❤️‍؟) ولا تنس المتابعة للحصول على التحديثات المستقبلية.

هذا كل شيء مني. سنتحدث قريبا!

— الهورمات ♟️