الاستيراد والتصدير

تتضمن قائمة File في بيئة تطوير QuantCraft (في شريط أدوات محرر Python فوق المحرر) أداتين تربطان مساحة العمل بباقي حاسوبك:

• Export — يحفظ الملف المفتوح حاليًا في المحرر كملف .py في أي مكان على القرص.
• Import… — يجلب ملفات .py (أو .json وغيرها من الملفات النصية) من حاسوبك إلى مساحة العمل كعلامات تبويب جديدة.

يفتح كلا الإجراءين مربع حوار الحفظ / الفتح القياسي في النظام، فيمكنك اختيار أي مجلد على جهازك.

---

Export

استخدم File → Export لحفظ نسخة من الملف النشط في المحرر على القرص.

ما يفعله:

• يأخذ المحتوى الحي للملف المفتوح في المحرر (فتُضمَّن أي تعديلات غير محفوظة).
• يقترح اسم ملف بناءً على عنوان علامة التبويب — تُضاف الامتداد .py تلقائيًا، وتُستبدل الأحرف غير المسموح بها في أسماء الملفات بـ _.
• يفتح مربع حوار Save في النظام حيث يمكنك تغيير الاسم واختيار المجلد والتأكيد.
• يكون مرشّح مربع الحوار افتراضيًا Python (.py)، مع All files كبديل.
• بعد الحفظ بنجاح تظهر رسالة تأكيد قصيرة.

ملاحظات:

• يعمل Export على ملف واحد في كل مرة — الملف الذي عليه التركيز في المحرر.
• إذا لم يكن هناك ملف مفتوح في المحرر، تعرض القائمة تنبيهًا يطلب منك فتح ملف أولًا.
• Export مستقل عن مجلد مساحة العمل المرتبط — يذهب الملف المحفوظ إلى المكان الذي تحدده في مربع الحوار، وليس إلى مجلد مساحة العمل. ولنسخ ملف داخل مساحة العمل، استخدم Save As… في قائمة File بدلًا من ذلك.
• ميزة التصدير متاحة في تطبيق سطح المكتب (Tauri). أما في نسخة المتصفح فلا يمكنها فتح مربع حوار حفظ أصلي.

---

Import…

استخدم File → Import… لجلب ملف واحد أو أكثر من القرص إلى مساحة العمل كعلامات تبويب جديدة في المحرر.

ما يفعله:

• يفتح مربع حوار Open في النظام مع تفعيل التحديد المتعدد، فيمكنك اختيار عدة ملفات دفعة واحدة.
• المرشّحات المتاحة:
  • Python (.py)
  • JSON (.json)
  • All files
• يقرأ كل ملف كنص وينشئ علامة تبويب جديدة له في بيئة التطوير.
• تستخدم علامات التبويب الجديدة اسم الملف الذي استوردته (مع إزالة الالتباس — إذا كانت علامة تبويب باسم strategy.py موجودة بالفعل، يصبح الملف المستورد strategy (1).py ثم strategy (2).py وهكذا).
• تُوضع الملفات المستوردة في جذر مساحة العمل (بلا مجلد)، فتظهر في المستوى الأعلى من الشريط الجانبي Files. ويمكنك بعد ذلك سحبها إلى مجلد إن أردت.

المتطلبات:

• يجب أن تكون مساحة عمل بيئة التطوير محمّلة. إذا شغّلت Import أثناء تحميلها، يطلب منك تنبيه قصير الانتظار.
• يجب أن يكون مجلد مساحة العمل مرتبطًا في الشريط الجانبي Files. يعرض الاستيراد بدونه رسالة تطلب منك اختيار مجلد أولًا — فـ Import يكتب الملفات الجديدة في ذلك المجلد لتكون جزءًا من مشروعك على القرص.
• مثل Export، يستخدم Import مربعات حوار الملفات الأصلية وهو مخصص لـتطبيق سطح المكتب.

---

نصائح

• استخدم Export لمشاركة استراتيجية — اختر ملف الاستراتيجية وصدّره بصيغة .py وأرسل الملف إلى زميل. يمكنه استخدام Import… لإدخاله مباشرة إلى مساحة عمله.
• الاستيراد الجماعي — أضف مجلدًا من ملفات .py إلى مساحة العمل بتحديدها كلها دفعة واحدة في مربع حوار Import. يصبح كل ملف علامة تبويب مستقلة.
• حافظ على تفرّد الأسماء — يعيد Import تسمية الملفات المكررة تلقائيًا بحيث لا يكتب فوق علامة تبويب موجودة أبدًا. وإذا كنت تفضّل اسم الملف المستورد، فأعد تسمية الملف السابق أو احذفه ثم استورد مرة أخرى.
• للإعدادات الكاملة (تفضيلات الواجهة والحسابات وقائمة الحزم وغيرها) استخدم العنصرين العامين Export Config… / Import Config… من قائمة التطبيق العلوية — فهما يتعاملان مع كل ما هو خارج محرر بيئة التطوير نفسه.