搜尋套件、儲存庫與 APP 分類

套件詳情v0.1.9

riverpod_test

一個測試程式庫,讓測試提供者變得輕鬆。專為與 riverpod 套件搭配使用而設計。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
4570
喜歡數
28
Pub 分數
150

安裝套件

flutter pub add riverpod_test

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

riverpod_test 是一個專門設計來簡化 Flutter 應用程式中 Riverpod 提供者測試的測試庫。它提供實用工具,可輕鬆覆蓋、模擬和隔離測試提供者值,確保測試的可靠性與可維護性。專為 Riverpod 套件打造,它與 Flutter 測試生態系統無縫整合,讓開發者能在不依賴實際相依性的前提下驗證狀態邏輯。該套件支援所有主要平台,非常適合跨平台測試工作流程。

適用情境

  • 測試提供者狀態變更
  • 在測試中模擬依賴項
  • 驗證提供者中的業務邏輯
  • 將單元測試與真實資料來源隔離
  • 驗證提供程式中的異步操作

主要特色

  • 輕鬆提供者覆蓋
  • 內建模擬支援
  • 與 Flutter 測試框架的整合
  • 對異步和同步提供程式的支持
  • 乾淨、可讀的測試語法

適合對象

  • 使用 Riverpod 的 Flutter 開發人員
  • 重視測試可靠性的團隊
  • 需要大量 provider 測試的項目
  • 撰寫單元測試與整合測試的開發者
  • 跨平台 Flutter 應用程式

使用建議

  • 需要 Riverpod 包
  • 僅限 Riverpod 特定測試
  • 複雜場景可能需要額外的設定
  • 僅適用於 widget 層級測試
  • 依賴外部測試環境設定

原始 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 項

原始碼儲存庫

使用此套件的專案

暫無相關資料。