err_router 0.2.0 err_router: ^0.2.0 copied to clipboard
A logs router that can pop messages to the device screen. An on device error log is available
Err router #
A logs router that can pop messages to the device screen. Based on the err package for errors management. The messages can be routed to:
- Terminal and on device console
- Flash messages
- Snackbar messages
Usage #
Initialize the logger
import 'package:err_router/err_router.dart';
final ErrRouter log = ErrRouter();
Create an error with the Err class and log it to console:
final err = Err.error("Network error");
log.console(err);
Console messages #
The console
method prints an error and save it to history
Arguments
Accepted arguments: any object, string or an Err
instance. Pass it an Exception
or Error
to get the stacktrace printed in the message
The Err
class constructors all accept a userMessage
parameter. Use it to separate the technical message for the developer from the user friendly message for the user:
/// let's say we have an exception [e]
final err = Err.error(e, userMessage: "Can not connect to x");
log.scren(err, context);
The message displayed to user will be the one from userMessage
Snackbar messages #
log.screen(err, context);
Flash messages #
log.flash(err);
The flash messages are toast messages. They stay one second on the screen
History #
To access the history:
final List<Err> history = log.history;
On device console #
Navigate to DeviceConsolePage(log)
to see the console on the device