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 color = levelColor(record.level);

  buffer.add(_formatTopBorder(color));

  bool hasContent = false;
  for (final step in config.steps) {
    final content = getStepValue(step, record);
    if (content != null) {
      if (hasContent && (step == LogStep.STACKTRACE || step == LogStep.ERROR)) {
        buffer.add(_formatMiddleBorder(color));
      }
      buffer.addAll(_formatSection(color, content));
      hasContent = true;
    }
  }

  buffer.add(_formatBottomBorder(color));
  return buffer;
}