Enum DataState

pub enum DataState<T, E: ErrorBounds = Error> {
    None,
    AwaitingResponse(Awaiting<T, E>),
    Present(T),
    Failed(DataStateError<E>),
}

Used to store a type that is not always available and we need to keep polling it to get it ready

Variants

None

Represent no data present and not pending

AwaitingResponse(Awaiting<T, E>)

Represents data has been requested and awaiting it being available

Present(T)

Represents data that is available for use

Failed(DataStateError<E>)

Represents an error that Occurred

Implementations

impl<T, E: ErrorBounds> DataState<T, E>

pub fn egui_start_request<F, R>( &mut self, ui: &mut Ui, fetch_fn: F, ) -> CanMakeProgress

where F: FnOnce() -> R, R: Into<Awaiting<T, E>>,

Calls Self::start_request and adds a spinner if progress can be made

pub fn start_request<F, R>(&mut self, fetch_fn: F) -> CanMakeProgress

where F: FnOnce() -> R, R: Into<Awaiting<T, E>>,

Starts a new request. Only intended to be on Self::None and if state is any other value it returns [CanMakeProgress::UnableToMakeProgress]

pub fn poll(&mut self) -> &mut Self

Convenience method that will try to make progress if in Self::AwaitingResponse and does nothing otherwise. Returns a reference to self for chaining

pub fn egui_poll_mut( &mut self, ui: &mut Ui, error_btn_text: Option<&str>, ) -> Option<&mut T>

Meant to be a simple method to just provide the data if it’s ready or help with UI and polling to get it ready if it’s not.

WARNING: Does nothing if self is Self::None

If a error_btn_text is provided then it overrides the default

pub fn egui_poll( &mut self, ui: &mut Ui, error_btn_text: Option<&str>, ) -> Option<&T>

Wraps Self::egui_poll_mut and returns an immutable reference

pub fn await_data(rx: &mut Awaiting<T, E>) -> Option<Self>

Checks to see if the data is ready and if it is returns a new Self otherwise None.

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

Returns a reference to the inner data if available otherwise None.

NOTE: This function does not poll to get the data ready if the state is still awaiting

pub fn present_mut(&mut self) -> Option<&mut T>

Returns a mutable reference to the inner data if available otherwise None

NOTE: This function does not poll to get the data ready if the state is still awaiting

pub fn is_present(&self) -> bool

Returns true if the data state is Present.

pub fn is_none(&self) -> bool

Returns true if the data state is None.

Trait Implementations

impl<T, E: ErrorBounds> AsMut<DataState<T, E>> for DataState<T, E>

fn as_mut(&mut self) -> &mut DataState<T, E>

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T, E: ErrorBounds> AsRef<DataState<T, E>> for DataState<T, E>

fn as_ref(&self) -> &DataState<T, E>

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: Debug, E: Debug + ErrorBounds> Debug for DataState<T, E>

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

Formats the value using the given formatter.

impl<T, E: ErrorBounds> Default for DataState<T, E>

fn default() -> DataState<T, E>

Returns the “default value” for a type.