Struct RustBash 

pub struct RustBash { /* private fields */ }

A sandboxed bash shell interpreter.

Implementations

impl RustBash

pub fn exec(&mut self, input: &str) -> Result<ExecResult, RustBashError>

Execute a shell command string and return the result.

pub fn cwd(&self) -> &str

Returns the current working directory.

pub fn last_exit_code(&self) -> i32

Returns the exit code of the last executed command.

pub fn should_exit(&self) -> bool

Returns true if the shell received an exit command.

pub fn command_names(&self) -> Vec<&str>

Returns the names of all registered commands (builtins + custom).

pub fn command_meta(&self, name: &str) -> Option<&'static CommandMeta>

Returns the CommandMeta for a registered command, if it provides one.

pub fn set_shell_name(&mut self, name: String)

Sets the shell name ($0).

pub fn set_positional_params(&mut self, params: Vec<String>)

Sets the positional parameters ($1, $2, …).

pub fn fs(&self) -> &Arc<dyn VirtualFs>

Returns a reference to the virtual filesystem.

pub fn write_file(&self, path: &str, content: &[u8]) -> Result<(), VfsError>

Write a file to the virtual filesystem, creating parent directories.

pub fn read_file(&self, path: &str) -> Result<Vec<u8>, VfsError>

Read a file from the virtual filesystem.

pub fn mkdir(&self, path: &str, recursive: bool) -> Result<(), VfsError>

Create a directory in the virtual filesystem.

pub fn exists(&self, path: &str) -> bool

Check if a path exists in the virtual filesystem.

pub fn readdir(&self, path: &str) -> Result<Vec<DirEntry>, VfsError>

List entries in a directory.

pub fn stat(&self, path: &str) -> Result<Metadata, VfsError>

Get metadata for a path.

pub fn remove_file(&self, path: &str) -> Result<(), VfsError>

Remove a file from the virtual filesystem.

pub fn remove_dir_all(&self, path: &str) -> Result<(), VfsError>

Remove a directory (and contents if recursive) from the virtual filesystem.

pub fn register_command(&mut self, cmd: Arc<dyn VirtualCommand>)

Register a custom command.

pub fn exec_with_overrides( &mut self, input: &str, env: Option<&HashMap<String, String>>, cwd: Option<&str>, stdin: Option<&str>, ) -> Result<ExecResult, RustBashError>

Execute a command with per-exec environment and cwd overrides.

Overrides are applied before execution and restored afterward.

pub fn is_input_complete(input: &str) -> bool

Check whether input looks like a complete shell statement.

Returns true when the input can be tokenized and parsed without hitting an “unexpected end-of-input” / unterminated-quote error. Useful for implementing multi-line REPL input.

Note: mirrors the tokenize → parse flow from interpreter::parse().