1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91
//! A small toolbelt of macros that implement the [`Option::ok_or_else`] and
//! [`Result::map_err`] with macros instead of functions taking callbacks.
//!
//! This reduces the boilerplate when you can't use the abovementioned functions
//! because the error condition handling logic you need requires you that
//! you move certain values into the closures which you can't affort.
//!
//! People would normally work around it by `.clone()`-ing the value
//! to be passed into the closure, but that's bad because:
//!
//! - you need to `.clone()` the item, and that's not always possible;
//! - the `.clone()` is not really necessary, you can rewrite the code with
//! a manual `match` that would not require and ownership transfers.
//!
//! But writing a match is vebose, and who wants that?!
//! This is where this crate comes to help.
//!
//! For best look and feel, combine with
//! [`postfix-macros`](https://docs.rs/postfix-macros) crate.
/// An analog to [`Result::map_err`] but without a closure.
///
/// ```
/// use macro_map::map_err;
///
/// let myresult: Result<&str, &str> = Err("hello");
///
/// let mapped = map_err!(myresult, |myerr| 123);
///
/// assert_eq!(mapped, Err(123));
/// ```
///
/// Or with [`postfix-macros`](https://docs.rs/postfix-macros):
///
/// ```
/// use macro_map::map_err;
/// use postfix_macros::postfix_macros;
///
/// let myresult: Result<&str, &str> = Err("hello");
///
/// postfix_macros! {
/// let mapped = myresult.map_err!(|myerr| 123);
/// }
///
/// assert_eq!(mapped, Err(123));
/// ```
#[macro_export]
macro_rules! map_err {
($result:expr, |$err:pat_param| $closure:expr) => {
match $result {
Ok(val) => Ok(val),
Err($err) => Err($closure),
}
};
}
/// An analog to [`Option::ok_or_else`] but without a closure.
///
/// ```
/// use macro_map::ok_or_else;
///
/// let myoption: Option<&str> = None;
///
/// let mapped = ok_or_else!(myoption, || 123);
///
/// assert_eq!(mapped, Err(123));
/// ```
///
/// Or with [`postfix-macros`](https://docs.rs/postfix-macros):
///
/// ```
/// use macro_map::ok_or_else;
/// use postfix_macros::postfix_macros;
///
/// let myoption: Option<&str> = None;
///
/// postfix_macros! {
/// let mapped = ok_or_else!(myoption, || 123);
/// }
///
/// assert_eq!(mapped, Err(123));
/// ```
#[macro_export]
macro_rules! ok_or_else {
($result:expr, || $closure:expr) => {
match $result {
Some(val) => Ok(val),
None => Err($closure),
}
};
}