بسم الله الرحمن الرحيم 

الصلاة والسلام على اشرف المرسلين صلى الله عليه وسلم 

السلام عليكم ورحمة الله

تثبيت الحزم في بيئة افتراضية باستخدام pip و venv 

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

 إذا كنت تستخدم مدير حزم نظام التشغيل الخاص بك لتثبيت Python، فيرجى التأكد من تثبيت Python قبل متابعة هذه الخطوات.
إنشاء بيئة افتراضية جديدة
يتيح لك venv (لـ Python 3) إدارة عمليات تثبيت الحزم المنفصلة لمشاريع مختلفة. يقوم بإنشاء تثبيت بايثون "افتراضي" معزول.
عند تبديل المشاريع، يمكنك إنشاء بيئة افتراضية جديدة معزولة عن البيئات الافتراضية الأخرى. أنت تستفيد من البيئة الافتراضية حيث يمكن تثبيت الحزم بثقة ولن تتداخل مع بيئة مشروع آخر.
يوصى باستخدام بيئة افتراضية عند العمل مع حزم الطرف الثالث.
لإنشاء بيئة افتراضية، انتقل إلى دليل مشروعك وقم بتشغيل الأمر التالي. سيؤدي هذا إلى إنشاء بيئة افتراضية جديدة في مجلد محلي باسم .venv:

python3 -m venv venv

الوسيطة الثانية هي الموقع لإنشاء البيئة الافتراضية. بشكل عام، يمكنك فقط إنشاء هذا في مشروعك وتسميته .venv.

سيقوم venv بإنشاء تثبيت Python افتراضي في مجلد
.venv
يجب عليك استبعاد دليل البيئة الافتراضية الخاص بك من نظام التحكم في الإصدار الخاص بك باستخدام .gitignore أو ما شابه.
تفعيل البيئة الافتراضية
قبل أن تتمكن من البدء في تثبيت الحزم أو استخدامها في بيئتك الافتراضية، ستحتاج إلى تنشيطها. سيؤدي تنشيط البيئة الافتراضية إلى وضع ملفات python و pip القابلة للتنفيذ الخاصة بالبيئة الافتراضية في PATH الخاص بـ Shell.

source venv/bin/activate

للتأكد من تنشيط البيئة الافتراضية، تحقق من موقع مترجم Python الخاص بك:

which python

عندما تكون البيئة الافتراضية نشطة، سيقوم الأمر أعلاه بإخراج مسار ملف يتضمن الدليل .venv، من خلال الانتهاء مما يلي:

.venv/bin/python

أثناء تنشيط البيئة الافتراضية، ستقوم pip (pip) بتثبيت الحزم في تلك البيئة المحددة. يمكّنك هذا من استيراد واستخدام الحزم في تطبيق Python الخاص بك.
قم بإلغاء تنشيط البيئة الافتراضية
إذا كنت تريد تبديل المشاريع أو مغادرة بيئتك الافتراضية، فقم بإلغاء تنشيط البيئة:

deactivate

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

source .venv/bin/activate

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

python3 -m pip install --upgrade pip

python3 -m pip --version

بعد ذلك، يجب أن يكون لديك أحدث إصدار من pip مثبتًا في موقع المستخدم الخاص بك:

pip 0.0.0 from .../.venv/lib/python3.0/site-packages (python 0.0

تثبيت الحزم باستخدام pip
عندما يتم تنشيط بيئتك الافتراضية، يمكنك تثبيت الحزم. استخدم الأمر pip install لتثبيت الحزم.
قم بتثبيت الحزمة
على سبيل المثال، لنقم بتثبيت مكتبة الطلبات من Python Package Index (PyPI):

python3 -m pip install requests

تسمح لك pip بتحديد إصدار الحزمة المراد تثبيته باستخدام محددات الإصدار. على سبيل المثال، لتثبيت إصدار محدد من الطلبات:
python3 -m pip install 'أحدث إصدار 2.x'


لتثبيت أحدث إصدار 2.x من الطلبات:

python3 -m pip install 'أحدث إصدار 2.x'


لتثبيت إصدارات ما قبل النشر من الحزم، استخدم العلامة --pre :

python3 -m pip install --pre requests

تثبيت الإضافات
تحتوي بعض الحزم على إضافات اختيارية. يمكنك إخبار pip بتثبيت هذه العناصر عن طريق تحديد الإضافات بين قوسين:

python3 -m pip install --pre requests

قم بتثبيت الحزمة من المصدر
يمكن لـ pip تثبيت الحزمة مباشرةً من كود المصدر الخاص بها. على سبيل المثال، لتثبيت الكود المصدري في دليل google-auth:

cd google-auth

python3 -m pip install

بالإضافة إلى ذلك، يمكن لـ pip تثبيت الحزم من المصدر في وضع التطوير، مما يعني أن التغييرات في الدليل المصدر ستؤثر فورًا على الحزمة المثبتة دون الحاجة إلى إعادة التثبيت:

python3 -m pip install --editable .

التثبيت من أنظمة التحكم في الإصدار
يمكن لـ pip تثبيت الحزم مباشرةً من نظام التحكم في الإصدار الخاص بها. على سبيل المثال، يمكنك التثبيت مباشرةً من مستودع git:
google-auth @ git+https://github.com/GoogleCloudPlatform/google-auth-library-python.git

لمزيد من المعلومات حول أنظمة التحكم في الإصدار المدعومة وبناء الجملة، راجع وثائق pip على دعم VCS.

التثبيت من الأرشيفات المحلية
إذا كان لديك نسخة محلية من أرشيف حزمة التوزيع (ملف مضغوط أو ملف عجلة أو ملف tar) فيمكنك تثبيته مباشرةً باستخدام pip:

python3 -m pip install requests-0.tar.gz

إذا كان لديك دليل يحتوي على أرشيفات لحزم متعددة، فيمكنك إخبار pip بالبحث عن الحزم هناك وعدم استخدام Python Package Index (PyPI) على الإطلاق:

python3 -m pip install --no-index --find-links=/local/dir/ requests

يعد هذا مفيدًا إذا كنت تقوم بتثبيت حزم على نظام ذي اتصال محدود أو إذا كنت تريد التحكم الصارم في أصل حزم التوزيع.

التثبيت من فهارس الحزمة الأخرى
إذا كنت تريد تنزيل الحزم من فهرس مختلف عن Python Package Index (PyPI)، فيمكنك استخدام علامة --index-url :

python3 -m pip install --index-url http://index.example.com/simple/ SomeProject

إذا كنت تريد السماح بالحزم من كل من Python Package Index (PyPI) وفهرس منفصل، فيمكنك استخدام علامة --extra-index-url بدلاً من ذلك:

python3 -m pip install --extra-index-url http://index.example.com/simple/ SomeProject

ترقية الحزم
يمكن  ترقية الحزم pip  باستخدام علامة --upgrade. على سبيل المثال، لتثبيت أحدث إصدار من الطلبات وجميع تبعياتها:

python3 -m pip install --upgrade requests

باستخدام ملف المتطلبات
بدلاً من تثبيت الحزم بشكل فردي، تتيح لك pip (pip) الإعلان عن جميع التبعيات في ملف المتطلبات. على سبيل المثال، يمكنك إنشاء ملف require.txt يحتوي على:
requests==2.18.4
google-auth==1.1.0
واطلب من pip تثبيت كافة الحزم الموجودة في هذا الملف باستخدام العلامة -r :

python3 -m pip install -r Requirements.txt

تجميد التبعيات
يمكن لـ Pip تصدير قائمة بجميع الحزم المثبتة وإصداراتها باستخدام أمر التجميد:

python3 -m pip freeze

يعد أمر تجميد النقاط مفيدًا لإنشاء ملفات المتطلبات التي يمكنها إعادة إنشاء الإصدارات الدقيقة لجميع الحزم المثبتة في بيئة ما.