python editor v3

micro:bit Редактор Python V3

Этот проект представляет собой веб-редактор кода, предназначенный для версии языка программирования Python MicroPython.

Ожидается, что код, написанный с помощью этого редактора, будет работать на устройстве BBC micro:bit.

Попробуйте это на https://python.microbit.org/.

На изображении показано развертывание под брендом micro:bit.

Предыдущие версии

Дополнительные сведения о том, как этот редактор связан с исходным проектом редактора Python, см. в этом объяснении.

Проект редактора V2 по-прежнему доступен по адресу https://python.microbit.org/v/2, а его исходный код можно найти на GitHub по адресу https://github.com/bbcmicrobit/PythonEditor.

Сборка и запуск редактора

Мы написали технический обзор, который станет хорошей отправной точкой для работы над редактором Python или для использования идей и компонентов приложения в других проектах. Мы будем рады услышать ваше мнение, если вы воспользуетесь этим проектом. Связаться можно через поддержку.

Приступаем к работе:

1. Убедитесь, что у вас есть рабочая среда Node.js. Мы рекомендуем использовать версию Node LTS и 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 в производственном режиме и оптимизирует сборку для достижения наилучшей производительности.

Развертывания

Большинству пользователей следует использовать поддерживаемое развертывание 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, которое было модифицировано нами для работы в качестве веб-работника. Pyright принадлежит © Microsoft Corporation и используется по лицензии MIT.

Мы используем зависимости через реестр NPM, как указано в файле package.json, в соответствии с общими лицензиями с открытым исходным кодом.

Полную информацию о каждом пакете можно узнать, запустив license-checker :

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

Опустите флаги по желанию, чтобы получить более подробную информацию.

Нормы поведения

Доверие, партнерство, простота и страсть — наши основные ценности, которыми мы живем и дышим в повседневной работе и в наших проектах. Наши проекты с открытым исходным кодом не являются исключением. У нас есть активное сообщество, охватывающее весь мир, и мы приветствуем и поощряем участие и вклад в наши проекты каждого. Мы работаем над созданием позитивной, открытой, инклюзивной и поддерживающей среды и верим, что наше сообщество уважает кодекс поведения micro:bit. Ознакомьтесь с нашим кодексом поведения, в котором изложены наши ожидания от всех участников нашего сообщества, а также подробно описано, как сообщать о любых проблемах и что произойдет в случае нарушений.