cubit_test 0.0.7

A testing library built to make testing cubits easy. Built to be used with the cubit and bloc state management packages.

---

WARNING: This is highly experimental

A Dart package built to make testing cubits easy. Built to work with the cubit and bloc state management packages.

Create a Mock Cubit

import 'package:cubit_test/cubit_test.dart';

class MockCounterCubit extends MockCubit<int> implements CounterCubit {}

Stub the Cubit Stream

whenListen creates a stub response for the listen method on a Cubit. Use whenListen if you want to return a canned Stream of states for a cubit instance. whenListen also handles stubbing the state of the cubit to stay in sync with the emitted state.

// Create a mock instance
final counterCubit = MockCounterCubit();

// Stub the cubit `Stream`
whenListen(counterCubit, Stream.fromIterable([0, 1, 2, 3]));

// Assert that the cubit emits the stubbed `Stream`.
await expectLater(counterCubit, emitsInOrder(<int>[0, 1, 2, 3])))

// Assert that the cubit's current state is in sync with the `Stream`.
expect(counterCubit.state, equals(3));

Unit Test a Real Cubit with cubitTest

cubitTest creates a new cubit-specific test case with the given description. cubitTest will handle asserting that the cubit emits the expected states (in order) after act is executed. cubitTest also handles ensuring that no additional states are emitted by closing the cubit stream before evaluating the expectation.

build should be used for all cubit initialization and preparation and must return the cubit under test as a Future.

act is an optional callback which will be invoked with the cubit under test and should be used to interact with the cubit.

skip is an optional int which can be used to skip any number of states. The default value is 1 which skips the initialState of the cubit. skip can be overridden to include the initialState by setting skip to 0.

wait is an optional Duration which can be used to wait for async operations within the cubit under test such as debounceTime.

expect is an optional Iterable<State> which the cubit under test is expected to emit after act 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 cubit returned by build.

group('CounterCubit', () {
  cubitTest(
    'emits [] when nothing is called',
    build: () async => CounterCubit(),
    expect: [],
  );

  cubitTest(
    'emits [1] when increment is called',
    build: () async => CounterCubit(),
    act: (cubit) async => cubit.increment(),
    expect: [1],
  );
});

cubitTest can also be used to skip any number of emitted states before asserting against the expected states. The default value is 1 which skips the initialState of the cubit. skip can be overridden to include the initialState by setting skip to 0.

cubitTest(
  'CounterCubit emits [0, 1] when increment is called',
  build: () async => CounterCubit(),
  act: (cubit) async => cubit.increment(),
  skip: 0,
  expect: [0, 1],
);

cubitTest can also be used to wait for async operations like debounceTime by providing a Duration to wait.

cubitTest(
  'CounterCubit emits [1] when increment is called',
  build: () async => CounterCubit(),
  act: (cubit) async => cubit.increment(),
  wait: const Duration(milliseconds: 300),
  expect: [1],
);

cubitTest can also be used to verify internal cubit functionality.

cubitTest(
  'CounterCubit emits [1] when increment is called',
  build: () async => CounterCubit(),
  act: (cubit) async => cubit.increment(),
  expect: [1],
  verify: (_) async {
    verify(repository.someMethod(any)).called(1);
  }
);

Note: when using cubitTest with state classes which don't override == and hashCode you can provide an Iterable of matchers instead of explicit state instances.

cubitTest(
  'emits [StateB] when emitB is called',
  build: () async => MyCubit(),
  act: (cubit) async => cubit.emitB(),
  expect: [isA<StateB>()],
);

Dart Versions

• Dart 2: >= 2.7.0

Maintainers

• Felix Angelov