Struct Tool 

pub struct Tool { /* private fields */ }

Builder for running companion tools.

Implementations

impl Tool

pub fn new(program: &str) -> Self

Create a new tool invocation.

pub fn new_process_group(self) -> Self

Spawn the subprocess in a new process group so it survives a SIGTERM sent to the parent’s process group. Use this for cleanup subprocesses (e.g. bus claims release) that are spawned from a signal handler.

On non-Unix platforms this is a no-op (the flag is ignored).

pub fn arg(self, arg: &str) -> Self

Add a single argument.

pub fn args(self, args: &[&str]) -> Self

Add multiple arguments.

pub fn timeout(self, duration: Duration) -> Self

Set a timeout for the subprocess.

pub fn in_workspace(self, workspace: &str) -> Result<Self>

Wrap this command with maw exec <workspace> --.

Validates that the workspace name matches [a-z0-9][a-z0-9-]* to prevent argument confusion with the maw CLI.

pub fn run(&self) -> Result<RunOutput>

Run the tool, capturing stdout and stderr.

pub fn run_ok(&self) -> Result<RunOutput>

Run the tool and return an error if it fails.