Skip to main content

Executor

kaish_kernel::interpreter

Trait Executor 

Source 
pub trait Executor {
    // Required method
    fn execute(
        &mut self,
        stmts: &[Stmt],
        scope: &mut Scope,
    ) -> EvalResult<ExecResult>;

    // Provided method
    fn file_stat(&self, path: &Path) -> Option<DirEntry> { ... }
}
Expand description

Trait for executing pipelines (command substitution).

This is implemented by higher layers (L6: Pipes & Jobs) to provide actual command execution. The evaluator calls this when it encounters a $(pipeline) expression.

Required Methods§

Source

fn execute( &mut self, stmts: &[Stmt], scope: &mut Scope, ) -> EvalResult<ExecResult>

Execute a command-substitution body — a block of statements (the full grammar: pipelines, &&/|| chains, ;/newline sequences) — and return its combined result.

The executor should:

  1. Run each statement, accumulating stdout/stderr
  2. Carry the last statement’s exit code and structured data through
  3. Return an ExecResult with code, output, and parsed data

Provided Methods§

Source

fn file_stat(&self, path: &Path) -> Option<DirEntry>

Stat a file path through the VFS.

Returns Some(entry) if the path exists, None otherwise. Used by [[ -d path ]], [[ -f path ]], etc.

Default: falls back to std::fs::metadata (bypasses VFS).

Dyn Compatibility§

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§