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

//! Trait for orchestrating external linters and type checkers.

use crate::core::{Category, ConfidenceKind, Issue, Severity};
use anyhow::Result;
use std::path::Path;

#[derive(Debug, Clone)]
pub struct ExternalFinding {
    pub tool: String,
    pub code: String,
    pub message: String,
    pub file: String,
    pub line: usize,
    pub column: usize,
    pub severity: Severity,
}

pub trait ExternalChecker: Send + Sync {
    fn id(&self) -> &'static str;
    fn name(&self) -> &'static str;
    fn is_available(&self) -> bool;
    fn run(&self, root: &Path) -> Result<Vec<ExternalFinding>>;
}

impl ExternalFinding {
    pub fn into_issue(self) -> Issue {
        let title = format!("{}:{}", self.tool, self.code);
        Issue::builder(
            format!("EXT-{}", self.tool.to_uppercase()),
            title,
            self.message,
            self.file.into(),
            self.line,
            self.column,
        )
        .category(Category::Warning)
        .severity(self.severity)
        .build()
        .with_source(self.tool)
    }
}

trait IssueSource {
    fn with_source(self, source: String) -> Issue;
}

impl IssueSource for Issue {
    fn with_source(mut self, source: String) -> Issue {
        self.source = source;
        self.confidence = ConfidenceKind::ToolReported;
        self
    }
}

pub fn builtin_checkers() -> Vec<Box<dyn ExternalChecker>> {
    vec![Box::new(super::ruff::RuffChecker)]
}

pub fn find_checker(id: &str) -> Option<Box<dyn ExternalChecker>> {
    builtin_checkers().into_iter().find(|c| c.id() == id)
}