fastlogging-rs

fastlogging-rs is a high-performance and flexible logging framework designed for multiple programming languages. This robust library enables developers to implement efficient logging in the following languages, all featuring similar APIs:

• Rust (the primary implementation)
• Python (>=3.10 using pyo3)
• C (Foreign Function Interface)
• C++ (using FFI and CXX)
• Go
• Java FFM
• Java JNI
• C#

Key Features

• Exceptional Speed: Logging calls are non-blocking, allowing writers to operate in background threads without disrupting application performance.
• Thread-Safe Logging: Ensures that multiple threads can log simultaneously without issues.
• Multiple Output Sinks: Supports various logging sinks such as console, file, network streams, syslog, and callback functions.
• File Management: Offers optional file rotation and compression to manage log files efficiently.
• Secure Logging: Enables optional AES encryption for secure network logging.
• Flexible Configuration: Configuration can be done through API calls or configuration files in JSON, XML, or YAML formats.
• Inter-Process Logging: Automatically forwards log messages from subprocesses to the main process, even at varying nesting levels, which can be toggled on or off.

Available Writers

The framework supports multiple writers, including:

• Console Writer (with optional color coding)
• File Writer (with rotation and compression options)
• TCP Client (with optional authentication and AES encryption)
• Syslog for Linux and EventLog for Windows
• Callback Writer

All writers function in background threads, ensuring that logging operations do not hinder application performance as long as the queue remains manageable.

Configuration Options

Users can choose to configure logging via API or by utilizing a configuration file named fastlogging.<EXT> where <EXT> can be json, xml, or yaml. Sample configuration files can be found in the docs/configs directory.

Performance Benchmarks

fastlogging-rs stands out in terms of speed, as demonstrated by the following benchmarks:

Write Performance

File Rotation Performance

More detailed benchmarks, including charts and tables, can be found in doc/benchmarks within each sub-package or explore the complete benchmark overview here.

Usage Examples

Rust Usage

use fastlogging::{logging_new_default, LoggingError};

fn main() -> Result<(), LoggingError> {
    let mut log = logging_new_default()?;
    log.info("Hello, fastlogging!")?;
    log.shutdown(false)?;
    Ok(())
}

Python Usage

from fastlogging import Logging

log = Logging()
log.info("Hello, fastlogging!")
log.shutdown(False)

Documentation

Comprehensive documentation is available for each language binding, ensuring developers can easily implement and utilize the logging framework:

• Rust: fastlogging/README.md
• Python: pyfastlogging/README.md
• C: cfastlogging/README.md
• C++: cppfastlogging/README.md
• Go: gofastlogging/README.md
• Java FFM: jfastlogging-ffm/README.md
• Java JNI: jfastlogging-jni/README.md
• C#: [csharpfastlogging/README.md](csharpfastlogging/README.