Enum AsyncValue 

pub enum AsyncValue<T> {
    Idle,
    Loading(Option<T>),
    Ready(T),
    Error(TaskError),
}

The exhaustive state of an asynchronously-loaded value.

Deliberately named for parity with Riverpod’s AsyncValue<T> (Flutter) — the genuine prior art for a load/data/error sum type with exhaustive matching (research §9). The four states are:

• Idle — nothing requested yet.
• Loading — a fetch is in flight. It carries the previous value (Some on a refresh, None on a first load), so a UI can keep showing stale data instead of flickering to a spinner — mirroring Riverpod’s copyWithPrevious.
• Ready — the fetch resolved to a value.
• Error — the fetch failed.

Variants

Idle

No fetch requested yet.

Loading(Option<T>)

A fetch is in flight; carries the previous value for refresh-without-flicker (None on a first load).

Ready(T)

The fetch resolved.

Error(TaskError)

The fetch failed.

Implementations

impl<T> AsyncValue<T>

pub fn is_idle(&self) -> bool

Whether this is Idle.

pub fn is_loading(&self) -> bool

Whether a fetch is in flight.

pub fn is_ready(&self) -> bool

Whether the fetch resolved to a value.

pub fn is_error(&self) -> bool

Whether the fetch failed.

pub fn ready(&self) -> Option<&T>

The resolved value, if Ready.

pub fn value(&self) -> Option<&T>

The best-available value: the resolved one when Ready, or the carried-over previous one while Loading a refresh. This is what a flicker-free UI reads.

pub fn error(&self) -> Option<&TaskError>

The error, if Error.

Trait Implementations

impl<T: Clone> Clone for AsyncValue<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for AsyncValue<T>

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

Formats the value using the given formatter.

impl<T> Default for AsyncValue<T>

fn default() -> Self

Returns the “default value” for a type.