log method

  1. @override
List<String> log(
  1. LogRecord record
)
override

Formats the given LogRecord into a list of strings.

This method is called for each log event. The returned list of strings will be output line-by-line by the logging framework.

Each string in the list represents a line, allowing multi-line logs (such as those with stack traces or structured JSON).

Implementations should avoid side effects and keep formatting consistent.

Example return:

[
  "[INFO] Application started",
  "Details: version 1.0.0"
]

Implementation

@override
List<String> log(LogRecord record) {
  final buffer = <String>[];
  final mainLine = StringBuffer();

  for (final step in config.steps) {
    if (step == LogStep.STACKTRACE) {
      final stackLines = extractStack(record.stackTrace, excludePaths);
      buffer.addAll(stackLines.map((line) => '  ↪ $line'));
    } else {
      final value = getStepValue(step, record);
      if (value != null && value.isNotEmpty) {
        if (mainLine.isNotEmpty) mainLine.write(' ');

        if(step == LogStep.MESSAGE) {
          mainLine.write(value);
        } else {
          mainLine.write('[$value]');
        }
      }
    }
  }

  buffer.insert(0, mainLine.toString());
  return buffer;
}