Welcome to Perfect Error Handler, error handler with type-safety/streaming/freezed-functionality/cover-all-dio-exceptions

Motivation

try{}catch(e){} are hard to use also then((){}).catch((){}) make code hard to read and modify

  • handle all state init/loading/data/error easily
  • stream state changes
  • logger for states
  • built above freezed
  • function tear-off if possible
  • built on Dio so it covers all types of exceptions also you can add your own!

Same as mentioned in Freezed Implementing all of this can take hundreds of lines and it’s hard to make a specific error handler in each project

Perfect Error Handler is implemented so all you have to do is start sending requests!

Before After
before after

How to use

Install

For a Flutter project:

flutter pub add error_handler
flutter pub add dio

For a Dart project:

flutter pub add error_handler
flutter pub add dio

Example

read fill example here

import 'package:dio/dio.dart';
import 'package:error_handler/error_handler.dart';
import 'post.dart';


/// first create [Dio] api call
FutureResponse<Post> getPost() async {
  final dio = Dio();

  final response = await dio.get("https://jsonplaceholder.typicode.com/posts/1");

  return HttpResponse(Post.fromJson(response.data), response);
}

/// wrap the api call with [safeApiCall]
void main() {
  safeApiCall(getPost).listen((event) {
    event.when(
      idle: () {
        print("init");
      },
      loading: () {
        print("loading...");
      },
      data: (post, statusCode) {
        print("title: ${post.title}");
      },
      error: (error) {
        print(getErrorMessage(error));
      },
    );
  });
}

how to use safeApiCall

safeApiCall(() {
  return getPost();
}).listen((event) {
    event.whenOrNull(
      data: (post, statusCode) {
        print(post.title);
      },
    );
  });

other example

StreamState<Post> getPostRepository(String id) =>
    safeApiCall(() => getPost(id));

ResultState can use other typedef like

ApiResponse, UiState

Credits 🙏

Freezed

GitHub

View Github