erratic 0.13.3

Handling errors in an efficient way.
Documentation 
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

//! Payload placeholder for [`Builder`][crate::Builder].
use core::fmt::{self, Display};

/// A zero-sized payload placeholder for [Error][crate::Error].
#[derive(Debug)]
pub struct Empty {
    _private: (),
}

impl Empty {
    /// Creates a new [`Empty`] instance.
    pub(crate) fn new() -> Self {
        Empty { _private: () }
    }
}

impl Display for Empty {
    fn fmt(&self, _f: &mut fmt::Formatter<'_>) -> fmt::Result {
        Ok(())
    }
}

/// A trait for types that can [produce a payload][crate::BuilderExt::with_payload_fn].
pub trait PayloadFn {
    type Output: Display + Send + Sync + 'static;

    fn call(self) -> Self::Output;
}

impl<T, R> PayloadFn for T
where
    T: FnOnce() -> R,
    R: Display + Send + Sync + 'static,
{
    type Output = R;

    fn call(self) -> Self::Output {
        self()
    }
}

/// A wrapper that can be used as [`PayloadFn`].
#[derive(Debug)]
pub struct Immediate<P>(pub P)
where
    P: Display + Send + Sync + 'static;

impl<P> PayloadFn for Immediate<P>
where
    P: Display + Send + Sync + 'static,
{
    type Output = P;

    fn call(self) -> Self::Output {
        self.0
    }
}