الحاجة إلى البيئات الافتراضية والاستنساخ

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

1. البيئات الافتراضية: مساحات معزولة تُبقي تبعيات المشروع منفصلة عن عمليات تثبيت Python على مستوى النظام.

2. قابلية التكرار: التأكد من إمكانية إعداد المشروع بسهولة وتشغيله بشكل متسق عبر أجهزة أو بيئات مختلفة.

تم استخدام الأدوات التقليدية مثل venv وpip لهذه الأغراض منذ فترة طويلة، ولكنها غالبًا ما تتطلب خطوات متعددة وتدخلًا يدويًا. هذا هو المكان الذي يأتي فيه الشعر، حيث يقدم حلاً أكثر بساطة وقوة.

لماذا تختار الشعر؟

يقدم الشعر العديد من المزايا مقارنة بالأدوات التقليدية:

1. سير العمل المبسط: يجمع بين إدارة التبعية والتعبئة والنشر في أداة واحدة.

2. تحليل التبعيات: حل التبعيات والتعارضات المحتملة تلقائيًا.

3. البنيات القابلة للتكرار: تضمن بيئات متسقة عبر الأجهزة المختلفة.

4. ملف القفل: يُنشئ ملف قفل للتحكم الدقيق في الإصدار لجميع التبعيات.

5. عزل المشروع: إنشاء وإدارة البيئات الافتراضية تلقائيًا.

6. الأوامر البديهية: توفر واجهة سطر الأوامر (CLI) سهلة الاستخدام للمهام الشائعة.

تركيب وإعداد الشعر

curl -sSL https://install.python-poetry.org | python3 -

بعد التثبيت، أضف الشعر إلى المسار الخاص بك عن طريق إضافة السطر التالي إلى ملف تكوين الصدفة الخاص بك (على سبيل المثال، ~/.bashrc أو ~/.zshrc):

export PATH="$HOME/.local/bin:$PATH"

أعد تشغيل جهازك الطرفي أو قم بتشغيل المصدر ~/.bashrc (أو الملف المناسب) لتطبيق التغييرات.

التحقق من التثبيت عن طريق تشغيل:

poetry --version

تمكين إكمال علامة التبويب لـ Bash أو Fish أو Zsh

يدعم الشعر إنشاء نصوص برمجية كاملة لـ Bash وFish وZsh.

سحق

poetry completions bash >> ~/.bash_completion

سمكة

poetry completions fish > ~/.config/fish/completions/poetry.fish

زش

poetry completions zsh > ~/.zfunc/_poetry

استخدام الشعر

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

لإنشاء مشروع بايثون جديد باستخدام الشعر:

poetry new my-project
cd my-project

يؤدي هذا إلى إنشاء دليل جديد ببنية المشروع الأساسية، بما في ذلك ملف pyproject.toml.

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

لإضافة تبعية جديدة:

poetry add requests

يؤدي هذا إلى إضافة الحزمة إلى ملف pyproject.toml الخاص بك وتثبيتها في البيئة الافتراضية.

إدارة التبعيات

عرض الحزم المثبتة:

poetry show

تحديث جميع الحزم:

poetry update

إزالة الحزمة:

poetry remove requests

تشغيل البرامج النصية

تنفيذ نصوص بايثون داخل البيئة الافتراضية للمشروع:

poetry run python your_script.py

إدارة البيئة الافتراضية

تفعيل البيئة الافتراضية:

poetry shell

إلغاء تنشيطه:

exit

البناء والنشر

قم ببناء مشروعك:

poetry build

النشر على PyPI:

poetry publish

متطلبات التصدير

إنشاء ملف متطلبات.txt:

poetry export -f requirements.txt --output requirements.txt

خاتمة

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