From d3b697218773eaa5a3dd368705184726dbc0fa38 Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Sat, 21 Jun 2025 15:54:07 +0300
Subject: Implement headless testing framework for DS-Sim protocol simulations
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Created HeadlessSimulationRunner that loads and runs simulations without GUI
- Implemented LogCapture to intercept and store all simulation logs
- Added ProtocolVerifier for flexible pattern-based log verification
- Created test runners: standard, with logs, and clean (filters GUI errors)
- Implemented tests for all non-Raft protocols
- Added DummySimulatorFrame to satisfy GUI dependencies during loading
- Created CleanHeadlessRunner that filters GUI-related errors from output
- Updated run-tests.sh script with quiet mode option
- Documented the framework architecture and usage

The framework successfully runs protocol tests and verifies behavior through
log analysis. GUI errors occur internally due to tight coupling in DS-Sim
but are filtered in quiet mode for clean output.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../java/testing/protocols/BaseProtocolTest.java   | 45 ++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 src/test/java/testing/protocols/BaseProtocolTest.java

(limited to 'src/test/java/testing/protocols/BaseProtocolTest.java')

diff --git a/src/test/java/testing/protocols/BaseProtocolTest.java b/src/test/java/testing/protocols/BaseProtocolTest.java
new file mode 100644
index 0000000..e9cbc81
--- /dev/null
+++ b/src/test/java/testing/protocols/BaseProtocolTest.java
@@ -0,0 +1,45 @@
+package testing.protocols;
+
+import testing.*;
+import org.junit.jupiter.api.*;
+
+/**
+ * Base class for protocol tests providing common setup and utilities.
+ */
+public abstract class BaseProtocolTest {
+    protected HeadlessSimulationRunner runner;
+    
+    @BeforeEach
+    public void baseSetup() {
+        runner = new HeadlessSimulationRunner();
+    }
+    
+    @AfterEach
+    public void baseTeardown() {
+        if (runner != null) {
+            runner.shutdown();
+        }
+    }
+    
+    /**
+     * Run a simulation and get the result with error handling.
+     */
+    protected SimulationResult runSimulation(String file, long duration) {
+        try {
+            return runner.runSimulation(file, duration);
+        } catch (Exception e) {
+            throw new RuntimeException("Failed to run simulation: " + file, e);
+        }
+    }
+    
+    /**
+     * Create a basic verifier that checks for no errors.
+     */
+    protected ProtocolVerifier createBasicVerifier() {
+        return new ProtocolVerifier()
+            .expectNoLog("ERROR")
+            .expectNoLog("Exception")
+            .expectNoLog("null")
+            .expectNoLog("NullPointer");
+    }
+}
\ No newline at end of file
-- 
cgit v1.2.3