Struct ByteStream 

pub struct ByteStream { /* private fields */ }

An upload body with explicit length, integrity, and replay semantics.

Byte and file bodies are replayable. A caller-provided stream is one-shot and requires both its exact content length and SHA-256 digest so the client never buffers it or silently switches to unsigned payloads.

Implementations

impl ByteStream

pub fn from_bytes(bytes: impl Into<Bytes>) -> Self

Creates a replayable in-memory body.

pub fn from_path(path: impl AsRef<Path>) -> Self

Creates a replayable file body.

The explicitly supplied file is copied into a private disk-backed snapshot while it is hashed. Every retry reads that immutable snapshot, so changes to the original path cannot alter the signed upload bytes.

pub fn from_stream<S>(stream: S, length: u64, sha256: [u8; 32]) -> Self

where S: Stream<Item = Result<Bytes, Error>> + Send + 'static,

Creates a one-shot stream with a caller-supplied exact digest.

The stream is never retried. sha256 is the digest of exactly length bytes and is used for SigV4 payload signing.

Trait Implementations

impl Debug for ByteStream

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

Formats the value using the given formatter.

impl From<&'static [u8]> for ByteStream

fn from(value: &'static [u8]) -> Self

Converts to this type from the input type.

impl From<Bytes> for ByteStream

fn from(value: Bytes) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for ByteStream

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

Converts to this type from the input type.