convenient_architecture 0.1.3 convenient_architecture: ^0.1.3 copied to clipboard
The collection of useful utils and architecture base classes.
It is alpha #
Some API may be changed.
The collection of useful utils and architecture base classes.
It consists of #
response_parser
- helps to parse responses and errors, and map them to the convenientEither
format.fpdart
andfunctional_extensions
- main functional programming types and patterns.action_bloc
- subtype of the bloc which converts an action execution to theinProgress
andsuccess
/failure
states.facade_consumer_cubit
- cubit which shortcuts the subscribing and listening to the reactive facade.reactive_facade
- helps to make the work with the infrastracture layer reactive.
Take a look at the example app to see these parts in action
Action blocs #
Action bloc is used to automatically map action
to the states. It's supposed to
be used with the ReactiveFacade
.
action
is a function which performs an action that should be mapped to the states.
It may be similar to the FutureBuilder
which also maps action to the states however
action blocs are more advanced.
It works this way:
- event is added
- action is performed
- before actions is performed
in progress
state is emitted - when action is successfully performed
success
state is emitted - in case of failure
failure
state with an error is emitted.
- before actions is performed
- action is performed
To map an action
to the states bloc is using IStateAdapter
.
This is an adapter provided by user which takes an action with event, executes it
and returns an Either
of result or error.
Facade consumer cubit #
It's a base for the cubit which listens to the ReactiveFacade.dataStream
.
Reactive facade #
As you may know facade is a pattern which provides a simplified interface to complex set of classes. In our case these classes are api and local repositories.
Reactive Facade's goal is to be a single source of truth, hide the data synchronization and provide the reactive api.