python editor v3

مايكرو: بت بايثون محرر V3

هذا المشروع عبارة عن محرر أكواد برمجية على الويب يستهدف إصدار MicroPython من لغة البرمجة Python.

من المتوقع أن يتم تشغيل التعليمات البرمجية المكتوبة باستخدام هذا المحرر على جهاز BBC micro:bit.

جربه على https://python.microbit.org/

تُظهر الصورة نشر العلامة التجارية micro:bit

الإصدارات السابقة

لمزيد من المعلومات حول كيفية ارتباط هذا المحرر بمشروع Python Editor الأصلي، راجع هذا الشرح.

لا يزال مشروع محرر V2 متاحًا على https://python.microbit.org/v/2 ويمكن العثور على الكود المصدري الخاص به في GitHub على https://github.com/bbcmicrobit/PythonEditor.

بناء وتشغيل المحرر

لقد كتبنا نظرة عامة فنية تمثل نقطة انطلاق جيدة للعمل على محرر Python أو لاستخدام الأفكار والمكونات من التطبيق في مشاريع أخرى. نود أن نسمع منك إذا كنت تستفيد من هذا المشروع. يمكنك التواصل عبر الدعم.

النهوض والتشغيل:

1. تأكد من أن لديك بيئة Node.js صالحة للعمل. نوصي باستخدام إصدار LTS من Node وNPM الإصدار 8 أو الأحدث.
2. تحقق من هذا المستودع باستخدام Git. لدى GitHub بعض الموارد التعليمية لـ Git والتي قد تجدها مفيدة.
3. قم بتثبيت التبعيات عن طريق تشغيل npm install على سطر الأوامر في مجلد الخروج.
4. اختر من البرامج النصية NPM الموثقة أدناه. حاول npm start إذا لم تكن متأكدًا.

npm start

تشغيل التطبيق في وضع التطوير.

افتح http://localhost:3000 لمشاهدته في المتصفح.

سيتم إعادة تحميل الصفحة إذا قمت بإجراء تعديلات.

هذا لا يُظهر أخطاء TypeScript أو الوبر. استخدم المكوّن الإضافي eslint لمحررك وفكر أيضًا في تشغيل npm run typecheck:watch لرؤية أخطاء التحقق من النوع بالكامل.

npm test

تشغيل مشغل الاختبار في الوضع التفاعلي (ما لم يتم تعريف متغير بيئة CI ). راجع القسم الخاص بإجراء الاختبارات لمزيد من المعلومات.

إذا كان لديك جهاز micro:bit متصل، فإن تعيين متغير البيئة TEST_MODE_DEVICE=1 سيعمل على تمكين الاختبارات الإضافية التي ستتصل بجهاز micro:bit الخاص بك. ستقوم الاختبارات بالكتابة فوق البرامج والبيانات الموجودة على micro:bit.

npm run test:e2e

يقوم بتشغيل عداء الاختبار في وضع المراقبة التفاعلية الذي يقوم بتشغيل الاختبارات الشاملة.

يتم استبعاد هذه من التشغيل التجريبي العادي.

تتوقع الاختبارات أن يكون التطبيق قيد التشغيل بالفعل على http://localhost:3000، على سبيل المثال عبر npm start .

نحن نستخدم الكاتب المسرحي.

تقوم اختبارات CI بإجراء هذه الاختبارات الشاملة مقابل بناء الإنتاج.

npm run build

ينشئ التطبيق للإنتاج في مجلد build .
فهو يجمع React بشكل صحيح في وضع الإنتاج ويحسن البناء للحصول على أفضل أداء.

عمليات النشر

يجب على معظم المستخدمين استخدام النشر الأساسي المدعوم على https://python.microbit.org/

يتم نشر المحرر من خلال إجراءات GitHub.

يتم نشر الفرع main على https://python.microbit.org/v/beta في كل دفعة.

يتم نشر الفروع الأخرى (مثل العلاقات العامة) على https://review-python-editor-v3.microbit.org/{branch}. يتم استبدال الأحرف الخاصة في اسم الفرع بالواصلات. لن يتم تشغيل عمليات النشر في الشوكات.

رخصة

هذا البرنامج تحت ترخيص MIT مفتوح المصدر.

معرف ترخيص SPDX: MIT

يتم تضمين ثنائيات MicroPython لـ micro:bit V1 (الترخيص) وmicro:bit V2 (الترخيص). كلاهما مرخص من معهد ماساتشوستس للتكنولوجيا.

تستخدم تشخيصات Python والإكمال التلقائي شوكة من مدقق نوع Pyright من Microsoft والذي تم تعديله بواسطتنا ليعمل كعامل ويب. حقوق الطبع والنشر محفوظة لشركة Microsoft Corporation وتستخدم بموجب ترخيص من معهد ماساتشوستس للتكنولوجيا (MIT).

نحن نستخدم التبعيات عبر سجل NPM كما هو محدد في ملف package.json بموجب تراخيص مفتوحة المصدر مشتركة.

يمكن العثور على التفاصيل الكاملة لكل حزمة عن طريق تشغيل license-checker :

$ npx license-checker --direct --summary --production

حذف الأعلام حسب الرغبة للحصول على مزيد من التفاصيل.

مدونة لقواعد السلوك

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