uRustLogger

uRustLogger is a lightweight, flexible, and fully-featured logging library for Rust, designed for both console and file output. It supports multiple log levels, colored console output, file logging with optional icons, per-module tagging, and a rich set of macros for all common data types. The library is ideal for applications that need structured logging with minimal setup.

Features

• Multiple log levels: Verbose, Debug, Info, Warning, Error, Fatal, Fixed

• Console output with colors: Each log level can be shown in a distinct color for easy readability.

• File logging: Logs can be written to a timestamped file. Optionally, each log level can include Unicode emoji icons instead of plain text.

• Module support: Each log message can include a module tag to indicate the source of the log. Use the macro log_module!("MODULE_NAME"); at the top of your Rust file to set the module name for all subsequent logs from that file.
  Note: Module names are limited to 8 characters to ensure proper alignment in log output.

• Configurable formatting:

  • Include/exclude timestamps
  • Enable/disable console colors
  • Use icons or plain text in log files
  • Include module tags in log output

• Rich macro-based API:

  • log_print! – log multiple values at once
  • Type-specific macros for all Rust primitive types:
    • Strings: log_str!
    • Integers: log_i8!, log_i16!, log_i32!, log_i64!
    • Unsigned: log_u8!, log_u16!, log_u32!, log_u64!
    • Floats: log_f32!, log_f64!
    • Booleans: log_bool!
    • Characters: log_char!
    • Hex: log_hex8!, log_hex16!, log_hex32!, log_hex64!
    • Pointers: log_ptr!

• Global thread-safe logger using Arc<Mutex<Logger>>

• Initialization macros: log_init! to configure the logger and log_deinit! to safely shut it down.

• Per-file module tagging: Use log_module!("MODULE_NAME"); to assign a module name for all log statements in a file. This module name will appear in both console and file output next to the log level, making it easier to trace the origin of messages.
  Note: Only the first 8 characters of the module name are used for alignment.

Quick Setup

use logger::*;#[allow(clippy::approx_constant)]fnmain(){log_module!("TEST");// Initialize the logger:// console threshold = Verbose// file threshold = Verbose// enable file logging = true// enable colors = true// include date = true// use icons in file = truelog_init!(LogLevel::Verbose,// console thresholdLogLevel::Verbose,// file thresholdtrue,// enable file loggingtrue,// enable colorstrue,// include datefalse// use icons in file);// --- Basic string, integer, bool ---log_print!(LogLevel::Fixed,
log_str!("Starting application"),
log_i32!(123),
log_bool!(true));// --- Pointer logging ---let value = 999;log_print!(LogLevel::Debug,
log_str!("Value address:"),
log_ptr!(&value));// --- Hex logging ---log_print!(LogLevel::Verbose,
log_hex8!(0xABu8),
log_hex16!(4444u16),
log_hex32!(0xDEADBEEFu32),
log_hex64!(0xCAFEBABEDEADC0DEu64));// --- Floating point ---log_print!(LogLevel::Info,
log_str!("Pi approximation:"),
log_f32!(3.1415),
log_str!("..and e approximation:"),
log_f64!(2.718281828));// --- All integer types ---let i8val = -9;log_print!(LogLevel::Debug,
log_i8!(i8val),
log_i16!(-16),
log_i32!(-32),
log_i64!(-64),
log_u8!(8),
log_u16!(16),
log_u32!(32),
log_u64!(64));// --- Char logging ---log_print!(LogLevel::Info,
log_str!("Char:"),
log_char!('X'),
log_char!('✔'));// --- Error example ---log_print!(LogLevel::Error,
log_str!("This is an error caused by the value"),
log_f64!(3.1415926535));log_print!(LogLevel::Fatal,
log_str!("and this is a fatal one.."),
log_f64!(3.1415926535));log_print!(LogLevel::Fixed, log_str!("Ending application..."));// --- Show file location ---{let logger = LOGGER.lock().unwrap();ifletSome(path) = &logger.log_file_path{println!("Log file written to: {}", path);}}// Shut down logginglog_deinit!();println!("Logger test complete.");}

Testing

Run cargo run --example basic_test

Screenshot console output

Screenshot file output (with icons)

Screenshot file output (plain text)