rlg 0.0.9

A near-lock-free structured logging library for Rust. Sub-microsecond ingestion via a 65k-slot ring buffer (LMAX Disruptor pattern), deferred formatting, and native OS sinks (`os_log` on macOS via `syslog(3)`, `journald` on Linux). 14 output formats including JSON, MCP, OTLP, ECS, GELF, CEF, and Logfmt.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

// Copyright ยฉ 2024-2026 RustLogs (RLG). All rights reserved.
// SPDX-License-Identifier: Apache-2.0
// SPDX-License-Identifier: MIT
// See LICENSE-APACHE.md and LICENSE-MIT.md in the repository root for full license information.

//! # RustLogs (RLG) Macros Examples
//!
//! This example demonstrates the usage of the fluent API and modern macros
//! in the RustLogs (RLG) library.

use rlg::log::Log;
use rlg::log_format::LogFormat;

/// Entry point for the RustLogs macros examples.
///
/// This function demonstrates the fluent API and modern macros for logging.
pub(crate) fn main() {
    println!("๐Ÿฆ€ RustLogs Macros Examples ๐Ÿฆ€\n");

    fluent_api_example();
    conditional_log_example();
    rlg_span_example();
    rlg_time_it_example();
    rlg_mcp_notify_example();
    unicode_log_example();

    println!("\n๐ŸŽ‰ All examples completed successfully!");
}

/// Demonstrates the fluent builder API.
fn fluent_api_example() {
    println!("๐Ÿฆ€  **Fluent API Example**");
    println!("---------------------------------------------");

    Log::info("This is an info message")
        .component("component")
        .time("2022-01-01T12:00:00Z")
        .format(LogFormat::JSON)
        .fire();

    Log::warn("This is a warning").component("component").fire();

    Log::error("This is an error").component("component").fire();

    Log::trace("This is a trace").component("component").fire();

    Log::fatal("This is fatal").component("component").fire();
}

/// Demonstrates conditional logging.
fn conditional_log_example() {
    println!("\n๐Ÿฆ€  **Conditional Log Example**");
    println!("---------------------------------------------");

    let should_log = true;
    if should_log {
        Log::info("Conditional log fired")
            .component("component")
            .fire();
    }
    println!("(Log with true condition should have fired)");

    let should_not_log = false;
    if should_not_log {
        Log::warn("This should not appear")
            .component("component")
            .fire();
    }
    println!("(Log with false condition should not have fired)");
}

/// Demonstrates the rlg_span! macro.
fn rlg_span_example() {
    println!("\n๐Ÿฆ€  **rlg_span! Example**");
    println!("---------------------------------------------");

    let result = rlg::rlg_span!("Compute Task", {
        let x = 10;
        let y = 20;
        x + y
    });
    println!("    Span result: {}", result);
}

/// Demonstrates the rlg_time_it! macro.
fn rlg_time_it_example() {
    println!("\n๐Ÿฆ€  **rlg_time_it! Example**");
    println!("---------------------------------------------");

    let result = rlg::rlg_time_it!("Database Query", {
        let x = 100;
        x * 2
    });
    println!("    Timed result: {}", result);
}

/// Demonstrates the rlg_mcp_notify! macro.
fn rlg_mcp_notify_example() {
    println!("\n๐Ÿฆ€  **rlg_mcp_notify! Example**");
    println!("---------------------------------------------");

    rlg::rlg_mcp_notify!("user_status", "logged_in");
    println!("    MCP notification sent");
}

/// Demonstrates logging messages with Unicode characters.
fn unicode_log_example() {
    println!("\n๐Ÿฆ€  **Unicode Log Example**");
    println!("---------------------------------------------");

    Log::info("ใ“ใ‚“ใซใกใฏ RustLogs! ๐Ÿฆ€")
        .component("component")
        .time("2022-01-01T12:00:00Z")
        .fire();
}