nd_300/
cli.rs

1use clap::{Args, Parser, Subcommand};
2
3use crate::speedtest::TestDuration;
4
5/// ND-300: Cross-platform network diagnostic tool
6#[derive(Parser)]
7#[command(
8    name = "nd300",
9    author,
10    version,
11    disable_version_flag = true,
12    about = "ND-300 Network Diagnostic - QubeTX Developer Tools",
13    long_about = "ND-300 Network Diagnostic - QubeTX Developer Tools\n\n\
14        Cross-platform network diagnostics with 25+ concurrent checks,\n\
15        multi-stage network repair, and DNS configuration management.",
16    after_long_help = "EXAMPLES:\n\
17        \x20 nd300              Run standard diagnostics\n\
18        \x20 nd300 -t           Technician mode (deep diagnostics)\n\
19        \x20 nd300 -d           Change DNS configuration\n\
20        \x20 nd300 fix          Diagnostic-driven triage and recovery loop\n\
21        \x20 nd300 -f           Same as 'nd300 fix' (legacy flag form)\n\
22        \x20 nd300 update       Check for updates and install\n\
23        \x20 nd300 clear-dns    Reset DNS cache\n\
24        \x20 nd300 uninstall    Remove nd300 from this system\n\
25        \x20 nd300 --fast       Skip speed test for faster execution\n\
26        \x20 nd300 --json       Output results as JSON\n\n\
27        Run 'nd300 --help' for full details, or 'nd300 -h' for a summary."
28)]
29pub struct Nd300Cli {
30    /// Technician mode - full technical report with deep diagnostics
31    #[arg(
32        short = 't',
33        long = "tech",
34        alias = "technician",
35        help_heading = "Modes",
36        global = true
37    )]
38    pub tech: bool,
39
40    /// Custom title for the report header
41    #[arg(short = 'T', long, help_heading = "Modes", global = true)]
42    pub title: Option<String>,
43
44    /// Output results as JSON
45    #[arg(long, help_heading = "Output", global = true)]
46    pub json: bool,
47
48    /// Use ASCII characters instead of Unicode box-drawing
49    #[arg(long, help_heading = "Output", global = true)]
50    pub ascii: bool,
51
52    /// Disable colored output
53    #[arg(long, help_heading = "Output", global = true)]
54    pub no_color: bool,
55
56    /// Show additional debug/trace information
57    #[arg(long, help_heading = "Output", global = true)]
58    pub verbose: bool,
59
60    /// Skip the speed test (faster execution)
61    #[arg(long, help_heading = "Speed Test", global = true)]
62    pub fast: bool,
63
64    /// Speed test duration in seconds
65    #[arg(long, default_value = "10", help_heading = "Speed Test", global = true)]
66    pub speed_duration: u64,
67
68    /// Change DNS servers and verify connectivity
69    #[arg(short = 'd', long = "dns", help_heading = "Actions")]
70    pub dns: bool,
71
72    /// Diagnostic-driven triage and recovery loop (legacy flag form of `nd300 fix`)
73    #[arg(short = 'f', long = "fix", help_heading = "Actions")]
74    pub fix: bool,
75
76    /// Clear DNS cache and exit (legacy flag form of `nd300 clear-dns`)
77    #[arg(short = 'c', long = "clear-dns", help_heading = "Actions")]
78    pub clear_dns: bool,
79
80    /// Uninstall nd300 from this system (legacy flag form of `nd300 uninstall`)
81    #[arg(long = "uninstall", help_heading = "Actions")]
82    pub uninstall: bool,
83
84    /// Check for updates and install the latest version (legacy flag form of `nd300 update`)
85    #[arg(long = "update", help_heading = "Actions")]
86    pub update: bool,
87
88    /// Auto-confirm Medium-cost prompts when running the fix flow. Does NOT
89    /// bypass High-risk action prompts (Y/N is always required for those).
90    #[arg(
91        short = 'y',
92        long = "yes",
93        alias = "non-interactive",
94        help_heading = "Actions",
95        global = true
96    )]
97    pub yes: bool,
98
99    /// Print version
100    #[arg(short = 'v', long = "version", action = clap::ArgAction::Version)]
101    pub version: (),
102
103    /// Action subcommand. If present, takes precedence over the legacy action flags.
104    #[command(subcommand)]
105    pub command: Option<Nd300Command>,
106}
107
108/// Action subcommands. These are equivalent to the long-running action flags
109/// (`-f`, `--update`, `--clear-dns`, `--uninstall`) — both forms are supported and
110/// mean the same thing. The subcommand form is the preferred way going forward;
111/// the flag form is kept so existing scripts continue to work.
112#[derive(Subcommand, Debug, Clone)]
113pub enum Nd300Command {
114    /// Diagnostic-driven triage loop: tests → identifies failures → applies
115    /// targeted fixes → re-tests → repeats. Bounded by iteration count, wall
116    /// clock, and per-action attempt caps. Works for technical and non-technical
117    /// users; high-risk actions always require Y/N confirmation.
118    Fix(FixArgs),
119
120    /// Check for updates and install the latest release.
121    Update,
122
123    /// Clear the DNS cache and exit.
124    #[command(name = "clear-dns")]
125    ClearDns,
126
127    /// Uninstall nd300 from this system.
128    Uninstall,
129}
130
131/// Per-subcommand arguments for `fix`. Currently a placeholder — the `--yes`
132/// flag lives at the top level (global), so `nd300 fix --yes`,
133/// `nd300 --yes fix`, `nd300 -f -y`, and `nd300 -y -f` all work and share the
134/// same field on `Nd300Cli`. New fix-specific options can be added here later
135/// without affecting the legacy `-f` flag form.
136#[derive(Args, Debug, Clone, Default)]
137pub struct FixArgs {}
138
139/// SpeedQX Internet Speed Test - QubeTX Developer Tools
140///
141/// Quad-provider speed test using Cloudflare, M-Lab NDT7, LibreSpeed, and fast.com.
142#[derive(Parser)]
143#[command(
144    name = "speedqx",
145    author,
146    version,
147    disable_version_flag = true,
148    about = "SpeedQX Internet Speed Test - QubeTX Developer Tools",
149    long_about = "SpeedQX Internet Speed Test - QubeTX Developer Tools\n\n\
150        Quad-provider speed test using Cloudflare, M-Lab NDT7, LibreSpeed, and fast.com (Netflix).\n\
151        All four providers run and results are aggregated for maximum accuracy.",
152    after_long_help = "EXAMPLES:\n\
153        \x20 speedqx                     Run full speed test (all 4 providers)\n\
154        \x20 speedqx --duration 60       60s per direction for CF/NDT7/LS\n\
155        \x20 speedqx --fastcom-duration 30  Override fast.com to 30s/dir\n\
156        \x20 speedqx update              Check for updates and install\n\
157        \x20 speedqx --update            Same as 'speedqx update' (legacy flag form)\n\
158        \x20 speedqx --json              Output results as JSON\n\n\
159        Run 'speedqx --help' for full details, or 'speedqx -h' for a summary."
160)]
161pub struct SpeedQXCli {
162    /// Output results as JSON
163    #[arg(long, help_heading = "Output", global = true)]
164    pub json: bool,
165
166    /// Use ASCII characters instead of Unicode box-drawing
167    #[arg(long, help_heading = "Output", global = true)]
168    pub ascii: bool,
169
170    /// Disable colored output
171    #[arg(long, help_heading = "Output", global = true)]
172    pub no_color: bool,
173
174    /// Test duration per direction for CF/NDT7/LibreSpeed: seconds or "auto"
175    #[arg(
176        long,
177        default_value = "30",
178        value_parser = parse_duration,
179        help_heading = "Speed Test"
180    )]
181    pub duration: TestDuration,
182
183    /// Test duration per direction for fast.com: seconds or "auto" (default: auto)
184    #[arg(
185        long,
186        default_value = "auto",
187        value_parser = parse_duration,
188        help_heading = "Speed Test"
189    )]
190    pub fastcom_duration: TestDuration,
191
192    /// Number of latency probes
193    #[arg(long, default_value = "20", help_heading = "Speed Test")]
194    pub latency_probes: u32,
195
196    /// Check for updates and install the latest version (legacy flag form of `speedqx update`)
197    #[arg(long = "update", help_heading = "Actions")]
198    pub update: bool,
199
200    /// Print version
201    #[arg(short = 'v', long = "version", action = clap::ArgAction::Version)]
202    pub version: (),
203
204    /// Action subcommand. If present, takes precedence over the legacy `--update` flag.
205    #[command(subcommand)]
206    pub command: Option<SpeedQXCommand>,
207}
208
209/// Action subcommands for `speedqx`. Mirrors the `nd300` pattern: subcommand
210/// form is preferred, legacy `--update` flag is kept so existing scripts work.
211#[derive(Subcommand, Debug, Clone)]
212pub enum SpeedQXCommand {
213    /// Check for updates and install the latest release.
214    Update,
215}
216
217fn parse_duration(s: &str) -> Result<TestDuration, String> {
218    if s.eq_ignore_ascii_case("auto") {
219        Ok(TestDuration::Auto)
220    } else {
221        s.parse::<u64>()
222            .map(TestDuration::Seconds)
223            .map_err(|_| format!("invalid duration '{}': expected a number or \"auto\"", s))
224    }
225}
nd_300/cli.rs

nd_300/
cli.rs
