Add automated test suite for the Flutter frontend

Introduce a headless `flutter test` suite (83 tests) covering models, utilities, every API endpoint, and the five screens, with shared helpers and fixtures so new tests stay terse. API endpoint methods are statically-dispatched extensions on the BackendAPI singleton, so they cannot be mocked via `implements`. Mock at the Dio HTTP-adapter layer (http_mock_adapter) instead, enabled by two small @visibleForTesting seams: BackendAPI.dioForTesting swaps the singleton's Dio, and BackendReachability.forceOnlineForTesting() forces a deterministic online state so polling widgets load. Add frontend/run_tests.sh and document it in CLAUDE.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-08 19:21:54 +02:00 · 2026-06-03 19:41:52 -04:00
parent e6813a78fb
commit 98b5fa267f
33 changed files with 1690 additions and 2 deletions
@@ -0,0 +1,81 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:frontend/utils/oott_api.dart';
+import 'package:http_mock_adapter/http_mock_adapter.dart';
+
+import '../helpers/backend_test_harness.dart';
+import '../helpers/fixtures.dart';
+
+void main() {
+  late DioAdapter adapter;
+
+  setUp(() async {
+    adapter = await setUpBackendForTest();
+  });
+
+  test('getArpScannerStatus decodes /arp_scanner/status', () async {
+    adapter.onGet(
+      '/arp_scanner/status',
+      (server) => server.reply(
+        200,
+        intervalScannerJson(isRunning: true, runningForSeconds: 12),
+      ),
+    );
+
+    final status = await BackendAPI.instance.getArpScannerStatus();
+
+    expect(status.isRunning, isTrue);
+    expect(status.runningForSeconds, 12.0);
+  });
+
+  test('getSnmpScannerStatus decodes /snmp_scanner/status', () async {
+    adapter.onGet(
+      '/snmp_scanner/status',
+      (server) => server.reply(200, intervalScannerJson(isRunning: false)),
+    );
+
+    final status = await BackendAPI.instance.getSnmpScannerStatus();
+
+    expect(status.isRunning, isFalse);
+  });
+
+  test('getMdnsScannerStatus decodes /mdns_scanner/status', () async {
+    adapter.onGet(
+      '/mdns_scanner/status',
+      (server) => server.reply(
+        200,
+        listenerScannerJson(isListening: true, devicesSeen: 3),
+      ),
+    );
+
+    final status = await BackendAPI.instance.getMdnsScannerStatus();
+
+    expect(status.isListening, isTrue);
+    expect(status.devicesSeen, 3);
+  });
+
+  test('getSsdpScannerStatus decodes /ssdp_scanner/status', () async {
+    adapter.onGet(
+      '/ssdp_scanner/status',
+      (server) => server.reply(200, listenerScannerJson(devicesSeen: 1)),
+    );
+
+    final status = await BackendAPI.instance.getSsdpScannerStatus();
+
+    expect(status.devicesSeen, 1);
+  });
+
+  test('getDhcpScannerStatus decodes /dhcp_scanner/status', () async {
+    adapter.onGet(
+      '/dhcp_scanner/status',
+      (server) => server.reply(
+        200,
+        listenerScannerJson(isListening: true, devicesSeen: 5),
+      ),
+    );
+
+    final status = await BackendAPI.instance.getDhcpScannerStatus();
+
+    expect(status.isListening, isTrue);
+    expect(status.devicesSeen, 5);
+  });
+}