ic-query 0.2.23

Internet Computer query CLI for NNS, SNS, and related 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
121
122

use crate::{
    nns::topology::{commands as topology_commands, options as topology_options, report},
    nns::{
        NnsCommandError, command_args, command_icp_root, now_unix_secs,
        topology::options::TopologyReadOptions,
    },
    nns::{topology::report::NnsTopologyHostError, write_text_or_json},
};
use serde::Serialize;
use std::ffi::OsString;

macro_rules! topology_read_runner {
    (
        $name:ident,
        $options:ty,
        $request:ty,
        $report:ty,
        $usage:path,
        $build:path,
        $render:path
    ) => {
        pub(in crate::nns::topology::run) fn $name(
            args: Vec<OsString>,
        ) -> Result<(), NnsCommandError> {
            run_topology_read::<$options, $request, $report>(args, $usage, $build, $render)
        }
    };
}

topology_read_runner!(
    run_topology_summary,
    topology_options::TopologySummaryOptions,
    report::NnsTopologySummaryRequest,
    report::NnsTopologySummaryReport,
    topology_commands::topology_summary_usage,
    report::build_nns_topology_summary_report,
    report::nns_topology_summary_report_text
);
topology_read_runner!(
    run_topology_coverage,
    topology_options::TopologyCoverageOptions,
    report::NnsTopologyCoverageRequest,
    report::NnsTopologyCoverageReport,
    topology_commands::topology_coverage_usage,
    report::build_nns_topology_coverage_report,
    report::nns_topology_coverage_report_text
);
topology_read_runner!(
    run_topology_versions,
    topology_options::TopologyVersionsOptions,
    report::NnsTopologyVersionsRequest,
    report::NnsTopologyVersionsReport,
    topology_commands::topology_versions_usage,
    report::build_nns_topology_versions_report,
    report::nns_topology_versions_report_text
);
topology_read_runner!(
    run_topology_health,
    topology_options::TopologyHealthOptions,
    report::NnsTopologyHealthRequest,
    report::NnsTopologyHealthReport,
    topology_commands::topology_health_usage,
    report::build_nns_topology_health_report,
    report::nns_topology_health_report_text
);
topology_read_runner!(
    run_topology_gaps,
    topology_options::TopologyGapsOptions,
    report::NnsTopologyGapsRequest,
    report::NnsTopologyGapsReport,
    topology_commands::topology_gaps_usage,
    report::build_nns_topology_gaps_report,
    report::nns_topology_gaps_report_text
);
topology_read_runner!(
    run_topology_capacity,
    topology_options::TopologyCapacityOptions,
    report::NnsTopologyCapacityRequest,
    report::NnsTopologyCapacityReport,
    topology_commands::topology_capacity_usage,
    report::build_nns_topology_capacity_report,
    report::nns_topology_capacity_report_text
);
topology_read_runner!(
    run_topology_regions,
    topology_options::TopologyRegionsOptions,
    report::NnsTopologyRegionsRequest,
    report::NnsTopologyRegionsReport,
    topology_commands::topology_regions_usage,
    report::build_nns_topology_regions_report,
    report::nns_topology_regions_report_text
);
topology_read_runner!(
    run_topology_providers,
    topology_options::TopologyProvidersOptions,
    report::NnsTopologyProvidersRequest,
    report::NnsTopologyProvidersReport,
    topology_commands::topology_providers_usage,
    report::build_nns_topology_providers_report,
    report::nns_topology_providers_report_text
);

fn run_topology_read<Options, Request, Report>(
    args: Vec<OsString>,
    usage: fn() -> String,
    build_report: fn(&Request) -> Result<Report, NnsTopologyHostError>,
    render_text: fn(&Report) -> String,
) -> Result<(), NnsCommandError>
where
    Options: TopologyReadOptions<Request>,
    Report: Serialize,
{
    let Some(args) = command_args(args, usage) else {
        return Ok(());
    };
    let options = Options::parse_args(args)?;
    let format = options.format();
    let icp_root = command_icp_root()?;
    let request = options.into_request(icp_root, now_unix_secs()?);
    let report = build_report(&request)?;
    write_text_or_json(format, &report, render_text)
}