use-test-outcome 0.1.0

Stable test outcome vocabulary for RustUse testing primitives.
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

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

/// Stable vocabulary for completed test outcomes.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub enum TestOutcome {
    Passed,
    Failed,
    Skipped,
    Errored,
    ExpectedFailure,
    UnexpectedPass,
}

impl TestOutcome {
    pub const fn is_success(self) -> bool {
        matches!(self, Self::Passed | Self::ExpectedFailure)
    }

    pub const fn is_failure(self) -> bool {
        matches!(self, Self::Failed | Self::Errored | Self::UnexpectedPass)
    }

    pub const fn is_terminal(self) -> bool {
        match self {
            Self::Passed
            | Self::Failed
            | Self::Skipped
            | Self::Errored
            | Self::ExpectedFailure
            | Self::UnexpectedPass => true,
        }
    }
}

#[cfg(test)]
mod tests {
    use super::TestOutcome;

    #[test]
    fn classifies_success_outcomes() {
        assert!(TestOutcome::Passed.is_success());
        assert!(TestOutcome::ExpectedFailure.is_success());
        assert!(!TestOutcome::Skipped.is_success());
    }

    #[test]
    fn classifies_failure_outcomes() {
        assert!(TestOutcome::Failed.is_failure());
        assert!(TestOutcome::Errored.is_failure());
        assert!(TestOutcome::UnexpectedPass.is_failure());
        assert!(!TestOutcome::ExpectedFailure.is_failure());
    }

    #[test]
    fn all_outcomes_are_terminal() {
        let outcomes = [
            TestOutcome::Passed,
            TestOutcome::Failed,
            TestOutcome::Skipped,
            TestOutcome::Errored,
            TestOutcome::ExpectedFailure,
            TestOutcome::UnexpectedPass,
        ];

        assert!(outcomes.into_iter().all(TestOutcome::is_terminal));
    }
}