该项目是一个基于 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 行为准则。请参阅我们的行为准则,其中概述了我们对所有社区参与者的期望,以及如何报告任何问题以及发生违规行为时会发生什么的详细信息。