Struct ZshrsHost 

pub struct ZshrsHost;

ShellHost implementation that delegates to the current ShellExecutor via the with_executor thread-local.

Construct fresh on each VM run (it carries no state itself). The VM dispatches host method calls during vm.run(), and with_executor resolves to the executor pointer set by ExecutorContext::enter.

Trait Implementations

impl ShellHost for ZshrsHost

fn glob(&mut self, pattern: &str, _recursive: bool) -> Vec<String>

Glob expand pattern. If recursive, treat ** as a recursive marker. Returns the matched paths (empty when no match — caller decides how to handle nullglob/nomatch options).

fn tilde_expand(&mut self, s: &str) -> String

Tilde expansion: ~ → $HOME, ~user → user’s home, ~+/~- → dir stack. Returns input unchanged if no expansion applies.

fn brace_expand(&mut self, s: &str) -> Vec<String>

Brace expansion: {a,b} → [“a”,“b”], {1..10} → 10 strings. Returns a single-element vec containing the input when no braces present.

fn str_match(&mut self, s: &str, pattern: &str) -> bool

Glob match: does s match the shell glob pattern pat? Used by [[ x = pat ]] and case. Default is exact equality.

fn expand_param(&mut self, name: &str, modifier: u8, args: &[Value]) -> Value

Parameter expansion: ${var:-default}, ${#var}, ${var/pat/rep}, etc. modifier is one of crate::op::param_mod::*. args are the modifier operands (already evaluated to Values) — for ${var:-x} it’s [x], for ${var/p/r} it’s [p, r], for ${var:o:l} it’s [o, l]. LENGTH/UPPER/LOWER/KEYS/INDIRECT take no args.

fn regex_match(&mut self, s: &str, regex: &str) -> bool

Regex match: s =~ regex (extended POSIX or PCRE per host).

fn process_sub_in(&mut self, sub: &Chunk) -> String

Process substitution input: spawn sub, return path to a fd/FIFO that reads its stdout. (<(cmd))

fn process_sub_out(&mut self, sub: &Chunk) -> String

Process substitution output: spawn sub, return path to a fd/FIFO that writes to its stdin. (>(cmd))

fn subshell_begin(&mut self)

Begin subshell scope (snapshot/save state).

fn subshell_end(&mut self)

End subshell scope (restore state).

fn redirect(&mut self, fd: u8, op: u8, target: &str)

Apply a redirection at the next exec/builtin call. fd is the source fd, op from crate::op::redirect_op::*, target is the (already-expanded) filename or fd reference.

fn with_redirects_begin(&mut self, count: u8)

Begin scoped redirect block — cmd > out.txt style applied to a compound command. The host saves current fd state.

fn with_redirects_end(&mut self)

End scoped redirect block — restore fd state.

fn heredoc(&mut self, content: &str)

Heredoc body for the next command’s stdin.

fn herestring(&mut self, content: &str)

Herestring body for the next command’s stdin.

fn exec(&mut self, args: Vec<String>) -> i32

Spawn an external command and wait. Default uses std::process::Command.

fn cmd_subst(&mut self, sub: &Chunk) -> String

Run a sub-chunk and capture its stdout as a string. ($(cmd),`cmd`)

fn call_function(&mut self, name: &str, args: Vec<String>) -> Option<i32>

Call a user-defined shell function. Returns Some(status) when the function exists, None to fall through to external exec.

fn word_split(&mut self, s: &str) -> Vec<String>

Word splitting using current IFS rules.

fn array_index(&mut self, name: &str, index: &Value) -> Value

Index into an array variable: ${arr[idx]}. index is the evaluated subscript (Int for indexed arrays, Str for associative).

fn pipeline_begin(&mut self, n: u8)

Begin an N-stage pipeline. Subsequent pipeline_stage calls separate stages; pipeline_end waits for completion and returns final status.

fn pipeline_stage(&mut self)

Wire next pipeline stage (set up pipe between previous and next).

fn pipeline_end(&mut self) -> i32

Wait for the pipeline to complete; return last command’s exit status.

fn trap_set(&mut self, sig: &str, handler: &Chunk)

Install a trap handler for signal sig. The handler is a sub-chunk that the host runs when the signal fires.

fn trap_check(&mut self)

Process pending traps (called periodically by the VM dispatch loop).

fn exec_bg(&mut self, args: Vec<String>) -> i32

Spawn an external command in the background and detach. Returns the child pid (or 0 on failure / when the host doesn’t track pids). Default uses std::process::Command::spawn(). Frontends override to register the pid in their job table so jobs, fg, wait, disown see it.