fallow-engine 3.2.0

Typed analysis engine facade for fallow consumers
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

//! Large-function collection for health reports.

/// Collect functions exceeding their effective unit-size ceiling when the unit
/// size risk profile warrants it.
///
/// The ceiling defaults to 60 LOC (`health.maxUnitSize`) and can be raised per
/// file via `health.thresholdOverrides[].maxUnitSize`, so functions in relaxed
/// files (e.g. test suites) drop out of the list. Only populated when
/// `very_high_risk >= 3%` in the unit size profile. Sorted by line count
/// descending.
pub(super) struct LargeFunctionInput<'a> {
    pub(super) vital_signs: &'a fallow_output::VitalSigns,
    pub(super) modules: &'a [crate::source::ModuleInfo],
    pub(super) file_paths:
        &'a rustc_hash::FxHashMap<crate::discover::FileId, &'a std::path::PathBuf>,
    pub(super) config_root: &'a std::path::Path,
    pub(super) ignore_set: &'a globset::GlobSet,
    pub(super) changed_files: Option<&'a rustc_hash::FxHashSet<std::path::PathBuf>>,
    pub(super) ws_roots: Option<&'a [std::path::PathBuf]>,
    pub(super) thresholds: &'a super::threshold_overrides::ThresholdOverrideResolver,
}

pub(super) fn collect_large_functions(
    input: &LargeFunctionInput<'_>,
) -> Vec<fallow_output::LargeFunctionEntry> {
    let dominated = input
        .vital_signs
        .unit_size_profile
        .as_ref()
        .is_some_and(|p| p.very_high_risk >= 3.0);
    if !dominated {
        return Vec::new();
    }

    let mut entries = Vec::new();
    for module in input.modules {
        let Some(&path) = input.file_paths.get(&module.file_id) else {
            continue;
        };
        let relative = path.strip_prefix(input.config_root).unwrap_or(path);
        if input.ignore_set.is_match(relative) {
            continue;
        }
        if let Some(changed) = input.changed_files
            && !changed.contains(path.as_path())
        {
            continue;
        }
        if let Some(ws) = input.ws_roots
            && !ws.iter().any(|r| path.starts_with(r))
        {
            continue;
        }
        for func in &module.complexity {
            let max_unit_size = input
                .thresholds
                .effective_max_unit_size(relative, func.name.as_str());
            if func.line_count > max_unit_size {
                entries.push(fallow_output::LargeFunctionEntry {
                    path: path.clone(),
                    name: func.name.clone(),
                    line: func.line,
                    line_count: func.line_count,
                });
            }
        }
    }
    entries.sort_by_key(|e| std::cmp::Reverse(e.line_count));
    entries
}