Enum CloudHomeError 

pub enum CloudHomeError {
    NotFound(String),
    AlreadyExists(String),
    SlotCollision(String),
    Configuration(String),
    Transport(String),
    Backend {
        kind: StorageBackendFailure,
        operation: String,
        source: Box<dyn Error + Send + Sync>,
    },
    CleanupFailed {
        operation: Box<CloudHomeError>,
        cleanup: Box<CloudHomeError>,
    },
    UnresolvedOutcome {
        operation: Box<CloudHomeError>,
        settlement: Box<CloudHomeError>,
    },
    Io(Error),
    Local(FileError),
    BlobSource(StorageError),
    Protocol(StorageError),
    InvalidBlobSource(String),
}

Errors from raw cloud storage operations.

Variants

NotFound(String)

AlreadyExists(String)

SlotCollision(String)

Configuration(String)

The cloud home is misconfigured or its credentials are missing or invalid: a bucket/folder/drive that isn’t set, credentials absent from the keyring, a provider unsupported by this build, OAuth that needs re-authorization. The user must fix the configuration; retrying the same operation cannot succeed.

Transport(String)

The cloud backend or the network to it failed: a request error, a non-2xx status, a malformed response. Transient — a later attempt may succeed.

Backend

Fields

kind: StorageBackendFailure

operation: String

source: Box<dyn Error + Send + Sync>

CleanupFailed

Fields

operation: Box<CloudHomeError>

cleanup: Box<CloudHomeError>

UnresolvedOutcome

Fields

operation: Box<CloudHomeError>

settlement: Box<CloudHomeError>

Io(Error)

Local(FileError)

BlobSource(StorageError)

Protocol(StorageError)

InvalidBlobSource(String)

Implementations

impl CloudHomeError

pub fn backend( kind: StorageBackendFailure, operation: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

pub fn configuration( operation: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

pub fn transport( operation: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

pub fn is_retryable(&self) -> bool

Whether the failure is transient — worth retrying the operation unchanged — or a fault that will not resolve until the missing object appears or the user fixes the configuration. A transport or local-I/O failure is transient (true); a missing object, a misconfiguration, or absent/invalid credentials are not (false).

pub fn backend_failure(&self) -> Option<StorageBackendFailure>

pub fn cleanup_causes(&self) -> Option<(&CloudHomeError, &CloudHomeError)>

Trait Implementations

impl Debug for CloudHomeError

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

Formats the value using the given formatter.

impl Display for CloudHomeError

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

Formats the value using the given formatter.

impl Error for CloudHomeError

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<CloudHomeError> for CloudFileReadError

fn from(source: CloudHomeError) -> Self

Converts to this type from the input type.

impl From<CloudHomeError> for StorageError

fn from(e: CloudHomeError) -> Self

Converts to this type from the input type.

impl From<CloudHomeError> for StorageSetupError

fn from(source: CloudHomeError) -> Self

Converts to this type from the input type.

impl From<Error> for CloudHomeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FileError> for CloudHomeError

fn from(source: FileError) -> Self

Converts to this type from the input type.

impl From<StorageError> for CloudHomeError

Slot and reference validation lives on the protocol values and reports coven_protocol::objects::StorageError; provider code folds it into its own configuration vocabulary.

fn from(error: StorageError) -> Self

Converts to this type from the input type.