EasyLogger

Getting Started

🔩 Installation

Add to your pubspec.yaml:

dependencies:
  easy_logger: <last_version>

⚙️ Configuration logger

Create global logger value

import 'package:easy_logger/easy_logger.dart';

final EasyLogger logger = EasyLogger(
  name: 'NamePrefix',
  defaultLevel: LevelMessages.debug,
  enableBuildModes: [BuildMode.debug, BuildMode.profile, BuildMode.release],
  enableLevels: [LevelMessages.debug, LevelMessages.info, LevelMessages.error, LevelMessages.warning],
);

void main() async {
...
}

📜 EasyLogger properties

Properties	Required	Default	Description
name	false	''	Name prefix in the logging line.
defaultLevel	false	LevelMessages.info	Default message level if no level is set when call EasyLogger.
enableBuildModes	false	BuildMode.debug, BuildMode.profile	List of available build modes in which logging is enabled.
enableLevels	false	LevelMessages.debug, LevelMessages.info, LevelMessages.error, LevelMessages.warning	List of available levels messages in which logging is enabled.
printer	false	easyLogDefaultPrinter()	Default function printing.

Usage

Simle usage:

logger('Your log text');

Or you can set the message level

logger('Your log text', level: LevelMessages.info);

🐛 StackTrace

EasyLogger support StackTrace dump sending:

try {
  //same code
} on Exception catch (e, stackTrace) {
   logger('same error', stackTrace: stackTrace);
}

🖨️ Customise message or build levels

EasyLogger supported Flutter build modes. Read more about Build modes

// only debug and profile modes
logger.enableBuildModes = [BuildMode.debug, BuildMode.profile]

// logger off
logger.enableLevels = []

You can customize what levels of messages you need

// show only errors
logger.enableBuildModes = [LevelMessages.error]

🖨️ Customise printer function

EasyLogger have easiest way to change default printer function. Create your custom printer and past like parameter in class.

EasyLogPrinter customLogPrinter = (
  Object object, {
  String name,
  StackTrace stackTrace,
  LevelMessages level,
}) {
  print('$name: ${object.toString()}');
};

final EasyLogger logger = EasyLogger(
  printer: customLogPrinter,
);

Or insert into class object

logger.printer = customLogPrinter;

🖨️ Helpers

For easest using logger you can send messages without level parameter.

  logger.debug('your log text');
  logger.info('your log text');
  logger.warning('your log text');
  logger.error('your log text');