zerum 0.4.0

Deterministic Python code governance: ~75 checks, default/strict profiles, explain mode, optional Ruff orchestration
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

use crate::core::ast_util::{
    collect_class_metrics, collect_function_metrics, collect_import_modules,
};
use crate::parser::ParsedFile;

#[derive(Debug, Clone)]
pub struct FunctionView {
    pub name: String,
    pub line: usize,
    pub column: usize,
    pub arg_count: usize,
    pub body_lines: usize,
    pub branch_count: usize,
    pub max_conditional_depth: usize,
}

#[derive(Debug, Clone)]
pub struct ClassView {
    pub name: String,
    pub line: usize,
    pub column: usize,
    pub method_count: usize,
}

#[derive(Debug, Clone)]
pub struct ImportView {
    pub module: String,
    pub line: usize,
    pub column: usize,
}

#[derive(Debug, Clone)]
pub struct CommentView {
    pub text: String,
    pub line: usize,
    pub column: usize,
}

pub struct SourceModel<'a> {
    parsed: &'a ParsedFile,
}

impl<'a> SourceModel<'a> {
    pub fn from_parsed(parsed: &'a ParsedFile) -> Self {
        Self { parsed }
    }

    pub fn functions(&self) -> Vec<FunctionView> {
        collect_function_metrics(self.parsed)
            .into_iter()
            .map(|m| FunctionView {
                name: m.name,
                line: m.line,
                column: m.column,
                arg_count: m.arg_count,
                body_lines: m.body_lines,
                branch_count: m.branch_count,
                max_conditional_depth: m.max_conditional_depth,
            })
            .collect()
    }

    pub fn classes(&self) -> Vec<ClassView> {
        collect_class_metrics(self.parsed)
            .into_iter()
            .map(|m| ClassView {
                name: m.name,
                line: m.line,
                column: m.column,
                method_count: m.method_count,
            })
            .collect()
    }

    pub fn imports(&self) -> Vec<ImportView> {
        collect_import_modules(self.parsed)
            .into_iter()
            .map(|(module, line, column)| ImportView {
                module,
                line,
                column,
            })
            .collect()
    }

    pub fn comments(&self) -> Vec<CommentView> {
        self.parsed
            .source
            .lines()
            .enumerate()
            .filter_map(|(idx, line)| {
                let hash = line.find('#')?;
                Some(CommentView {
                    text: line[hash..].to_string(),
                    line: idx + 1,
                    column: hash + 1,
                })
            })
            .collect()
    }
}