Struct NativeRunner 

pub struct NativeRunner;

Native process runner using std::process::Command.

NativeRunner provides secure process execution using argv-style APIs only. It is the primary implementation of ProcessRunner for native execution without shell interpretation.

Security

NativeRunner enforces the following security properties:

• Uses Command::new().args() only - NO shell string evaluation
• Arguments are passed as discrete OsString elements
• No sh -c or cmd /C shell invocation
• Shell metacharacters in arguments are NOT interpreted

Threading

NativeRunner is a synchronous interface. It internally uses a thread-based approach for timeout handling to avoid exposing async in the public API. This aligns with NFR-ASYNC requirements.

Example

use xchecker_utils::runner::{NativeRunner, ProcessRunner, CommandSpec};
use std::time::Duration;

let runner = NativeRunner::new();
let cmd = CommandSpec::new("echo")
    .arg("hello")
    .arg("world");

let output = runner.run(&cmd, Duration::from_secs(30)).unwrap();
assert!(output.success());

Implementations

impl NativeRunner

pub const fn new() -> Self

Create a new NativeRunner.

Example

use xchecker_utils::runner::NativeRunner;

let runner = NativeRunner::new();

Trait Implementations

impl Clone for NativeRunner

fn clone(&self) -> NativeRunner

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NativeRunner

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

Formats the value using the given formatter.

impl Default for NativeRunner

fn default() -> NativeRunner

Returns the “default value” for a type.

impl ProcessRunner for NativeRunner

fn run( &self, cmd: &CommandSpec, timeout: Duration, ) -> Result<ProcessOutput, RunnerError>

Execute a command natively using argv-style APIs.

This implementation:

• Uses Command::new().args() only (no shell)
• Handles timeout via thread-based waiting
• Captures stdout and stderr
• Returns exit code or timeout error

Arguments

• cmd - The command specification to execute
• timeout - Maximum duration to wait for the process to complete

Returns

• Ok(ProcessOutput) - The process completed (possibly with non-zero exit code)
• Err(RunnerError::Timeout) - The process timed out
• Err(RunnerError::NativeExecutionFailed) - Failed to spawn or wait for process

Security

This method uses CommandSpec::to_command() which builds a Command using Command::new().args() only. No shell string evaluation occurs.

impl Copy for NativeRunner