logging library

A flexible and extensible structured logging library for Dart and Flutter.

The jetleaf_log library provides a pluggable, highly customizable logging solution for applications that require clarity, consistency, and control over how logs are captured, formatted, and displayed.

🔧 Features:

• Multiple log levels: TRACE, DEBUG, INFO, WARN, ERROR, FATAL
• Structured, human-readable, and colorized output
• Supports tagging, timestamps, error handling, stack traces, and more
• Easily switch or create custom log output styles via LogPrinter
• Customizable logging steps (LogStep) to include/exclude parts of a log

🖨️ Built-in Printer Types (via LogType)

🛠️ Creating a Custom Printer

To define a custom log printer, extend the LogPrinter abstract class:

class MyCustomPrinter extends LogPrinter {
  @override
  List<String> log(LogRecord record) {
    return ['[${record.level.name}] ${record.message}'];
  }
}

Then attach your printer to a custom tracing listener:

final myLogger = Jet();
myLogger.addListener(LoggerListener.withPrinter(MyCustomPrinter()));
myLogger.info('Hello from custom logger!');

🧪 Quick Usage Example

import 'package:jetleaf/logger.dart';

void main() {
  console.debug('Initializing system...');
  console.error('Failed to connect', error: Exception('Timeout'));
}

📦 Exports:

This library exports core types and interfaces:

• LogLevel — log severity levels
• LogStep — defines log components like timestamp, message, error, etc.
• JetType — enum for built-in printer styles
• LogPrinter — base class for custom printer implementations
• LoggingListener — interface for log event listening

@author Evaristus Adimonyemma @emailAddress evaristusadimonyemma@hapnium.com @organization Hapnium @website https://hapnium.com