{`dev_dependencies:
  flutter_test:
    sdk: flutter
  integration_test:
    sdk: flutter

  # Mock frameworks
  mockito: ^5.4.4
  build_runner: ^2.4.9
  mocktail: ^1.0.3

  # HTTP mock
  dio_mock_interceptor: ^2.0.0

  # Code generation
  json_serializable: ^6.7.1
  freezed: ^3.2.3`}

{[ ["dio mock adapter", "2.0.0", "HTTP 호출 가로채기", "Widget / Integration"], ["Mockito", "5.4.4", "Repository/Provider mock", "Unit / Widget"], ["flutter_test", "SDK", "Widget 테스트 프레임워크", "Widget"], ["mocktail", "1.0.3", "코드젠 불필요 mock 대안", "Unit"] ].map(([name, ver, purpose, type]) => ( ))}

도구	버전	용도	테스트 유형
`{name}`	{ver}	{purpose}	{type}

dio mock adapter는 dio의 HttpClientAdapter를 교체하여 네트워크 호출을 가로채는 방식이다. Synapse에서는 모든 백엔드 API 호출을 MockDioAdapter로 mock한다.

MockDioAdapter 구현

{`class MockDioAdapter implements HttpClientAdapter {
  final Map _mappings = {};

  void onGet(String path, MockResponse response) =>
      _mappings['GET:\$path'] = response;
  void onPost(String path, MockResponse response) =>
      _mappings['POST:\$path'] = response;
  void onPatch(String path, MockResponse response) =>
      _mappings['PATCH:\$path'] = response;
  void onDelete(String path, MockResponse response) =>
      _mappings['DELETE:\$path'] = response;

  @override
  Future fetch(RequestOptions options, ...) async {
    final key = '\${options.method}:\${options.path}';
    final response = _mappings[key] ?? _findPatternMatch(options);

    if (response == null) {
      throw DioException(
        requestOptions: options,
        error: 'No mock mapping for \$key',
        type: DioExceptionType.unknown,
      );
    }

    if (response.delay != null) await Future.delayed(response.delay!);

    return ResponseBody.fromString(
      jsonEncode(response.data),
      response.statusCode,
      headers: {'content-type': ['application/json']},
    );
  }
}`}

Mock/실제 전환 토글

{`Dio createDioClient({bool useMock = false}) {
  final dio = Dio(BaseOptions(baseUrl: AppConfig.apiBaseUrl));
  if (useMock) {
    dio.httpClientAdapter = MockDioAdapter()
      ..onPost('/auth/login', MockResponse(
          statusCode: 200,
          data: {"success": true, "data": {"accessToken": "mock_jwt"}}))
      ..onGet('/notes', MockResponse(
          statusCode: 200,
          data: {"success": true, "data": [...]}));
  }
  return dio;
}`}

패턴 1: 기본 GET/POST mock 등록

{`final adapter = MockDioAdapter();

// GET mock
adapter.onGet('/notes', MockResponse(
  statusCode: 200,
  data: {"success": true, "data": [
    {"id": "note-001", "title": "머신러닝 기초 정리"}
  ]},
));

// POST mock
adapter.onPost('/notes', MockResponse(
  statusCode: 201,
  data: {"success": true, "data": {"id": "note-003"}},
));`}

패턴 2: regex 패턴 매칭

{`// /notes/:id 같은 동적 경로 매칭
MockResponse? _findPatternMatch(RequestOptions options) {
  final key = '\${options.method}:\${options.path}';
  for (final entry in _patternMappings.entries) {
    if (RegExp(entry.key).hasMatch(key)) {
      return entry.value;
    }
  }
  return null;
}

// 등록: regex 패턴으로
adapter.onGetPattern(r'/notes/[\\w-]+', MockResponse(...));`}

패턴 3: 네트워크 지연 시뮬레이션

{`adapter.onPost('/ai/generate-cards', MockResponse(
  statusCode: 200,
  data: {"success": true, "data": {"cards": [...]}},
  delay: Duration(milliseconds: 800),  // Claude API 응답 시간 시뮬레이션
));`}

{[ ["unmapped route 에러", "DioException 메시지에 'No mock mapping for GET:/path' 표시 → 해당 경로 등록 필요"], ["method 와일드카드", "에러 응답(400/401/500)은 method='*'로 등록하면 모든 메서드에 매칭"], ["body 검증 불가", "MockDioAdapter는 요청 body를 검증하지 않음 — body 검증은 Mockito Repository mock에서"] ].map(([problem, solution]) => (

{problem}

{solution}

))}

다른 언어 대안:

Mockito (Dart)는 @GenerateMocks 어노테이션과 build_runner로 mock 클래스를 자동 생성한다.

1단계: 어노테이션 추가

{`// test/repositories/note_repository_test.dart
import 'package:mockito/annotations.dart';
import 'package:mockito/mockito.dart';

@GenerateMocks([NoteRepository, CardRepository])
import 'note_repository_test.mocks.dart';`}

2단계: 코드 생성

{`dart run build_runner build --delete-conflicting-outputs`}

3단계: 테스트에서 사용

{`void main() {
  late MockNoteRepository mockNoteRepo;

  setUp(() {
    mockNoteRepo = MockNoteRepository();
  });

  test('should return notes list', () async {
    when(mockNoteRepo.getNotes())
        .thenAnswer((_) async => [Note(id: 'note-001', title: '테스트')]);

    final notes = await mockNoteRepo.getNotes();

    expect(notes.length, 1);
    verify(mockNoteRepo.getNotes()).called(1);
  });
}`}

다른 언어 대안:

flutter_test는 Flutter SDK 내장 위젯 테스트 프레임워크. testWidgets로 위젯을 렌더링하고, find로 요소를 찾고, expect로 검증한다.

Widget 테스트 + Riverpod override

{`// test/widgets/review_screen_test.dart
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

void main() {
  testWidgets('ReviewScreen shows card count', (tester) async {
    final mockCardRepo = MockCardRepository();
    when(mockCardRepo.getDueCards())
        .thenAnswer((_) async => [card1, card2, card3]);

    await tester.pumpWidget(
      ProviderScope(
        overrides: [
          cardRepositoryProvider.overrideWithValue(mockCardRepo),
        ],
        child: const MaterialApp(home: ReviewScreen()),
      ),
    );
    await tester.pumpAndSettle();

    expect(find.text('3장'), findsOneWidget);
    expect(find.byType(CardWidget), findsNWidgets(1));  // 첫 번째 카드
  });
}`}

mocktail은 Mockito와 달리 build_runner 코드 생성 없이 mock을 만든다. class 상속 방식으로 mock 정의.

Mockito vs mocktail 비교

항목	Mockito	mocktail
Mock 생성	`@GenerateMocks` + build_runner	class 상속 (수동)
설정 시간	코드젠 필요 (느림)	즉시 (빠름)
타입 안전성	컴파일 타임 검증	런타임 검증
추천 상황	프로덕션 코드, CI	프로토타입, 빠른 테스트

mocktail 사용법

{`import 'package:mocktail/mocktail.dart';

// Mock 정의 — class 상속만으로 끝
class MockNoteRepository extends Mock implements NoteRepository {}

void main() {
  late MockNoteRepository mockRepo;

  setUp(() {
    mockRepo = MockNoteRepository();
  });

  test('should fetch notes', () async {
    when(() => mockRepo.getNotes())
        .thenAnswer((_) async => [Note(id: 'note-001')]);

    final notes = await mockRepo.getNotes();
    expect(notes.length, 1);
  });
}`}