Struct ShellExecutor 

pub struct ShellExecutor {

    pub functions: HashMap<String, ShellCommand>,
    pub aliases: HashMap<String, String>,
    pub global_aliases: HashMap<String, String>,
    pub suffix_aliases: HashMap<String, String>,
    pub last_status: i32,
    pub variables: HashMap<String, String>,
    pub arrays: HashMap<String, Vec<String>>,
    pub assoc_arrays: HashMap<String, HashMap<String, String>>,
    pub jobs: JobTable,
    pub fpath: Vec<PathBuf>,
    pub zwc_cache: HashMap<PathBuf, ZwcFile>,
    pub positional_params: Vec<String>,
    pub history: Option<HistoryEngine>,
    pub traps: HashMap<String, String>,
    pub options: HashMap<String, bool>,
    pub completions: HashMap<String, CompSpec>,
    pub dir_stack: Vec<PathBuf>,
    pub comp_matches: Vec<CompMatch>,
    pub comp_groups: Vec<CompGroup>,
    pub comp_state: CompState,
    pub zstyles: Vec<ZStyle>,
    pub comp_words: Vec<String>,
    pub comp_current: i32,
    pub comp_prefix: String,
    pub comp_suffix: String,
    pub comp_iprefix: String,
    pub comp_isuffix: String,
    pub readonly_vars: HashSet<String>,
    pub local_save_stack: Vec<(String, Option<String>)>,
    pub local_scope_depth: usize,
    pub autoload_pending: HashMap<String, AutoloadFlags>,
    pub hook_functions: HashMap<String, Vec<String>>,
    pub named_dirs: HashMap<String, PathBuf>,
    pub zptys: HashMap<String, ZptyState>,
    pub open_fds: HashMap<i32, File>,
    pub next_fd: i32,
    pub scheduled_commands: Vec<ScheduledCommand>,
    pub profile_data: HashMap<String, ProfileEntry>,
    pub profiling_enabled: bool,
    pub unix_sockets: HashMap<i32, UnixSocketState>,
    pub compsys_cache: Option<CompsysCache>,
    pub compinit_pending: Option<(Receiver<CompInitBgResult>, Instant)>,
    pub plugin_cache: Option<PluginCache>,
    pub deferred_compdefs: Vec<Vec<String>>,
    pub command_hash: HashMap<String, String>,
    pub pcre_state: PcreState,
    pub tcp_sessions: TcpSessions,
    pub zftp: Zftp,
    pub profiler: Profiler,
    pub style_table: StyleTable,
    pub zsh_compat: bool,
    pub posix_mode: bool,
    pub worker_pool: Arc<WorkerPool>,
    pub intercepts: Vec<Intercept>,
    pub async_jobs: HashMap<u32, Receiver<(i32, String)>>,
    pub next_async_id: u32,
    pub defer_stack: Vec<Vec<String>>,
    /* private fields */
}

Fields

functions: HashMap<String, ShellCommand>

aliases: HashMap<String, String>

global_aliases: HashMap<String, String>

suffix_aliases: HashMap<String, String>

last_status: i32

variables: HashMap<String, String>

arrays: HashMap<String, Vec<String>>

assoc_arrays: HashMap<String, HashMap<String, String>>

jobs: JobTable

fpath: Vec<PathBuf>

zwc_cache: HashMap<PathBuf, ZwcFile>

positional_params: Vec<String>

history: Option<HistoryEngine>

traps: HashMap<String, String>

options: HashMap<String, bool>

completions: HashMap<String, CompSpec>

dir_stack: Vec<PathBuf>

comp_matches: Vec<CompMatch>

comp_groups: Vec<CompGroup>

comp_state: CompState

zstyles: Vec<ZStyle>

comp_words: Vec<String>

comp_current: i32

comp_prefix: String

comp_suffix: String

comp_iprefix: String

comp_isuffix: String

readonly_vars: HashSet<String>

local_save_stack: Vec<(String, Option<String>)>

Stack for local variable save/restore (name, old_value).

local_scope_depth: usize

Current function scope depth for local tracking.

autoload_pending: HashMap<String, AutoloadFlags>

hook_functions: HashMap<String, Vec<String>>

named_dirs: HashMap<String, PathBuf>

zptys: HashMap<String, ZptyState>

open_fds: HashMap<i32, File>

next_fd: i32

scheduled_commands: Vec<ScheduledCommand>

profile_data: HashMap<String, ProfileEntry>

profiling_enabled: bool

unix_sockets: HashMap<i32, UnixSocketState>

compsys_cache: Option<CompsysCache>

compinit_pending: Option<(Receiver<CompInitBgResult>, Instant)>

plugin_cache: Option<PluginCache>

deferred_compdefs: Vec<Vec<String>>

command_hash: HashMap<String, String>

pcre_state: PcreState

tcp_sessions: TcpSessions

zftp: Zftp

profiler: Profiler

style_table: StyleTable

zsh_compat: bool

zsh compatibility mode - use .zcompdump, fpath scanning, etc.

posix_mode: bool

POSIX sh strict mode — no SQLite, no worker pool, no zsh extensions

worker_pool: Arc<WorkerPool>

Worker thread pool for background tasks (compinit, process subs, etc.)

intercepts: Vec<Intercept>

AOP intercept table: command/function name → advice chain. Glob patterns supported (e.g. “git ”, “”).

async_jobs: HashMap<u32, Receiver<(i32, String)>>

Async job handles: id → receiver for (status, stdout)

next_async_id: u32

Next async job ID

defer_stack: Vec<Vec<String>>

Defer stack: commands to run on scope exit (LIFO).

Implementations

impl ShellExecutor

pub fn new() -> ShellExecutor

pub fn enter_posix_mode(&mut self)

Enter POSIX strict mode — drop all SQLite caches, shrink worker pool to minimum. No zsh extensions, no caching, no threads beyond the bare minimum. Dinosaur mode.

pub fn run_hooks(&mut self, hook_name: &str)

Run hook functions (precmd, preexec, chpwd, etc.)

pub fn add_hook(&mut self, hook_name: &str, func_name: &str)

Add a function to a hook

pub fn add_named_dir(&mut self, name: &str, path: &str)

Add a named directory (hash -d name=path)

pub fn expand_tilde_named(&self, path: &str) -> String

Expand ~ with named directories

pub fn autoload_function(&mut self, name: &str) -> Option<ShellCommand>

Try to load a function from ZWC files in fpath

pub fn add_fpath(&mut self, path: PathBuf)

Add a directory to fpath

pub fn glob_match_static(s: &str, pattern: &str) -> bool

Static glob match — same logic as glob_match but callable without &self, needed for Rayon parallel iterators that can’t capture &self.

pub fn execute_script_file(&mut self, file_path: &str) -> Result<i32, String>

Execute a script file with bytecode caching — skips lex+parse+compile on cache hit. The AST is stored in SQLite keyed by (path, mtime).

pub fn execute_script(&mut self, script: &str) -> Result<i32, String>

pub fn execute_command(&mut self, cmd: &ShellCommand) -> Result<i32, String>

pub fn maybe_autoload(&mut self, name: &str) -> bool

Check if a function is autoload pending and load it if so

impl ShellExecutor

pub fn run_trap(&mut self, signal: &str)

Execute trap handlers for a signal

pub fn drain_compinit_bg(&mut self)

Non-blocking drain of background compinit results. Call this before any completion lookup (prompt, tab-complete, etc.). If the background thread hasn’t finished yet, this is a no-op.

pub fn zfork(&mut self, flags: ForkFlags) -> Result<ForkResult, Error>

Fork a new process Port of zfork() from exec.c

pub fn zexecve(&self, cmd: &str, args: &[String]) -> !

Execute a command in the current process (exec family) Port of zexecve() from exec.c

pub fn entersubsh(&mut self, flags: SubshellFlags)

Enter a subshell Port of entersubsh() from exec.c

pub fn doshfunc( &mut self, name: &str, func: &ShellCommand, args: &[String], ) -> Result<i32, String>

Execute a shell function Port of doshfunc() from exec.c

pub fn execarith(&mut self, expr: &str) -> i32

Execute arithmetic expression Port of execarith() from exec.c

pub fn execcond(&mut self, cond: &CondExpr) -> i32

Execute conditional expression Port of execcond() from exec.c

pub fn exectime(&mut self, cmd: &ShellCommand) -> Result<i32, String>

Execute command and capture time Port of exectime() from exec.c

pub fn findcmd(&self, name: &str, do_hash: bool) -> Option<String>

Find command in PATH Port of findcmd() from exec.c

pub fn hashcmd(&mut self, name: &str, path: &str)

Hash a command (add to command hash table) Port of hashcmd() from exec.c

pub fn iscom(&self, name: &str) -> bool

Check if command exists and is executable Port of iscom() from exec.c

pub fn closem(&self, exceptions: &[i32])

Close all file descriptors except stdin/stdout/stderr Port of closem() from exec.c

pub fn mpipe(&self) -> Result<(i32, i32), Error>

Create a pipe Port of mpipe() from exec.c

pub fn addfd( &self, fd: i32, target_fd: i32, mode: RedirMode, ) -> Result<(), Error>

Add a file descriptor for redirection Port of addfd() from exec.c

pub fn gethere(&mut self, terminator: &str, strip_tabs: bool) -> String

Get heredoc content Port of gethere() from exec.c

pub fn getherestr(&mut self, word: &str) -> String

Get herestring content Port of getherestr() from exec.c

pub fn resolvebuiltin(&self, name: &str) -> Option<BuiltinType>

Resolve a builtin command Port of resolvebuiltin() from exec.c

pub fn cancd(&self, path_str: &str) -> bool

Check if cd is possible Port of cancd() from exec.c

pub fn commandnotfound(&mut self, name: &str, args: &[String]) -> i32

Command not found handler Port of commandnotfound() from exec.c

Trait Implementations

impl Default for ShellExecutor

fn default() -> ShellExecutor

Returns the “default value” for a type.