python editor v3

Éditeur micro:bit Python V3

Ce projet est un éditeur de code Web qui cible la version MicroPython du langage de programmation Python.

Le code écrit avec cet éditeur devrait s'exécuter sur le périphérique BBC micro:bit.

Essayez-le sur https://python.microbit.org/

L'image montre le déploiement de la marque micro:bit

Versions précédentes

Pour plus d'informations sur la relation entre cet éditeur et le projet Python Editor d'origine, consultez cette explication.

Le projet d'éditeur V2 est toujours disponible sur https://python.microbit.org/v/2 et son code source peut être trouvé dans GitHub à https://github.com/bbcmicrobit/PythonEditor.

Construire et exécuter l'éditeur

Nous avons rédigé un aperçu technique qui constitue un bon point de départ pour travailler sur l'éditeur Python ou pour utiliser des idées et des composants de l'application dans d'autres projets. Nous serions ravis de vous entendre si vous utilisez ce projet. Vous pouvez nous contacter via le support.

Mise en route :

1. Assurez-vous de disposer d'un environnement Node.js fonctionnel. Nous vous recommandons d'utiliser la version LTS de Node et NPM version 8 ou ultérieure.
2. Découvrez ce référentiel avec Git. GitHub propose des ressources d'apprentissage pour Git qui pourraient vous être utiles.
3. Installez les dépendances en exécutant npm install sur la ligne de commande dans le dossier d'extraction.
4. Choisissez parmi les scripts NPM documentés ci-dessous. Essayez npm start si vous n'êtes pas sûr.

npm start

Exécute l'application en mode développement.

Ouvrez http://localhost:3000 pour l'afficher dans le navigateur.

La page se rechargera si vous apportez des modifications.

Cela n'affiche pas les erreurs TypeScript ou Lint. Utilisez le plugin eslint pour votre éditeur et envisagez également d'exécuter npm run typecheck:watch pour voir les erreurs de vérification de type complètes.

npm test

Lance le testeur en mode interactif (sauf si la variable d'environnement CI est définie). Consultez la section sur l'exécution de tests pour plus d'informations.

Si vous avez un appareil micro:bit connecté, la définition de la variable d'environnement TEST_MODE_DEVICE=1 permettra des tests supplémentaires qui se connecteront à votre micro:bit. Les tests écraseront les programmes et les données sur le micro:bit.

npm run test:e2e

Lance le programme d'exécution de tests en mode montre interactive exécutant les tests de bout en bout.

Ceux-ci sont exclus du test normal.

Les tests s'attendent à ce que l'application soit déjà exécutée sur http://localhost:3000, par exemple via npm start .

Nous utilisons Playwright.

Les tests CI exécutent ces tests de bout en bout sur une version de production.

npm run build

Construit l'application pour la production dans le dossier build .
Il regroupe correctement React en mode production et optimise la construction pour les meilleures performances.

Déploiements

La plupart des utilisateurs doivent utiliser le déploiement Foundation pris en charge sur https://python.microbit.org/

L'éditeur est déployé par les actions GitHub.

La branche main est déployée sur https://python.microbit.org/v/beta à chaque push.

D'autres branches (par exemple pour les PR) sont déployées sur https://review-python-editor-v3.microbit.org/{branch}. Les caractères spéciaux dans le nom de la branche sont remplacés par des tirets. Les déploiements ne s’exécuteront pas par forks.

Licence

Ce logiciel est sous licence open source MIT.

Identifiant de licence SPDX : MIT

Les binaires pour MicroPython sont inclus pour micro:bit V1 (licence) et micro:bit V2 (licence). Tous deux sont sous licence MIT.

Les diagnostics Python et la saisie semi-automatique utilisent un fork du vérificateur de type Pyright de Microsoft que nous avons modifié pour s'exécuter en tant que Web Worker. Pyright est © Microsoft Corporation et utilisé sous licence MIT.

Nous utilisons des dépendances via le registre NPM comme spécifié par le fichier package.json sous les licences Open Source communes.

Tous les détails de chaque package peuvent être trouvés en exécutant license-checker :

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

Omettez les drapeaux si vous le souhaitez pour obtenir plus de détails.

Code de conduite

Confiance, partenariat, simplicité et passion sont nos valeurs fondamentales que nous vivons et respirons dans notre vie professionnelle quotidienne et dans nos projets. Nos projets open source ne font pas exception. Nous avons une communauté active qui s'étend dans le monde entier et nous accueillons et encourageons la participation et les contributions de chacun à nos projets. Nous travaillons pour favoriser un environnement positif, ouvert, inclusif et solidaire et sommes convaincus que notre communauté respecte le code de conduite micro:bit. Veuillez consulter notre code de conduite qui décrit nos attentes à l'égard de tous ceux qui participent à notre communauté et détaille la manière de signaler toute préoccupation et ce qui se passerait en cas de violation.