إدارة تبعيات Poetry: إدارة حزم بايثون الحديثة

بايثون، لغة برمجة متعددة الاستخدامات وشائعة الاستخدام، تزدهر بفضل نظامها البيئي الواسع من المكتبات والحزم. تُعد إدارة هذه التبعيات بفعالية أمرًا بالغ الأهمية لنجاح المشروع، وهذا هو المكان الذي تلعب فيه أدوات مثل Poetry دورها. تتعمق هذه المدونة في Poetry، وهي أداة حديثة لإدارة تبعيات بايثون وتعبئتها، وتستكشف ميزاتها وفوائدها وكيف تبسط تطوير بايثون للمطورين في جميع أنحاء العالم.

تحديات إدارة تبعيات بايثون

قبل الغوص في Poetry، من الضروري فهم تحديات إدارة تبعيات بايثون التقليدية. تاريخيًا، اعتمد المطورون غالبًا على pip لتثبيت الحزم وملفات requirements.txt لسرد تبعيات المشروع. ومع ذلك، غالبًا ما قدم هذا النهج صعوبات، بما في ذلك:

• تعارضات التبعيات: غالبًا ما تتطلب الحزم المختلفة إصدارات مختلفة من نفس التبعية. يمكن أن تكون إدارة هذه التعارضات يدويًا مملة وعرضة للأخطاء، مما يؤدي إلى مشكلات مثل “جحيم التبعيات”.
• مشكلات قابلية إعادة الإنتاج: قد يكون إنشاء بيئات متسقة عبر أجهزة مختلفة ومراحل تطوير مختلفة أمرًا صعبًا. على الرغم من أن أدوات مثل virtualenv ساعدت، إلا أنها لا تزال تتطلب إدارة يدوية.
• تعقيد التعبئة والنشر: كانت تعبئة حزم بايثون ونشرها إلى PyPI (فهرس حزم بايثون) تتضمن تقليديًا عدة خطوات يدوية، بما في ذلك إعداد ملف setup.py أو setup.cfg.
• تحديات تحديد الإصدارات: يمكن أن يكون تتبع وإدارة إصدارات الحزم بدقة أمرًا معقدًا، مما يؤدي إلى مشكلات توافق محتملة.

تسلط هذه التحديات الضوء على الحاجة إلى نهج أكثر قوة وتبسيطًا لإدارة تبعيات بايثون، وهو ما تعالجه Poetry.

تقديم Poetry: حل حديث

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

• إدارة التبعيات التصريحية: تستخدم Poetry ملف pyproject.toml (المعياري بواسطة PEP 518) للإعلان عن تبعيات المشروع والبيانات الوصفية. يعمل هذا الملف كمصدر واحد للحقيقة لجميع المعلومات المتعلقة بالمشروع.
• حل التبعيات: يحدد محلل تبعيات Poetry بكفاءة الإصدارات المثلى للتبعيات وتبعياتها الفرعية، مما يضمن التوافق.
• إدارة البيئة الافتراضية: تدير Poetry تلقائيًا البيئات الافتراضية لكل مشروع، مما يعزل التبعيات ويمنع التعارضات.
• التعبئة والنشر: تبسط Poetry عملية بناء ونشر حزم بايثون إلى PyPI أو مستودعات الحزم الأخرى.
• ملف القفل: ينشئ Poetry ملف poetry.lock، الذي يسرد صراحة الإصدارات الدقيقة لجميع التبعيات المثبتة. يضمن هذا الملف قابلية إعادة الإنتاج عبر بيئات مختلفة ويمنع تحديثات الإصدارات غير المتوقعة.
• الأوامر المبسطة: توفر Poetry واجهة سطر أوامر سهلة الاستخدام (CLI) مع أوامر بديهية لإدارة التبعيات وتشغيل الاختبارات وبناء الحزم.

البدء باستخدام Poetry

تثبيت Poetry أمر مباشر. يمكنك استخدام pip، مثبت حزم بايثون. يوصى عمومًا بتثبيت Poetry في بيئة المستخدم الخاصة بك لتجنب الحاجة إلى امتيازات المسؤول، أو لمنع التعارضات مع حزم النظام.

pip install poetry

بعد التثبيت، تحقق من تثبيت Poetry بشكل صحيح عن طريق التحقق من إصداره:

poetry --version

سيظهر هذا إصدار Poetry الذي قمت بتثبيته، مؤكدًا أنه يعمل. قد يبدو الإخراج شيئًا كهذا:

Poetry (version 1.7.0)

إنشاء مشروع جديد

لإنشاء مشروع بايثون جديد باستخدام Poetry، انتقل إلى الدليل المطلوب وقم بتشغيل الأمر التالي:

poetry new my-project

سيؤدي هذا إلى إنشاء دليل جديد يسمى my-project وتهيئة مشروع بايثون جديد بملف pyproject.toml، وملف poetry.lock، وهيكل دليل أساسي لمشروعك (على سبيل المثال، دليل src يحتوي على الشفرة المصدرية الخاصة بك، أو دليل my_project يحتوي على الحزمة). بالنسبة للمشاريع التي لا تحمل اسم حزمة، لا يقوم Poetry بإنشاء دليل src تلقائيًا؛ سيقوم بإنشاء حزمة بنفس اسم المشروع. سيحتوي ملف pyproject.toml على معلومات المشروع الأساسية مثل اسم المشروع وإصداره وقيود إصدار بايثون.

إضافة التبعيات

إضافة التبعيات بسيطة مع Poetry. استخدم الأمر التالي، واستبدل package-name باسم الحزمة التي تريد تثبيتها:

poetry add package-name

على سبيل المثال، لتثبيت مكتبة requests الشائعة، قم بتشغيل:

poetry add requests

ستقوم Poetry تلقائيًا بحل التبعيات، وتثبيت الحزمة داخل البيئة الافتراضية للمشروع، وتحديث ملفي pyproject.toml و poetry.lock.

تثبيت التبعيات

لتثبيت جميع التبعيات المحددة في ملف pyproject.toml، انتقل إلى دليل مشروعك وقم بتشغيل:

poetry install

يقوم هذا الأمر بتثبيت جميع التبعيات المدرجة في ملف pyproject.toml الخاص بك وينشئ أو يحدّث ملف poetry.lock.

تشغيل الأوامر داخل البيئة الافتراضية

لتشغيل الأوامر داخل البيئة الافتراضية للمشروع، استخدم الأمر poetry run، على سبيل المثال:

poetry run python my_script.py

ينفذ هذا الأمر نص بايثون البرمجي (my_script.py) داخل البيئة الافتراضية للمشروع، مما يضمن وصوله إلى التبعيات المثبتة.

الملفات الرئيسية في مشروع Poetry

يعد فهم الملفات الرئيسية في مشروع Poetry أمرًا بالغ الأهمية للإدارة الفعالة:

• pyproject.toml: هذا الملف هو قلب مشروع Poetry. يحتوي على بيانات تعريف المشروع (الاسم، الإصدار، المؤلفون، الوصف، وما إلى ذلك) وقائمة بالتبعيات وإصداراتها. يستخدم هذا تنسيق TOML (لغة توم الواضحة والمبسطة).
• poetry.lock: يعمل هذا الملف كملف قفل. يسرد الإصدارات الدقيقة لجميع التبعيات المثبتة وتبعاتها الفرعية. يضمن ملف القفل أن كل من يعمل على المشروع، أو الأجهزة التي تشغل المشروع، تستخدم نفس إصدارات التبعيات، مما يجعل المشروع متسقًا وقابلاً لإعادة الإنتاج عبر جميع البيئات.
• دليل البيئة الافتراضية: تنشئ Poetry وتدير بيئة افتراضية لكل مشروع، وتقع عادة في .venv (الافتراضي، على الرغم من أنه يمكن تكوينه) داخل دليل مشروعك. يعزل هذا الدليل تبعيات المشروع عن تثبيت بايثون على مستوى النظام.

إدارة التبعيات باستخدام Poetry: أمثلة عملية

دعنا نستعرض بعض الأمثلة العملية لتوضيح كيفية إدارة التبعيات باستخدام Poetry.

إضافة إصدار محدد من حزمة

لتحديد إصدار معين من حزمة، قم بتضمين قيد الإصدار في الأمر poetry add. على سبيل المثال، لتثبيت الإصدار 2.2.1 من مكتبة requests، استخدم:

poetry add requests==2.2.1

يقوم هذا الأمر بتثبيت الإصدار المحدد وتحديث كل من pyproject.toml و poetry.lock.

إضافة حزم للتطوير أو الاختبار

تسمح لك Poetry بتحديد التبعيات التي تحتاجها فقط أثناء التطوير أو الاختبار، مثل أطر عمل الاختبار مثل pytest أو أدوات linting مثل flake8. لإضافة حزمة كاعتماد تطوير، استخدم العلم --group:

poetry add pytest --group dev

سيؤدي هذا إلى تضمين pytest فقط في بيئة التطوير الخاصة بك ولن يتم تعبئته عند نشر مشروعك. يمكنك استخدام مجموعات مختلفة لاحتياجات التطوير أو الاختبار المختلفة، على سبيل المثال، tests، docs.

على سبيل المثال، إذا كنت بحاجة إلى تبعيات للاختبار، فقد تضيفها إلى مجموعة "test":

poetry add pytest --group test

poetry add coverage --group test

ثم، عند تشغيل الاختبارات، ستقوم أولاً بتنشيط البيئة الافتراضية، ثم تشغيل اختباراتك حسب الحاجة، كما تفعل مع أي مشروع بايثون آخر. يتم التعامل مع هذا غالبًا في البرامج النصية، كما هو الحال في مسارات CI/CD أو إجراءات الاختبار الخاصة بك.

تحديث التبعيات

لتحديث التبعيات إلى أحدث إصداراتها المتوافقة، قم بتشغيل:

poetry update

يقوم هذا الأمر بحل التبعيات وتحديث pyproject.toml و poetry.lock.

بدلاً من ذلك، يمكنك تحديث حزمة معينة:

poetry update requests

إزالة التبعيات

لإزالة حزمة، استخدم الأمر poetry remove، متبوعًا باسم الحزمة:

poetry remove requests

سيؤدي هذا إلى إزالة الحزمة من المشروع وتحديث ملفي pyproject.toml و poetry.lock.

بناء ونشر حزم بايثون باستخدام Poetry

تبسط Poetry عملية بناء ونشر حزم بايثون الخاصة بك. فيما يلي تفصيل للخطوات المتضمنة:

بناء حزمتك

لبناء حزمتك، استخدم الأمر التالي:

poetry build

ينشئ هذا الأمر أرشيفًا قابلاً للتوزيع (ملف .tar.gz وملف .whl) في دليل dist. تحتوي هذه الملفات على الشيفرة المصدرية لحزمتك وبياناتها الوصفية، جاهزة للتوزيع.

نشر حزمتك إلى PyPI

قبل النشر إلى PyPI، تحتاج إلى التسجيل وإعداد بيانات اعتماد PyPI الخاصة بك (اسم المستخدم وكلمة المرور). ثم، قم بتشغيل:

poetry publish

ستطالبك Poetry باسم مستخدم PyPI وكلمة المرور الخاصة بك، ثم تقوم بتحميل حزمتك إلى PyPI. قد تحتاج أيضًا إلى إعداد رمز API لـ PyPI.

بدلاً من ذلك، يمكنك نشر مشروعك إلى مستودع مخصص مثل خادم حزم خاص. يمكنك تحديد المستودع باستخدام الخيار --repository:

poetry publish --repository my-private-repo

فوائد استخدام Poetry

تقدم Poetry العديد من المزايا لمطوري بايثون:

• إدارة التبعيات المبسطة: تبسط Poetry حل التبعيات وتحديد الإصدارات وإدارة البيئة الافتراضية.
• قابلية إعادة الإنتاج: يضمن ملف poetry.lock أن جميع المطورين والبيئات يستخدمون نفس إصدارات الحزم بالضبط، مما يجعل عمليات النشر أكثر موثوقية.
• سهولة الاستخدام: واجهة سطر الأوامر (CLI) بديهية وسهلة التعلم، حتى للمطورين الجدد في إدارة حزم بايثون.
• التعبئة والنشر المبسّطين: تبسط Poetry عملية بناء ونشر الحزم إلى PyPI.
• هيكل مشروع محسّن: تشجع Poetry هيكل مشروع محدد جيدًا، مما يشجع على أفضل الممارسات.
• عزل التبعيات: تتجنب معالجة البيئة الافتراضية في Poetry التعارضات مع حزم النظام والمشاريع الأخرى.
• مصدر واحد للحقيقة: يعمل ملف pyproject.toml كمكان واحد لتكوين المشروع وبياناته الوصفية والتبعيات.
• تقليل "جحيم التبعيات": تحل Poetry تعارضات التبعيات تلقائيًا، مما يجعل إدارة التبعيات أسهل.

التأثير العالمي والتبني

ساهم تصميم Poetry سهل الاستخدام ومجموعة ميزاتها القوية في شعبيتها المتزايدة بين مطوري بايثون في جميع أنحاء العالم. لقد أصبحت أداة قياسية للعديد من مطوري بايثون، الكبار والصغار. تعود القدرة على إدارة الحزم ونشرها بسهولة بالفائدة على المطورين في مواقع متنوعة، بما في ذلك على سبيل المثال لا الحصر:

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

يعكس تبني Poetry عبر القارات المختلفة مرونتها وسهولة استخدامها وقدرتها على حل المشكلات الشائعة في تطوير بايثون. هذا التبني العالمي مدفوع بالحاجة إلى قابلية إعادة الإنتاج، وإعداد المشروع المبسّط، وإدارة التبعيات الفعالة.

أفضل الممارسات والنصائح لاستخدام Poetry

لتحقيق أقصى استفادة من Poetry، ضع في اعتبارك أفضل الممارسات التالية:

• الالتزام بملفي pyproject.toml و poetry.lock: قم دائمًا بتسليم كل من ملفي pyproject.toml و poetry.lock إلى نظام التحكم بالإصدار الخاص بك (مثل Git) لضمان الاتساق عبر البيئات.
• استخدام البيئات الافتراضية: اعمل دائمًا ضمن بيئة افتراضية تديرها Poetry لعزل تبعيات المشروع.
• تحديث التبعيات بانتظام: حافظ على تحديث تبعياتك عن طريق تشغيل poetry update بشكل دوري، والانتباه لأي تغييرات قد تؤثر على المشروع.
• الاختبار الشامل: اختبر مشروعك بدقة بعد تحديث التبعيات لضمان التوافق.
• تحديد قيود الإصدار: استخدم قيود الإصدار المناسبة في ملف pyproject.toml للتحكم في إصدارات الحزم المسموح بتثبيتها.
• فهم مجموعات التبعيات: استخدم مجموعات التبعيات (على سبيل المثال، dev، test) لفصل التبعيات المطلوبة للتطوير/الاختبار عن تلك المطلوبة لبيئة التشغيل.
• الاستفادة من أوامر Poetry: تعرف على النطاق الكامل لأوامر Poetry (على سبيل المثال، poetry add، poetry remove، poetry run، poetry build، poetry publish) لتبسيط سير عملك.
• استخدام الترقيم الدلالي (SemVer): اتبع إرشادات SemVer (الترقيم الدلالي) للمساعدة في إدارة التبعيات وتعزيز الممارسات الجيدة داخل مشروعك.
• التحقق من الثغرات الأمنية: فكر في دمج أدوات أو ممارسات للتحقق من التبعيات بحثًا عن الثغرات الأمنية، خاصة في المشاريع المتاحة للجمهور، أو التي تعمل مع بيانات حساسة.

مقارنة مع مديري تبعيات بايثون الآخرين

في حين أن pip و virtualenv هما أدوات أساسية لتطوير بايثون، فإن Poetry تقدم مزايا كبيرة لإدارة التبعيات والتعبئة. إليك مقارنة:

الميزة	Poetry	pip + virtualenv
حل التبعيات	نعم (محلل متقدم)	لا (يتطلب إدارة يدوية)
إدارة البيئة الافتراضية	تلقائي	يدوي (عبر virtualenv)
الإعلان عن التبعيات	pyproject.toml	requirements.txt (أقل تنظيمًا)
ملف القفل	نعم (poetry.lock)	لا (يتطلب إنشاء يدوي)
التعبئة والنشر	متكامل	يدوي (عبر setup.py، إلخ)
سهولة الاستخدام	عالية (واجهة سطر أوامر بديهية)	متوسطة (خطوات يدوية أكثر)

مقارنة بـ Pip و virtualenv، تقدم Poetry تجربة تطوير أكثر تكاملاً وتبسيطًا، خاصة للمشاريع الأكبر حجمًا، وتوفر مصدرًا واحدًا للحقيقة لتبعيات المشروع. بينما Pip هو مدير حزم أساسي، فإن ميزات إدارة التبعيات والتعبئة في Poetry توفر حلاً كاملاً.

الخلاصة: احتضن تطوير بايثون الحديث مع Poetry

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

سواء كنت مطور بايثون متمرسًا أو بدأت للتو رحلتك، فإن دمج Poetry في سير عملك يمكن أن يحسن إنتاجيتك بشكل كبير، ويقلل من المشكلات المتعلقة بالتبعيات، ويمكّنك من إنشاء مشاريع بايثون أكثر قوة وقابلية لإعادة الإنتاج. مع استمرار تطور نظام بايثون البيئي، ستلعب أدوات مثل Poetry دورًا حاسمًا في دعم ممارسات تطوير البرامج الفعالة والموثوقة حول العالم.

فكر في دمج Poetry في مشاريع بايثون الخاصة بك واختبر فوائد إدارة تبعيات بايثون الحديثة.