Enum CoreStorageError 

#[non_exhaustive]
pub enum CoreStorageError {
    NotFound {
        path: String,
    },
    AlreadyExists {
        path: String,
    },
    CasConflict,
    Io(String),
    Internal(Box<dyn Error + Send + Sync>),
}

Domain error type for all storage port operations.

Adapters map backend-specific errors (e.g., git2::Error, std::io::Error) into these variants before returning. Domain logic never sees infrastructure error types.

Usage:

use auths_core::ports::storage::StorageError;

fn handle(err: StorageError) {
    match err {
        StorageError::NotFound { path } => eprintln!("missing: {path}"),
        StorageError::AlreadyExists { path } => eprintln!("duplicate: {path}"),
        StorageError::CasConflict => eprintln!("concurrent modification"),
        StorageError::Io(msg) => eprintln!("I/O: {msg}"),
        StorageError::Internal(inner) => eprintln!("bug: {inner}"),
    }
}

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.

NotFound

The item was not found.

Fields

path: String

Path of the missing item.

AlreadyExists

An item already exists at this path.

Fields

path: String

Path of the existing item.

CasConflict

Optimistic concurrency conflict; retry the operation.

Io(String)

An I/O error occurred.

Internal(Box<dyn Error + Send + Sync>)

An unexpected internal error.

Implementations

impl StorageError

pub fn not_found(path: impl Display) -> StorageError

Convenience constructor for NotFound.

pub fn already_exists(path: impl Display) -> StorageError

Convenience constructor for AlreadyExists.

pub fn internal(err: impl Error + Send + Sync + 'static) -> StorageError

Convenience constructor wrapping any error as Internal.

Trait Implementations

impl AuthsErrorInfo for StorageError

fn error_code(&self) -> &'static str

Returns a unique error code string for this error variant.

fn suggestion(&self) -> Option<&'static str>

Returns an optional actionable suggestion for resolving the error.

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<KelStorageError> for StorageError

fn from(err: KelStorageError) -> StorageError

Converts to this type from the input type.