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

/// Code age classifier.
///
/// Classifies files by how long ago they were last modified in git:
/// - Active:  < `active_days` days ago (default 90)
/// - Stale:   between `active_days` and `frozen_days` (default 365)
/// - Frozen:  > `frozen_days` days ago
use std::path::PathBuf;

/// Age classification for a source file.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum AgeStatus {
    /// Modified within `active_days` days.
    Active,
    /// Not modified for `active_days`–`frozen_days` days.
    Stale,
    /// Not modified for more than `frozen_days` days.
    Frozen,
}

impl AgeStatus {
    pub fn label(self) -> &'static str {
        match self {
            AgeStatus::Active => "ACTIVE",
            AgeStatus::Stale => "STALE",
            AgeStatus::Frozen => "FROZEN",
        }
    }
}

/// Age analysis result for a single file.
pub struct FileAge {
    /// Repository-relative file path.
    pub path: PathBuf,
    pub language: String,
    /// Unix timestamp of the last commit touching this file.
    pub last_modified: i64,
    /// Number of days since the last commit.
    pub age_days: u64,
    pub status: AgeStatus,
}

/// Thresholds for age classification (in days).
pub struct AgeThresholds {
    /// Files modified within this many days are Active.
    pub active_days: u64,
    /// Files not modified for more than this many days are Frozen.
    pub frozen_days: u64,
}

impl Default for AgeThresholds {
    fn default() -> Self {
        Self {
            active_days: 90,
            frozen_days: 365,
        }
    }
}

/// Classify a file by its last modification timestamp relative to `now`.
pub fn classify(
    path: PathBuf,
    language: &str,
    last_modified: i64,
    now: i64,
    thresholds: &AgeThresholds,
) -> FileAge {
    let age_days = ((now - last_modified).max(0) as u64) / 86_400;
    let status = if age_days < thresholds.active_days {
        AgeStatus::Active
    } else if age_days < thresholds.frozen_days {
        AgeStatus::Stale
    } else {
        AgeStatus::Frozen
    };
    FileAge {
        path,
        language: language.to_string(),
        last_modified,
        age_days,
        status,
    }
}

#[cfg(test)]
#[path = "analyzer_test.rs"]
mod tests;