python editor v3

micro:bit Python Editor V3

Bei diesem Projekt handelt es sich um einen webbasierten Code-Editor, der auf die MicroPython-Version der Programmiersprache Python abzielt.

Mit diesem Editor geschriebener Code soll voraussichtlich auf dem BBC micro:bit-Gerät ausgeführt werden.

Probieren Sie es unter https://python.microbit.org/ aus.

Das Bild zeigt die Bereitstellung mit der Marke micro:bit

Frühere Versionen

Weitere Hintergrundinformationen zur Beziehung dieses Editors zum ursprünglichen Python-Editor-Projekt finden Sie in dieser Erklärung.

Das V2-Editor-Projekt ist weiterhin unter https://python.microbit.org/v/2 verfügbar und sein Quellcode kann in GitHub unter https://github.com/bbcmicrobit/PythonEditor gefunden werden.

Erstellen und Ausführen des Editors

Wir haben einen technischen Überblick geschrieben, der einen guten Ausgangspunkt für die Arbeit am Python-Editor oder für die Verwendung von Ideen und Komponenten aus der App in anderen Projekten darstellt. Wir würden uns freuen, von Ihnen zu hören, wenn Sie dieses Projekt nutzen. Sie erreichen uns über den Support.

Inbetriebnahme und Inbetriebnahme:

1. Stellen Sie sicher, dass Sie über eine funktionierende Node.js-Umgebung verfügen. Wir empfehlen die Verwendung der LTS-Version von Node und NPM Version 8 oder neuer.
2. Schauen Sie sich dieses Repository mit Git an. GitHub bietet einige Lernressourcen für Git, die für Sie nützlich sein könnten.
3. Installieren Sie die Abhängigkeiten, indem Sie npm install in der Befehlszeile im Checkout-Ordner ausführen.
4. Wählen Sie aus den unten dokumentierten NPM-Skripten. Versuchen Sie es npm start wenn Sie sich nicht sicher sind.

npm start

Führt die App im Entwicklungsmodus aus.

Öffnen Sie http://localhost:3000, um es im Browser anzuzeigen.

Die Seite wird neu geladen, wenn Sie Änderungen vornehmen.

Dies zeigt keine TypeScript- oder Lint-Fehler an. Verwenden Sie das eslint-Plugin für Ihren Editor und erwägen Sie auch die Ausführung von npm run typecheck:watch um vollständige Typprüfungsfehler anzuzeigen.

npm test

Startet den Testläufer im interaktiven Modus (sofern die CI Umgebungsvariable nicht definiert ist). Weitere Informationen finden Sie im Abschnitt zum Ausführen von Tests.

Wenn Sie über ein angeschlossenes micro:bit-Gerät verfügen, werden durch das Setzen der Umgebungsvariablen TEST_MODE_DEVICE=1 zusätzliche Tests aktiviert, die eine Verbindung zu Ihrem micro:bit herstellen. Durch die Tests werden Programme und Daten auf dem micro:bit überschrieben.

npm run test:e2e

Startet den Test Runner im interaktiven Überwachungsmodus und führt die End-to-End-Tests aus.

Diese sind vom normalen Testlauf ausgeschlossen.

Die Tests gehen davon aus, dass die App bereits auf http://localhost:3000 läuft, beispielsweise über npm start .

Wir nutzen Playwright.

Die CI-Tests führen diese End-to-End-Tests anhand eines Produktions-Builds durch.

npm run build

Erstellt die App für die Produktion im build -Ordner.
Es bündelt React im Produktionsmodus korrekt und optimiert den Build für die beste Leistung.

Bereitstellungen

Die meisten Benutzer sollten die unterstützte Foundation-Bereitstellung unter https://python.microbit.org/ verwenden.

Der Editor wird durch GitHub-Aktionen bereitgestellt.

Der main wird bei jedem Push unter https://python.microbit.org/v/beta bereitgestellt.

Andere Zweige (z. B. für PRs) werden unter https://review-python-editor-v3.microbit.org/{branch} bereitgestellt. Sonderzeichen im Filialnamen werden durch Bindestriche ersetzt. Bereitstellungen werden nicht in Forks ausgeführt.

Lizenz

Diese Software steht unter der MIT-Open-Source-Lizenz.

SPDX-Lizenzkennung: MIT

Binärdateien für MicroPython sind für micro:bit V1 (Lizenz) und micro:bit V2 (Lizenz) enthalten. Beide sind MIT-lizenziert.

Python-Diagnose und Autovervollständigung verwenden einen Zweig des Pyright-Typprüfers von Microsoft, der von uns so geändert wurde, dass er als Web Worker ausgeführt werden kann. Pyright ist © Microsoft Corporation und wird unter einer MIT-Lizenz verwendet.

Wir verwenden Abhängigkeiten über die NPM-Registrierung, wie in der Datei package.json unter gängigen Open-Source-Lizenzen angegeben.

Ausführliche Informationen zu jedem Paket finden Sie, indem Sie license-checker ausführen:

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

Lassen Sie die Flags nach Wunsch weg, um mehr Details zu erhalten.

Verhaltenskodex

Vertrauen, Partnerschaft, Einfachheit und Leidenschaft sind unsere Grundwerte, die wir in unserem täglichen Arbeitsleben und in unseren Projekten leben. Unsere Open-Source-Projekte sind keine Ausnahme. Wir haben eine aktive Community auf der ganzen Welt und wir begrüßen und ermutigen jeden, sich an unseren Projekten zu beteiligen und Beiträge zu leisten. Wir arbeiten daran, ein positives, offenes, integratives und unterstützendes Umfeld zu schaffen und vertrauen darauf, dass unsere Community den Verhaltenskodex von micro:bit respektiert. Bitte lesen Sie unseren Verhaltenskodex, der unsere Erwartungen an alle Mitglieder unserer Community darlegt und Einzelheiten dazu enthält, wie Bedenken gemeldet werden können und was bei Verstößen passieren würde.