패키지, 저장소 및 앱 카테고리 검색

패키지 상세v0.1.9

riverpod_test

프로바이더를 테스트하기 쉽게 만들어주는 테스트 라이브러리입니다. riverpod 패키지와 함께 사용하도록 설계되었습니다.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
4.6천
좋아요
28
Pub 점수
150

패키지 설치

flutter pub add riverpod_test

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

riverpod_test는 Flutter 애플리케이션에서 Riverpod 제공자를 테스트하는 것을 간편하게 만드는 테스트 라이브러리입니다. 이 라이브러리는 제공자 값을 쉽게 오버라이드하고 모킹하며 고립된 상태에서 테스트할 수 있는 유틸리티를 제공하여 신뢰할 수 있고 유지보수 가능한 테스트를 보장합니다. Riverpod 패키지 전용으로 제작되었으며, Flutter의 테스트 생태계와 원활하게 통합되어 실제 종속성에 의존하지 않고 상태 로직을 검증할 수 있게 해줍니다. 이 라이브러리는 모든 주요 플랫폼을 지원하므로 크로스플랫폼 테스트 워크플로우에 이상적입니다.

사용 사례

  • 공급자 상태 변경 테스트
  • 테스트에서 종속성 모킹
  • 공급자에서 비즈니스 로직 검증
  • 실제 데이터 소스로부터 단위 테스트 분리
  • 공급자에서 비동기 작업 확인

주요 기능

  • 간편한 공급업체 오버라이드
  • 내장된 모킹 지원
  • Flutter 테스트 프레임워크와의 통합
  • 비동기 및 동기 제공자 지원
  • 깨끗하고 읽기 쉬운 테스트 문법

적합한 대상

  • Riverpod를 사용하는 Flutter 개발자
  • 테스트 신뢰성을 우선시하는 팀
  • 광범위한 프로바이더 테스트가 필요한 프로젝트
  • 단위 및 통합 테스트를 작성하는 개발자
  • 크로스플랫폼 플러터 애플리케이션

고려 사항

  • Riverpod 패키지가 필요합니다
  • Riverpod 전용 테스트에 국한
  • 복잡한 시나리오를 위해 추가 설정이 필요할 수 있습니다
  • 위젯 레벨 테스트에만 적합하지 않음
  • 외부 테스트 환경 구성에 의존

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

Pub Star on Github Flutter Website License: MIT Bloc Library


Package

Package is a port of felangel's bloc_test, modified to work with Riverpod Providers.
Increase code coverage by testing all riverpod providers.

Installation

For a Flutter project:

flutter pub add --dev riverpod_test

For a Dart project:

dart pub add --dev riverpod_test

Usage

testProvider

import 'package:riverpod_test.dart';

testProvider(
  'expect [0]',
  provider: counterProvider,
  expect: () => [0],
);

final counterProvider = Provider<int>((ref) => 0);

testNotifier

testNotifier(
  'expect [2] when increment is called twice and skip: 1',
  provider: counterNotifierProvider,
  act: (notifier) => notifier
      ..increment()
      ..increment(),
  skip: 1,
  expect: () => [2],
);

final counterNotifierProvider =
    NotifierProvider<CounterNotifier, int>(CounterNotifier.new);

class CounterNotifier extends Notifier<int> {
  @override
  int build() => 0;

  void increment() => state++;
}

testAsyncNotifier (also handles StreamNotifier)

testAsyncNotifier<CounterAsyncNotifier, int>(
  'expect [AsyncData(1)] when call increment',
  provider: counterAsyncNotifierProvider(0),
  act: (notifier) => notifier.increment(),
  expect: () => <AsyncValue<int>>[const AsyncData(1)],
);

testAsyncNotifier(
  'verify if mockRepository sideEffect is called',
  provider: sideEffectAsyncNotifierProvider(1),
  overrides: [repositoryProvider.overrideWithValue(mockRepository)],
  act: (notifier) => notifier.increment(),
  verify: (_) => verify(mockRepository.sideEffect).called(1),
);

final counterAsyncNotifierProvider =
    AsyncNotifierProviderFamily<CounterAsyncNotifier, int, int>(
  CounterAsyncNotifier.new,
);

class CounterAsyncNotifier extends FamilyAsyncNotifier<int, int> {
  @override
  FutureOr<int> build(int initialValue) => initialValue;

  void increment() => state = AsyncData(value + 1);
}

class MockRepository extends Mock implements Repository {}

final sideEffectAsyncNotifierProvider =
    AsyncNotifierProviderFamily<SideEffectAsyncNotifier, int, int>(
  SideEffectAsyncNotifier.new,
);

class SideEffectAsyncNotifier extends FamilyAsyncNotifier<int, int> {
  @override
  FutureOr<int> build(int initialValue) => initialValue;

  Repository get repository => ref.watch(repositoryProvider);

  void increment() {
    repository.sideEffect();
    state = AsyncData(value + 1);
  }
}

testResultProvider

testResultProvider<Repository>(
  'expect [1] when incrementCounter is called',
  provider: repositoryProvider,
  act: (result) => result.incrementCounter(),
  expect: () => [1],
);

final repositoryProvider = Provider<Repository>((ref) => Repository());

class Repository {
  int incrementCounter() => 1;
}

testStateNotifier

testStateNotifier<CounterStateNotifier, int>(
  'expect [0] when decrement is called and seed: 1',
  provider: counterStateNotifierProvider,
  act: (notifier) => notifier.decrement(),
  seed: 1,
  wait: const Duration(milliseconds: 100),
  expect: () => <int>[0],
);

final counterStateNotifierProvider =
    StateNotifierProvider<CounterStateNotifier, int>(
  (ref) => CounterStateNotifier(),
);

class CounterStateNotifier extends StateNotifier<int> {
  CounterStateNotifier() : super(0);

  void increment() => state++;

  Future<void> decrement() async {
    await Future<void>.delayed(const Duration(milliseconds: 100));
    state--;
  }
}

카테고리

의존성

의존성 목록 4 개

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.