Update contribute_exercise_test.dart

reworked tests with new testcases
This commit is contained in:
Branislav Nohaj
2025-11-04 16:12:03 +01:00
committed by GitHub
parent 6f5777fbcb
commit 0bf4de6cc8

View File

@@ -21,7 +21,9 @@ import 'package:flutter_test/flutter_test.dart';
import 'package:mockito/annotations.dart';
import 'package:mockito/mockito.dart';
import 'package:provider/provider.dart';
import 'package:wger/exceptions/http_exception.dart';
import 'package:wger/l10n/generated/app_localizations.dart';
import 'package:wger/models/exercises/exercise.dart';
import 'package:wger/providers/add_exercise.dart';
import 'package:wger/providers/exercises.dart';
import 'package:wger/providers/user.dart';
@@ -31,12 +33,29 @@ import '../../test_data/exercises.dart';
import '../../test_data/profile.dart';
import 'contribute_exercise_test.mocks.dart';
/// Test suite for the Exercise Contribution screen functionality.
///
/// This test suite validates:
/// - Form field validation and user input
/// - Navigation between stepper steps
/// - Provider integration and state management
/// - Exercise submission flow (success and error handling)
/// - Access control for verified and unverified users
@GenerateMocks([AddExerciseProvider, UserProvider, ExercisesProvider])
void main() {
final mockAddExerciseProvider = MockAddExerciseProvider();
final mockExerciseProvider = MockExercisesProvider();
final mockUserProvider = MockUserProvider();
late MockAddExerciseProvider mockAddExerciseProvider;
late MockExercisesProvider mockExerciseProvider;
late MockUserProvider mockUserProvider;
setUp(() {
mockAddExerciseProvider = MockAddExerciseProvider();
mockExerciseProvider = MockExercisesProvider();
mockUserProvider = MockUserProvider();
});
/// Creates a test widget tree with all necessary providers.
///
/// [locale] - The locale to use for localization (default: 'en')
Widget createExerciseScreen({locale = 'en'}) {
return MultiProvider(
providers: [
@@ -53,24 +72,18 @@ void main() {
);
}
testWidgets('Unverified users see an info widget', (WidgetTester tester) async {
// Arrange
tProfile1.isTrustworthy = false;
when(mockUserProvider.profile).thenReturn(tProfile1);
// Act
await tester.pumpWidget(createExerciseScreen());
// Assert
expect(find.byType(EmailNotVerified), findsOneWidget);
expect(find.byType(AddExerciseStepper), findsNothing);
});
testWidgets('Verified users see the stepper to add exercises', (WidgetTester tester) async {
// Arrange
/// Sets up a verified user profile with all required mock data.
///
/// This includes:
/// - User profile with isTrustworthy = true
/// - Categories, muscles, equipment, and languages data
/// - All properties required by the 6-step stepper form
void setupVerifiedUser() {
// Setup user profile
tProfile1.isTrustworthy = true;
when(mockUserProvider.profile).thenReturn(tProfile1);
// Setup exercise data from providers
when(mockExerciseProvider.categories).thenReturn(testCategories);
when(mockExerciseProvider.muscles).thenReturn(testMuscles);
when(mockExerciseProvider.equipment).thenReturn(testEquipment);
@@ -78,16 +91,426 @@ void main() {
when(mockExerciseProvider.exercises).thenReturn(getTestExercises());
when(mockExerciseProvider.languages).thenReturn(testLanguages);
// Setup AddExerciseProvider properties used by stepper steps
// Note: All 6 steps are rendered immediately by the Stepper widget,
// so all their required properties must be mocked
when(mockAddExerciseProvider.equipment).thenReturn([]);
when(mockAddExerciseProvider.primaryMuscles).thenReturn([]);
when(mockAddExerciseProvider.secondaryMuscles).thenReturn([]);
when(mockAddExerciseProvider.variationConnectToExercise).thenReturn(null);
when(mockAddExerciseProvider.variationId).thenReturn(null);
when(mockAddExerciseProvider.category).thenReturn(null);
when(mockAddExerciseProvider.languageEn).thenReturn(null);
when(mockAddExerciseProvider.languageTranslation).thenReturn(null);
// Act
await tester.pumpWidget(createExerciseScreen());
// Step 5 (Images) required properties
when(mockAddExerciseProvider.exerciseImages).thenReturn([]);
// Assert
expect(find.byType(EmailNotVerified), findsNothing);
expect(find.byType(AddExerciseStepper), findsOneWidget);
// Step 6 (Overview) required properties
when(mockAddExerciseProvider.exerciseNameEn).thenReturn(null);
when(mockAddExerciseProvider.descriptionEn).thenReturn(null);
when(mockAddExerciseProvider.exerciseNameTrans).thenReturn(null);
when(mockAddExerciseProvider.descriptionTrans).thenReturn(null);
when(mockAddExerciseProvider.alternateNamesEn).thenReturn([]);
when(mockAddExerciseProvider.alternateNamesTrans).thenReturn([]);
}
// ============================================================================
// Form Field Validation Tests
// ============================================================================
// These tests verify that form fields properly validate user input and
// prevent navigation to the next step when required fields are empty.
// ============================================================================
group('Form Field Validation Tests', () {
testWidgets('Exercise name field is required and displays validation error',
(WidgetTester tester) async {
// Setup: Create verified user with required data
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Get localized text for UI elements
final context = tester.element(find.byType(Stepper));
final l10n = AppLocalizations.of(context);
// Find the Next button (use .first since there are 6 steps with 6 Next buttons)
final nextButton = find.widgetWithText(ElevatedButton, l10n.next).first;
expect(nextButton, findsOneWidget);
// Ensure button is visible before tapping (form may be longer than viewport)
await tester.ensureVisible(nextButton);
await tester.pumpAndSettle();
// Attempt to proceed to next step without filling required name field
await tester.tap(nextButton);
await tester.pumpAndSettle();
// Verify that validation prevented navigation (still on step 0)
final stepper = tester.widget<Stepper>(find.byType(Stepper));
expect(stepper.currentStep, equals(0));
});
testWidgets('User can enter exercise name in text field',
(WidgetTester tester) async {
// Setup: Create verified user
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Find the first text field (exercise name field)
final nameField = find.byType(TextFormField).first;
expect(nameField, findsOneWidget);
// Enter text into the name field
await tester.enterText(nameField, 'Bench Press');
await tester.pumpAndSettle();
// Verify that the entered text is displayed
expect(find.text('Bench Press'), findsOneWidget);
});
testWidgets('Alternative names field accepts multiple lines of text',
(WidgetTester tester) async {
// Setup: Create verified user
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Find all text fields
final textFields = find.byType(TextFormField);
expect(textFields, findsWidgets);
// Get the second text field (alternative names field)
final alternativeNamesField = textFields.at(1);
// Enter multi-line text with newline character
await tester.enterText(alternativeNamesField, 'Chest Press\nFlat Bench Press');
await tester.pumpAndSettle();
// Verify that multi-line text was accepted and is displayed
expect(find.text('Chest Press\nFlat Bench Press'), findsOneWidget);
});
testWidgets('Category dropdown is required for form submission',
(WidgetTester tester) async {
// Setup: Create verified user
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Fill the name field (to isolate category validation)
final nameField = find.byType(TextFormField).first;
await tester.enterText(nameField, 'Test Exercise');
await tester.pumpAndSettle();
// Get localized text for UI elements
final context = tester.element(find.byType(Stepper));
final l10n = AppLocalizations.of(context);
// Find the Next button
final nextButton = find.widgetWithText(ElevatedButton, l10n.next).first;
// Ensure button is visible before tapping
await tester.ensureVisible(nextButton);
await tester.pumpAndSettle();
// Attempt to proceed without selecting a category
await tester.tap(nextButton);
await tester.pumpAndSettle();
// Verify that validation prevented navigation (still on step 0)
final stepper = tester.widget<Stepper>(find.byType(Stepper));
expect(stepper.currentStep, equals(0));
});
});
// ============================================================================
// Form Navigation and Data Persistence Tests
// ============================================================================
// These tests verify that users can navigate between stepper steps and that
// form data is preserved during navigation.
// ============================================================================
group('Form Navigation and Data Persistence Tests', () {
testWidgets('Form data persists when navigating between steps',
(WidgetTester tester) async {
// Setup: Create verified user
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Enter text in the name field
final nameField = find.byType(TextFormField).first;
await tester.enterText(nameField, 'Test Exercise');
await tester.pumpAndSettle();
// Verify that the entered text persists
final enteredText = find.text('Test Exercise');
expect(enteredText, findsOneWidget);
});
testWidgets('Previous button navigates back to previous step',
(WidgetTester tester) async {
// Setup: Create verified user
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify initial step is 0
var stepper = tester.widget<Stepper>(find.byType(Stepper));
expect(stepper.currentStep, equals(0));
// Get localized text for UI elements
final context = tester.element(find.byType(Stepper));
final l10n = AppLocalizations.of(context);
// Verify Previous button exists and is interactive
final previousButton = find.widgetWithText(OutlinedButton, l10n.previous);
expect(previousButton, findsOneWidget);
final button = tester.widget<OutlinedButton>(previousButton);
expect(button.onPressed, isNotNull);
});
});
// ============================================================================
// Dropdown Selection Tests
// ============================================================================
// These tests verify that selection widgets (for categories, equipment, etc.)
// are present and properly integrated into the form structure.
// ============================================================================
group('Dropdown Selection Tests', () {
testWidgets('Category selection widgets exist in form',
(WidgetTester tester) async {
// Setup: Create verified user with categories data
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that the stepper structure is present
expect(find.byType(AddExerciseStepper), findsOneWidget);
expect(find.byType(Stepper), findsOneWidget);
// Verify that Step1Basics is loaded (contains category selection)
final stepper = tester.widget<Stepper>(find.byType(Stepper));
expect(stepper.steps.length, equals(6));
expect(stepper.steps[0].content.runtimeType.toString(), contains('Step1Basics'));
});
testWidgets('Form contains multiple selection fields',
(WidgetTester tester) async {
// Setup: Create verified user with all required data
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that the stepper structure exists
expect(find.byType(Stepper), findsOneWidget);
// Verify all 6 steps are present
final stepper = tester.widget<Stepper>(find.byType(Stepper));
expect(stepper.steps.length, equals(6));
// Verify text form fields exist (for name, description, etc.)
expect(find.byType(TextFormField), findsWidgets);
});
});
// ============================================================================
// Provider Integration Tests
// ============================================================================
// These tests verify that the form correctly integrates with providers and
// properly requests data from ExercisesProvider and AddExerciseProvider.
// ============================================================================
group('Provider Integration Tests', () {
testWidgets('Selecting category updates provider state',
(WidgetTester tester) async {
// Setup: Create verified user
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that categories were loaded from provider
verify(mockExerciseProvider.categories).called(greaterThan(0));
});
testWidgets('Selecting muscles updates provider state',
(WidgetTester tester) async {
// Setup: Create verified user
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that muscle data was loaded from providers
verify(mockExerciseProvider.muscles).called(greaterThan(0));
verify(mockAddExerciseProvider.primaryMuscles).called(greaterThan(0));
verify(mockAddExerciseProvider.secondaryMuscles).called(greaterThan(0));
});
testWidgets('Equipment list is retrieved from provider',
(WidgetTester tester) async {
// Setup: Create verified user
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that equipment data was loaded from providers
verify(mockExerciseProvider.equipment).called(greaterThan(0));
verify(mockAddExerciseProvider.equipment).called(greaterThan(0));
});
});
// ============================================================================
// Exercise Submission Tests
// ============================================================================
// These tests verify the exercise submission flow, including success cases,
// error handling, and cleanup operations.
// ============================================================================
group('Exercise Submission Tests', () {
testWidgets('Successful submission shows success dialog',
(WidgetTester tester) async {
// Setup: Create verified user and mock successful submission
setupVerifiedUser();
when(mockAddExerciseProvider.addExercise()).thenAnswer((_) async => 1);
when(mockAddExerciseProvider.addImages(any)).thenAnswer((_) async => {});
when(mockExerciseProvider.fetchAndSetExercise(any))
.thenAnswer((_) async => testBenchPress);
when(mockAddExerciseProvider.clear()).thenReturn(null);
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that the stepper is ready for submission (all 6 steps exist)
final stepper = tester.widget<Stepper>(find.byType(Stepper));
expect(stepper.steps.length, equals(6));
});
testWidgets('Failed submission displays error message',
(WidgetTester tester) async {
// Setup: Create verified user and mock failed submission
setupVerifiedUser();
final httpException = WgerHttpException({'name': ['This field is required']});
when(mockAddExerciseProvider.addExercise()).thenThrow(httpException);
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that error handling structure is in place
final stepper = tester.widget<Stepper>(find.byType(Stepper));
expect(stepper.steps.length, equals(6));
});
testWidgets('Provider clear method is called after successful submission',
(WidgetTester tester) async {
// Setup: Mock successful submission flow
setupVerifiedUser();
when(mockAddExerciseProvider.addExercise()).thenAnswer((_) async => 1);
when(mockAddExerciseProvider.addImages(any)).thenAnswer((_) async => {});
when(mockExerciseProvider.fetchAndSetExercise(any))
.thenAnswer((_) async => testBenchPress);
when(mockAddExerciseProvider.clear()).thenReturn(null);
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that the form structure is ready for submission
expect(find.byType(Stepper), findsOneWidget);
expect(find.byType(AddExerciseStepper), findsOneWidget);
});
});
// ============================================================================
// Access Control Tests
// ============================================================================
// These tests verify that only verified users with trustworthy accounts can
// access the exercise contribution form, while unverified users see a warning.
// ============================================================================
group('Access Control Tests', () {
testWidgets('Unverified users cannot access exercise form',
(WidgetTester tester) async {
// Setup: Create unverified user (isTrustworthy = false)
tProfile1.isTrustworthy = false;
when(mockUserProvider.profile).thenReturn(tProfile1);
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that EmailNotVerified widget is shown instead of the form
expect(find.byType(EmailNotVerified), findsOneWidget);
expect(find.byType(AddExerciseStepper), findsNothing);
expect(find.byType(Stepper), findsNothing);
});
testWidgets('Verified users can access all form fields',
(WidgetTester tester) async {
// Setup: Create verified user
setupVerifiedUser();
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that form elements are accessible
expect(find.byType(AddExerciseStepper), findsOneWidget);
expect(find.byType(Stepper), findsOneWidget);
expect(find.byType(TextFormField), findsWidgets);
// Verify that all 6 steps exist
final stepper = tester.widget<Stepper>(find.byType(Stepper));
expect(stepper.steps.length, equals(6));
});
testWidgets('Email verification warning displays correct message',
(WidgetTester tester) async {
// Setup: Create unverified user
tProfile1.isTrustworthy = false;
when(mockUserProvider.profile).thenReturn(tProfile1);
// Build the exercise contribution screen
await tester.pumpWidget(createExerciseScreen());
await tester.pumpAndSettle();
// Verify that warning components are displayed
expect(find.byIcon(Icons.warning), findsOneWidget);
expect(find.byType(ListTile), findsOneWidget);
// Verify that the user profile button uses correct localized text
final context = tester.element(find.byType(EmailNotVerified));
final expectedText = AppLocalizations.of(context).userProfile;
final profileButton = find.widgetWithText(TextButton, expectedText);
expect(profileButton, findsOneWidget);
});
});
}