rustwatch 0.2.2

First-class logging and monitoring for Rust applications. Deep insights and structured logs, wherever you deploy.
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

use crate::Record;

/// Core trait that all log handlers must implement.
///
/// A `Handler` is responsible for writing a log record to a destination
/// such as a file, console, socket, or external service.
///
/// Each handler may optionally declare an `order` weight used for execution
/// within a logger. Lower values are executed first.
///
/// The `log` method determines whether a record is accepted by the handler.
/// If it returns `true`, the record is considered handled and propagation
/// may stop depending on the logger’s bubbling configuration.
pub trait Handler: Send + Sync {
    /// Processes the given log record.
    ///
    /// **Returns**
    /// - `true`  → record was handled/accepted by this handler
    /// - `false` → handler did not accept the record; next handler may try
    fn log(&mut self, record: &Record) -> bool;

    /// Returns the execution order of this handler.
    ///
    /// Lower values are executed first, allowing deterministic ordering
    /// of handlers within a logger pipeline.
    fn order(&self) -> usize {
        0
    }
}

// Internal modules for handler implementations
mod console;
mod file;

// Re-export all handler implementations
pub use console::*;
pub use file::*;