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,71 @@
+import 'package:encrypter/encrypter/xor.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:frontend/settings/settings.dart';
+
+import '../helpers/backend_test_harness.dart';
+import '../helpers/pump_app.dart';
+
+void main() {
+  setUp(() async {
+    await setUpBackendForTest(
+      prefs: {
+        'base_url': 'http://my.server/api',
+        'api_key': XOR().xorEncode('topsecret'),
+        'theme': 'catppuccin_mocha',
+      },
+    );
+  });
+
+  testWidgets('prefills the form from stored preferences', (tester) async {
+    await pumpScreen(tester, const Settings());
+
+    expect(find.text('http://my.server/api'), findsOneWidget);
+    expect(find.text('Catppuccin Mocha'), findsOneWidget);
+  });
+
+  testWidgets('validates an empty base URL when testing the connection',
+      (tester) async {
+    await pumpScreen(tester, const Settings());
+
+    await tester.enterText(find.byType(TextFormField).first, '');
+    await tester.tap(find.widgetWithText(ElevatedButton, 'Test'));
+    await tester.pump();
+
+    expect(find.text('The URL cannot be empty'), findsOneWidget);
+  });
+
+  testWidgets('disables Save once the connection details are edited',
+      (tester) async {
+    await pumpScreen(tester, const Settings());
+    final saveButton = find.widgetWithText(ElevatedButton, 'Save');
+
+    expect(
+      tester.widget<ElevatedButton>(saveButton).onPressed,
+      isNotNull,
+      reason: 'enabled for the unmodified, prefilled form',
+    );
+
+    await tester.enterText(
+      find.byType(TextFormField).first,
+      'http://changed/api',
+    );
+    await tester.pump();
+
+    expect(
+      tester.widget<ElevatedButton>(saveButton).onPressed,
+      isNull,
+      reason: 'disabled until the new connection is tested',
+    );
+  });
+
+  testWidgets('saving the unmodified form shows a success message',
+      (tester) async {
+    await pumpScreen(tester, const Settings());
+
+    await tester.tap(find.widgetWithText(ElevatedButton, 'Save'));
+    await pumpUntilFound(tester, find.text('Settings saved successfully'));
+
+    expect(find.text('Settings saved successfully'), findsOneWidget);
+  });
+}