python editor v3

ไมโคร:บิต ไพธอน เอดิเตอร์ V3

โปรเจ็กต์นี้เป็นโปรแกรมแก้ไขโค้ดบนเว็บที่กำหนดเป้าหมายภาษาการเขียนโปรแกรม Python เวอร์ชัน MicroPython

โค้ดที่เขียนด้วยโปรแกรมแก้ไขนี้คาดว่าจะทำงานบนอุปกรณ์ 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 Editor หรือสำหรับการใช้แนวคิดและส่วนประกอบจากแอปในโปรเจ็กต์อื่น เรายินดีรับฟังจากคุณหากคุณใช้โครงการนี้ คุณสามารถติดต่อผ่านฝ่ายสนับสนุน

การเริ่มต้นใช้งาน:

1. ตรวจสอบให้แน่ใจว่าคุณมีสภาพแวดล้อม Node.js ที่ใช้งานได้ เราขอแนะนำให้ใช้โหนดเวอร์ชัน LTS และ NPM เวอร์ชัน 8 หรือใหม่กว่า
2. ชำระเงินพื้นที่เก็บข้อมูลนี้ด้วย Git GitHub มีแหล่งข้อมูลการเรียนรู้สำหรับ Git ที่คุณอาจพบว่ามีประโยชน์
3. ติดตั้งการขึ้นต่อกันโดยการรัน npm install บนบรรทัดคำสั่งในโฟลเดอร์ชำระเงิน
4. เลือกจากสคริปต์ NPM ที่บันทึกไว้ด้านล่าง ลอง npm start หากคุณไม่แน่ใจ

npm start

เรียกใช้แอปในโหมดการพัฒนา

เปิด http://localhost:3000 เพื่อดูในเบราว์เซอร์

เพจจะโหลดซ้ำหากคุณทำการแก้ไข

สิ่งนี้ไม่แสดงข้อผิดพลาด TypeScript หรือ Lint ใช้ปลั๊กอิน 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 ดำเนินการการทดสอบแบบ end-to-end เหล่านี้กับรุ่นที่ใช้งานจริง

npm run build

สร้างแอปสำหรับการผลิตไปยังโฟลเดอร์ build ด์
มันรวม React ในโหมดการผลิตอย่างถูกต้องและปรับโครงสร้างให้เหมาะสมเพื่อประสิทธิภาพที่ดีที่สุด

การปรับใช้

ผู้ใช้ส่วนใหญ่ควรใช้การปรับใช้ Foundation ที่รองรับที่ https://python.microbit.org/

ตัวแก้ไขถูกปรับใช้โดยการกระทำของ GitHub

สาขา main ถูกปรับใช้กับ https://python.microbit.org/v/beta ในแต่ละครั้ง

สาขาอื่นๆ (เช่น สำหรับ PR) ได้รับการปรับใช้กับ https://review-python-editor-v3.microbit.org/{branch} อักขระพิเศษในชื่อสาขาจะถูกแทนที่ด้วยยัติภังค์ การปรับใช้จะไม่ทำงานในทางแยก

ใบอนุญาต

ซอฟต์แวร์นี้อยู่ภายใต้ใบอนุญาตโอเพ่นซอร์สของ MIT

SPDX-ใบอนุญาต-ตัวระบุ: MIT

ไบนารีสำหรับ MicroPython รวมอยู่ใน micro:bit V1 (ใบอนุญาต) และ micro:bit V2 (ใบอนุญาต) ทั้งสองได้รับใบอนุญาตจาก MIT

การวินิจฉัย Python และการเติมข้อความอัตโนมัติใช้ทางแยกของตัวตรวจสอบประเภท Pyright ของ Microsoft ซึ่งเราแก้ไขให้ทำงานเป็น Web Worker Pyright คือ © Microsoft Corporation และใช้ภายใต้ใบอนุญาต MIT

เราใช้การขึ้นต่อกันผ่านรีจิสทรี NPM ตามที่ระบุไว้ในไฟล์ package.json ภายใต้ใบอนุญาต Open Source ทั่วไป

รายละเอียดทั้งหมดของแต่ละแพ็คเกจสามารถพบได้โดยการรัน license-checker :

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

ละเว้นแฟล็กตามต้องการเพื่อให้ได้รายละเอียดเพิ่มเติม

หลักจรรยาบรรณ

ความไว้วางใจ หุ้นส่วน ความเรียบง่าย และความหลงใหลคือค่านิยมหลักของเราที่เราดำเนินชีวิตและหายใจเข้าในชีวิตการทำงานในแต่ละวันและภายในโครงการของเรา โครงการโอเพ่นซอร์สของเราก็ไม่มีข้อยกเว้น เรามีชุมชนที่กระตือรือร้นซึ่งครอบคลุมทั่วโลก และเรายินดีและสนับสนุนให้ทุกคนมีส่วนร่วมและมีส่วนร่วมในโครงการของเรา เราทำงานเพื่อส่งเสริมสภาพแวดล้อมเชิงบวก เปิดกว้าง ครอบคลุม และสนับสนุน และไว้วางใจว่าชุมชนของเราเคารพหลักจรรยาบรรณแบบ micro:bit โปรดดูจรรยาบรรณของเราซึ่งสรุปความคาดหวังของเราสำหรับทุกคนที่มีส่วนร่วมในชุมชนของเราและรายละเอียดเกี่ยวกับวิธีการรายงานข้อกังวลใด ๆ และสิ่งที่จะเกิดขึ้นหากมีการละเมิดเกิดขึ้น