arafatamim / deferred_type

Modeling asynchronous data made easy in Dart

deferred_type for Dart

Modeling asynchronous data in Dart made easy.

Examples

final Deferred<String> idle = Deferred.idle();
final Deferred<String> inProgress = Deferred.inProgress();
final Deferred<String> success = Deferred.success('DATA!');
final Deferred<String> error = Deferred.error('ERROR!');

Flutter

Package deferred_type_flutter contains FutureBuilder2, an alternative "FutureBuilder" which is simpler to use than the bundled one provided by default in Flutter.

import "package:deferred_type_flutter/deferred_type_flutter.dart";

final futureBuilder = FutureBuilder2<String>(
  future: someFuture,
  builder: (context, state) => state.maybeWhen<Widget>(
    inProgress: () => const CircularProgressIndicator(),
    success: (data) => SomeWidget(data),
    error: (error, _stacktrace) => SomeErrorWidget(error),
    // handle fallback cases, must be provided
    // if all states are not handled.
    orElse: () => const FallbackWidget(),
  );
);

API Reference

Detailed API documentation can be found on pub.dev.

Other resources

• Comprehensive functional programming library for Dart: https://github.com/SandroMaglione/fpdart.
• Datum library for TypeScript compatible with fp-ts: https://github.com/nullpub/datum.
• Alternative, similar package on pub.dev: https://pub.dev/packages/remote_state.

License

This project is MIT licensed.