Enum PrikkError 

#[non_exhaustive]
pub enum PrikkError {
    CanonicalEncoding(String),
    InvalidObjectId(String),
    InvalidSignature(String),
    InvalidName(String),
    ObjectTypeMismatch {
        expected: String,
        actual: String,
    },
    UnsupportedFormatVersion(u32),
    MalformedData(String),
    Integrity(String),
    LockConflict(String),
    Precondition(String),
    UnsupportedObjectType(String),
    Io {
        kind: Option<ErrorKind>,
        context: String,
    },
}

Error type used by the initial implementation crates.

#[non_exhaustive] (RFC 132 increment 1): prikk-error is published, and until this attribute landed, adding any new variant was a breaking change for every downstream match. Verified free to add before landing it: no exhaustive match on a PrikkError value exists anywhere in this workspace.

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.

CanonicalEncoding(String)

Canonical encoding failed because input data violates the frozen schema contract.

InvalidObjectId(String)

An object identifier had an invalid form.

InvalidSignature(String)

A signature had an invalid form or did not match its envelope context.

InvalidName(String)

A path-like name failed Prikk path/ref validation.

ObjectTypeMismatch

A persistent object had an unexpected type.

Fields

expected: String

The object type required by the caller.

actual: String

The object type actually found in the stored envelope.

UnsupportedFormatVersion(u32)

The persistent format version is unsupported.

MalformedData(String)

A persisted object or record has malformed bytes.

Integrity(String)

A persisted object was found at a path that does not match its computed ID.

LockConflict(String)

A lock could not be acquired because another writer may be active.

Precondition(String)

A caller precondition for the requested operation is not satisfied. Distinct from Self::LockConflict, which means another writer may hold a lock: nothing here is transient and waiting does not help — the caller must change what they asked for.

UnsupportedObjectType(String)

The requested object type cannot be persisted in the requested store.

Io

An I/O failure. kind is Some only when this value was built from a real std::io::Error via From – every explicit construction site elsewhere in the workspace (a caller-precondition violation, a platform-capability refusal, or a validation failure wearing this variant rather than one that describes it) sets kind: None, which is the truth, not a placeholder to “tidy” into something non-optional. RFC 132 increment 2 is expected to move those sites onto variants that describe them and narrow this field.

Fields

kind: Option<ErrorKind>

The underlying std::io::ErrorKind, when this was built from a real std::io::Error.

context: String

Human-readable context. Alone carries the full Display message – see that impl.

Trait Implementations

impl Clone for PrikkError

fn clone(&self) -> PrikkError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PrikkError

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

Formats the value using the given formatter.

impl Display for PrikkError

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

Formats the value using the given formatter.

impl Eq for PrikkError

impl Error for PrikkError

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 PrikkError

fn from(value: Error) -> Self

Converts to this type from the input type.

impl PartialEq for PrikkError

fn eq(&self, other: &PrikkError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PrikkError