test_help-rs 0.2.0

Test helpers for Rust
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130

// assertions_as_str.rs : test_help-rs

// As-str assertion macros

/// Asserts that two values are equal when compared as strings ([`&str`]).
///
/// # Forms
///
/// * `assert_as_str_eq!(expected, actual)` — compares via
///   [`crate::base_traits::AsStr::as_str`];
/// * `assert_as_str_eq!(expected, actual, …)` — same, with a custom
///   panic message (as for [`assert_eq!`]);
///
/// Operands must provide an `#as_str()` method — either inherently or via
/// [`crate::base_traits::AsStr`].
///
/// # Examples
///
/// ```
/// use test_helpers::assert_as_str_eq;
///
/// assert_as_str_eq!("abc", String::from("abc"));
/// ```
///
/// # Panics
///
/// Panics when the string views are unequal (via [`assert_eq!`]).
#[macro_export]
macro_rules! assert_as_str_eq {
    ($expected:expr, $actual:expr) => {
        let expected_arg = &$expected;
        let actual_arg = &$actual;

        let expected = {
            use $crate::base_traits::AsStr as _;

            expected_arg.as_str()
        };
        let actual = {
            use $crate::base_traits::AsStr as _;

            actual_arg.as_str()
        };

        assert_eq!(expected, actual);
    };

    ($expected:expr, $actual:expr, $($arg:tt)+) => {
        let expected_arg = &$expected;
        let actual_arg = &$actual;

        let expected = {
            use $crate::base_traits::AsStr as _;

            expected_arg.as_str()
        };
        let actual = {
            use $crate::base_traits::AsStr as _;

            actual_arg.as_str()
        };

        assert_eq!(expected, actual, $($arg)+);
    };
}

/// Asserts that two values are not equal when compared as strings.
///
/// # Forms
///
/// * `assert_as_str_ne!(expected, actual)` — compares via
///   [`crate::base_traits::AsStr::as_str`];
/// * `assert_as_str_ne!(expected, actual, …)` — same, with a custom
///   panic message (as for [`assert_ne!`]);
///
/// Operands must provide an `#as_str()` method — either inherently or via
/// [`crate::base_traits::AsStr`].
///
/// # Examples
///
/// ```
/// use test_helpers::assert_as_str_ne;
///
/// assert_as_str_ne!("abc", String::from("ABC"));
/// ```
///
/// # Panics
///
/// Panics when the string views are equal (via [`assert_ne!`]).
#[macro_export]
macro_rules! assert_as_str_ne {
    ($expected:expr, $actual:expr) => {
        let expected_arg = &$expected;
        let actual_arg = &$actual;

        let expected = {
            use $crate::base_traits::AsStr as _;

            expected_arg.as_str()
        };
        let actual = {
            use $crate::base_traits::AsStr as _;

            actual_arg.as_str()
        };

        assert_ne!(expected, actual);
    };

    ($expected:expr, $actual:expr, $($arg:tt)+) => {
        let expected_arg = &$expected;
        let actual_arg = &$actual;

        let expected = {
            use $crate::base_traits::AsStr as _;

            expected_arg.as_str()
        };
        let actual = {
            use $crate::base_traits::AsStr as _;

            actual_arg.as_str()
        };

        assert_ne!(expected, actual, $($arg)+);
    };
}


// ///////////////////////////// end of file //////////////////////////// //