err 0.3.0 err: ^0.3.0 copied to clipboard
A logs router that can pop messages to the device screen. The routes are configurable for each log level.
Err #
A logs router that can pop messages to the device screen.
Configuration #
Configure the log levels routes: available routes: console, screen or black hole. All the logs routed to the black hole will be silently swallowed: use this to disable a route. All routes default to console.
import 'package:err/err.dart';
var logger = ErrRouter(
criticalRoute: [ErrRoute.console, ErrRoute.screen],
errorRoute: [ErrRoute.screen, ErrRoute.console],
warningRoute: [ErrRoute.screen, ErrRoute.console],
infoRoute: [ErrRoute.screen],
debugRoute: [ErrRoute.blackHole]);
Screen route usage #
Flash messages #
The flash messages are toast messages. They stay one second on the screen
@override
void initState() {
logger.debugFlash("Init state");
super.initState();
}
Available flash messages:
debugFlash
(String
msg): a debug message
infoFlash
(String
msg): an information message
Regular messages #
The regular messages are snackbar messages. They need a BuildContext
logger.info("File uploaded in $elapsed s", context: context);
logger.debug("A debug message", context: context);
try {
somethingWrong();
} catch(ex) {
logger.criticalErr(
err: ex,
msg: "Something wrong happened",
context: context);
}
Available messages:
critical
(String
msg): will stay on screen until dismissed
criticalErr
({String
msg, dynamic
err}): err
is an error or an exception. Will stay on screen until dismissed
error
(String
msg): will stay on screen until dismissed
errorErr
({String
msg, dynamic
err}): err
is an error or an exception. Will stay on screen until dismissed
warning
(String
msg): will stay on screen until dismissed
warningErr
({String
msg, dynamic
err}): err
is an error or an exception. Will stay on screen until dismissed
warningShort
(String
msg): will stay on screen for 3 seconds
warningErrShort
({String
msg, dynamic
err}): err
is an error or an exception. Will stay on screen for 3 seconds
info
(String
msg): will stay on screen for 3 seconds
debug
(String
msg): will stay on screen for 3 seconds
Console route #
By default the terminal output is configured for black and white. If your terminal supports colorized unicode emoticons use this parameter:
var logger = ErrRouter(
// ...
terminalColors: true);