ripr 0.5.0

Find Rust test-oracle gaps before mutation testing with static RIPR evidence
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

use std::path::Path;

pub fn is_production_rust_path(path: &Path) -> bool {
    if path.extension().and_then(|e| e.to_str()) != Some("rs") {
        return false;
    }

    let normalized = normalize_path(path);
    let components = normalized.split('/').collect::<Vec<_>>();

    if !components.iter().any(|c| c == &"src") {
        return false;
    }

    let exclude_components = [
        "tests",
        "examples",
        "benches",
        "target",
        "fixtures",
        "editors",
        "node_modules",
        "xtask",
    ];
    if components.iter().any(|c| exclude_components.contains(c)) {
        return false;
    }

    let file_stem = path.file_stem().and_then(|s| s.to_str()).unwrap_or("");
    if file_stem == "tests" {
        return false;
    }

    true
}

pub fn package_root(path: &Path) -> Option<String> {
    let normalized = normalize_path(path);
    if normalized.starts_with("src/")
        || normalized.starts_with("tests/")
        || normalized.starts_with("examples/")
        || normalized.starts_with("benches/")
    {
        return Some(String::new());
    }
    if let Some(rest) = normalized.strip_prefix("crates/")
        && let Some((crate_name, crate_relative)) = rest.split_once('/')
        && (crate_relative.starts_with("src/") || crate_relative.starts_with("tests/"))
    {
        return Some(format!("crates/{crate_name}/"));
    }
    for marker in ["/src/", "/tests/", "/examples/", "/benches/"] {
        if let Some(idx) = normalized.rfind(marker) {
            let prefix = &normalized[..idx];
            if !prefix.is_empty() {
                return Some(format!("{prefix}/"));
            }
        }
    }
    None
}

pub fn normalize_path(path: &Path) -> String {
    path.to_string_lossy()
        .replace('\\', "/")
        .trim_start_matches("./")
        .to_string()
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::path::PathBuf;

    #[test]
    fn classify_functions_are_callable() {
        let path = PathBuf::from("src/lib.rs");
        assert!(is_production_rust_path(&path));
        assert_eq!(package_root(&path), Some(String::new()));
        let normalized = normalize_path(&path);
        assert_eq!(normalized, "src/lib.rs");
    }

    #[test]
    fn production_path_excludes_repository_automation_fixture_and_non_production_trees() {
        for excluded in [
            "xtask/src/main.rs",
            "fixtures/boundary_gap/input/src/lib.rs",
            "editors/vscode/src/extension.rs",
            "target/debug/build/example/src/lib.rs",
            "node_modules/ripr/src/lib.rs",
            "tests/pricing.rs",
            "examples/demo/src/lib.rs",
            "benches/exposure.rs",
            "src/tests.rs",
            "README.md",
        ] {
            assert!(
                !is_production_rust_path(&PathBuf::from(excluded)),
                "expected repo-mode production filter to exclude {excluded}"
            );
        }

        for included in [
            "src/lib.rs",
            "crates/ripr/src/lib.rs",
            "tools/audit/src/main.rs",
        ] {
            assert!(
                is_production_rust_path(&PathBuf::from(included)),
                "expected repo-mode production filter to include {included}"
            );
        }
    }
}