testing-conventions 0.0.100

Enforce testing conventions in libraries (Python, TypeScript, and 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

mod common;

use std::path::PathBuf;

use common::expect_tested;
use testing_conventions::mutation::measure_rust;

fn crate_dir(name: &str) -> PathBuf {
    PathBuf::from(env!("CARGO_MANIFEST_DIR"))
        .join("tests/fixtures/unit_mutation/rust")
        .join(name)
}

#[test]
fn killed_reports_no_survivors_and_counts_the_tested_mutants() {
    let (count, survivors) = expect_tested(
        measure_rust(
            &crate_dir("killed"),
            &[],
            &std::collections::BTreeMap::new(),
            None,
            &[],
        )
        .expect("cargo-mutants runs"),
    );
    assert!(
        survivors.is_empty(),
        "every mutant should be caught; got {survivors:?}"
    );
    assert!(count > 0, "the engine judged the crate's mutants");
}

#[test]
fn survivors_are_reported() {
    let (count, survivors) = expect_tested(
        measure_rust(
            &crate_dir("survivors"),
            &[],
            &std::collections::BTreeMap::new(),
            None,
            &[],
        )
        .expect("cargo-mutants runs"),
    );
    assert!(
        !survivors.is_empty(),
        "the assertion-light suite should leave survivors"
    );
    assert!(
        survivors.iter().all(|m| m.file == "src/lib.rs"),
        "every survivor is in src/lib.rs; got {survivors:?}"
    );
    assert!(
        count >= survivors.len(),
        "every survivor was judged, so the count covers them"
    );
}

#[test]
fn a_mutation_exemption_drops_the_survivors() {
    let exempt = vec!["src/lib.rs".to_string()];
    let (_, survivors) = expect_tested(
        measure_rust(
            &crate_dir("survivors"),
            &exempt,
            &std::collections::BTreeMap::new(),
            None,
            &[],
        )
        .expect("cargo-mutants runs"),
    );
    assert!(
        survivors.is_empty(),
        "the exemption should drop every survivor; got {survivors:?}"
    );
}