sloc-languages 1.5.64

Source line analysis tool with CLI, web UI, HTML/PDF reports, and CI/CD integration
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
116
117
118
119
120
121
122
123
124
125
126
127
128
129

// SPDX-License-Identifier: AGPL-3.0-or-later
// Copyright (C) 2026 Nima Shafie <nimzshafie@gmail.com>

//! Style-guide analysis for Rust.
//! Guides: Official rustfmt defaults, Mozilla Rust, Rust API Guidelines.

use super::common::*;

pub fn analyze(text: &str) -> StyleAnalysis {
    let lines: Vec<&str> = text.lines().collect();
    let m = scan_base_metrics(&lines);

    let mut trailing_commas = 0u32;
    let mut snake_case_fn = 0u32;
    let mut camel_case_fn = 0u32;

    for line in &lines {
        let trimmed = line.trim();
        if trimmed.starts_with("//") {
            continue;
        }

        // Trailing commas in multi-line constructs
        if trimmed == "," || trimmed.ends_with(',') && !trimmed.ends_with(",,") {
            trailing_commas += 1;
        }

        // fn naming convention
        if let Some(rest) = trimmed.strip_prefix("fn ") {
            let name = rest.split('(').next().unwrap_or("").trim();
            if name.contains('_') && name == name.to_lowercase() {
                snake_case_fn += 1;
            } else if name.chars().next().is_some_and(|c| c.is_uppercase()) {
                camel_case_fn += 1;
            }
        }
    }

    let indent = classify_indent(m.tabs, m.sp2, m.sp4);
    let guides = score_rust(
        indent,
        m.over80,
        m.over100,
        m.over120,
        m.total,
        trailing_commas,
    );

    let signals = vec![
        StyleSignal {
            name: "Indentation".into(),
            value: indent.display().into(),
        },
        StyleSignal {
            name: "Function Naming".into(),
            value: if snake_case_fn + camel_case_fn == 0 {
                "\u{2014}".into()
            } else if snake_case_fn >= camel_case_fn {
                "snake_case (idiomatic)".into()
            } else {
                "CamelCase (non-idiomatic)".into()
            },
        },
        StyleSignal {
            name: "Max Line Length".into(),
            value: format!("{} chars", m.max_len),
        },
    ];

    StyleAnalysis::assemble("Rust", indent, &m, signals, guides)
}

fn score_rust(
    ind: IndentStyle,
    over80: u32,
    over100: u32,
    over120: u32,
    total: u32,
    trailing_commas: u32,
) -> Vec<StyleGuideScore> {
    let i4 = score_indent_4(ind);
    let l100 = score_line100(over100, total);
    let l80 = score_line80(over80, total);
    let l120 = score_line120(over120, total);
    let tc = if total == 0 {
        0.50_f32
    } else {
        let ratio = trailing_commas as f32 / total as f32;
        if ratio > 0.02 {
            1.0
        } else if ratio > 0.005 {
            0.70
        } else {
            0.30
        }
    };

    // Official rustfmt: 4-space, 100-col, trailing commas in multi-line
    let rustfmt = weighted_score(&[(0.40, i4), (0.40, l100), (0.20, tc)]);
    // Mozilla Rust: 4-space, 100-col (historically 99)
    let mozilla = weighted_score(&[(0.40, i4), (0.40, l100), (0.20, 0.70)]);
    // Rust API Guidelines: 4-space, 80-col
    let api_guidelines = weighted_score(&[(0.50, i4), (0.35, l80), (0.15, tc)]);
    // Oxide/stricter: 4-space, 120-col
    let relaxed = weighted_score(&[(0.50, i4), (0.50, l120)]);

    vec![
        StyleGuideScore {
            name: "rustfmt defaults".into(),
            description: "4-space | 100-col | trailing commas".into(),
            score_pct: rustfmt,
        },
        StyleGuideScore {
            name: "Mozilla Rust".into(),
            description: "4-space | 100-col".into(),
            score_pct: mozilla,
        },
        StyleGuideScore {
            name: "Rust API Guidelines".into(),
            description: "4-space | 80-col".into(),
            score_pct: api_guidelines,
        },
        StyleGuideScore {
            name: "Relaxed (120-col)".into(),
            description: "4-space | 120-col".into(),
            score_pct: relaxed,
        },
    ]
}