brush_shell/
args.rs

1//! Types for brush command-line parsing.
2
3use clap::{Parser, builder::styling};
4use std::{io::IsTerminal, path::PathBuf};
5
6use crate::{events, productinfo};
7
8const SHORT_DESCRIPTION: &str = "Bo[u]rn[e] RUsty SHell 🦀 (https://brush.sh)";
9
10const LONG_DESCRIPTION: &str = r"brush is a bash-compatible, Rust-implemented, POSIX-style shell.
11
12brush is distributed under the terms of the MIT license. If you encounter any issues or discrepancies in behavior from bash, please report them at https://github.com/reubeno/brush.
13
14For more information, visit https://brush.sh.";
15
16const USAGE: &str = color_print::cstr!(
17    "<bold>brush</bold> <italics>[OPTIONS]</italics>... <italics>[SCRIPT_PATH [SCRIPT_ARGS]...]</italics>"
18);
19
20const VERSION: &str = const_format::concatcp!(
21    productinfo::PRODUCT_VERSION,
22    " (",
23    productinfo::PRODUCT_GIT_VERSION,
24    ")"
25);
26
27const HEADING_STANDARD_OPTIONS: &str = "Standard shell options";
28
29const HEADING_UI_OPTIONS: &str = "User interface options";
30
31/// Identifies the input backend to use for the shell.
32#[derive(Clone, Copy, clap::ValueEnum)]
33pub enum InputBackend {
34    /// Richest input backend, based on reedline.
35    Reedline,
36    /// Basic input backend that provides minimal completion support for testing.
37    Basic,
38    /// Most minimal input backend.
39    Minimal,
40}
41
42/// Parsed command-line arguments for the brush shell.
43#[derive(Parser)]
44#[clap(name = productinfo::PRODUCT_NAME,
45       version = VERSION,
46       about = SHORT_DESCRIPTION,
47       long_about = LONG_DESCRIPTION,
48       author,
49       override_usage = USAGE,
50       disable_help_flag = true,
51       disable_version_flag = true,
52       styles = brush_help_styles())]
53pub struct CommandLineArgs {
54    /// Display usage information.
55    #[clap(long = "help", action = clap::ArgAction::HelpShort)]
56    pub help: Option<bool>,
57
58    /// Display shell version.
59    #[clap(long = "version", action = clap::ArgAction::Version)]
60    pub version: Option<bool>,
61
62    /// Enable `noclobber` shell option.
63    #[arg(short = 'C', help_heading = HEADING_STANDARD_OPTIONS)]
64    pub disallow_overwriting_regular_files_via_output_redirection: bool,
65
66    /// Execute the provided command and then exit.
67    #[arg(short = 'c', value_name = "COMMAND", help_heading = HEADING_STANDARD_OPTIONS)]
68    pub command: Option<String>,
69
70    /// Run in interactive mode.
71    #[clap(short = 'i', help_heading = HEADING_STANDARD_OPTIONS)]
72    pub interactive: bool,
73
74    /// Inherit the specified file descriptors injected by the parent process.
75    #[clap(long = "inherit-fd", value_name = "FD", help_heading = HEADING_STANDARD_OPTIONS)]
76    pub inherited_fds: Vec<i32>,
77
78    /// Make shell act as if it had been invoked as a login shell.
79    #[clap(short = 'l', long = "login", help_heading = HEADING_STANDARD_OPTIONS)]
80    pub login: bool,
81
82    /// Do not execute commands.
83    #[clap(short = 'n', help_heading = HEADING_STANDARD_OPTIONS)]
84    pub do_not_execute_commands: bool,
85
86    /// Don't use readline for input.
87    #[clap(long = "noediting", help_heading = HEADING_STANDARD_OPTIONS)]
88    pub no_editing: bool,
89
90    /// Don't process any profile/login files (`/etc/profile`, `~/.bash_profile`, `~/.bash_login`,
91    /// `~/.profile`).
92    #[clap(long = "noprofile", help_heading = HEADING_STANDARD_OPTIONS)]
93    pub no_profile: bool,
94
95    /// Don't process "rc" files if the shell is interactive (e.g., `~/.bashrc`, `~/.brushrc`).
96    #[clap(long = "norc", help_heading = HEADING_STANDARD_OPTIONS)]
97    pub no_rc: bool,
98
99    /// Don't inherit environment variables from the calling process.
100    #[clap(long = "noenv", help_heading = HEADING_STANDARD_OPTIONS)]
101    pub do_not_inherit_env: bool,
102
103    /// Enable option (`set -o` option).
104    #[clap(short = 'o', value_name = "OPTION", help_heading = HEADING_STANDARD_OPTIONS)]
105    pub enabled_options: Vec<String>,
106
107    /// Disable option (`set -o` option).
108    #[clap(long = "+o", value_name = "OPTION", hide = true, help_heading = HEADING_STANDARD_OPTIONS)]
109    pub disabled_options: Vec<String>,
110
111    /// Enable `shopt` option.
112    #[clap(short = 'O', value_name = "SHOPT_OPTION", help_heading = HEADING_STANDARD_OPTIONS)]
113    pub enabled_shopt_options: Vec<String>,
114
115    /// Disable `shopt` option.
116    #[clap(long = "+O", value_name = "SHOPT_OPTION", hide = true, help_heading = HEADING_STANDARD_OPTIONS)]
117    pub disabled_shopt_options: Vec<String>,
118
119    /// Disable non-POSIX extensions.
120    #[clap(long = "posix", help_heading = HEADING_STANDARD_OPTIONS)]
121    pub posix: bool,
122
123    /// Path to the rc file to load in interactive shells (instead of `bash.bashrc` and `~/.bashrc`).
124    #[clap(long = "rcfile", alias = "init-file", value_name = "FILE", help_heading = HEADING_STANDARD_OPTIONS)]
125    pub rc_file: Option<PathBuf>,
126
127    /// Read commands from standard input.
128    #[clap(short = 's', help_heading = HEADING_STANDARD_OPTIONS)]
129    pub read_commands_from_stdin: bool,
130
131    /// Run in `sh` compatibility mode, as if run as `/bin/sh`.
132    #[clap(long = "sh")]
133    pub sh_mode: bool,
134
135    /// Run only one command and then exit.
136    #[clap(short = 't', help_heading = HEADING_STANDARD_OPTIONS)]
137    pub exit_after_one_command: bool,
138
139    /// Print input when it's processed.
140    #[clap(short = 'v', long = "verbose", help_heading = HEADING_STANDARD_OPTIONS)]
141    pub verbose: bool,
142
143    /// Print commands as they execute.
144    #[clap(short = 'x', help_heading = HEADING_STANDARD_OPTIONS)]
145    pub print_commands_and_arguments: bool,
146
147    /// Disable bracketed paste.
148    #[clap(long = "disable-bracketed-paste", help_heading = HEADING_UI_OPTIONS)]
149    pub disable_bracketed_paste: bool,
150
151    /// Disable colorized output.
152    #[clap(long = "disable-color", help_heading = HEADING_UI_OPTIONS)]
153    pub disable_color: bool,
154
155    /// Enable syntax highlighting (experimental).
156    #[clap(long = "enable-highlighting", help_heading = HEADING_UI_OPTIONS)]
157    pub enable_highlighting: bool,
158
159    /// Input backend.
160    #[clap(long = "input-backend", value_name = "BACKEND", help_heading = HEADING_UI_OPTIONS)]
161    pub input_backend: Option<InputBackend>,
162
163    /// Enable debug logging for classes of tracing events.
164    #[clap(long = "debug", alias = "log-enable", value_name = "EVENT", help_heading = HEADING_UI_OPTIONS)]
165    pub enabled_debug_events: Vec<events::TraceEvent>,
166
167    /// Disable logging for classes of tracing events (takes same event types as `--debug`).
168    #[clap(
169        long = "disable-event",
170        alias = "log-disable",
171        value_name = "EVENT",
172        hide_possible_values = true,
173        help_heading = HEADING_UI_OPTIONS
174    )]
175    pub disabled_events: Vec<events::TraceEvent>,
176
177    /// Path and arguments for script to execute (optional).
178    #[clap(
179        trailing_var_arg = true,
180        allow_hyphen_values = false,
181        value_name = "SCRIPT_PATH [SCRIPT_ARGS]..."
182    )]
183    pub script_args: Vec<String>,
184}
185
186impl CommandLineArgs {
187    /// Returns whether or not the arguments indicate that the shell should run in interactive mode.
188    pub fn is_interactive(&self) -> bool {
189        // If -i is provided, then that overrides any further consideration; it forces
190        // interactive mode.
191        if self.interactive {
192            return true;
193        }
194
195        // If -c or non-option arguments are provided, then we're not in interactive mode.
196        if self.command.is_some() || !self.script_args.is_empty() {
197            return false;
198        }
199
200        // If *either* stdin or stderr is not a terminal, then we're not in interactive mode.
201        if !std::io::stdin().is_terminal() || !std::io::stderr().is_terminal() {
202            return false;
203        }
204
205        // In all other cases, we assume interactive mode.
206        true
207    }
208}
209
210/// Returns clap styling to be used for command-line help.
211#[doc(hidden)]
212fn brush_help_styles() -> clap::builder::Styles {
213    styling::Styles::styled()
214        .header(
215            styling::AnsiColor::Yellow.on_default()
216                | styling::Effects::BOLD
217                | styling::Effects::UNDERLINE,
218        )
219        .usage(styling::AnsiColor::Green.on_default() | styling::Effects::BOLD)
220        .literal(styling::AnsiColor::Magenta.on_default() | styling::Effects::BOLD)
221        .placeholder(styling::AnsiColor::Cyan.on_default())
222}
brush_shell/args.rs

brush_shell/
args.rs
