Enum MetadataError 

#[non_exhaustive]
pub enum MetadataError {
    DuplicateName(String),
    VarNotFound(VarId),
    ProjectNotFound(ProjectId),
    Invalid(String),
    KindMismatch {
        id: VarId,
        expected: VarKind,
        actual: VarKind,
    },
    Backend(String),
}

Errors that can occur while interacting with a MetadataStore.

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.

DuplicateName(String)

A variable with the given name already exists in the registry.

VarNotFound(VarId)

No variable with the given identifier was found.

ProjectNotFound(ProjectId)

No project with the given identifier was found.

Invalid(String)

A value supplied to the metadata layer failed a domain invariant.

KindMismatch

An operation that requires a specific VarKind (e.g. storing a plain value) was invoked on a variable of the wrong kind.

This guards against secrets accidentally flowing into the plain-value side table — every backend must enforce this rule, never silently accept a kind mismatch.

Fields

id: VarId

Identifier of the offending variable.

expected: VarKind

The kind the operation expected.

actual: VarKind

The kind the variable actually has.

Backend(String)

The underlying storage backend reported an unexpected failure.

Backend implementors MUST NOT include secret material, variable values, or absolute paths that disclose the user’s home directory in this string. Wrap raw backend errors with a category label (e.g. "sqlite write failed") rather than format!("{e}") that may propagate parameter values from a failed query.

Trait Implementations

impl Debug for MetadataError

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

Formats the value using the given formatter.

impl Display for MetadataError

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

Formats the value using the given formatter.

impl Error for MetadataError

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<MetadataError> for CoreError

fn from(source: MetadataError) -> Self

Converts to this type from the input type.