the_logger 0.0.18

A modular logging library for Flutter: supports multiple loggers, storage and filters

TheLogger

A modular logging library for Flutter.

Features

• Colorful console logging
• Database logging
• Custom logging
• Sessions
• Exports logs to compressed file
• Flexible logs filtering and retaining strategies
• Ability to mask sensitive data
• Custom color scheme for console logging
• Parsing and pretty printing JSON strings in logs

Getting started

To use this package, add the_logger and logging as a dependency in your pubspec.yaml file.

Usage

Import the packages:

import 'package:the_logger/the_logger.dart';
import 'package:logging/logging.dart';

copied to clipboard

Get an instance of the logger and initialize it:

await TheLogger.i().init();

copied to clipboard

And then you can use it by calling Logger methods:

final _log = Logger('MyHomePage');
_log.finest('some finest log');

copied to clipboard

TheLogger is a singleton, so you can get the same instance anywhere in your app:

final instance = TheLogger.i();

copied to clipboard

This should be done as early as possible in your app, and only once. Before calling init() second time, you should call dispose() method.

You can define retain strategy for logs. For example:

TheLogger.i().init(retainStrategy: {
  Level.ALL:      200,  // ALL records will be deleted after 200 sessions
  Level.INFO:     100,  // records with INFO and higher level retained for 300 sessions
  Level.SEVERE:   50,   // records with SEVERE and higher level retained for 350 sessions
});

copied to clipboard

Logs are separated by sessions. By default, TheLogger starts a new session every time you call init() method (but you can change this behavior by passing startNewSession: false to init() method):

TheLogger.i().init(startNewSession: false);

copied to clipboard

You can start a new session manually by calling:

TheLogger.i().startSession();

copied to clipboard

startSession() can be called multiple times, for example when app resumes from background (see example).

There is a way to append session start log message with custom string (for example, you can add application version) or change session start log message level:

TheLogger.i().init(
  sessionStartExtra: $appVersion,
  sessionStartLevel: Level.FINE, // default is Level.INFO
);

copied to clipboard

To enable or disable console logging and whether to store logs in database, use:

TheLogger.i().init(
  consoleLogger: false,
  dbLogger: false,
);

copied to clipboard

There is a way to capture logs that will be sent to console by providing callback function consoleLoggerCallback:

TheLogger.i().init(
  consoleLoggerCallback: (
      String message, {
      DateTime? time,
      int? sequenceNumber,
      int level = 0,
      String name = '',
      Zone? zone,
      Object? error,
      StackTrace? stackTrace,
  ) {
    // do something with the record
  },
);

copied to clipboard

You can define custom color scheme for console logging by extending ConsoleColors class and providing it's instance to init() method as consoleColors parameter.

Console logger tries to parse embedded in message and error JSON strings and print them in pretty format. You can disable this feature by setting consoleFormatJson to false in init() method.

You can add custom loggers (for example for sending logs to server):

TheLogger.i().init(
  customLoggers: [
    remoteLogger,
    anotherLogger,
  ],
);

copied to clipboard

To write all logs to compressed file call writeAllLogsToJson method:

final filePath = await TheLogger.i().writeAllLogsToJson();

copied to clipboard

This method returns a path to the file with logs. You can send this file to server, ask user to send it to you, or do whatever you want with it.

For debugging purposes, you can get all logs from database and clear all logs from database:

final logsAsString = await TheLogger.i().getAllLogsAsString();
final logsAsList = await TheLogger.i().getAllLogs();
final logsAsMaps = await TheLogger.i().getAllLogsAsMaps();
final logsAsMaps = await TheLogger.i().clearAllLogs();

copied to clipboard

To mask sensitive data in logs, you can provide a list of strings or regular expressions:

TheLogger.i().addMaskingString(MaskingString('password'));
TheLogger.i().addMaskingStrings(
  {
    MaskingString(
      's[ecr]+t',
      isRegExp: true,
    ),
    MaskingString(
      'seed',
      caseSensitive: false,
      maskedString: '######',
    ),
  },
);

copied to clipboard

Viewing logs

You can view logs in console while debugging your app. Also you can add sending logs to server by adding custom logger or by using writeAllLogsToJson method, which writes all logs to compressed file that you can send by email or 'share' it in any other way. To view exported logs, you can use TheLoggerViewer.

Testing

This package includes several unit tests for its features. To run the tests, use the following command:

flutter test

copied to clipboard