Standardisierte Tests

Ziel

Dieses Repository verwendet zwei verbindliche Testebenen:

PHPUnit prüft reine PHP-Logik und Struktur bei jedem Push.
Symcon-Modultests prüfen reale Instanzen, Variablen, Actions und Zusammenspiel in IP-Symcon 8.x.

Alle implementierten Module müssen in tests/Symcon/manifest.php eingetragen sein und ein eigenes Skript in tests/Symcon/modules/ besitzen. Der PHPUnit-Test SymconTestContractTest erzwingt diese Regel auch für künftig hinzugefügte Module.

Testvertrag

Ein Modultest gibt eine aufrufbare Funktion mit dieser Signatur zurück:

use Belevo\EnelixUtils\SymconTest\TestContext;

return static function (TestContext $test): void {
    $test->runCase('Beschreibung', static function (TestContext $test): void {
        // Instanz aufbauen, Eingang simulieren und Ergebnis prüfen.
    });
};

Das Framework erzeugt für jeden Modultest eine eindeutige Kategorie unterhalb der Objektwurzel. Instanzen und Hilfsobjekte werden ausschließlich dort angelegt. Der Runner entfernt den vollständigen Baum in einem finally-Pfad. Ein fehlgeschlagener Cleanup macht den Gesamtlauf rot.

Tests dürfen keine vorhandenen Objekte verändern oder anhand ihres Namens löschen. Globale Variablenprofile müssen nur dann registriert und entfernt werden, wenn sie vor dem Lauf nicht existierten.

Modi

all: alle registrierten Module
single: genau die als Auswahl übergebenen Module
affected: die durch geänderte Pfade ermittelten Module

Verfügbare Module: CC100Hardware, Energiediagramm, ShellyModul, VGTSchnittstelle, Verbrauchskostenreport und VirtuelleBatterie.

Die Utils-Module werden jeweils eigenständig und ohne Abhängigkeit zu Enelix EMS getestet.

Manuelle Ausführung in IP-Symcon

Das Repository muss über die Modulverwaltung installiert und auf dem zu prüfenden Stand sein. In der Schnellausführung:

require_once IPS_GetKernelDir() . 'modules/Enelix-Utils/tests/Symcon/bootstrap.php';

$result = enelixUtilsRunSymconTests('all');
echo $result['console'];

Ein Einzeltest wird beispielsweise mit enelixUtilsRunSymconTests('single', 'ShellyModul') gestartet.

Auf dem Agent-Server kann derselbe Lauf über JSON-RPC ausgeführt werden:

tests/Symcon/bin/run-symcon-tests.sh all
tests/Symcon/bin/run-symcon-tests.sh single ShellyModul

Die URL kann ausschließlich zur Laufzeit über ENELIX_SYMCON_URL gesetzt werden. Zugangsdaten gehören nicht in Repository, Skripte oder Logs.

Berichte

Jeder Lauf erzeugt:

eine kurze Konsolenzusammenfassung,
build/symcon-tests/report.json für Diagnose und Archivierung,
build/symcon-tests/junit.xml für CI-Auswertung.

Zusätzlich schreibt der Runner die Zusammenfassung in das IP-Symcon-Log.

CI-Regeln

Bei jedem Push laufen sämtliche PHPUnit-Tests und die PHP-Syntaxprüfung. Die Symcon-Modultests werden bis zur Verfügbarkeit eines geschützten Runners auf der isolierten IP-Symcon-8.0-Instanz des Agent-Servers ausgeführt. Vor jeder Übernahme nach beta ist ein erfolgreicher Lauf im Modus all verbindlich. Der erzeugte JSON- und JUnit-Bericht gehört zum Freigabenachweis.

Eine spätere CI-Automatisierung benötigt einen geschützten Runner mit dem Label symcon-8, lokalem Zugriff auf die isolierte IP-Symcon-Instanz und den exakt zu prüfenden Repository-Stand.

Checkliste für neue Module

PHPUnit-Tests für die reine Logik ergänzen.
tests/Symcon/modules/<Modul>.php hinzufügen.
Modul und betroffene Pfade in tests/Symcon/manifest.php registrieren.
Instanz, Pflichtvariablen, Actions, Normalfall und mindestens einen Fehler- oder Grenzfall prüfen.
Alle Hilfsobjekte über TestContext anlegen.
composer check, Einzeltest und Gesamttest erfolgreich ausführen.

3.7 KiB Raw Permalink Blame History