محرر Python

محرر Python هو قلب بيئة تطوير QuantCraft (تخطيط مساحة العمل). يُفتح كلما حدّدت ملفًا في Files Sidebar أو فتحت علامة تبويب في شريط المحرر، ويمنحك تجربة برمجة متكاملة وحديثة مضبوطة لكتابة استراتيجيات التداول بلغة Python. أدِر المكتبات من Packages (التبعيات)، وشغّل الشيفرة بـ Run / Test (تشغيل الشيفرة).

تغطي هذه الصفحة المجالات الأربعة الأكثر استخدامًا:

• التحرير
• السمات
• حجم الخط
• Format Document

---

التحرير

عند فتح ملف، يملأ المحرر وسط IDE Main Panel ويتصرف مثل محررات Python التي اعتدت عليها.

كتابة الشيفرة

• تمييز الصياغة للغة Python، بألوان تحددها سمة المحرر التي تختارها.
• إزاحة ذكية — الضغط على Enter في نهاية سطر يزيح السطر التالي إزاحة صحيحة لـ Python (بعد def وclass وif وfor وwith وغيرها).
• التفاف الأسطر — تلتف الأسطر الطويلة بصريًا فلا تحتاج إلى التمرير أفقيًا. ولا يتغير المحتوى الفعلي.
• التدقيق الإملائي معطّل داخل المحرر، فلا تُسطَّر المعرّفات والكلمات المفتاحية.
• مفتاح Tab يُدرج 4 مسافات.

الإكمال التلقائي

يقدّم المحرر اقتراحات واعية بالسياق أثناء الكتابة:

• المقتطفات (Snippets) لأنماط Python الشائعة: def وclass وfor وwhile وtry وwith وlambda وimport وfrom وifmain وغيرها.
• المكتبة القياسية والحزم المثبّتة — كتابة import أو from تقترح وحدات من بيئة Python الخاصة ببيئة التطوير بالإضافة إلى مجلدات وملفات مساحة عملك.
• إكمال الأعضاء — كتابة . بعد وحدة أو حزمة أو كائن QuantCraft معروف (مثل bar. وfundamentals. وpd.) تُظهر الخصائص والدوال المتاحة. فضّل bar. وfundamentals. في دوال استدعاء الاستراتيجية — فالوحدة qc_ohlcv على مستوى الوحدة غالبًا ما تكون غير مضبوطة وقت الاستيراد داخل بيئة التطوير.
• تظهر الاقتراحات تلقائيًا؛ ويمكنك أيضًا استدعاؤها صراحةً بـ Ctrl+Space.

التنقل بين ملفات مساحة العمل

• Ctrl+Click (أو Cmd+Click على macOS) على import أو رمز في مساحة العمل ينتقل إلى ذلك الملف في المحرر ويضع المؤشر على السطر المطابق.
• تتذكر كل علامة تبويب موضع التمرير وموقع المؤشر بين الزيارات، فيعيدك تبديل الملفات دائمًا إلى المكان الذي توقفت عنده بالضبط.

البحث والاستبدال

توجد لوحة بحث مدمجة أعلى المحرر:

• Find — Ctrl+F (أو Edit → Find).
• Replace — Ctrl+H (أو Edit → Replace).
• لا يظهر صف الاستبدال إلا عندما يكون الملف قابلًا للتحرير.

أوامر التحرير القياسية

جميع إجراءات التحرير القياسية متاحة من قائمة Edit في شريط أدوات المحرر وعبر اختصارات لوحة المفاتيح:

نصيحة: النسخ واللصق يستخدمان حافظة النظام، فيمكنك نقل الشيفرة بين QuantCraft وأي تطبيق آخر.

---

السمات

سمة ألوان المحرر مستقلة عن بقية التطبيق — يمكنك تشغيل التطبيق في الوضع الداكن مع استخدام سمة محرر فاتحة، أو العكس.

تغيير السمة

1. افتح شريط أدوات المحرر في أعلى المحرر.
2. انقر Theme.
3. اختر سمة من القائمة. يتحدّث المحرر فورًا.

يُحفظ اختيارك تلقائيًا ويُستعاد عند فتح بيئة التطوير في المرة التالية.

السمات المتاحة

تتضمن قائمة Theme مجموعة منتقاة من السمات الفاتحة والداكنة:

• Default Light وDefault Dark
• VS Code Light وVS Code Dark (VS Code Dark هي الافتراضية)
• GitHub Light وGitHub Dark
• Dracula
• Monokai
• Nord
• Solarized Light وSolarized Dark
• Tokyo Night
• Gruvbox Dark
• Material Light وMaterial Dark

تدل علامة الاختيار في القائمة على السمة النشطة حاليًا.

---

حجم الخط

يمكنك اختيار حجم خط المحرر بما يناسب شاشتك وعينيك — دون تغيير أحجام الخطوط في أي مكان آخر من التطبيق.

تغيير حجم الخط

1. افتح شريط أدوات المحرر.
2. انقر Font Size.
3. اختر حجمًا. يُعاد رسم المحرر فورًا بالحجم الجديد.

يُحفظ اختيارك بين الجلسات.

الأحجام المتاحة

11 px و12 px و13 px و**14 px (الافتراضي)** و15 px و16 px و18 px و20 px و22 px.

تدل علامة الاختيار في القائمة على الحجم النشط.

---

Format Document

يرتّب Format Document الملف بأكمله في خطوة واحدة — وهو مفيد قبل تثبيت التغييرات أو مشاركة الشيفرة أو لإبقاء الاستراتيجية مقروءة أثناء عملك.

كيفية تشغيله

• افتح قائمة Edit في شريط أدوات المحرر واختر Format Document، أو
• اضغط Shift+Alt+F بينما يكون التركيز على المحرر.

ما يفعله

• بالنسبة لملفات Python، ينسّق المحرر شيفرتك باستخدام منسّق Python المدمج في QuantCraft.
• بالنسبة لملفات JSON، يعرض المحرر JSON بتنسيق مقروء (إزاحة بمسافتين). كما يُتعرَّف على JSON المفصول بأسطر جديدة وتُطبَّع كل سطر.
• إذا لم يكن الملف Python أو JSON صالحًا، يعود التنسيق إلى منسّق Python حتى تحصل مع ذلك على رسالة خطأ مفيدة.

أين تظهر الأخطاء

إذا تعذّر تنسيق ملف (مثلًا بسبب خطأ في الصياغة)، يترك المحرر شيفرتك دون تغيير ويكتب رسالة الخطأ في لوحة المخرجات أسفل مساحة العمل، مميّزة باللون الأحمر. أصلح المشكلة المُبلَّغ عنها ثم شغّل Format Document مرة أخرى.

نصائح

• لا يحفظ Format Document الملف — فهو يعيد كتابة المخزن المؤقت فقط. استخدم File → Save As… إذا احتجت إلى الحفظ باسم جديد.
• التراجع (Ctrl+Z) يلغي التنسيق في خطوة واحدة إذا لم تعجبك النتيجة.
• أمر التنسيق مدمج أيضًا في المحرر نفسه، لذا يعمل الاختصار Shift+Alt+F سواء كنت في القائمة أو تكتب في الشيفرة.