#event-logging #once #log-messages #macro #events #message #helper

log-once

Collection of helper macros for logging some events only once

8 releases

0.4.1 Jan 4, 2024
0.4.0 Sep 10, 2022
0.3.1 Oct 13, 2019
0.3.0 Dec 11, 2018
0.1.0 Nov 25, 2016

#138 in Rust patterns

Download history 15392/week @ 2024-07-31 17120/week @ 2024-08-07 15118/week @ 2024-08-14 13139/week @ 2024-08-21 11188/week @ 2024-08-28 11304/week @ 2024-09-04 9411/week @ 2024-09-11 8919/week @ 2024-09-18 8503/week @ 2024-09-25 10436/week @ 2024-10-02 11680/week @ 2024-10-09 13527/week @ 2024-10-16 12507/week @ 2024-10-23 13739/week @ 2024-10-30 14896/week @ 2024-11-06 11841/week @ 2024-11-13

55,161 downloads per month
Used in 83 crates (4 directly)

MIT/Apache

13KB
125 lines

log-once

Tests Documentation Crates.io version

Collection of helper macros for logging some events only once.

This crate provide macro in the log_once family (warn_once!, trace_once!, ...); that only send a logging event once for every message. It rely and uses the logging infrastructure in the log crate; and is fully compatible with any logger implementation.

These macro will store the already seen messages in a BTreeSet, and check if a message is in the set before sending the log event.

Usage

  1. Add it to your Cargo.toml file:
[dependencies]
log-once = "0.4"
  1. import the macros:
use log_once::{warn_once, log_once};
  1. Enjoy!

Examples

use log::info;
use log_once::{info_once, warn_once};

pub fn shave_the_yak(yaks: &[Yak]) {
    for yak in yaks {
        info!(target: "yak_events", "Commencing yak shaving for {yak:?}");

        loop {
            match find_a_razor() {
                Ok(razor) => {
                    // This will only appear once in the logger output for each razor
                    info_once!("Razor located: {razor}");
                    yak.shave(razor);
                    break;
                }
                Err(err) => {
                    // This will only appear once in the logger output for each error
                    warn_once!("Unable to locate a razor: {err}, retrying");
                }
            }
        }
    }
}

License

log-once is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT for details.

Dependencies

~87KB