該專案是一個基於 Web 的程式碼編輯器,面向 Python 程式語言的 MicroPython 版本。
使用此編輯器編寫的程式碼預計可以在 BBC micro:bit 裝置上執行。
請在 https://python.microbit.org/ 試試看
該圖顯示了 micro:bit-branded 部署有關此編輯器如何與原始 Python 編輯器專案相關的更多背景信息,請參閱此說明。
V2 編輯器專案仍可在 https://python.microbit.org/v/2 上找到,其原始程式碼可在 GitHub 中找到:https://github.com/bbcmicrobit/PythonEditor。
我們編寫了一份技術概述,這是使用 Python 編輯器或在其他專案中使用應用程式中的想法和元件的良好起點。如果您正在使用該項目,我們很樂意聽取您的意見。您可以透過支援取得聯繫。
啟動並運行:
npm install
來安裝依賴項。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 測試針對生產建置執行這些端對端測試。
npm run build
將用於生產的應用程式建置到build
資料夾。
它在生產模式下正確捆綁 React 並優化構建以獲得最佳性能。
大多數使用者應使用 https://python.microbit.org/ 上支援的 Foundation 部署
此編輯器由 GitHub actions 部署。
每次推送時, main
分支都會部署到 https://python.microbit.org/v/beta。
其他分支(例如 PR)部署到 https://review-python-editor-v3.microbit.org/{branch}。分支名稱中的特殊字元將替換為連字符。部署不會在分叉中運作。
該軟體遵循 MIT 開源許可證。
SPDX 許可證識別碼:MIT
micro:bit V1(許可證)和 micro:bit V2(許可證)包含 MicroPython 的二進位。兩者均獲得麻省理工學院許可。
Python 診斷和自動完成使用 Microsoft Pyright 類型檢查器的一個分支,我們已對其進行修改以作為 Web Worker 運行。 Pyright 屬於 © Microsoft Corporation,並在 MIT 授權下使用。
我們透過 NPM 註冊表使用依賴項,如通用開源許可證下的 package.json 檔案所指定的那樣。
可以透過執行license-checker
找到每個套件的完整詳細資訊:
$ npx license-checker --direct --summary --production
根據需要省略標誌以獲得更多詳細資訊。
信任、夥伴關係、簡單和熱情是我們在日常工作和專案中生活和呼吸的核心價值。我們的開源專案也不例外。我們擁有一個遍布全球的活躍社區,我們歡迎並鼓勵每個人參與我們的專案並為我們的專案做出貢獻。我們致力於創造一個積極、開放、包容和支持性的環境,並相信我們的社區尊重 micro:bit 行為準則。請參閱我們的行為準則,其中概述了我們對所有社區參與者的期望,以及如何報告任何問題以及發生違規行為時會發生什麼的詳細資訊。