kimun 0.20.0

Code metrics tool — health score, complexity, duplication, hotspots, ownership
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
116
117
118
119
120
121
122
123
124
125

/// Per-file metric collection for the score module.
///
/// Reads and classifies each source file, computes per-file metrics
/// conditionally based on the scoring model (cognitive or legacy),
/// normalizes content for duplication detection, and bundles results
/// for project-level scoring.
use std::path::Path;

use crate::cogcom;
use crate::cycom;
use crate::dups;
use crate::hal;
use crate::indent;
use crate::loc::counter::LineKind;
use crate::miv;
use crate::util::{find_test_block_start, read_and_classify};

use super::ScoringModel;

/// Per-file raw metrics collected during the walk.
pub struct FileMetrics {
    pub path: std::path::PathBuf,
    pub code_lines: usize,
    // Cognitive model (v0.14+)
    pub max_cognitive: Option<usize>,
    // Legacy model (v0.13: MI + Cyclomatic)
    pub mi_score: Option<f64>,
    pub max_complexity: Option<usize>,
    // Shared dimensions
    pub indent_stddev: Option<f64>,
    pub halstead_effort: Option<f64>,
}

/// Result of analyzing a single file for scoring: raw metrics,
/// normalized content for duplication detection, and line count.
pub struct SingleFileResult {
    pub metrics: FileMetrics,
    pub dup_file: dups::detector::NormalizedFile,
    pub normalized_count: usize,
}

/// Analyze a single source file: read, classify, compute metrics, normalize for dups.
/// Returns `None` for binary files, non-code files, or on I/O errors.
pub fn analyze_single_file(
    file_path: &Path,
    spec: &crate::loc::language::LanguageSpec,
    exclude_tests: bool,
    model: &ScoringModel,
) -> Option<SingleFileResult> {
    let (lines, kinds) = match read_and_classify(file_path, spec) {
        Ok(Some(v)) => v,
        Ok(None) => return None,
        Err(e) => {
            eprintln!("warning: {}: {e}", file_path.display());
            return None;
        }
    };

    let code_lines = kinds.iter().filter(|k| **k == LineKind::Code).count();
    let comment_lines = kinds.iter().filter(|k| **k == LineKind::Comment).count();

    let indent_stddev = indent::analyzer::analyze(&lines, &kinds, 4).map(|m| m.stddev);

    let hal_metrics = hal::analyze_content(&lines, &kinds, spec);
    let halstead_effort = hal_metrics.as_ref().map(|h| h.effort);

    let (max_cognitive, mi_score, max_complexity) = match model {
        ScoringModel::Cognitive => {
            let cogcom_result = cogcom::analyze_content(&lines, &kinds, spec);
            let max_cog = cogcom_result.as_ref().map(|c| c.max_complexity);
            (max_cog, None, None)
        }
        ScoringModel::Legacy => {
            let cycom_result = cycom::analyze_content(&lines, &kinds, spec);
            let max_cycom = cycom_result.as_ref().map(|c| c.max_complexity);

            let mi = hal_metrics.as_ref().and_then(|h| {
                let complexity = cycom_result
                    .as_ref()
                    .map(|c| c.total_complexity)
                    .unwrap_or(1);
                miv::analyzer::compute_mi(h.volume, complexity, code_lines, comment_lines)
                    .map(|m| m.mi_score)
            });

            (None, mi, max_cycom)
        }
    };

    // Skip non-code files: must have at least one model-specific metric.
    // Files without the primary complexity dimension (e.g. Markdown, TOML)
    // are excluded even if they have Halstead data.
    let has_model_metric = match model {
        ScoringModel::Cognitive => max_cognitive.is_some(),
        ScoringModel::Legacy => mi_score.is_some() || max_complexity.is_some(),
    };
    if !has_model_metric {
        return None;
    }

    let dup_end = if exclude_tests {
        find_test_block_start(&lines)
    } else {
        lines.len()
    };
    let normalized = dups::normalize_content(&lines[..dup_end], &kinds[..dup_end]);
    let normalized_count = normalized.len();

    Some(SingleFileResult {
        metrics: FileMetrics {
            path: file_path.to_path_buf(),
            code_lines,
            max_cognitive,
            mi_score,
            max_complexity,
            indent_stddev,
            halstead_effort,
        },
        dup_file: dups::detector::NormalizedFile {
            path: file_path.to_path_buf(),
            lines: normalized,
        },
        normalized_count,
    })
}