devela 0.27.0

A development layer of coherence.
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

// devela::code::util::is
//
//! Defines inline if macro [`is!`].
//

#[doc = crate::_tags!(code)]
/// Conditional evaluation.
#[doc = crate::_doc_location!("code/util")]
///
/// Combines:
/// 1. `if`/`else` conditions
/// 2. `if let` pattern matching
///
/// # Examples
///
/// 1. Replacing `if`:
/// ```
/// # use devela::is;
/// is![true, print!("true")];
///
/// // This
/// let s = is![1 > 0, true, false];
///
/// // Would be equivalent to
/// let s = if 1 > 0 {
///     true
/// } else {
///     false
/// };
/// ```
///
/// 2. Replacing `if let`:
/// ```
/// # use devela::is;
/// let num = Some(123);
///
/// // This
/// is![let Some(n) = num , println!("num:{n}") , { dbg![num]; }];
///
/// // Would be equivalent to
/// if let Some(n) = num {
///     println!("num:{n}")
/// } else {
///     dbg![num];
/// }
/// ```
///
/// Nested:
/// ```
/// # use devela::is;
/// let mut s = String::new();
/// let is_premium = Some(true);
///
/// // This
/// is![let Some(b) = is_premium, is![b, s += " [premium]"]];
///
/// // Would be equivalent to
/// if let Some(b) = is_premium {
///     if b {
///         s += " [premium]"
///     }
/// }
/// ```
#[macro_export]
#[cfg_attr(cargo_primary_package, doc(hidden))]
macro_rules! is {
    ($cond:expr , $then:expr) => {
        #[allow(clippy::question_mark, reason = "to remain const-friendly")]
        if $cond {
            $then
        }
    };
    ($cond:expr , $then:expr , $($else:expr)?) => {
        // WAIT: [stmt_expr_attributes](https://github.com/rust-lang/rust/issues/15701)
        // #[allow(clippy::redundant_else)]
        if $cond {
            $then
        } else {
            $( $else )?
        }
    };

    (let $pat:pat = $cond:expr , $then:expr) => {
        #[allow(clippy::question_mark)]
        if let $pat = $cond {
            $then
        }
    };
    (let $pat:pat = $cond:expr , $then:expr , $($else:expr)? ) => {
        if let $pat = $cond {
            $then
        } else {
            $( $else )?
        }
    };
}
#[doc(inline)]
pub use is;

#[cfg(test)]
mod test_is {
    #[test]
    fn is_if() {
        assert_eq!('a', is!(true, 'a', 'b'));
        assert_eq!('b', is!(false, 'a', 'b'));
    }

    #[test]
    fn is_let() {
        let somea = Some('a');
        let noa: Option<char> = None;

        assert_eq!('a', is!(let Some(a) = somea, a , 'b'));
        assert_eq!('b', is!(let Some(a) = noa, a , 'b'));
    }
}