unfault 1.0.5

Unfault — a cognitive context engine for thoughtful engineers
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

// unfault-ignore: rust.println_in_lib
use colored::Colorize;

use crate::exit_codes::{EXIT_ERROR, EXIT_SUCCESS};
use crate::fmt::{COL_WIDTH, word_wrap};

/// Execute `unfault info <id>`.
///
/// Prints the full SRE glossary entry for the given ID (e.g. "SLO-001"),
/// wrapping body text at 80 columns.
pub fn execute(id: &str) -> i32 {
    let id = id.to_uppercase();

    match unfault_analysis::sre::lookup_glossary(&id) {
        Some(entry) => {
            let indent = "  ";
            println!();
            println!(
                "  {}  {}",
                format!("[{}]", entry.id).bright_red().bold(),
                entry.aka.bold()
            );

            println!();
            println!("  {}", "The Hazard".bright_yellow().bold());
            for line in word_wrap(entry.hazard, indent, indent, COL_WIDTH) {
                println!("{}", line);
            }

            println!();
            println!("  {}", "How It Kills Services".bright_yellow().bold());
            for line in word_wrap(entry.mechanics, indent, indent, COL_WIDTH) {
                println!("{}", line);
            }

            println!();
            println!("  {}", "The Fix".bright_green().bold());
            for line in word_wrap(entry.fix, indent, indent, COL_WIDTH) {
                println!("{}", line);
            }

            println!();
            println!("  {}", "System Design Tradeoff".bright_yellow().bold());
            let gain_line = format!("+ Gain:  {}", entry.tradeoff.gain);
            let risk_line = format!("- Risk:  {}", entry.tradeoff.risk);
            for line in word_wrap(&gain_line, indent, "           ", COL_WIDTH) {
                println!("{}", line.green());
            }
            for line in word_wrap(&risk_line, indent, "           ", COL_WIDTH) {
                println!("{}", line.red());
            }

            println!();
            EXIT_SUCCESS
        }
        None => {
            eprintln!("  {} Unknown glossary ID: {}", "✗".bright_red(), id);
            eprintln!();
            eprintln!("  Available IDs: SLO-001 through SLO-006");
            eprintln!();
            EXIT_ERROR
        }
    }
}