svccat 0.17.0

Detect drift between your declared service catalog and what actually lives in the repo.
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

use crate::manifest::{Manifest, ServiceEntry};
use colored::Colorize;

/// Print a field-coverage summary table with ASCII bar charts.
///
/// For each tracked metadata field, shows how many services have it set
/// along with a percentage and a coloured progress bar.  Finishes with
/// an overall health score (average coverage across all fields).
pub fn run(manifest: &Manifest) {
    let total = manifest.services.len();
    if total == 0 {
        println!("svccat stats: no services declared.");
        return;
    }

    let s = if total == 1 { "" } else { "s" };
    println!("{}", format!("svccat stats  [{total} service{s}]").bold());
    println!();
    println!("Field Coverage:");
    println!();

    type CheckFn = fn(&ServiceEntry) -> bool;
    let fields: &[(&str, CheckFn)] = &[
        ("language", |s| filled(s.language.as_deref())),
        ("platform", |s| filled(s.platform.as_deref())),
        ("team", |s| filled(s.team.as_deref())),
        ("docs", |s| filled(s.docs.as_deref())),
        ("url", |s| filled(s.url.as_deref())),
        ("role", |s| filled(s.role.as_deref())),
        ("oncall", |s| filled(s.oncall.as_deref())),
    ];

    const BAR_WIDTH: usize = 20;
    let mut sum_pct: usize = 0;

    for (name, check) in fields {
        let count = manifest.services.iter().filter(|s| check(s)).count();
        let pct = count * 100 / total;
        let filled_len = count * BAR_WIDTH / total;
        let bar = format!(
            "{}{}",
            "█".repeat(filled_len),
            "░".repeat(BAR_WIDTH - filled_len)
        );

        let pct_label = format!("{pct:>3}%");
        let coloured_pct = if pct == 100 {
            pct_label.green().bold()
        } else if pct >= 50 {
            pct_label.yellow().bold()
        } else {
            pct_label.red().bold()
        };

        println!(
            "  {:<10}  {:>3}/{:<3}  {}  {}",
            name, count, total, bar, coloured_pct
        );

        sum_pct += pct;
    }

    let overall = sum_pct / fields.len();
    println!();
    let health_label = format!("Overall health: {overall}%");
    let coloured_health = if overall == 100 {
        health_label.green().bold()
    } else if overall >= 50 {
        health_label.yellow().bold()
    } else {
        health_label.red().bold()
    };
    println!("  {coloured_health}");
}

// ── Helpers ───────────────────────────────────────────────────────────────────

fn filled(v: Option<&str>) -> bool {
    v.map(|s| !s.is_empty()).unwrap_or(false)
}