Enum UpdateStatus 

#[non_exhaustive]
pub enum UpdateStatus {
    Idle,
    Checking,
    UpToDate,
    Available(Version),
    Downloading {
        downloaded: u64,
        total: Option<u64>,
    },
    Installing,
    Staged(Version),
    Errored(UpdateError),
}

Observable state of an update operation.

Idle → Checking → UpToDate | Available(v)
                              → Downloading { downloaded, total } → Installing → Staged(v)
any operation → Errored(error)

Downloading carries live byte counts. A cancelled download returns to Available(v), not Errored.

Marked #[non_exhaustive]: later versions may add states, so match it with a wildcard arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Idle

Nothing has been checked yet.

Checking

A check is in flight.

UpToDate

The running version is the latest.

Available(Version)

A newer version is available to download and install.

Downloading

The update artifact is downloading. total is None until/unless the server reports a Content-Length.

Fields

downloaded: u64

total: Option<u64>

Installing

The download is verified and being swapped into place.

Staged(Version)

The update is installed and ready to launch on restart.

Errored(UpdateError)

The last operation failed. UpdateError::kind says what kind of failure it was; its Display is the message to show.

Implementations

impl UpdateStatus

pub fn is_busy(&self) -> bool

Whether an operation is currently in flight.

Trait Implementations

impl Clone for UpdateStatus

fn clone(&self) -> UpdateStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateStatus

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

Formats the value using the given formatter.

impl Default for UpdateStatus

fn default() -> UpdateStatus

Returns the “default value” for a type.

impl Eq for UpdateStatus

impl PartialEq for UpdateStatus

fn eq(&self, other: &UpdateStatus) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for UpdateStatus