mu_state 0.0.1

A set of helpers for pragmatic state handling as mentioned in my Medium article.

mu_state

A set of helpers for pragmatic state handling in Flutter as mentioned in my Medium article .

Features

A set of classes for handling state based on ValueNotifier and ValueListenableBuilder, where state is wrapped in a MuEvent object:

• MuEvent - state event with data, loading and error fields
• MuState - a ValueNotifier of type MuEvent
• MuBuilder - a ValueListenableBuilder of type MuEvent
• MuMultiBuilder - listen to multiple MuState objects and get notified with a list of values

Getting started

Declare state as a global final MuState variable and pass it an initial MuEvent. Pass a new MuEvent object to MuState.value as the state changes.

Implement a custom state class which extends MuState, for more complex state handling.

Listen to a single state object using MuBuilder.

Listen to multiple state objects using MuMultiBuilder, which notifies you with a list of MuEvent values.

Example

In load_state.dart:

import 'package:mu_state/mu_state.dart';

class LoadState extends MuState<String> {
  LoadState(MuEvent<String> value) : super(value);

  void load() async {
    value = const MuEvent.loading();
    await Future.delayed(const Duration(milliseconds: 500));
    value = const MuEvent.data('done');
  }
}

final loadState = LoadState(const MuEvent.data('initial'));

In main.dart:

Scaffold(
  body: Center(
    child: MuBuilder<String>(
      state: loadState,
      builder: (context, event, child) {
        if (event.loading) {
          return const CircularProgressIndicator();
        }
        if (event.hasError) {
          return Text('Error: ${event.error.toString()}');
        }
        return Text('${event.data}');
      },
    ),
  ),
),

Also see Example.

Additional information

I'd like to keep this packages minimal, but please create an issue if you have a suggestion.

I'm on Twitter as @apptakk