Enum StorageError 

pub enum StorageError {
    Failure(StorageFailure),
    Caused {
        failure: StorageFailure,
        source: Box<dyn Error + Sync + Send>,
    },
    Provider {
        provider: CloudProvider,
        failure: StorageFailure,
        source: Box<dyn Error + Sync + Send>,
    },
    Cleanup {
        operation: Box<StorageError>,
        cleanup: Box<StorageError>,
    },
    Bug(Bug),
}

A storage error preserves its cause without converting it into text.

Variants

Failure(StorageFailure)

A classified failure with no underlying native error.

Caused

A classified local failure with its diagnostic or native cause.

Fields

failure: StorageFailure

The failure the app can act on.

source: Box<dyn Error + Sync + Send>

The diagnostic or original error.

Provider

A provider failure, classified for the app, with its original cause.

Fields

provider: CloudProvider

Provider that failed.

failure: StorageFailure

Actionable classification.

source: Box<dyn Error + Sync + Send>

Original transport, SDK or framework error.

Cleanup

Cleanup failed too; neither cause is hidden.

Fields

operation: Box<StorageError>

The original failure.

cleanup: Box<StorageError>

Failure removing temporary data or recording the failed upload state.

Bug(Bug)

Coven’s work for the request panicked: a bug, which the caller reports (E15). Its failure is StorageFailure::Bug.

Implementations

impl StorageError

pub fn failure(&self) -> StorageFailure

What the app can do about this failure.

pub fn own_failure(&self) -> Option<StorageFailure>

The failure when the request alone failed: none when its cleanup failed too, which leaves state behind that a caller handling the failure itself, such as an occupied path or a throttled request, doesn’t know of.

pub fn answered(&self) -> bool

Whether the provider answered the request behind this failure, even with an error (E5). Network alone cannot say: a server’s error response is an answer; a refused connection or a timeout is not.

pub fn refused(&self) -> bool

Whether the provider answered this request with a refusal, so it stored nothing. A timeout, or a lost, malformed or server-failure reply, leaves the outcome unknown. The clients resend a request only after a refusal (a rejected token, a skewed clock), so no earlier attempt of it stored anything either.

pub fn retryable(&self) -> bool

Transport interruptions and provider throttling invite retry.

Trait Implementations

impl CarriesBug for StorageError

fn bug(&self) -> Option<&Bug>

The bug this error carries, itself or through the failure it keeps.

impl Debug for StorageError

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

Formats the value using the given formatter.

impl Display for StorageError

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

Formats the value using the given formatter.

impl Error for StorageError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Bug> for StorageError

fn from(source: Bug) -> StorageError

Converts to this type from the input type.

impl From<Error> for StorageError

A code’s storage part that the format’s primitives refuse: truncated, trailing bytes, an unknown tag or a length past its bound (format.md D13).

fn from(error: Error) -> StorageError

Converts to this type from the input type.

impl From<FileError> for StorageError

fn from(error: FileError) -> StorageError

Converts to this type from the input type.

impl From<PathError> for StorageError

fn from(error: PathError) -> StorageError

Converts to this type from the input type.

impl From<StorageError> for FileReadError

fn from(error: StorageError) -> FileReadError

Converts to this type from the input type.

impl From<StorageError> for OAuthError

fn from(source: StorageError) -> OAuthError

Converts to this type from the input type.

impl From<StorageError> for StorageCheckError

fn from(error: StorageError) -> StorageCheckError

Converts to this type from the input type.

impl From<StorageError> for StorageSetupError

fn from(error: StorageError) -> Self

Converts to this type from the input type.

impl From<StorageError> for StoreKeyUnlockError

fn from(error: StorageError) -> Self

Converts to this type from the input type.

impl From<StorageError> for SyncError

fn from(error: StorageError) -> SyncError

Converts to this type from the input type.

impl From<StorageFailure> for StorageError

fn from(failure: StorageFailure) -> StorageError

Converts to this type from the input type.