Struct MockShell 

pub struct MockShell {
    pub calls: RefCell<Vec<String>>,
    pub run_success: bool,
    pub command_exists_result: bool,
    pub command_output_value: String,
    pub command_output_ok: bool,
    pub exec_capture_results: RefCell<VecDeque<CommandResult>>,
}

Mock shell for unit tests: records calls and returns configurable results.

Intended for testing use. Not gated behind #[cfg(test)] so that downstream crates can use it in their own test suites; LTO eliminates it from production builds.

Fields

calls: RefCell<Vec<String>>

Ordered log of every call made to this shell, formatted as "program arg1 arg2".

run_success: bool

Value returned by run_command / shell_exec / exec_capture. Defaults to true.

command_exists_result: bool

Value returned by command_exists. Defaults to true.

command_output_value: String

Stdout value returned by command_output when command_output_ok is true.

command_output_ok: bool

When false, command_output returns Err (e.g. to simulate a tool not installed).

exec_capture_results: RefCell<VecDeque<CommandResult>>

Queue of results for exec_capture calls; pops front on each call. If empty, falls back to CommandResult { success: run_success, stderr: "" }.

Implementations

impl MockShell

pub fn new() -> Self

Create a new MockShell with all success flags set to true and empty recorded calls.

pub fn calls(&self) -> Vec<String>

Return a snapshot of all calls recorded so far.

Trait Implementations

impl Default for MockShell

fn default() -> Self

Returns the “default value” for a type.

impl Shell for MockShell

fn run_command( &self, _label: &str, program: &str, args: &[&str], _output: &mut dyn Output, _mode: OutputMode, ) -> Result<CommandResult, ShellError>

Run program with args, displaying progress under label.

fn shell_exec( &self, script: &str, _output: &mut dyn Output, _mode: OutputMode, ) -> Result<CommandResult, ShellError>

Run an arbitrary shell script string (passed to bash -c / powershell -Command).

fn command_exists(&self, _program: &str) -> bool

Return true when program can be found on PATH.

fn command_output( &self, program: &str, args: &[&str], ) -> Result<String, ShellError>

Run program args and return its captured stdout as a trimmed String.

fn exec_capture( &self, cmd: &str, _output: &mut dyn Output, _mode: OutputMode, ) -> Result<CommandResult, ShellError>

Run a shell command, capturing stdout/stderr silently without display. In dry-run mode (DryRunShell), logs the command and returns success without executing.

fn exec_interactive( &self, cmd: &str, _output: &mut dyn Output, _mode: OutputMode, ) -> Result<(), ShellError>

Run a shell command with inherited stdio (for interactive flows like aws sso login). In dry-run mode (DryRunShell), logs the command and returns success without executing.