logging library

Provides a flexible logging infrastructure with support for multiple log providers and structured logging.

This library implements a comprehensive logging system inspired by Microsoft.Extensions.Logging, supporting various output formats and log levels with dependency injection integration.

Basic Usage

Configure logging with dependency injection:

final services = ServiceCollection()
  ..addLogging((builder) {
    builder
      ..setMinimumLevel(LogLevel.debug)
      ..addSimpleConsole()
      ..addDebug();
  });

final provider = services.buildServiceProvider();
final logger = provider.getRequiredService<ILogger>();

Logging Messages

Log messages at different severity levels:

logger.logInformation('Application started');
logger.logWarning('Low disk space');
logger.logError('Failed to connect', error: exception);
logger.logDebug('Cache hit for key: {Key}', ['user123']);

Console Formatters

Multiple console output formats are available:

• Simple: Human-readable format with colors
• JSON: Structured JSON output for log aggregation
• Systemd: Systemd journal compatible format

builder.addJsonConsole();  // JSON format
builder.addSystemdConsole();  // Systemd format

Scoped Logging

Create log scopes for contextual information:

using((scope) {
  logger.logInformation('Processing order');
  // All logs in this scope include the order ID
}, logger.beginScope({'OrderId': '12345'}));