Credits to bloc_test for the orignal model
Super Test
Designed to simplify testing of SuperControllers, RxNotifiers and RxTs. Developed for the flutter_super package.
Create a Mock
class MockCounterController extends CounterController {}
class MockCounterNotifier extends CounterNotifier {}
Controller Tests
Test case for a SuperController
object.
The testController
function is used to define a test case for a SuperController
object. It takes various parameters to configure the test case, including the description
of the test, the build
function to create the SuperController
object, functions for handling enable, alive, and disable states, setup and teardown functions, initial state seed
, actions to perform on the controller, a wait duration, expected outcomes, verification functions, error handling, and optional tags
for categorization.
Example usage:
testController<MyController, int>(
'MyController test',
build: MyController(),
state: (controller) => controller.myState,
onEnable: (controller) {
// Handle the enable state.
},
onAlive: (controller) {
// Handle the alive state.
},
onDisable: (controller) {
// Handle the disable state.
},
setUp: () {
// Perform setup operations.
},
seed: 10,
act: (controller) async {
// Perform actions on the controller.
},
wait: const Duration(seconds: 1),
expect: [10],
verify: (controller) async {
// Perform additional verifications.
},
tearDown: () {
// Perform teardown operations.
},
);
In the above example, the testController function is used to define a test case for a custom SuperController
object that holds an integer value. The test case includes a description, a build
function to create the SuperController
object, functions to handle the enable, alive, and disable states, setup and teardown functions, an initial state seed
, actions to perform on the controller, a wait duration, expected outcomes, verification functions, and teardown operations. The test case can be executed by running the test suite.
The testController function provides a convenient way to define and organize test cases for SuperController
objects in unit tests.
RxT Tests
Defines a test case for a RxT
object.
The testRxT function defines a test case for a specific RxT
object, which represents a reactive state container. It allows you to set up the initial state, perform actions on the state, and verify the expected behavior and outcomes.
The testRxT function takes various parameters to configure the test case, such as the test description, setup and teardown functions, actions to perform on the state, expected outcomes, and error handling. It uses the test
library from the test
package to define and run the actual test.
Example usage:
testRxT<int>(
'RxT test case',
build: RxT<int>(0),
act: (rx) => rx.value = 10,
expect: [10],
);
In the above example, the testRxT function is used to define a test case for an RxT
object that holds an integer value. The test case sets up the initial state, performs an action by assigning the value 10 to the state, and expects the state to have the value 10. The test case is then run using the test
library.
The testRxT function simplifies the testing of reactive state containers, allowing you to define clear and concise test cases that cover different scenarios and behaviors of the state.
RxNotifier Tests
Defines a test case for a RxNotifier
object.
The testRxNotifier function defines a test case for a specific RxNotifier
object, which represents a reactive state container. It allows you to set up the initial state, perform actions on the state, and verify the expected behavior and outcomes.
The testRxNotifier function takes various parameters to configure the test case, such as the test description, setup and teardown functions, actions to perform on the state, expected outcomes, and error handling. It uses the test
library from the test
package to define and run the actual test.
Example usage:
testRxNotifier<int>(
'RxNotifier test case',
build: RxNotifier<int>(0),
act: (notifier) => notifier.value = 10,
expect: [10],
);
In the above example, the testRxNotifier function is used to define a test case for an RxNotifier
object that holds an integer value. The test case sets up the initial state, performs an action by assigning the value 10 to the state, and expects the state to have the value 10. The test case is then run using the test
library.
The testRxNotifier function simplifies the testing of reactive state containers, allowing you to define clear and concise test cases that cover different scenarios and behaviors of the state.
Additional Information
For more information on all the APIs and more, check out the API reference.
Requirements
- Dart 3: >= 3.0.0
Maintainers
Credits
All credits to God Almighty who guided me through the project.
Libraries
- super_test
- Developed to simplify testing of SuperControllers, RxNotifiers and RxTs.