13.1.1. محرر البرامج النصية

المحرر هو محرر نصوص احترافي كامل مبني على نواة Qt Creator، في تخطيط ذي علامات تبويب ونافذة واحدة. تبدّل علامات التبويب على طول الأعلى بين الملفات المفتوحة، وتعيش عمليات الملفات والتحرير المعتادة في قائمتي File وEdit وعلى أزرار شريط الأدوات على طول الحافة اليسرى. يعمل معظمه بالطريقة التي تتوقعها من أي محرر؛ والميزات أدناه هي تلك التي تهم عند العمل بـ MicroPython.

13.1.1.1. المسافات البيضاء

الإزاحة هي جزء من بناء جملة Python، وخطأ IndentationError الناجم عن علامة جدولة شاردة غير مرئي في العرض العادي. عندما يحدث ذلك، فعّل Visualize Whitespace تحت Edit → Advanced -- تُرسم كل مسافة وعلامة جدولة على الشاشة، ويسهل اكتشاف الشاذة منها.

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

اضغط Ctrl+F لشريط البحث والاستبدال. يطابق النص العادي، أو الكلمات الكاملة، أو التعبيرات النمطية، ويمكن للاستبدالات استخدام مجموعات الالتقاط والحفاظ على حالة الأحرف لكل تطابق تستبدله. اضغط Ctrl+Shift+F لـ Advanced Find، الذي يوسّع البحث ليشمل كل الملفات المفتوحة أو كل ملف ضمن مجلد على القرص ويسرد التطابقات كنتائج قابلة للنقر.

13.1.1.3. إكمال الكود وتلميحات الاستدعاء

يعرف المحرر واجهة برمجة Python في الكاميرا. اكتب . بعد اسم وحدة أو كائن فتُفتح قائمة إكمال بدوالها وطرقها وثوابتها؛ اختر واحدة فيرشدك تلميح استدعاء عبر الوسائط. مرّر المؤشر فوق أي اسم API لرؤية وثائقه في تلميح أداة -- النص نفسه الموجود في مرجع المكتبة، دون مغادرة المحرر. يغطي الإكمال الوحدات الخاصة بالكاميرا (csi، image، machine، وبقية مرجع المكتبة) بالإضافة إلى لغة Python نفسها.

يفحص خادم لغة Python مرفق كودك أثناء كتابتك، مُسطِّراً تحت الأسماء غير المعرّفة، والواردات غير المستخدمة، وأخطاء بناء الجملة قبل أن يعمل البرنامج النصي أصلاً -- فصنف كامل من أعطال الأخطاء المطبعية لا يصل إلى الكاميرا أبداً.

The editor's completion popup open after typing a dot, listing the image methods with their call signatures

اكتب نقطة فتُفتح قائمة الإكمال -- كل مدخل مع توقيع استدعائه الكامل.

13.1.1.4. GitHub Copilot

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

13.1.1.5. ما وراء ملفات Python

يفتح المحرر أكثر من البرامج النصية. افتح ملف صورة فيظهر في عارض صور بعناصر تحكم بالتكبير والملاءمة للشاشة -- مفيد لفحص اللقطات والقوالب المحفوظة دون مغادرة IDE. افتح ملفاً ثنائياً فيظهر في محرر سداسي عشري، مفيد لإلقاء نظرة سريعة داخل تسجيل أو ملف واصف.

13.1.1.6. التحرير خارج IDE

البرامج النصية ملفات .py بسيطة، ولا شيء يلزمك بتحريرها في IDE. عندما يتغير ملف مفتوح في المحرر على القرص -- محفوظاً من محرر آخر، أو مسحوباً من نظام التحكم بالإصدارات -- يلاحظ IDE ذلك بمجرد استعادة نافذته للتركيز ويعيد تحميل الملف. يسأل أولاً فقط إذا كانت النسخة في المحرر تحتوي على تغييرات غير محفوظة خاصة بها.