legible 0.4.2

A Rust port of Mozilla's Readability.js for extracting readable content from web pages
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

/// Lazy debug logging macro that only evaluates format arguments when debug is enabled.
///
/// This avoids allocating strings for log messages when debugging is disabled.
///
/// # Usage
///
/// With `self` that has `self.options.debug`:
/// ```ignore
/// debug_log!(self, "Message: {}", value);
/// ```
///
/// With a direct boolean expression (use `@bool` prefix):
/// ```ignore
/// debug_log!(@bool debug_flag, "Message: {}", value);
/// ```
macro_rules! debug_log {
    // Form 1: Use with a direct boolean expression (must use @bool prefix)
    (@bool $debug:expr, $($arg:tt)*) => {
        if $debug {
            eprintln!("Reader: (Readability) {}", format_args!($($arg)*));
        }
    };
    // Form 2: Use with `self` that has `self.options.debug`
    ($self:ident, $($arg:tt)*) => {
        if $self.options.debug {
            eprintln!("Reader: (Readability) {}", format_args!($($arg)*));
        }
    };
}

pub(crate) use debug_log;