الحزم الخارجية في خوارزميات Python

عند إنشاء cBots أو مؤشرات أو إضافات تعتمد على Python لـ cTrader، قد تحتاج إلى استخدام حزم خارجية مثل pandas أو numpy أو مكتبات أخرى. يوضح هذا الدليل كيفية الإعلان عن مثل هذه التبعيات في ملف requirements.txt، مما يضمن تشغيل الخوارزمية الخاصة بك بشكل صحيح عبر البيئات المختلفة.

إعداد الملف والقواعد

requirements.txt هو ملف نصي عادي يُستخدم لتحديد حزم Python الخارجية التي يحتاجها المشروع. يجب أن يتبع ملف requirements.txt الخاص بك هذه القواعد:

• يجب تسمية الملف بالضبط requirements.txt
• يجب وضع الملف في جذر المشروع، إلى جانب ملف الإدخال Python الخاص بك (على سبيل المثال، Super cBot_main.py).
• يجب تضمين الملف في ملفات المشروع بحيث يتم تعبئته مع الخوارزمية.

بمجرد وجود ملف requirements.txt وتنسيقه بشكل صحيح، ما عليك سوى بناء مشروعك، وستتم إضافة جميع التبعيات المدرجة وحلها تلقائيًا. إليك مثال:

الموقعالمحتوى

...\Documents\cAlgo\Sources\Robots\Super cBot\Super cBot

1 2	pandas==2.2.2 numpy>=1.26.4

الميزات المدعومة

يتبع تنسيق requirements.txt الاتفاقيات القياسية المستخدمة بواسطة pip. توضح الأمثلة التالية كيفية تحديد إصدارات الحزم باستخدام محددات الإصدار، وإضافة التعليقات واستخدام الأسطر الفارغة لتحسين القراءة:

التثبيت على إصدار محدد

1

pandas==2.2.2

السماح بإصدار أدنى

1

numpy>=1.26.4

استخدام التعليقات والأسطر الفارغة

1
2
3
4
5

# Data science libraries
pandas==2.2.2
numpy>=1.26.4

# You can leave blank lines for readability

أفضل الممارسات

1. قم بتثبيت المكتبات الأساسية لتجنب السلوك غير المتوقع عندما تقدم الإصدارات الجديدة تغييرات جذرية.
2. إذا كنت تستخدم محددات النطاق للحزم الأقل أهمية، فاختبر الخوارزمية الخاصة بك كلما تم تحديث التبعية.
3. فكر في كتابة تعليقات ذات مغزى لشرح سبب استخدام حزم معينة أو سبب اختيار إصدارات محددة.
4. أعد بناء مشروعك في كل مرة تقوم فيها بتحرير requirements.txt للتأكد من تثبيت التبعيات بشكل صحيح.