Struct DataSource 

pub struct DataSource<'a>(/* private fields */);

The input to a wrapped operation: anything this crate knows how to feed into a WIT stream<u8>.

Operation methods take impl Into<DataSource<'_>>, so byte slices, owned buffers, and streams received from other components all work directly:

• &[u8], &[u8; N], Vec<u8>, &Vec<u8>, Cow<'a, [u8]> — buffered sources. Owned data is moved and written whole, never copied; borrowed data is fed chunk by chunk through one reusable buffer, so a large input is never duplicated whole (the ABI’s per-chunk copy into an owned buffer is unavoidable).
• StreamReader<u8> — passed through to the operation as-is, without buffering.
• DataSource::from_buf (feature bytes) — fed chunk by chunk.
• DataSource::from_reader (feature futures-io) — pumped incrementally; read failures surface as Error::Read.

Warning: truncating producers

Dropping a stream’s writer is its only end-of-input signal and carries no verdict, so a producer that fails midway is indistinguishable on the wire from one that finished — the operation correctly computes over the delivered prefix. Buffer-backed sources own their whole input and are immune. For a StreamReader<u8> fed by another component, convey completeness in-band (e.g. length framing) or discard the result on producer failure. A DataSource::from_reader source is handled for you: its failure is observed locally and reported as Error::Read instead of the operation’s result.

Trait Implementations

impl<'a> From<&'a [u8]> for DataSource<'a>

fn from(data: &'a [u8]) -> Self

Converts to this type from the input type.

impl<'a, const N: usize> From<&'a [u8; N]> for DataSource<'a>

fn from(data: &'a [u8; N]) -> Self

Converts to this type from the input type.

impl<'a> From<&'a Vec<u8>> for DataSource<'a>

fn from(data: &'a Vec<u8>) -> Self

Converts to this type from the input type.

impl<'a> From<Cow<'a, [u8]>> for DataSource<'a>

fn from(data: Cow<'a, [u8]>) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for DataSource<'_>

fn from(data: Vec<u8>) -> Self

Converts to this type from the input type.