Logger RS

A Rust-style logger for Dart with colored output, precise file locations, and clean formatting inspired by the Rust compiler.

Installation

dependencies:
  logger_rs: ^2.0.2

Quick Start

import 'package:logger_rs/logger_rs.dart';

void main() {
  Log.d('Debug message');     // Cyan
  Log.i('Info message');      // Green
  Log.w('Warning message');   // Yellow
  Log.e('Error message');     // Red
  Log.f('Fatal message');     // Magenta
  Log.t('Trace message');     // Gray
}

Log Levels

Level	Method	Color	Description
Trace	Log.t()	Gray	Verbose debugging, method entry/exit
Debug	Log.d()	Cyan	Development information
Info	Log.i()	Green	General information
Warning	Log.w()	Yellow	Potential issues
Error	Log.e()	Red	Errors with optional stack traces
Fatal	Log.f()	Magenta	Critical failures

Error Handling

try {
  await riskyOperation();
} catch (error, stackTrace) {
  Log.e('Operation failed', error: error, stackTrace: stackTrace);
}

Output:

ERROR: Operation failed
  --> src/service.dart:45:12
   |
   = error: SocketException: Connection refused
 1 | #0  Service.call (src/service.dart:45:12)
 2 | #1  App.run (src/app.dart:23:5)
   └─

Logging Objects

Maps and objects are automatically formatted as JSON:

Log.i({'user': 'john', 'action': 'login'});

Output:

INFO: src/auth.dart:15:3
   |
   ┌─
{
  "user": "john",
  "action": "login"
}
   └─

Tag Logging (Advanced)

Group related logs across your application and export them for debugging or AI analysis.

Basic Usage

// Tag logs throughout your code
Log.tag('auth', 'User pressed login');
Log.tag('auth', 'Validating credentials', level: Level.INFO);
Log.tag('auth', {'email': 'user@example.com'});

// Export when needed
Log.export('auth');

Conditional Export

// Export only if errors occurred
Log.export('auth', onlyOnError: true);

// Export based on custom condition
Log.export('auth', export: isDebugMode);

Tag API

Method	Description
Log.tag(name, msg)	Add log to tag
Log.tag(name, msg, level: Level.SEVERE)	Add with specific level
Log.export(name)	Export tag to console
Log.export(name, onlyOnError: true)	Export only if errors exist
Log.exportAll()	Export all tags
Log.clear(name)	Clear tag without exporting
Log.clearAll()	Clear all tags
Log.hasTag(name)	Check if tag exists
Log.hasErrors(name)	Check if tag has errors
Log.entryCount(name)	Get entry count

Tags are automatically removed in release builds (zero overhead).

Platform Support

Works on all Dart platforms with automatic color support:

• Flutter (iOS, Android, Web, Desktop)
• Dart VM / Native
• Web (WASM compatible)

Performance

Operation	Time
Simple log	~17μs
Map/JSON log	~24μs
Error with stack	~27μs

License

MIT License - see LICENSE for details.

Author

JhonaCode - @JhonaCodes