erratic 0.6.0

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

//! Payload placeholder for [`Builder`][crate::Builder].
use std::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;

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

impl<T, R> PayloadFn for T
where
    T: FnOnce() -> R,
{
    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);

impl<P> PayloadFn for Immediate<P> {
    type Output = P;

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