Struct OsSubprocessRuntime 

pub struct OsSubprocessRuntime { /* private fields */ }

Default implementation using std::process::Command.

Implementations

impl OsSubprocessRuntime

pub fn new() -> OsSubprocessRuntime

Create a new OS subprocess runtime with no timeout.

pub fn with_timeout(timeout_secs: u64) -> OsSubprocessRuntime

Create a new OS subprocess runtime with the given wall-clock timeout.

If the subprocess does not complete within timeout_secs seconds the call returns a SubprocessError with a “timed out” message. The spawned process is left for the OS to reap — it is not explicitly killed.

Stdin size caveat

Stdin data is written synchronously before the timeout poll loop begins. If the subprocess hangs before consuming stdin and the data exceeds the OS pipe buffer (~64 KiB on Linux), run_command will block in the write phase and the timeout will not fire. For typical Perl source files this is not a concern.

Panics

Panics if timeout_secs is zero (a zero-second timeout would time out every command immediately and is almost certainly a caller bug).

Trait Implementations

impl Default for OsSubprocessRuntime

Available on non-WebAssembly only.

fn default() -> OsSubprocessRuntime

Returns the “default value” for a type.

impl SubprocessRuntime for OsSubprocessRuntime

Available on non-WebAssembly only.

fn run_command( &self, program: &str, args: &[&str], stdin: Option<&[u8]>, ) -> Result<SubprocessOutput, SubprocessError>

Execute a command with the given arguments and optional stdin.