Enum ErrorKind 

#[non_exhaustive]
pub enum ErrorKind {
    Network,
    Metadata,
    Verification,
    Location,
    Permission,
    Install,
    Unsupported,
    Cancelled,
    Other,
}

The broad class of an Error, stable enough to drive user interface decisions: which message to show, and whether retrying can help.

Error::kind and UpdateError::kind return the same classification. A typical user interface reacts like this:

Kind	Typical user interface
Network	“Try again later”
Metadata	“Contact the developer”
Verification	A security warning; do not offer a retry
Location	“Move the app to Applications”
Permission	“Ask an administrator”, or a manual download
Install	A manual download link
Unsupported	A manual download link
Cancelled	Nothing
Other	Show the message

Location and Permission come before anything is downloaded; see check_location.

Marked #[non_exhaustive]: 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.

Network

The network failed: DNS, connect, timeout, or a non-success HTTP status. Retrying later may help.

Metadata

The release metadata is malformed or lists no artifact for this platform. The publisher has to fix it.

Verification

The update failed an integrity, authenticity, or transport-security check, or the policy requires a check the release cannot satisfy. Do not install it.

Location

The app runs from a location it cannot update in place, such as a disk image or an App Translocation path. Moving the app fixes it.

Permission

The current user may not write where the update must go.

Install

Installing failed for another reason.

Unsupported

This platform or artifact type has no install strategy.

Cancelled

The operation was cancelled on request.

Other

Anything else, such as a local I/O error.

Trait Implementations

impl Clone for ErrorKind

fn clone(&self) -> ErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorKind

impl Debug for ErrorKind

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

Formats the value using the given formatter.

impl Eq for ErrorKind

impl Hash for ErrorKind

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ErrorKind

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ErrorKind