تثبيت الاعتماديات باستخدام requirements.txt

يستدعي كودكم المكتبات، وهذه المكتبات تتغير. يعني تثبيت الإصدار تدوين الإصدارات الدقيقة، حتى يطابق تثبيت اليوم تثبيت الغد. 📌

في Python، يسرد ملف نصي عادي اسمه requirements.txt كل حزمة يحتاج إليها مشروعكم، حزمةً في كل سطر. إنه وصفة التثبيت الخاصة بكم.

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

استخدم العامل == لتثبيت إصدار محدد بدقة. وهكذا تثبّت كل آلة الكود نفسه في كل مرة.

يطبع الأمر pip freeze كل حزمة مثبتة مع إصدارها الدقيق، ويكون الناتج جاهزًا للصق في ملفكم.

مرّروا الملف إلى pip ليعيد إنشاء إعدادكم بالكامل. وتعني العلامة -r قراءة المتطلبات من هذا الملف.

يتيح العامل ~= تحديثات التصحيحات الآمنة، لكنه يمنع التغييرات التي قد تكسر التوافق. فهو يقبل 1.4.x، لكنه لا ينتقل أبدًا إلى 1.5.

تجلب الحزم التي تسردونها تبعياتها الخاصة أيضًا. وقد تغيّر هذه التبعيات المخفية الإصدارات وتسبب التعطل بالسهولة نفسها.

يسجل ملف القفل الإصدار الدقيق لكل حزمة، بما في ذلك التبعيات الانتقالية المخفية. وينشئ pip-tools وPoetry هذه الملفات نيابةً عنكم.

تؤدي إضافة تجزئة إلى جعل pip يرفض أي حزمة لا تتطابق بايتاتها. وهذا يحمي من التنزيلات التي تم العبث بها أو استبدالها.

أودعوا requirements.txt في التحكم في الإصدارات إلى جانب الكود. وهكذا تنتقل البيئة الدقيقة مع كل إيداع ومراجعة.

تعلمتم تثبيت الإصدارات الدقيقة في requirements.txt، وتجميدها وإعادة تثبيتها، وقفل الشجرة كاملةً لتظل عمليات التثبيت حتمية. 🎯