Experimentieren aus einer IDE#
World.pause(), World.invoke(callback, *args, **kwargs), World.refresh()
und World.resume() bilden die öffentliche Schnittstelle für interaktive
Objektaufrufe. world.is_paused zeigt den Experimentierzustand an.
Das bisherige stop() behält seine Semantik; start() beendet auch eine
Experimentierpause.
from miniworlds import World, Actor, ExperimentSession
world = World(400, 300)
figur = Actor((50, 50))
world.pause()
world.refresh()
world.invoke(figur.move, 10)
# Rückgabewerte kommen direkt zurück, Fehler werden weitergereicht.
world.resume()
Pause hält auch Frame 0 an. Automatische Aktionen, Kollisionen, Animationen, Timer und Spielereignisse werden nicht ausgeführt. Betriebssystemereignisse wie Fenster schließen bleiben in der laufenden App aktiv. Ereignisse für pausierte Welten werden verworfen, nicht für später gesammelt. Andere Welten laufen weiter; für eine komplett pausierte Anwendung alle Welten pausieren.
refresh() zeichnet den aktuellen Zustand, ohne einen Simulationsschritt
auszuführen. invoke() pausiert vor dem Aufruf und bleibt auch nach Fehlern
pausiert. Änderungen vor einem Fehler bleiben erhalten und werden dargestellt.
Die Schnittstelle unterstützt synchrone Aufrufe; Coroutinen werden abgewiesen.
Objektbank und Programmversion#
session = ExperimentSession(world, source_version="hash-des-geladenen-projekts")
handle = session.register(figur)
session.invoke(handle, "move", 10)
# Bei Änderungen im Editor, ohne Schülercode erneut auszuführen:
session.mark_source_changed("hash-des-geänderten-projekts")
status = session.describe(handle)
assert status["is_stale"]
# UI: „Code geändert – Laufzeit verwendet noch den vorherigen Stand“
Die geladene Version bleibt während der Sitzung unverändert. Der Host muss Revisionen für alle relevanten Projektdateien bestimmen und Änderungen melden. Alte Objekte bleiben mit ihrem bisherigen Code aufrufbar. Wird der Editorstand wiederhergestellt, verschwindet die Abweichung.
Bei Backend-Ende session.close() aufrufen und die Objektbank im Frontend
leeren. Erst nach erfolgreichem Laden des neuen Programms eine neue Sitzung
mit neuer Quellversion anlegen. Jede Sitzung hat eine eigene Generation;
Handles aus einer anderen oder geschlossenen Sitzung sind ungültig. Ein neues
ExperimentSession-Objekt allein lädt keinen Programmcode neu.
Einbindung in Thonny#
Diese Schnittstelle gehört in den Ausführungsprozess. Die Oberfläche importiert
miniworlds nicht. IDE-Kommandos müssen auf dem Thread ausgeführt werden, auf dem
die Welt erzeugt wurde und die SDL-Hauptschleife läuft. invoke() prüft diesen
Thread. Auch pause, resume und refresh dort ausführen.
Der Desktop-Aufruf world.run() betreibt weiterhin seine eigene Hauptschleife.
Der Thonny-Adapter unter libraries/thonny-miniworlds installiert intern einen
Host, der Kommandos zwischen Frames verarbeitet. Ein expliziter Experimentierstart
über das Objektlabor aktiviert ihn; Schülercode benötigt keine zusätzlichen
Aufrufe oder Importe. Normales F5 führt das Programm wie bisher aus.
Die Oberfläche und der Ausführungsprozess tauschen Aufträge über einen lokalen, mit einem zufälligen Token geschützten Kanal aus. Empfang und Ausführung sind getrennt: Nur die Hauptschleife führt Objektoperationen aus. Jede Antwort enthält Sitzungsgeneration und Auftragskennung. Stop/Restart beendet die Sitzung; Editoränderungen markieren den Laufzeitstand als veraltet. Lange Schüleraufrufe blockieren weiterhin den Ausführungsthread und lassen sich mit Thonnys Stop/Restart abbrechen.