Pakete, Repositories und App-Kategorien suchen

Paketdetailsv0.1.9

riverpod_test

Eine Testbibliothek, die das Testen von Providern vereinfacht. Speziell für den Einsatz mit dem riverpod-Paket entwickelt.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
4570
Likes
28
Pub-Punkte
150

Paket installieren

flutter pub add riverpod_test

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

riverpod_test ist eine Testbibliothek, die entwickelt wurde, um das Testen von Riverpod-Anbietern in Flutter-Anwendungen zu vereinfachen. Sie bietet Werkzeuge, um Anbieterwerte einfach zu überschreiben, zu mocken und isoliert zu testen, wodurch zuverlässige und wartbare Tests gewährleistet werden. Speziell für das Riverpod-Paket entwickelt, integriert sie sich nahtlos in das Flutter-Testökosystem und ermöglicht Entwicklern, Zustandslogik zu überprüfen, ohne auf echte Abhängigkeiten angewiesen zu sein. Die Bibliothek unterstützt alle wichtigen Plattformen und ist daher ideal für plattformübergreifende Testworkflows.

Anwendungsfälle

  • Testen von Anbieterzustandsänderungen
  • Abhängigkeiten in Tests mocken
  • Überprüfung der Geschäftslogik in Anbietern
  • Einheitstests von echten Datenquellen isolieren
  • Asynchrone Vorgänge in Anbietern überprüfen

Hauptmerkmale

  • Einfache Anbieterüberschreibungen
  • Eingebaute Mocking-Unterstützung
  • Integration mit dem Testframework von Flutter
  • Unterstützung für asynchrone und synchrone Anbieter
  • Saubere, lesbare Test-Syntax

Geeignet für

  • Flutter-Entwickler, die Riverpod verwenden
  • Teams, die Testzuverlässigkeit priorisieren
  • Projekte, die umfangreiche Provider-Tests erfordern
  • Entwickler, die Einheitstests und Integrationstests schreiben
  • Plattformübergreifende Flutter-Anwendungen

Hinweise

  • Benötigt das Riverpod-Paket
  • Beschränkt auf Riverpod-spezifische Tests
  • Für komplexe Szenarien ist möglicherweise zusätzliche Einrichtung erforderlich
  • Nicht geeignet für Widget-Ebene-Tests allein
  • Abhängig von der Konfiguration der externen Testumgebung

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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--;
  }
}

Kategorien

Abhängigkeiten

Abhängigkeiten 4 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.