Enum StdinData 

#[non_exhaustive]
pub enum StdinData {
    Bytes(Vec<u8>),
    Reader(Box<dyn Read + Send>),
}

Input data to feed to a child process’s stdin.

Construct via the From impls for bytes/strings, or from_reader / from_async_reader for streaming sources.

Retry and clone semantics

• Bytes: owned. If the Cmd is configured to retry, each attempt re-feeds the same bytes (internally the buffer is Arc-shared for cheap clones).
• Reader: one-shot. The first run attempt consumes the reader; subsequent retries or cloned-then-run attempts see no stdin. Avoid .retry() with a reader unless you understand this.
• AsyncReader: one-shot like Reader. Only usable on the async path (Cmd::run_async / Cmd::spawn_async). Passing it to the sync runner surfaces a RunError::Spawn with ErrorKind::InvalidInput.

Picking the right variant for large inputs

For inputs larger than a few MB, the sync Reader variant streams through an OS pipe without buffering the whole thing in memory. On the async path, Reader would require spawn_blocking to drain the sync reader fully into memory before writing — not suitable for gigabyte-sized inputs. Use from_async_reader with a tokio::fs::File or any other AsyncRead source for async streaming.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Bytes(Vec<u8>)

Owned bytes. Reusable across retries.

Reader(Box<dyn Read + Send>)

One-shot sync reader. The reader only needs Send; it doesn’t have to be Sync because procpilot hands it to at most one thread at a time (via Arc<Mutex<Option<_>>>).

Implementations

impl StdinData

pub fn from_reader<R>(reader: R) -> StdinData

where R: Read + Send + 'static,

Wrap any sync Read source as one-shot streaming stdin.

Trait Implementations

impl Debug for StdinData

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

Formats the value using the given formatter.

impl From<&[u8]> for StdinData

fn from(s: &[u8]) -> StdinData

Converts to this type from the input type.

impl From<&String> for StdinData

fn from(s: &String) -> StdinData

Converts to this type from the input type.

impl From<&Vec<u8>> for StdinData

fn from(v: &Vec<u8>) -> StdinData

Converts to this type from the input type.

impl From<&str> for StdinData

fn from(s: &str) -> StdinData

Converts to this type from the input type.

impl From<String> for StdinData

fn from(s: String) -> StdinData

Converts to this type from the input type.

impl From<Vec<u8>> for StdinData

fn from(v: Vec<u8>) -> StdinData

Converts to this type from the input type.