Enum StorageError 

pub enum StorageError {
    InvalidConfig(String),
    InvalidRequest(String),
    NotYetImplemented {
        note: String,
    },
    UnsupportedCapability {
        capability: String,
        context: String,
    },
    BackendOperation {
        operation: String,
        message: String,
    },
    Serialization(String),
    Io(String),
}

Portable error type returned by the storage Kit.

Portable request families report unsupported backend behavior explicitly instead of synthesizing successful responses. Use StorageError::InvalidRequest for semantically invalid caller input that is already structurally valid Rust.

Examples

let error = storage_kit::StorageError::InvalidRequest(
    "vector value cannot be coerced without precision loss".into(),
);

assert!(error.to_string().contains("invalid request"));

Variants

InvalidConfig(String)

The supplied configuration is structurally invalid.

InvalidRequest(String)

A portable request is structurally valid Rust but semantically invalid.

Vector coercion policy failures and malformed typed requests use this variant before a backend operation is attempted.

NotYetImplemented

The selected backend does not expose the requested operation yet.

Fields

note: String

Human-readable note describing the missing support.

UnsupportedCapability

The backend or mode does not support a requested capability.

Fields

capability: String

Missing or unsupported capability name.

context: String

Additional human-readable context.

BackendOperation

A backend-specific operation failed.

Fields

operation: String

Portable operation label used by the adapter.

message: String

Human-readable backend error message.

Serialization(String)

Serialization or wire-format conversion failed.

Io(String)

Filesystem or OS I/O failed.

Implementations

impl StorageError

pub fn not_yet_implemented(note: impl Into<String>) -> Self

Creates a StorageError::NotYetImplemented value.

Examples

let error = storage_kit::StorageError::not_yet_implemented(
    "retained operation mapping is pending",
);
assert!(matches!(
    error,
    storage_kit::StorageError::NotYetImplemented { .. }
));

pub fn unsupported_capability( capability: impl Into<String>, context: impl Into<String>, ) -> Self

Creates a StorageError::UnsupportedCapability value.

Examples

let error = storage_kit::StorageError::unsupported_capability(
    "FULL_TEXT",
    "selected backend cannot provide this full-text query",
);
assert!(error.to_string().contains("FULL_TEXT"));

pub fn backend_op( operation: impl Into<String>, message: impl Into<String>, ) -> Self

Creates a StorageError::BackendOperation value.

Examples

let error = storage_kit::StorageError::backend_op(
    "query",
    "provider returned an error",
);
let cloned = error.clone();
assert_eq!(error.to_string(), cloned.to_string());

Trait Implementations

impl Clone for StorageError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StorageError

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

Formats the value using the given formatter.

impl Display for StorageError

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

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

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<Error> for StorageError

fn from(value: Error) -> Self

Converts to this type from the input type.