Struct MultipartStream

pub struct MultipartStream<S, E>
where
    S: Stream<Item = Result<Bytes, E>> + Unpin,
    E: Into<Box<dyn StdError + Send + Sync + 'static>>,
{ /* private fields */ }

The main MultipartStream struct which will contain one or more fields (a stream of streams)

You can construct this given a boundary and a stream of bytes from a server request.

Please Note: If you are reading in a field, you must exhaust the field’s bytes before moving onto the next field

let mut stream = MultipartStream::new(boundary, body.map_ok(|mut buf| {
    let mut ret = BytesMut::with_capacity(buf.remaining());
    ret.put(buf);
    ret.freeze()
}));

while let Ok(Some(mut field)) = stream.try_next().await {
    println!("Field received:{}", field.name().unwrap());
    if let Ok(filename) = field.filename() {
        println!("Field filename:{}", filename);
    }

    while let Ok(Some(bytes)) = field.try_next().await {
        println!("Bytes received:{}", bytes.len());
    }
}

Implementations

impl<S, E> MultipartStream<S, E>

where S: Stream<Item = Result<Bytes, E>> + Unpin, E: Into<Box<dyn StdError + Send + Sync + 'static>>,

pub fn new<I: Into<Bytes>>(boundary: I, stream: S) -> Self

Construct a MultipartStream given a boundary

Trait Implementations

impl<S, E> Stream for MultipartStream<S, E>

where S: Stream<Item = Result<Bytes, E>> + Unpin, E: Into<Box<dyn StdError + Send + Sync + 'static>>,

type Item = Result<MultipartField<S, E>, MultipartError>

Values yielded by the stream.

fn poll_next( self: Pin<&mut Self>, cx: &mut Context<'_>, ) -> Poll<Option<Self::Item>>

Attempt to pull out the next value of this stream, registering the current task for wakeup if the value is not yet available, and returning None if the stream is exhausted.

fn size_hint(&self) -> (usize, Option<usize>)

Returns the bounds on the remaining length of the stream.