Alice

pub package pub package pub package

Alice is an HTTP Inspector tool for Flutter which helps debugging http requests. It catches and stores http requests and responses, which can be viewed via simple UI. It is inspired from Chuck (https://github.com/jgilfelt/chuck).

Suported Dart http client plugins:

  • Dio
  • HttpClient from dart:io package
  • Http from http/http package

Features:
✔️ Detailed logs for each HTTP calls (HTTP Request, HTTP Response)
✔️ Inspector UI for viewing HTTP calls
✔️ Save HTTP calls to file
✔️ Statistics
✔️ Notification on HTTP call
✔️ Support for top used HTTP clients in Dart
✔️ Error handling

Install

  1. Add this to your pubspec.yaml file:
dependencies:
  alice: ^0.0.13
  1. Install it
$ flutter packages get
  1. Import it
import 'package:alice/alice.dart';

Usage

Create Alice instance:

Alice alice = Alice(showNotification: true);

Alice default behaviour is to show notification with http requests. You can disable it in Alice constructor.

Add navigator key to your application:

MaterialApp( navigatorKey: alice.getNavigatorKey(), home: ...)

You need to add this navigator key in order to show inspector UI. You can use also your navigator key in Alice:

Alice alice = Alice(showNotification: true, navigatorKey: yourNavigatorKeyHere);

If you're using Dio, you just need to add interceptor.

Dio dio = Dio();
dio.interceptors.add(alice.getDioInterceptor());

If you're using HttpClient from dart:io package:

httpClient
	.getUrl(Uri.parse("https://jsonplaceholder.typicode.com/posts"))
	.then((request) async {
		alice.onHttpClientRequest(request);
		var httpResponse = await request.close();
		var responseBody = await httpResponse.transform(utf8.decoder).join();
		alice.onHttpClientResponse(httpResponse, request, body: responseBody);
 });

If you're using http from http/http package:

http.get('https://jsonplaceholder.typicode.com/posts').then((response) {
    alice.onHttpResponse(response);
});

To show inspector manually:

alice.showInspector();

Saving calls

Alice supports saving logs to your mobile device storage. In order to make save feature works, you need to add in your Android application manifest:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Example

See complete example here: https://github.com/jhomlala/alice/blob/master/example/lib/main.dart

Libraries

alice
alice_alert_helper
alice_base_call_details_widget
alice_call_details_screen
alice_call_error_widger
alice_call_list_item
alice_call_overview_widget
alice_call_request_widget
alice_call_response_widget
alice_calls_list_screen
alice_core
alice_dio_interceptor
alice_http_adapter
alice_http_call
alice_http_client_adapter
alice_http_error
alice_http_request
alice_http_response
alice_menu_item
alice_save_helper
alice_stats_screen