VersaLog is a powerful and flexible logging library for Dart.
It supports everything from simple usage to advanced, highly customizable configurations to meet a wide range of needs.
- Supports standard log levels:
INFO,ERROR,WARNING,DEBUG,CRITICAL
- Colored output for better readability
- Symbol-based prefixes (e.g.
[+],[-],[!])
Easily switch between different log styles:
simple→[+] messagesimple2→[TIME] [+] messagedetailed→[TIME][LEVEL] : messagefile→[FILE:LINE][LEVEL] message
- Add custom tags to logs
- Supports multiple tags (e.g.
["API", "AUTH"]) - Optional default tags
- Display caller file name and line number
- Useful for debugging large projects
- Automatically save logs to files
- Output path:
./log/YYYY-MM-DD.log - Select which log levels to save
- Automatically deletes old log files (default: 7 days)
- Keeps your log directory clean
- Disable console output
- Useful for background services
- Automatically captures unhandled exceptions
- Logs them as
CRITICAL
- Optional desktop alerts for errors and critical logs
- Uses
plyer.notification
- Non-blocking log processing using threads and queues
- Improves performance in high-load environments
Join our Discord server for support, questions, and community discussions:
dart pub add versalog_dart| Enum | Description |
|---|---|
detailed | Logs including execution time and log levels |
file | Logs with filename and line number |
simple | Simple and easy-to-read logs |
simple2 | Simple and easy-to-read log format. The timestamp is automatically included. |
| Options | Description |
|---|---|
show_file | True : Display filename and line number (for simple and detailed modes) |
show_tag | True : Show self.tag if no explicit tag is provided |
tag | Default tag to use when show_tag is enabled |
enable_all | Shortcut to enable both show_file and show_tag |
notice | True : When an error or critical level log is output, a desktop notification (using plyer.notification) will be displayed. The notification includes the log level and message. |
all_save | True : When an error or critical level log is output, the log will be saved to a file. |
save_levels | A list of log levels to save. Defaults to ["INFO", "ERROR", "WARNING", "DEBUG", "CRITICAL"]. |
silent | True : Suppress standard output (print) |
catch_exceptions | True : Automatically catch unhandled exceptions and log them as critical |
import'package:versalog_dart/versalog_dart.dart';
voidmain() {
// one tagfinal logger1 =VersaLog(
enumMode:"detailed",
tag:"APP",
showTag:true,
);
logger1.info("Application started");
// multiple tagsfinal logger2 =VersaLog(
enumMode:"detailed",
tag: ["API", "AUTH"],
showTag:true,
);
logger2.warning("Token expired");
}
import'package:versalog_dart/versalog_dart.dart';
voidmain() {
final log =VersaLog();
log.info("Application started");
log.warning("Low memory");
log.error("Unexpected error");
log.debug("Debug info");
log.critical("System failure");
}