Pakete, Repositories und App-Kategorien suchen

Paketdetailsv0.0.10

state_notifier_test

Eine Testbibliothek, die das Testen von StateNotifier vereinfacht. Speziell für die Verwendung mit den Paketen state_notifier, riverpod oder flutter_riverpod entwickelt.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
1970
Likes
22
Pub-Punkte
150

Paket installieren

flutter pub add state_notifier_test

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Eine Testbibliothek, die die Prüfung von StateNotifier-Klassen vereinfacht und mit state_notifier, Riverpod und flutter_riverpod kompatibel ist. Sie bietet Hilfsmittel zum einfachen Überprüfen von Zustandsänderungen, zur Behandlung asynchroner Aktualisierungen und zum Testen von Fehlerzuständen. Das Paket integriert sich nahtlos in Flutter-Testworkflows und ermöglicht Entwicklern, zuverlässige und wartbare Tests für reaktive Zustandslogik auf mehreren Plattformen zu schreiben.

Anwendungsfälle

  • Testen von Zustandsübergängen im StateNotifier
  • Asynchrone Zustandsaktualisierungen überprüfen
  • Überprüfung der Fehlerbehandlung in der Zustandslogik
  • Einheitstests für Riverpod-basierte Zustandsverwaltung
  • Konsistenzverhalten über Plattformen hinweg sicherstellen

Hauptmerkmale

  • Einfache Assertion von Zustandsänderungen
  • Unterstützung für asynchrone Zustandstests
  • Integration in das Riverpod-Ökosystem
  • Minimales Boilerplate
  • Plattformübergreifende Kompatibilität
  • Test-Hilfsmethoden für häufige Szenarien

Geeignet für

  • Flutter-Entwickler, die Riverpod oder state_notifier verwenden
  • Teams, die Testzuverlässigkeit priorisieren
  • Projekte mit komplexer Zustandslogik
  • CI/CD-Pipelines, die robuste Unit-Tests erfordern
  • Entwickler, die saubere, isolierte Zustandsprüfungen schreiben

Hinweise

  • Erfordert state_notifier, riverpod oder flutter_riverpod
  • Beschränkt auf StateNotifier-basierte Zustandsverwaltung
  • Möglicherweise ist zusätzliche Einrichtung für komplexe Abhängigkeiten erforderlich
  • Nicht für Integrationstests auf Widget-Ebene vorgesehen
  • Am besten zusammen mit anderen Testpaketen wie mockito oder test verwendet

Original-README

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

Package

Package is a port of felangel's bloc_test, modified to work with StateNotifier class

Installation

Add to dev dependencies inside pubspec_yaml:

dev_dependencies:
  state_notifier_test: [version]

Usage

import 'package:state_notifier_test.dart';

stateNotifierTest(
  'CounterNotifier emits [9,10] when seeded with 9',
  build: () => CounterNotifier(),
  seed: () => [9],
  actions: (stateNotifier) => stateNotifier.increment(),
  expect: () => [9,10],
);

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

  void increment() {
    state = state + 1;
  }
}

stateNotifierTest can also be used to skip any number of emitted states before asserting against the expected states. skip defaults to 0.

stateNotifierTest(
  'CounterNotifier emits [2] when increment is called twice',
  build: () => CounterNotifier(),
  actions: (stateNotifier) {
    stateNotifier
      ..increment()
      ..increment();
  },
  skip: 1,
  expect: () => [2],
);

stateNotifierTest can also be used to verify internal stateNotifier functionality.

stateNotifierTest(
  'CounterNotifier emits [1] when increment is called',
  build: () => CounterNotifier(),
  actions: (stateNotifier) => stateNotifier.increment(),
  expect: () => [1],
  verify: (_) {
    verify(() => repository.someMethod(any())).called(1);
  }
);

Testing Options

setUp is optional and should be used to set up any dependencies prior to initializing the stateNotifier under test. setUp should be used to set up state necessary for a particular test case. For common set up code, prefer to use setUp from package:test/test.dart.

build should construct and return the stateNotifier under test.

seed is an optional Function that returns an Iterable of States which will be used to seed the stateNotifier before actions is called.

actions is an optional callback which will be invoked with the stateNotifier under test and should be used to interactions with the stateNotifier.

skip is an optional int which can be used to skip any number of states. skip defaults to 0.

expect is an optional Function that returns a Matcher which the stateNotifier under test is expected to emit after actions is executed.

verify is an optional callback which is invoked after expect and can be used for additional verification/assertions. verify is called with the stateNotifier returned by build.

errors is an optional Function that returns a Matcher which the stateNotifier under test is expected to throw after actions is executed.

tearDown is optional and can be used to execute any code after the test has run. tearDown should be used to clean up after a particular test case. For common tear down code, prefer to use tearDown from package:test/test.dart.

expectInitialState is an optional bool.If set to true, the initial state from the constructor will also be checked. Useful when you want to validate the initial state. Note: if set to true, it will only catch the last assigned state in the constructor. expectInitialState defaults to false.

Kategorien

Abhängigkeiten

Abhängigkeiten 5 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden