Skip to main content

DownloadStream

Struct DownloadStream 

Source
pub struct DownloadStream { /* private fields */ }
Expand description

A streaming download handle that yields data chunks as they are reconstructed (mirror data_writer/download_stream.rs).

The reconstruction task is spawned at construction but pauses until start is called (or the first next / blocking_next). Data is pulled from the sequential writer’s internal queue, bypassing the synchronous writer thread.

Each call to next()/blocking_next() returns the next sequential chunk, or Ok(None) at end-of-stream or cancellation. Any reconstruction error surfaces on the call that would have returned the next chunk (or on the final None) via the shared run state.

Implementations§

Source§

impl DownloadStream

Source

pub fn start(&mut self)

Unblocks the reconstruction task so it begins producing data.

If already started, this is a no-op. Called automatically on the first next / blocking_next. This method is non-async and does not require a tokio runtime context.

Source

pub async fn next(&mut self) -> Result<Option<Bytes>, SdxError>

Returns the next chunk of downloaded data asynchronously.

Returns Ok(None) when the download is complete or cancelled.

Dropping this future before it completes preserves any pending chunk for the next call. Use cancel to stop the download.

§Errors

Returns SdxError when a background reconstruction task failed.

Source

pub fn blocking_next(&mut self) -> Result<Option<Bytes>, SdxError>

Returns the next chunk of downloaded data, blocking the current thread until data is available.

Returns Ok(None) when the download is complete or cancelled.

§Runtime requirements

This runs the async next on a dedicated multi-threaded runtime owned by the client, so it works from plain CLI threads and from tokio::task::spawn_blocking without panicking (upstream xet-data panics inside an async runtime via blocking_recv). Calling it from within an async context is supported but blocks that executor thread until the next chunk arrives — prefer next there.

§Errors

Returns SdxError when a background reconstruction task failed.

Source

pub fn cancel(&mut self)

Cancels the in-progress (or not-yet-started) download.

Subsequent calls to next / blocking_next return Ok(None).

Trait Implementations§

Source§

impl Drop for DownloadStream

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> DropFlavorWrapper<T> for T

Source§

type Flavor = MayDrop

The DropFlavor that wraps T into Self
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, W> HasTypeWitness<W> for T
where W: MakeTypeWitness<Arg = T>, T: ?Sized,

Source§

const WITNESS: W = W::MAKE

A constant of the type witness
Source§

impl<T> Identity for T
where T: ?Sized,

Source§

const TYPE_EQ: TypeEq<T, <T as Identity>::Type> = TypeEq::NEW

Proof that Self is the same type as Self::Type, provides methods for casting between Self and Self::Type.
Source§

type Type = T

The same type as Self, used to emulate type equality bounds (T == U) with associated type equality constraints (T: Identity<Type = U>).
Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more