qualifier 0.3.0

Deterministic quality attestations for software artifacts
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

use comfy_table::{Cell, CellAlignment, Color, Table};

use crate::attestation::Record;
use crate::scoring::{self, ScoreReport};

/// Format a score for human display: `[+40]` or `[-30]` or `[  0]`.
pub fn format_score(score: i32) -> String {
    if score > 0 {
        format!("[+{}]", score)
    } else if score < 0 {
        format!("[{}]", score)
    } else {
        "[  0]".into()
    }
}

/// Pick a color based on the effective score.
pub fn score_color(score: i32) -> Color {
    if score >= 60 {
        Color::Green
    } else if score >= 0 {
        Color::Yellow
    } else {
        Color::Red
    }
}

/// Build a comfy-table for the `qualifier score` output.
pub fn score_table(reports: &[(String, ScoreReport)]) -> Table {
    let mut table = Table::new();
    table.set_header(vec!["SUBJECT", "RAW", "EFF", "", "STATUS"]);

    for (subject, report) in reports {
        let status = scoring::score_status(report);
        let bar = scoring::score_bar(report.effective, 10);

        let status_text = if let Some(ref path) = report.limiting_path {
            format!("limited by {}", path.join(" -> "))
        } else {
            status.to_string()
        };

        let color = score_color(report.effective);

        table.add_row(vec![
            Cell::new(subject),
            Cell::new(report.raw).set_alignment(CellAlignment::Right),
            Cell::new(report.effective)
                .set_alignment(CellAlignment::Right)
                .fg(color),
            Cell::new(&bar),
            Cell::new(&status_text).fg(color),
        ]);
    }

    table
}

/// JSON output for machine consumption — scores.
pub fn scores_json(reports: &[(String, ScoreReport)]) -> String {
    let entries: Vec<serde_json::Value> = reports
        .iter()
        .map(|(subject, report)| {
            serde_json::json!({
                "subject": subject,
                "raw_score": report.raw,
                "effective_score": report.effective,
                "status": scoring::score_status(report),
                "limiting_path": report.limiting_path,
            })
        })
        .collect();

    serde_json::to_string_pretty(&entries).unwrap_or_default()
}

/// JSON output for a single artifact show.
pub fn show_json(subject: &str, report: &ScoreReport, records: &[Record]) -> String {
    serde_json::to_string_pretty(&serde_json::json!({
        "subject": subject,
        "raw_score": report.raw,
        "effective_score": report.effective,
        "limiting_path": report.limiting_path,
        "records": records,
    }))
    .unwrap_or_default()
}