Crate rslog 

rslog

A lightweight logging library for Rust built entirely using the standard library with zero external dependencies.

Features

• Zero Dependencies: Pure standard library implementation
• Multiple Log Levels: Trace, Debug, Info, Warn, Error, Critical
• Multiple Output Targets: Console and file output simultaneously
• Async Writing: Background thread for non-blocking file writes
• Log Rotation: Size-based and time-based rotation support with optional gzip compression
• Log Filtering: Per-module log level overrides (with set_module_level)
• Formatting Macros: trace!, debug!, info!, warn!, error!, critical! with format!-style syntax
• Multiple Output Formats: Text, JSON, and custom patterns
• Configurable: Flexible configuration options via ConfigBuilder

Quick Start

use rslog::{Logger, LogLevel};
 
// Get the logger instance
let logger = Logger::get_instance();
 
// Log messages
logger.info("Application started");
logger.debug("Debug message");
logger.warn("Warning message");
logger.error("Error message");
logger.critical("Critical error");

Custom Configuration

use rslog::{Logger, LogLevel, ConfigBuilder, OutputFormat};
 
let config = ConfigBuilder::new()
    .log_dir("logs")
    .file_prefix("app_")
    .level(LogLevel::Info)
    .output_format(OutputFormat::Json)
    .build();
 
Logger::init_with_config(config);
let logger = Logger::get_instance();
logger.info("Hello, world!");

Per-Module Log Filtering

use rslog::{Logger, ConfigBuilder, LogLevel, LogFilter};

let mut filter = LogFilter::new();
filter.set_module_level("network", LogLevel::Error);
filter.set_module_level("database", LogLevel::Trace);

let config = ConfigBuilder::new()
    .level(LogLevel::Warn)
    .filter(filter)
    .build();

Logger::init_with_config(config);
let logger = Logger::get_instance();

// Or set module levels at runtime:
// logger.set_module_level("http", LogLevel::Debug);

Log Rotation & Compression

use rslog::{Logger, ConfigBuilder, RotationStrategy, RotatorConfig};

let config = ConfigBuilder::new()
    .rotation(RotatorConfig {
        strategy: RotationStrategy::SizeBased(10 * 1024 * 1024), // 10MB
        max_files: 5,
        compress_old_files: true, // gzip-compress rotated files
    })
    .build();

Logger::init_with_config(config);

Re-exports

pub use level::LogLevel;

pub use logger::Logger;

pub use config::Config;

pub use config::ConfigBuilder;

pub use formatter::OutputFormat;

pub use rotator::RotationStrategy;

pub use rotator::RotatorConfig;

pub use writer::LogEntry;

pub use color::Color;

pub use color::LogColorScheme;

pub use color::ColorFormatter;

pub use filter::LogFilter;

Modules

color

Color module

config

Configuration module

filter

Log filter module

formatter

Formatter module

level

Log level definition module

logger

Logger module

macros

Logging macros

rotator

Rotator module

writer

Writer module

Macros

critical

Log a critical message with format string and automatic target (module path).

debug

Log a debug message with format string and automatic target (module path).

error

Log an error message with format string and automatic target (module path).

info

Log an info message with format string and automatic target (module path).

trace

Log a trace message with format string and automatic target (module path).

warn

Log a warning message with format string and automatic target (module path).