Enum SourceError 

pub enum SourceError {
    Unavailable {
        name: String,
        reason: String,
    },
    UnsupportedCapability {
        name: String,
        capability: Capabilities,
    },
    BadReference {
        name: String,
        reference: String,
        reason: String,
    },
    Upstream {
        name: String,
        message: String,
    },
    Locked {
        name: String,
    },
    Io {
        name: String,
        source: Error,
    },
}

All the ways a source operation can fail.

Variants

Unavailable

The source’s SecretSource::is_available check returned something other than Available. Caller may retry against a fallback or surface the underlying status.

Fields

name: String

Source name (matches SecretSource::name).

reason: String

Human-readable detail — typically the Display of the underlying SourceStatus variant.

UnsupportedCapability

The router asked the source to do something its SecretSource::capabilities said it could not.

Fields

name: String

Source name.

capability: Capabilities

The capability that was missing.

BadReference

The reference string isn’t well-formed for this backend (e.g. malformed op:// URL, invalid Vault path).

Fields

name: String

Source name.

reference: String

The reference the source rejected.

reason: String

Human-readable detail.

Upstream

The source itself errored (network failure, upstream returned 5xx, plugin subprocess crashed, …).

Fields

name: String

Source name.

message: String

Human-readable detail.

Locked

The source needs an unlock step before it can answer this operation. Typically maps to SourceStatus::Locked.

Fields

name: String

Source name.

Io

I/O error talking to the source (mostly subprocess stdio / socket I/O for plugin-style sources).

Fields

name: String

Source name.

source: Error

Underlying I/O error.

Trait Implementations

impl Debug for SourceError

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

Formats the value using the given formatter.

impl Display for SourceError

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

Formats the value using the given formatter.

impl Error for SourceError

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.