suitecase 0.1.1

The structured test toolkit. A sync Rust crate for named cases, optional suite and per-case hooks, and macros so each case appears in cargo test—without a custom harness or DSL.
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

use crate::{Case, HookFns, RunConfig, fail, fail_now, run};

#[derive(Default)]
struct FailRecorder {
    log: Vec<&'static str>,
}

impl FailRecorder {
    fn push(&mut self, e: &'static str) {
        self.log.push(e);
    }
}

fn fr_setup(s: &mut FailRecorder) {
    s.push("setup_suite");
}
fn fr_teardown(s: &mut FailRecorder) {
    s.push("teardown_suite");
}

static FAIL_HOOKS: HookFns<FailRecorder> = HookFns {
    setup_suite: Some(fr_setup),
    teardown_suite: Some(fr_teardown),
    before_each: None,
    after_each: None,
};

#[test]
fn fail_marks_case_failed_and_continues() {
    let mut suite = FailRecorder::default();
    static CASES: &[Case<FailRecorder>] = cases![FailRecorder, s =>
        first => { s.push("first"); },
        second => { fail("expected failure"); },
        third => { s.push("third"); },
    ];
    run(&mut suite, CASES, RunConfig::all(), &FAIL_HOOKS);
    assert_eq!(
        suite.log,
        vec!["setup_suite", "first", "third", "teardown_suite"]
    );
}

#[test]
fn fail_now_aborts_remaining_cases() {
    let mut suite = FailRecorder::default();
    static CASES: &[Case<FailRecorder>] = cases![FailRecorder, s =>
        first => { s.push("first"); },
        second => { fail_now("abort here"); },
        third => { s.push("third"); },
    ];
    let err = std::panic::catch_unwind(std::panic::AssertUnwindSafe(|| {
        run(&mut suite, CASES, RunConfig::all(), &FAIL_HOOKS);
    }));
    assert!(err.is_err());
    assert_eq!(suite.log, vec!["setup_suite", "first", "teardown_suite"]);
}

#[test]
fn fail_now_runs_teardown() {
    let mut suite = FailRecorder::default();
    static CASES: &[Case<FailRecorder>] = cases![FailRecorder, s =>
        only => { fail_now("abort"); },
    ];
    let err = std::panic::catch_unwind(std::panic::AssertUnwindSafe(|| {
        run(&mut suite, CASES, RunConfig::all(), &FAIL_HOOKS);
    }));
    assert!(err.is_err());
    assert_eq!(suite.log, vec!["setup_suite", "teardown_suite"]);
}

#[test]
fn multiple_fail_only_first_records() {
    let mut suite = FailRecorder::default();
    static CASES: &[Case<FailRecorder>] = cases![FailRecorder, s =>
        a => { fail("first fail"); },
        b => { fail("second fail"); },
        c => { s.push("c"); },
    ];
    run(&mut suite, CASES, RunConfig::all(), &FAIL_HOOKS);
    assert_eq!(suite.log, vec!["setup_suite", "c", "teardown_suite"]);
}

#[test]
fn regular_panic_still_re_raises() {
    let mut suite = FailRecorder::default();
    static CASES: &[Case<FailRecorder>] = cases![FailRecorder, s =>
        first => { s.push("first"); },
        second => { panic!("regular panic"); },
        third => { s.push("third"); },
    ];
    let err = std::panic::catch_unwind(std::panic::AssertUnwindSafe(|| {
        run(&mut suite, CASES, RunConfig::all(), &FAIL_HOOKS);
    }));
    assert!(err.is_err());
    assert_eq!(
        suite.log,
        vec!["setup_suite", "first", "third", "teardown_suite"]
    );
}