#macro #log #tracing

skip_error

Utility helping skip and log Result::Error in iterations

7 stable releases

3.1.1 Sep 21, 2021
3.0.0 Sep 6, 2021
2.0.0 Jul 19, 2021
1.1.0 May 12, 2021
1.0.0 Mar 23, 2020

#525 in Debugging

Download history 266/week @ 2023-11-20 248/week @ 2023-11-27 329/week @ 2023-12-04 214/week @ 2023-12-11 283/week @ 2023-12-18 154/week @ 2023-12-25 187/week @ 2024-01-01 275/week @ 2024-01-08 255/week @ 2024-01-15 265/week @ 2024-01-22 210/week @ 2024-01-29 200/week @ 2024-02-05 227/week @ 2024-02-12 229/week @ 2024-02-19 282/week @ 2024-02-26 313/week @ 2024-03-04

1,060 downloads per month
Used in 4 crates (3 directly)

MIT license

19KB
283 lines

GitHub Action Status Latest Version

skip_error

skip_error provides a single macro to help ignoring Error that would happen in a loop. See documentation to know more.

Rust version requirement

skip_error 3.0.0 requires Rustc version 1.54 or greater.


lib.rs:

This crate provides a single macro to help skipping a error in a loop, possibly logging it.

For example, imagine you have some code like this.

for string_number in &["1", "2", "three", "4"] {
  let number: u32 = match string_number.parse() {
    Ok(n) => n,
    Err(e) => continue,
  };
}

Then you can use the macro skip_error! to write like this.

for string_number in &["1", "2", "three", "4"] {
  let number: u32 = skip_error!(string_number.parse());
}

Or even better, use the trait SkipError that extends Iterator and do the following (essentially equivalent to [Iterator::flatten()] but see below for logging abilities).

use skip_error::SkipError;
let numbers: Vec<u32> = ["1", "2", "three", "4"]
  .into_iter()
  .map(|string_number| string_number.parse())
  .skip_error()
  .collect();

Features

  • log: emit log message with the standard std::log macro. Disabled by default.
  • tracing: emit traces with the tracing::trace macro. Disabled by default. If both log and tracing are enabled, then log will be ignored since tracing is configured in a compatibility mode with standard log.

Dependencies

~105KB