Struct SimplePipe 

pub struct SimplePipe { /* private fields */ }

A simple pipe that executes a shell command with input on stdin.

Security Warning

The command string is passed directly to the shell (sh -c on Unix, cmd /C on Windows). If you construct the command from untrusted input, you risk shell injection attacks.

// DANGEROUS if `user_input` is untrusted:
SimplePipe::new(format!("grep {}", user_input))

// SAFE alternatives:
// 1. Use a fixed command string
SimplePipe::new("grep pattern")

// 2. Validate/sanitize user input before interpolation
let sanitized = sanitize_for_shell(user_input);
SimplePipe::new(format!("grep {}", sanitized))

Implementations

impl SimplePipe

pub fn new(command: impl Into<String>) -> Self

Create a new pipe that executes the given shell command.

The default mode is PipeMode::Passthrough with a 30-second timeout.

Security

See the struct-level documentation for shell injection warnings.

pub fn capture(self) -> Self

Use the command’s stdout as the new output.

pub fn consume(self) -> Self

Don’t print anything to the terminal after piping.

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

Trait Implementations

impl PipeTarget for SimplePipe

fn pipe(&self, input: &str) -> Result<String, PipeError>

Pipe the input to the target and return the resulting output.