retch_cli/
cli.rs

1// SPDX-License-Identifier: GPL-3.0-or-later
2// Copyright (C) 2026 l1a
3
4//! Command-line interface definitions.
5//!
6//! Defines the CLI arguments, flags, and options using the `clap` crate.
7
8use clap::{Parser, ValueEnum};
9
10/// Command-line arguments for retch.
11#[derive(Parser, Debug)]
12#[command(name = "retch", author, version, about, long_about = None)]
13pub struct Cli {
14    /// Output mode: short, long, or custom
15    #[arg(short, long)]
16    pub mode: Option<String>,
17
18    /// Use a specific theme
19    #[arg(short, long)]
20    pub theme: Option<String>,
21
22    /// Path to custom config file
23    #[arg(short, long)]
24    pub config: Option<String>,
25
26    /// Force a specific distribution logo by name/ID
27    #[arg(long)]
28    pub logo: Option<String>,
29
30    /// Disable logo
31    #[arg(long)]
32    pub no_logo: bool,
33
34    /// Show only ASCII logo (even if graphics are supported)
35    #[arg(long)]
36    pub ascii_logo: bool,
37
38    /// Force Chafa symbols output (even if graphics are supported)
39    #[arg(long)]
40    pub chafa_logo: bool,
41
42    /// Short output mode (OS, Kernel, Host, CPU, GPU, Memory, Disk)
43    #[arg(short, long)]
44    pub short: bool,
45
46    /// Long output mode (show all fields)
47    #[arg(short, long)]
48    pub long: bool,
49
50    /// List available themes
51    #[arg(long)]
52    pub list_themes: bool,
53
54    /// Print an example custom theme template
55    #[arg(long)]
56    pub print_theme_template: bool,
57
58    /// List known distros
59    #[arg(long)]
60    pub list_distros: bool,
61
62    /// Print logos for known distros
63    #[arg(long)]
64    pub print_logos: bool,
65
66    /// Print default config (commented) to stdout
67    #[arg(long)]
68    pub generate_config: bool,
69
70    /// Write default config to a file (uses default location if no path given)
71    #[arg(long)]
72    pub write_config: bool,
73
74    /// Path(s) to write the config file to. Only the first value is used.
75    #[arg(trailing_var_arg = true, num_args = 0..)]
76    pub write_config_path: Vec<String>,
77
78    /// Merge default settings (as comments) into existing config
79    #[arg(long)]
80    pub merge_config: bool,
81
82    /// Fields to display (comma separated). Overrides config
83    #[arg(long)]
84    pub fields: Option<String>,
85
86    /// Generate shell completions
87    #[arg(long, value_enum)]
88    pub completions: Option<CompletionShell>,
89}
90
91/// Supported shells for completion generation.
92#[derive(ValueEnum, Clone, Debug)]
93pub enum CompletionShell {
94    Bash,
95    Elvish,
96    Fish,
97    #[clap(name = "power-shell")]
98    PowerShell,
99    Zsh,
100    Nushell,
101}
retch_cli/cli.rs

retch_cli/
cli.rs
