Test-API¶
Was ist das?¶
Die Test-API macht GUI-Programme deterministisch testbar — das übliche Problem,
dass Spiele und grafische Tools normalerweise manuelles Klicken brauchen. Das
Konzept entspricht Snapshot-Testing (wie Jest/Vitest für React-Komponenten) in
Kombination mit Input-Simulation (wie xdotool, Selenium oder Playwright): dein
Programm rendert einen Frame in einen Offscreen-Framebuffer, du speicherst das
Bild auf Platte (Screenshot/BMP), injizierst Tastatur- und Maus-Events direkt
in die Event-Queue und vergleichst in späteren Läufen das neue Bild mit dem
alten. So werden Pong, Breakout & Co. headless und reproduzierbar validierbar.
screenshot / bildschirmfoto¶
Signatur: screenshot(win, pfad)
Zweck: Schreibt den aktuellen Framebuffer als BMP-Datei.
taste_simulieren / simulate_key¶
Signatur: taste_simulieren(taste, gedrückt)
Zweck: Injiziert einen Key-Event in die SDL-Event-Queue.
gedrückt = wahr = key-down, falsch = key-up.
maus_simulieren / simulate_mouse¶
Signatur: maus_simulieren(x, y, knopf)
Zweck: Setzt Mausposition und Knopfstatus (0=keiner, 1=links, …).
Vollständiges Beispiel (aus beispiele/test_pong.moo)¶
# Frame 0: Start-Screenshot
fenster_löschen(win, "#111111")
zeichne_rechteck(win, 20, p1_y, 12, 80, "#4CAF50")
fenster_aktualisieren(win)
screenshot(win, "beispiele/test_screenshots/pong_01_start.bmp")
# Paddle hoch fahren: 60 Frames lang "hoch" drücken
taste_simulieren("hoch", wahr)
setze f auf 0
solange f < 60:
# ... Update + Render + fenster_aktualisieren ...
setze f auf f + 1
taste_simulieren("hoch", falsch)
screenshot(win, "beispiele/test_screenshots/pong_02_paddle_oben.bmp")