multi_try 0.3.0

Safely combine results
Documentation
  • Coverage
  • 100%
    4 out of 4 items documented2 out of 2 items with examples
  • Size
  • Source code size: 26.87 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 2.01 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 10s Average build duration of successful builds.
  • all releases: 10s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • JoshMcguigan/multi_try
    82 3 1
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • JoshMcguigan

multi_try

crates.io badge Docs.rs Build Status

This crate allows you to combine multiple Result types and return either a tuple containing all of their results, or a Vec of any errors which occurred. It is useful when you want to provide an error message for all errors rather than simply returning the first error.

Generics are used to support Result<T, E> for any types of T and E. The Ok types of the combined results are NOT required to be the same, but all of the Err types must be the same.

The Documentation

Example

use multi_try::MultiTry;

struct A {
    b: Result<i32, MyErr>,
    c: Result<i64, MyErr>,
    d: Result<f32, MyErr>,
}

struct ValidatedA {
    b: i32,
    c: i64,
    d: f32,
}

enum MyErr {
    FailedB,
    FailedC,
    FailedD,
}

fn validate(a: A) -> Result<ValidatedA, Vec<MyErr>> {
    let (b, c, d) = a.b.and_try(a.c).and_try(a.d)?;

    Ok(ValidatedA { b, c, d })
}

Check the tests directory for additional examples.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.