pub mod report;
use super::{
NnsCommandError,
leaf::{self, NnsLeafCommandSpec},
};
use crate::nns::data_center::report::{
DEFAULT_NNS_DATA_CENTER_SOURCE_ENDPOINT, NnsDataCenterCacheRequest, NnsDataCenterInfoRequest,
NnsDataCenterListRequest, NnsDataCenterRefreshRequest, build_nns_data_center_info_report,
build_nns_data_center_list_report, nns_data_center_info_report_text,
nns_data_center_list_report_text, nns_data_center_list_report_verbose_text,
nns_data_center_refresh_report_text, refresh_nns_data_center_report,
};
use std::{ffi::OsString, path::Path};
#[cfg(test)]
use super::leaf::{NnsLeafInfoOptions, NnsLeafListOptions, NnsLeafRefreshOptions};
const DATA_CENTER_LIST_HELP_AFTER: &str = "\
Examples:
icq nns data-center list
icq nns data-center list --verbose
icq --network ic nns data-center list --format json
Force-refresh cached native NNS data:
icq nns data-center refresh";
const DATA_CENTER_INFO_HELP_AFTER: &str = "\
Examples:
icq nns data-center info <data-center>
icq nns data-center info <data-center-prefix>
icq --network ic nns data-center info <data-center> --format json
Force-refresh cached native NNS data:
icq nns data-center refresh";
const DATA_CENTER_REFRESH_HELP_AFTER: &str = "\
Examples:
icq nns data-center refresh
icq --network ic nns data-center refresh --format json
icq nns data-center refresh --dry-run --output .icq/data-center/ic/data-centers.preview.json";
const DATA_CENTER_SPEC: NnsLeafCommandSpec = NnsLeafCommandSpec {
command_name: "data-center",
bin_name: "icq nns data-center",
about: "Inspect NNS data-center metadata",
list_about: "List cached mainnet NNS data centers",
info_about: "Show one cached mainnet NNS data center",
refresh_about: "Force-refresh and cache NNS data-center metadata",
list_help_after: DATA_CENTER_LIST_HELP_AFTER,
info_help_after: DATA_CENTER_INFO_HELP_AFTER,
refresh_help_after: DATA_CENTER_REFRESH_HELP_AFTER,
input_value_name: "data-center|data-center-prefix",
input_help: "Data-center id or unique data-center id prefix",
list_source_help: "IC API endpoint used if the data-center cache is missing",
info_source_help: "IC API endpoint used if the data-center cache is missing",
refresh_source_help: "IC API endpoint used for native NNS registry queries",
verbose_help: "Show GPS coordinates and registry metadata in text output",
dry_run_help: "Fetch and validate without replacing the cached data-center report",
output_help: "Also write the fetched data-center JSON to this path",
};
pub(super) fn run<I>(args: I) -> Result<(), NnsCommandError>
where
I: IntoIterator<Item = OsString>,
{
leaf::run_cached_leaf(
args,
&DATA_CENTER_SPEC,
DEFAULT_NNS_DATA_CENTER_SOURCE_ENDPOINT,
leaf::NnsLeafReportFns::new(
build_nns_data_center_list_report,
build_nns_data_center_info_report,
refresh_nns_data_center_report,
nns_data_center_list_report_text,
nns_data_center_list_report_verbose_text,
nns_data_center_info_report_text,
nns_data_center_refresh_report_text,
),
)
}
impl leaf::NnsLeafCacheRequest for NnsDataCenterCacheRequest {
fn from_root_network(icp_root: &Path, network: &str) -> Self {
Self {
icp_root: icp_root.to_path_buf(),
network: network.to_string(),
}
}
}
impl leaf::NnsLeafListRequest for NnsDataCenterListRequest {
type Cache = NnsDataCenterCacheRequest;
fn from_leaf_parts(cache: Self::Cache, source_endpoint: String, now_unix_secs: u64) -> Self {
Self {
cache,
source_endpoint,
now_unix_secs,
}
}
}
impl leaf::NnsLeafInfoRequest for NnsDataCenterInfoRequest {
type Cache = NnsDataCenterCacheRequest;
fn from_leaf_parts(
cache: Self::Cache,
source_endpoint: String,
input: String,
now_unix_secs: u64,
) -> Self {
Self {
cache,
source_endpoint,
input,
now_unix_secs,
}
}
}
impl leaf::NnsLeafRefreshRequest for NnsDataCenterRefreshRequest {
type Cache = NnsDataCenterCacheRequest;
fn from_leaf_parts(
cache: Self::Cache,
source_endpoint: String,
now_unix_secs: u64,
lock_stale_after_seconds: u64,
dry_run: bool,
output_path: Option<std::path::PathBuf>,
) -> Self {
Self {
cache,
source_endpoint,
now_unix_secs,
lock_stale_after_seconds,
dry_run,
output_path,
}
}
}
#[cfg(test)]
pub(super) fn data_center_list_options<I>(args: I) -> Result<NnsLeafListOptions, NnsCommandError>
where
I: IntoIterator<Item = OsString>,
{
NnsLeafListOptions::parse(
args,
&DATA_CENTER_SPEC,
DEFAULT_NNS_DATA_CENTER_SOURCE_ENDPOINT,
)
}
#[cfg(test)]
pub(super) fn data_center_info_options<I>(args: I) -> Result<NnsLeafInfoOptions, NnsCommandError>
where
I: IntoIterator<Item = OsString>,
{
NnsLeafInfoOptions::parse(
args,
&DATA_CENTER_SPEC,
DEFAULT_NNS_DATA_CENTER_SOURCE_ENDPOINT,
)
}
#[cfg(test)]
pub(super) fn data_center_refresh_options<I>(
args: I,
) -> Result<NnsLeafRefreshOptions, NnsCommandError>
where
I: IntoIterator<Item = OsString>,
{
NnsLeafRefreshOptions::parse(
args,
&DATA_CENTER_SPEC,
DEFAULT_NNS_DATA_CENTER_SOURCE_ENDPOINT,
)
}
#[cfg(test)]
pub(super) fn data_center_usage() -> String {
leaf::usage(&DATA_CENTER_SPEC)
}
#[cfg(test)]
pub(super) fn data_center_list_usage() -> String {
leaf::list_usage(&DATA_CENTER_SPEC, DEFAULT_NNS_DATA_CENTER_SOURCE_ENDPOINT)
}
#[cfg(test)]
pub(super) fn data_center_info_usage() -> String {
leaf::info_usage(&DATA_CENTER_SPEC, DEFAULT_NNS_DATA_CENTER_SOURCE_ENDPOINT)
}
#[cfg(test)]
pub(super) fn data_center_refresh_usage() -> String {
leaf::refresh_usage(&DATA_CENTER_SPEC, DEFAULT_NNS_DATA_CENTER_SOURCE_ENDPOINT)
}