Crate debug_log

Dead simple log utils for debug in Rust.

• 🦀 Enabled only in debug mode when DEBUG environment variable is set
• 🔊 Only perform log in files whose paths match DEBUG="filename". Match all by using DEBUG="", or DEBUG="*"
• 📦 Group output with debug_group
• 📤 WASM support. It will use the console API.

The output log is super easy to read on VS Code with sticky scroll enabled.

Example

use debug_log::{debug_dbg, debug_log, group};
group!("A Group");
{
    group!("Sub A Group");
    let arr: Vec<_> = (0..3).collect();
    debug_dbg!(&arr);
    {
        group!("Sub Sub A Group");
        debug_dbg!(&arr);
    }
    debug_log!("Hi");
    debug_dbg!(&arr);
}

{
    group!("B Group");
    debug_log!("END");
}

Run with DEBUG=* cargo run

Output

A Group {
    Sub A Group {
        [src/lib.rs:144] &arr = [
            0,
            1,
            2,
        ]
        Sub Sub A Group {
            [src/lib.rs:147] &arr = [
                0,
                1,
                2,
            ]
        }
        [src/lib.rs:150] Hi
        [src/lib.rs:151] &arr = [
            0,
            1,
            2,
        ]
    }
    B Group {
        [src/lib.rs:157] END
    }
}

Modules

console

Macros

debug_dbg

It can be filtered by DEBUG env and can only log on debug mode

debug_log

Use it like println!(). Except it can be filtered by DEBUG env and can only log on debug mode

group

Group the following logs until the guard is dropped

Functions

set_debug

Change the DEBUG value to filter tests