oops 0.2.0

Lightweight error-handling. Provides `Option<T> -> std::io::Result<T>`.
Documentation
  • Coverage
  • 0%
    0 out of 4 items documented0 out of 3 items with examples
  • Size
  • Source code size: 5.27 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 1.1 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Links
  • blakehawkins/oops
    1 1 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • blakehawkins

Lightweight error-handling for transforming values into std::io::Result. Provides:

  • Option<T>::oops(self, &str) -> std::io::Result<T>
  • Result<T, E>::oops(self, &str) -> std::io::Result<T>
  • Option<T>::lazy_oops(self, FnOnce() -> String) -> std::io::Result<T>
  • Resukt<T, E>::lazy_oops(self, FnOnce() -> String) -> std::io::Result<T>

Examples

use std::io::Result;

fn third_element(slice: &[usize]) -> Result<&usize> {
    // Using oops to add context to a None
    slice.iter().nth(3).oops("No third element")
}

fn parse_batch(slice: &[&str]) -> Result<Vec<usize>> {
    slice
        .iter()
        .map(|v| {
            v
                .parse::<usize>()

                // Using lazy_oops to add debug messages
                .lazy_oops(|| format!("Failed to parse {} from {:?}", v, slice))
        })
        .collect()
}

assert_eq!(
    // No third element
    third_element(&[1, 2, 3]).err().unwrap().kind(),
    std::io::ErrorKind::Other
);

assert_eq!(
    // Failed to parse lo from ["2", "3", "7", "lo", "11"]
    parse_batch(&["2", "3", "7", "lo", "11"]).err().unwrap().kind(),
    std::io::ErrorKind::Other
);