Struct TestState 

pub struct TestState {

    pub caps: u32,
    pub vars: HashMap<String, String>,
    pub exported: HashSet<String>,
    pub cwd: PathBuf,
    pub stdout: Vec<u8>,
    pub stderr: Vec<u8>,
    pub files: HashMap<PathBuf, Vec<u8>>,
    pub sandbox_root: Option<PathBuf>,
    pub allow_exec: Vec<CommandPattern>,
    pub exec_log: Vec<ExecRecord>,
    pub set_log: Vec<(String, String)>,
    pub export_log: Vec<(String, String)>,
    pub write_log: Vec<(PathBuf, usize)>,
}

In-memory state behind every TestCtx host import. The runner constructs this from CLI flags or a scenario file, then reads it back after the guest call to format results / evaluate expectations.

Note: the in-memory write paths intentionally skip the validation that the production host’s VarTable::set (and similar) performs (readonly-var rejection, integer-attribute checks, etc.). Test scenarios verifying those guard paths must run against the real shell, not this harness.

Fields

caps: u32

Granted capability bitmask. Same shape as HostContext.capabilities.

vars: HashMap<String, String>

exported: HashSet<String>

cwd: PathBuf

stdout: Vec<u8>

stderr: Vec<u8>

files: HashMap<PathBuf, Vec<u8>>

Virtual filesystem contents (when sandbox_root is None).

sandbox_root: Option<PathBuf>

If set, files:* host imports operate on the real FS scoped to this canonicalised root. Otherwise they operate on files.

allow_exec: Vec<CommandPattern>

commands:exec allowlist. Empty = all denied (PatternNotAllowed).

exec_log: Vec<ExecRecord>

set_log: Vec<(String, String)>

(key, value) pairs the plugin wrote via variables::set during the current step. Reset by the scenario runner between steps.

export_log: Vec<(String, String)>

write_log: Vec<(PathBuf, usize)>

(path, bytes-written) for each files::{write,append}-file call.

Implementations

impl TestState

pub fn with_caps(caps: u32) -> Self

Construct a TestState with the given capability bitmask and every other field at its Default value. Used by per-module unit tests so each module doesn’t have to repeat a local state_with helper.

Trait Implementations

impl Clone for TestState

fn clone(&self) -> TestState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TestState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TestState

fn default() -> TestState

Returns the “default value” for a type.