simplest_logger 1.0.1

A lightweight, opinionated, colorful logging utility for Dart applications. Minimal configuration necessary.

simplest_logger

A lightweight, opinionated, colorful logging utility for Dart applications. Minimal configuration necessary.

Features

• Colorful output with ANSI colors (can be disabled)
• Simple API with info, warning, and error levels
• Context-based logging with automatic class name detection
• Minimal configuration required
• Convenient mixin for class-based logging
• Stack trace support for error logging

Installation

Add simplest_logger to your pubspec.yaml:

dependencies:
  simplest_logger: ^1.0.0

Then run:

dart pub get

Usage

Basic Usage

import 'package:simplest_logger/simplest_logger.dart';

void main() {
  // Create a logger instance with a context
  final logger = SimplestLogger('MyApp');
  
  // Initialize the logger
  logger.init();
  
  // Log messages
  logger.info('Application started');
  logger.warning('Resource usage is high');
  logger.error('Failed to connect to database', 
    Exception('Connection timeout'), 
    StackTrace.current
  );
}

Using the Mixin

For class-based logging, use the SimplestLoggerMixin:

import 'package:simplest_logger/simplest_logger.dart';

class MyService with SimplestLoggerMixin {
  void doSomething() {
    logger.info('Starting operation');
    // Your code here
    logger.info('Operation completed');
  }
}

Configuration

Log Levels

Control logging output with log levels:

final logger = SimplestLogger('MyApp');
logger.init();

// Turn off all logging
logger.setLevel(SimplestLoggerLevel.none);

// Enable all logging
logger.setLevel(SimplestLoggerLevel.all);

Color Output

Enable or disable ANSI color output:

final logger = SimplestLogger('MyApp');
logger.init();

// Disable colors
logger.useColors(false);

// Enable colors
logger.useColors(true);

Output Format

The logger produces output in the following format:

LEVEL TIMESTAMP [CONTEXT] MESSAGE

For errors, additional information is included:

LEVEL TIMESTAMP [CONTEXT] MESSAGE
Error: ERROR_DETAILS
Stack trace:
STACK_TRACE

Colors are applied as follows:

• INFO: Green
• WARNING: Yellow
• ERROR: Red

License

MIT License - feel free to use this package in your projects.