دليل استخدام pip في ServBay

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

يهدف هذا الدليل لمساعدة مستخدمي ServBay على فهم واستخدام pip بكفاءة لإدارة حزم بايثون، سواء لتثبيت مكتبات جديدة، أو تحديث التبعيات الحالية، أو العمل في بيئات معزولة.

ما هي pip؟

pip هي أداة لتثبيت وإدارة حزم بايثون. تستطيع من خلالها جلب الحزم من مؤشر حزم بايثون (PyPI) أو مصادر أخرى.

التاريخ والأهمية:
- تم إصدار pip لأول مرة عام 2008 كبديل مُحسن لأداة easy_install.
- منذ إصدار بايثون 3.4 أصبحت pip مضمنة افتراضياً ضمن حزمة التثبيت الخاصة ببايثون، وأصبحت أداة الإدارة القياسية للحزم.
- عبر pip، يمكن للمطور تثبيت وتحديث وحذف وإدارة كافة مكتبات وأطر العمل الخارجية بسهولة.
ملخص الوظائف الأساسية:
- تثبيت الحزم: تحميل وتثبيت حزم بايثون وتبعياتها من PyPI أو مصادر أخرى.
- إدارة التبعيات: تسجيل كافة الحزم اللازمة للمشروع مع الإصدارات المحددة، وإعادة بناء البيئة بناءً عليها (غالبًا عبر ملف requirements.txt).
- معالجة الإصدارات: تثبيت إصدارات معينة من الحزم، ومعالجة التعارضات المحتملة بين الحزم وتبعياتها.
- مصادر تثبيت متعددة: دعم التثبيت من PyPI، أو أنظمة إدارة الإصدارات مثل Git، أو من الملفات المحلية.
تكامل ServBay مع pip:
- يقدم ServBay دائماً أحدث إصدار مستقر من pip متوافق مع إصدار بايثون المثبت.
- يتكامل نظام إدارة الحزم في ServBay مع pip لتوفير تجربة تثبيت سلسة.
- يمكنك تثبيت وإدارة الحزم لمختلف إصدارات بايثون الموجودة ضمن بيئة ServBay.

المتطلبات المسبقة

قبل استخدام pip داخل ServBay تأكد من:

أنك قمت بتثبيت ServBay بنجاح ويعمل بشكل صحيح.
أنك قمت بتمكين إصدار واحد على الأقل من بايثون ضمن حزم ServBay.

الأساسيات: استخدام pip في ServBay

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

افتح نافذة الطرفية ونفّذ الأوامر التالية:

أوامر شائعة

تثبيت حزمة:
bash
```
pip install اسم_الحزمة
```
1
على سبيل المثال، لتثبيت إطار العمل الشهير Flask:
bash
```
pip install Flask
```
1
تثبيت إصدار محدد من الحزمة:
bash
```
pip install اسم_الحزمة==رقم_الإصدار
```
1
كمثال، لتثبيت الإصدار 2.0.0 من Flask:
bash
```
pip install Flask==2.0.0
```
1
تحديث حزمة:
bash
```
pip install --upgrade اسم_الحزمة
```
1
على سبيل المثال لتحديث Flask إلى أحدث إصدار:
bash
```
pip install --upgrade Flask
```
1
إزالة (حذف) حزمة:
bash
```
pip uninstall اسم_الحزمة
```
1
لإزالة Flask:
bash
```
pip uninstall Flask
```
1
بعد تنفيذ هذا الأمر سيعرض pip الملفات التي سيتم إزالتها ويطلب منك التأكيد.
عرض الحزم المثبتة:
bash
```
pip list
```
1
هذا الأمر سيعرض كافة الحزم والإصدارات المثبتة حاليًا في البيئة النشطة.
عرض الحزم التي تتوفر إصدارات أحدث منها:
bash
```
pip list --outdated
```
1
هذا يساعدك على معرفة الحزم التي يوجد لها تحديثات متاحة.

الطُرق المتقدمة لإدارة التبعيات عبر pip

خلال تطوير المشاريع، غالبًا ما تحتاج إلى استخدام مزايا متقدمة في pip لإدارة التبعيات بكفاءة.

توليد ملف التبعيات (requirements.txt): لتوثيق جميع الحزم والإصدارات المطلوبة حاليًا للمشروع، استخدم أمر pip freeze. هذا مهم لضمان اتساق البيئة بين التطوير والاختبار والإنتاج.
bash
```
pip freeze > requirements.txt
```
1
هذا ينشئ ملف requirements.txt يحوي قائمة كاملة بكافة الحزم المثبتة عبر pip في البيئة الحالية.
تثبيت التبعيات من ملف requirements.txt: عند استلام مشروع يحتوي على requirements.txt يمكنك تثبيت كافة التبعيات فيه بسهولة:
bash
```
pip install -r requirements.txt
```
1
سيقرأ pip الملف ويثبت الحزم والإصدارات المشار إليها بداخله.
استخدام مصدر حزم بديل (مؤقت): في بعض الشبكات قد يكون التحميل من PyPI بطيئًا أو غير مستقر. يمكنك تمرير الخيار -i لتحديد مصدر مرآة مؤقت للحزم:
bash
```
pip install اسم_الحزمة -i https://pypi.tuna.tsinghua.edu.cn/simple
```
1
لاحظ أن هذا التغيير مؤقت لهذا الأمر فقط. لجعل مصدر الحزم دائمًا افتراضيًا يمكنك تعديل إعدادات pip العامة.

البيئات الافتراضية (Virtual Environments)

ننصح دائمًا باستخدام البيئات الافتراضية أثناء تطوير مشاريع بايثون. البيئة الافتراضية عبارة عن بيئة منفصلة تحتوي على مترجم بايثون مخصص ونسخة مستقلة من pip ومجلد site-packages خاص بها. فوائد البيئات الافتراضية تتضمن:

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

إنشاء واستخدام البيئة الافتراضية ضمن ServBay

بيئة ServBay غالبًا ما تحتوي مسبقًا على الوحدة venv (موجودة افتراضيًا منذ بايثون 3.3) أو تدعم تثبيت أداة virtualenv. نوصي باستخدام الوحدة المدمجة venv.

إنشاء بيئة افتراضية: انتقل لمجلد مشروعك (مثلاً /Applications/ServBay/www/my-python-project) ثم نفذ:
bash
```
cd /Applications/ServBay/www/my-python-project
python -m venv myenv
```
1
2
سيتم إنشاء مجلد باسم myenv في نفس المسار يحوي بيئة بايثون مستقلة داخله.
تفعيل البيئة الافتراضية: تحتاج لتفعيل البيئة الافتراضية قبل استخدامها، ليتم توجيه جميع أوامر python وpip في ذلك الطرفية إلى البيئة الجديدة.
- في macOS/Linux:
  bash
```
source myenv/bin/activate
```
  1
- في Windows (عبر ServBay أو طرفية متوافقة):
  bash
```
myenv\Scripts\activate
```
  1
عند نجاح التفعيل، يظهر اسم البيئة الافتراضية في بادئة سطر الأوامر (مثلا: (myenv) your_prompt$).
استخدام pip ضمن البيئة الافتراضية: بعد تفعيل البيئة يمكنك تثبيت الحزم باستخدام pip، وسيتم وضعها حصريًا ضمن مجلد site-packages الخاص بـ myenv:
bash
```
(myenv) pip install requests
```
1
هذا سيتم تثبيت مكتبة requests ضمن البيئة الافتراضية فقط دون التأثير على النظام أو بيئات أُخرى.
الخروج من البيئة الافتراضية: عند الانتهاء يمكنك الخروج بتنفيذ:
bash
```
deactivate
```
1
ستلاحظ عودة سطر الأوامر إلى حالته الطبيعية، وأوامر python وpip ستشير مجددًا إلى البيئة العامة في النظام أو ServBay.

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

استخدم pip دومًا ضمن بيئة افتراضية: هذه القاعدة الذهبية في أي مشاريع بايثون.
أدرّ تبعيات مشروعك عبر ملف requirements.txt: حدث القائمة بانتظام مستخدمًا pip freeze > requirements.txt وضعها ضمن مستودع المشروع.
حدث pip بانتظام: رغم اعتماد ServBay على إصدار جديد من pip، إلا أنه يمكنك تحديث pip داخل بيئتك الافتراضية أو النظامية عبر: pip install --upgrade pip.
تابع تحديث الحزم القديمة: استخدم pip list --outdated لتعرف ما يمكن تحديثه وقرر وفقًا لمتطلبات مشروعك.
تعلم كيفية استكشاف الأخطاء الشائعة: في حال حدوث أخطاء تثبيت، راجع الرسائل جيدًا؛ الأسباب الشائعة تتضمن مشاكل الشبكة، الصلاحيات، تعارض التبعيات أو نقص أدوات البناء اللازمة.

الأسئلة الشائعة (FAQ)

س: أحصل على رسالة “الأمر pip غير معروف” في طرفية ServBay، ما العمل؟
- ج: تأكد من أنك فعّلت حزمة بايثون في تطبيق ServBay وأن متغيرات البيئة مضبوطة بشكل صحيح.
س: سرعة تثبيت الحزم بطيئة أو يفشل التثبيت؟
- ج: غالبًا بسبب مشاكل الشبكة. جرب استخدام الخيار -i لاختيار مصدر مرآة أسرع أو ضبط مصدر الحزم الافتراضي في pip.
س: تظهر لي “Permission Denied” عند تثبيت إحدى الحزم؟
- ج: لا تستخدم sudo pip install ... في البيئة العامة للنظام. يُفضل دائمًا استخدام البيئة الافتراضية حيث تكون الصلاحيات كافية. إذا لزم الأمر للتثبيت على مستوى المستخدم (وهو غير مفضل)، استخدم: pip install --user اسم_الحزمة.

الخلاصة

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

دليل استخدام pip في ServBay ​

ما هي pip؟ ​

المتطلبات المسبقة ​

الأساسيات: استخدام pip في ServBay ​

أوامر شائعة ​

الطُرق المتقدمة لإدارة التبعيات عبر pip ​

البيئات الافتراضية (Virtual Environments) ​

إنشاء واستخدام البيئة الافتراضية ضمن ServBay ​

نصائح وأفضل الممارسات ​

الأسئلة الشائعة (FAQ) ​

الخلاصة ​