schwifty

Description:

schwifty

Schwifty #
This is a simple stream-based state machine for Flutter. It was designed to be a simplified version of the BLoC pattern that does not rely on context and requires less boilerplate.
Installation #
Add the following to your pubspec.yaml file:
dependencies:
schwifty: ^0.0.1
copied to clipboard
Usage #
Creating a Schwifty State Stream #
To create a new state stream, use the Schwifty class. This class has a single method, create, which takes a function that returns a stream of the state you want to manage. The function will be called when the stream is first listened to.
final Schwifty<int> _schwifty = Schwifty<int>('counter');
copied to clipboard
In the example above, we create a new Schwifty instance that will manage an integer state. You need to pass a unique name to the constructor and specify the value type for the instance so that the state can be identified. Using the name of an existing instance will return the same instance. If you access an existing instance with a different type, an exception will be thrown.
You can access the current value of the state by using the value property of the Schwifty instance.
print(_schwifty.value);
copied to clipboard
You can also set the initial value of the state by passing it to the constructor.
final Schwifty<int> _schwifty = Schwifty<int>('counter')..emit(1);
copied to clipboard
You can access the previous value of the state by using the previousValue property of the Schwifty instance.
print(_schwifty.previousValue);
copied to clipboard
Listening to the State Stream #
To listen to the value stream, you can listen to the stream property of the Schwifty instance, use a StreamBuilder widget, or use the SchwiftyBuilder widget.
Using the stream Property
_schwifty.stream.listen((value) {
print(value);
});
copied to clipboard
Using a StreamBuilder Widget
StreamBuilder<int>(
stream: _schwifty.stream,
builder: (context, snapshot) {
return Text(snapshot.data.toString());
},
);
copied to clipboard
Using a SchwiftyBuilder Widget
SchwiftyBuilder<int>(
schwifty: _schwifty,
builder: (context, schwifty) {
return Text(schwifty.value.toString());
},
);
copied to clipboard
Updating the State #
You can update the state value by calling the emit method of the Schwifty instance.
_schwifty.emit(1);
copied to clipboard
You can also use the emitFromFuture method to update the state value from a future. This will automatically handle the loading state and error state for you.
_schwifty.emitFromFuture(Future.value(1));
copied to clipboard
Lastly, you can use the emitFromStream method to update the state value from a stream. This will put the stream in a loading state until the stream emits a value or an error.
_schwifty.emitFromStream(Stream.value(1));
copied to clipboard
Handling Loading and Error States #
When you use the emitFromFuture or emitFromStream methods, the state will automatically be set to a loading state until the future or stream emits a value. If the future or stream throws an error, the state will be set to an error state with the error object.
You can check if a Schwifty instance is in a loading or error state by checking the isLoading and hasError properties.
if (_schwifty.isLoading) {
print('Loading...');
}

if (_schwifty.hasError) {
print('Error: ${_schwifty.error}');
}
copied to clipboard
Disposing the State Stream #
To dispose of the state stream, you can call the dispose method of the Schwifty instance. If you call this on a Schwifty instance that was created with a unique name, the instance will still be accessible by the name, but the stream will be closed and will not emit any more values.
_schwifty.dispose();
copied to clipboard
The SchwiftyBuilder Widget #
The SchwiftyBuilder is a convenience widget that will automatically listen to the state stream and rebuild the widget when the state changes.
Properties:

schwifty: The Schwifty instance to use.
builder: A function that takes a BuildContext and a Schwifty instance and returns a Widget.
loadingBuilder: A function that takes a BuildContext and a Schwifty instance and returns a Widget. This will be called when the state is in a loading state.
errorBuilder: A function that takes a BuildContext, a Schwifty instance, and an Object and returns a Widget. This will be called when the state is in an error state.
shouldRebuild: A function that takes the Schwifty instance and returns a bool. If this function returns false, the widget will not be rebuilt.
onlyRebuildOnValueChange: A bool that determines if the widget should only be rebuilt when the state value changes. Defaults to true.
onlyBuildOnce: A bool that determines if the widget should only be built once as soon as the state has a value. Defaults to false.

SchwiftyBuilder<int>(
schwifty: _schwifty,
builder: (context, schwifty) {
return Text(schwifty.value.toString());
},
loadingBuilder: (context, schwifty) {
return CircularProgressIndicator();
},
errorBuilder: (context, schwifty, error) {
return Text('Error: $error');
},
shouldRebuild: (schwifty) {
return schwifty.value % 2 == 0;
},
onlyRebuildOnValueChange: false,
onlyBuildOnce: true,
);
copied to clipboard
Conclusion #
That's it! You now have a simple stream-based state machine for Flutter. Feel free to open an issue on GitHub if you have any suggestions or improvements.