Crates.io Documentation License: MIT Build Status Rust GitHub stars GitHub issues GitHub pull requests GitHub last commit

High-performance, production-ready structured logging library for Rust

📚 Documentation | API Reference | Quick Start

Overview

🚀 Core Features

⚡ Performance & Scalability

📝 Output Management

🔧 Filtering & Formatting

🎯 Advanced Features

Installation

[dependencies]
logly = "0.0.4"
# With GPU support (experimental)
logly = { version = "0.0.4", features = ["gpu"] }

Quick Start

use logly::prelude::*;
fn main() -> Result<(), Box<dyn std::error::Error>> {
 let logger = Logger::new();
 logger.add_sink(SinkConfig::default())?;
 
 logger.info("Application started".to_string())?;
 logger.success("Operation completed!".to_string())?;
 logger.warning("Warning message".to_string())?;
 logger.error("Error occurred".to_string())?;
 
 Ok(())
}

Performance Benchmarks

Performance Characteristics

Platform Support

Advanced Usage

File Logging with Rotation

use logly::prelude::*;
use std::path::PathBuf;
let logger = Logger::new();
let config = SinkConfig {
 path: Some(PathBuf::from("logs/app.log")),
 rotation: Some("daily".to_string()),
 size_limit: Some(10 * 1024 * 1024), // 10MB
 retention: Some(7), // Keep 7 files
 async_write: true,
 ..Default::default()
};
logger.add_sink(config)?;

Custom Log Levels

// Add custom level with priority between WARNING (30) and ERROR (40)
logger.add_custom_level("NOTICE".to_string(), 35, "96".to_string())?;
// Use custom level
logger.log_custom("NOTICE", "Custom level message".to_string())?;

Callbacks

// Log callback for monitoring
logger.add_log_callback(|record| {
 if record.level >= Level::Error {
 println!("High severity: {}", record.message);
 }
 Ok(())
});
// Custom color callback
logger.add_color_callback(|level, message| {
 format!("\x1b[1m[{}]\x1b[0m {}", level.as_str(), message)
});
// Exception callback
logger.add_exception_callback(|error, backtrace| {
 eprintln!("Exception: {}\n{}", error, backtrace);
});

Context Binding

// Bind persistent context
logger.bind("user_id".to_string(), serde_json::json!("12345"));
logger.bind("session".to_string(), serde_json::json!("abc-def"));
logger.info("User action logged".to_string())?;
// Remove binding
logger.unbind("user_id");
// Clear all bindings
logger.clear_bindings();

GPU Acceleration

let mut config = LoggerConfig::default();
config.enable_gpu = true;
config.gpu_buffer_size = 2 * 1024 * 1024; // 2MB
logger.configure(config);
logger.enable_gpu()?;
println!("{}", logger.gpu_info());

Configuration

Basic Configuration

let mut config = LoggerConfig::default();
config.level = Level::Debug;
config.color = true;
config.json = false;
logger.configure(config);

Configuration File

[logly.configuration]
level = "DEBUG"
auto_sink = true
[logly.display]
color = true
global_console_display = true
global_file_storage = true
[logly.features]
enable_callbacks = true
enable_exception_handling = true
enable_version_check = true

Documentation

Getting Started

Feature Guides

Project Information

Examples

# Basic usage
cargo run --example basic
# Advanced features
cargo run --example advanced
# Complete configuration
cargo run --example configuration
# GPU logging (requires CUDA)
cargo run --example gpu_logging --features gpu
# Callbacks and custom colors
cargo run --example callbacks
# File rotation
cargo run --example rotation
# Custom log levels
cargo run --example custom_levels

Testing

# Run all tests
cargo test
# Run with output
cargo test -- --nocapture
# Run specific test
cargo test test_level_priority
# Run benchmarks
cargo bench

Error Reporting

Contributing

License

Repository

Version

if let Ok(Some(msg)) = logger.check_version() {
 println!("{}", msg);
}

Author

Star History Chart

⭐ Star the repository if you find logly-rs useful!