gitstack 5.3.0

Git history viewer with insights - Author stats, file heatmap, code ownership
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

//! Related file analysis
//!
//! Analyze files that are frequently changed together from commit history

use std::collections::HashMap;

/// Related file information
#[derive(Debug, Clone)]
pub struct RelatedFiles {
    /// Target file
    pub target_file: String,
    /// List of related files (file path, co-change count)
    pub related: Vec<(String, usize)>,
}

/// Analyze related files
///
/// target_file: Target file path
/// commit_files: Iterator that returns the list of changed files for each commit
pub fn analyze_related_files<I>(target_file: &str, commit_files: I) -> RelatedFiles
where
    I: Iterator<Item = Vec<String>>,
{
    let mut co_change_counts: HashMap<String, usize> = HashMap::new();

    for files in commit_files {
        // Check if this commit contains the target file
        if files.iter().any(|f| f == target_file) {
            // Count other files in the same commit
            for file in files {
                if file != target_file {
                    *co_change_counts.entry(file).or_insert(0) += 1;
                }
            }
        }
    }

    // Sort by count
    let mut related: Vec<(String, usize)> = co_change_counts.into_iter().collect();
    related.sort_by(|a, b| b.1.cmp(&a.1));

    // Limit to top 20
    related.truncate(20);

    RelatedFiles {
        target_file: target_file.to_string(),
        related,
    }
}

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

    #[test]
    fn test_analyze_related_files_basic() {
        let commits = vec![
            vec!["src/a.rs".to_string(), "src/b.rs".to_string()],
            vec!["src/a.rs".to_string(), "src/c.rs".to_string()],
            vec![
                "src/a.rs".to_string(),
                "src/b.rs".to_string(),
                "src/c.rs".to_string(),
            ],
            vec!["src/d.rs".to_string()], // does not contain a.rs
        ];

        let result = analyze_related_files("src/a.rs", commits.into_iter());

        assert_eq!(result.target_file, "src/a.rs");
        // b.rs: 2 times, c.rs: 2 times
        assert!(result
            .related
            .iter()
            .any(|(f, c)| f == "src/b.rs" && *c == 2));
        assert!(result
            .related
            .iter()
            .any(|(f, c)| f == "src/c.rs" && *c == 2));
        // d.rs was not co-changed with a.rs
        assert!(!result.related.iter().any(|(f, _)| f == "src/d.rs"));
    }

    #[test]
    fn test_analyze_related_files_no_target() {
        let commits = vec![
            vec!["src/x.rs".to_string(), "src/y.rs".to_string()],
            vec!["src/z.rs".to_string()],
        ];

        let result = analyze_related_files("src/a.rs", commits.into_iter());

        assert!(result.related.is_empty());
    }

    #[test]
    fn test_analyze_related_files_empty() {
        let commits: Vec<Vec<String>> = vec![];
        let result = analyze_related_files("src/a.rs", commits.into_iter());
        assert!(result.related.is_empty());
    }
}