conditional-assignment 0.2.0

This is a very simple, small crate to help make conditional assignments more ergonomic.
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
58
59
60
61
62
63
64
65
66
67
68
69

#![doc = include_str!("../README.md")]

pub trait Pick<O>: private::Sealed {
    fn pick(self, when_true: O, when_false: O) -> O;
    fn pick_lazy<P, N>(self, when_true: P, when_false: N) -> O
    where
        P: FnOnce() -> O,
        N: FnOnce() -> O;
}

// Prevent this trait from being implemented outside of this crate.
// https://rust-lang.github.io/api-guidelines/future-proofing.html#c-sealed
mod private {
    pub trait Sealed {}
    impl Sealed for bool {}
}

impl<O> Pick<O> for bool {
    ///
    ///
    /// Example:
    /// ```
    /// use conditional_assignment::Pick;
    /// let condition = 0 < 1;
    /// let outcome = if condition {
    ///    "true"
    /// } else {
    ///    "false"
    /// };
    /// ```
    #[inline]
    fn pick(self: bool, when_true: O, when_false: O) -> O {
        if self {
            when_true
        } else {
            when_false
        }
    }

    ///
    ///
    /// Example:
    /// ```
    /// use conditional_assignment::Pick;
    /// let condition = 0 < 1;
    /// let outcome = condition.pick_lazy(
    ///     || {
    ///         assert!(condition);
    ///         "true"
    ///     },
    ///     || {
    ///         assert!(!condition);
    ///         "false"
    ///     },
    /// );
    /// ```
    #[inline]
    fn pick_lazy<P, N>(self: bool, when_true: P, when_false: N) -> O
    where
        P: FnOnce() -> O,
        N: FnOnce() -> O,
    {
        if self {
            when_true()
        } else {
            when_false()
        }
    }
}