ic-query 0.22.1

Internet Computer query library for NNS, SNS, ICRC, system canisters, and public network metadata
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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

//! Module: sns::report::text::canisters
//!
//! Responsibility: render SNS Root canister inventory and health reports.
//! Does not own: Root calls, report construction, JSON serialization, or lookup.
//! Boundary: presents raw report fields compactly without changing the JSON contract.

use crate::{
    sns::report::SnsCanisterReport,
    table::{ColumnAlign, render_table},
    text_value::{sanitize_text, truncate_text, yes_no},
    token_metadata_text::optional_text,
};

const MODULE_HASH_TEXT_CHARS: usize = 12;

/// Render one SNS Root canister report as human-facing text.
#[must_use]
pub fn sns_canister_report_text(report: &SnsCanisterReport) -> String {
    let mut lines = vec![
        format!("network: {}", sanitize_text(&report.network)),
        format!("sns_id: {}", report.id),
        format!("name: {}", sanitize_text(&report.name)),
        format!("root_canister_id: {}", report.root_canister_id),
        format!("canister_count: {}", report.canister_count),
        format!("health_status_count: {}", report.health_status_count),
        format!("gap_count: {}", report.gap_count),
        format!(
            "point_in_time_guaranteed: {}",
            yes_no(report.point_in_time_guaranteed)
        ),
        format!(
            "inventory_method: {}",
            sanitize_text(&report.inventory_method)
        ),
        format!("health_method: {}", sanitize_text(&report.health_method)),
        format!(
            "health_call_type: {}",
            sanitize_text(&report.health_call_type)
        ),
        format!(
            "health_update_canister_list: {}",
            yes_no(report.health_update_canister_list)
        ),
        format!("sns_wasm_canister_id: {}", report.sns_wasm_canister_id),
        format!("fetched_at: {}", sanitize_text(&report.fetched_at)),
        format!(
            "source_endpoint: {}",
            sanitize_text(&report.source_endpoint)
        ),
        String::new(),
        render_table(
            &[
                "ROLE",
                "CANISTER",
                "STATUS",
                "MODULE HASH",
                "CYCLES",
                "MEMORY",
                "CONTROLLERS",
            ],
            &report
                .canisters
                .iter()
                .map(|canister| {
                    [
                        canister.role.as_str().to_string(),
                        canister.canister_id.clone(),
                        canister
                            .status
                            .map_or_else(|| "-".to_string(), |status| status.as_str().to_string()),
                        canister.module_hash_hex.as_ref().map_or_else(
                            || "-".to_string(),
                            |hash| truncate_text(hash, MODULE_HASH_TEXT_CHARS),
                        ),
                        optional_text(canister.cycles.as_ref()),
                        optional_text(canister.memory_size.as_ref()),
                        canister.controllers.len().to_string(),
                    ]
                })
                .collect::<Vec<_>>(),
            &[
                ColumnAlign::Left,
                ColumnAlign::Left,
                ColumnAlign::Left,
                ColumnAlign::Left,
                ColumnAlign::Right,
                ColumnAlign::Right,
                ColumnAlign::Right,
            ],
        ),
    ];

    if !report.gaps.is_empty() {
        lines.push(String::new());
        lines.push("gaps:".to_string());
        lines.push(render_table(
            &["KIND", "ROLE", "INVENTORY CANISTER", "SUMMARY CANISTER"],
            &report
                .gaps
                .iter()
                .map(|gap| {
                    [
                        gap.kind.as_str().to_string(),
                        gap.role.as_str().to_string(),
                        optional_text(gap.inventory_canister_id.as_ref()),
                        optional_text(gap.summary_canister_id.as_ref()),
                    ]
                })
                .collect::<Vec<_>>(),
            &[
                ColumnAlign::Left,
                ColumnAlign::Left,
                ColumnAlign::Left,
                ColumnAlign::Left,
            ],
        ));
    }

    lines.join("\n")
}