Enum PartialFormatErrorKind 

pub enum PartialFormatErrorKind {
    TooShort {
        observed: usize,
        minimum: usize,
    },
    WrongMagic {
        found: [u8; 4],
    },
    WrongVersion {
        expected: u8,
        found: u8,
    },
    Crc,
    ParadigmMismatch {
        expected: u8,
        found: u8,
    },
    KernelMismatch {
        expected: u32,
        found: u32,
    },
    GridMismatch {
        detail: String,
    },
    ParityMismatch {
        expected: u8,
        found: u8,
    },
    RkyvDecode {
        detail: String,
    },
    Internal {
        detail: String,
    },
}

Sub-discriminator for PartialError::Format. The validation pipeline runs cheapest-first, so the variant also indicates how far the validator got before tripping.

Tag stability is part of the public Python surface. The snake_case Self::tag strings appear on the FFI exception’s kind attribute and are asserted against in the parity test suite. Renames require a coordinated stub + test update.

Variants

TooShort

Length too short to contain even the framing header.

Fields

observed: usize

Observed length.

minimum: usize

Minimum required.

WrongMagic

Magic-bytes prefix did not match b"VRPS".

Fields

found: [u8; 4]

First four bytes found.

WrongVersion

format_version byte did not match the receiving rank’s compiled-in crate::envelope::FORMAT_VERSION.

Fields

expected: u8

Compiled-in version.

found: u8

Found in the partial.

Crc

CRC32 footer did not match. Truncation, transport corruption, or hand-crafted payload.

ParadigmMismatch

paradigm_kind byte did not match. Means the partial belongs to a different paradigm (e.g., a semantic partial loaded by an instance evaluator).

Fields

expected: u8

Receiving evaluator’s paradigm.

found: u8

Partial’s declared paradigm.

KernelMismatch

discriminator did not match within a paradigm. For instance: merging a bbox partial into a segm evaluator. Each paradigm defines its own discriminator semantics; the value is opaque to this crate.

The tag "kernel_mismatch" is preserved for backward compatibility with ADR-0031 v1 instance partials.

Fields

expected: u32

Receiving evaluator’s discriminator.

found: u32

Partial’s declared discriminator.

GridMismatch

Header shape_fingerprint did not match. Each paradigm interprets the four u32 slots: instance uses (n_categories, n_area_ranges, n_images, retain_iou), semantic uses (n_classes, 0, n_images, 0), panoptic uses (n_categories, 0, n_images, things_stuff_split).

The tag "grid_mismatch" is preserved for backward compatibility with ADR-0031 v1 instance partials.

Fields

detail: String

Free-form detail naming which slot mismatched.

ParityMismatch

parity_mode byte did not match.

Fields

expected: u8

Receiving evaluator’s parity mode discriminant.

found: u8

Partial’s declared parity mode discriminant.

RkyvDecode

rkyv archive validation refused the payload. Pointer offsets out of range, bad enum tag, etc.

Fields

detail: String

rkyv’s diagnostic message.

Internal

Catch-all for internal-state failures that need to surface through the partial-error vocabulary because they share the FFI exception class but aren’t framing-related: e.g., a background worker that was shut down before the FFI call reached it, or an op invoked after finalize. Distinct from Self::RkyvDecode so users don’t see a misleading “rkyv_decode” tag for a non-archive failure.

Fields

detail: String

Free-form detail. Surfaced on the FFI exception’s kind attribute as the literal "internal" tag.

Implementations

impl PartialFormatErrorKind

pub fn tag(&self) -> &'static str

Stable snake_case identifier for this variant. Surfaced on the FFI exception’s kind attribute. Adding a variant requires adding a tag here — the exhaustive match makes the omission a compile error.

Trait Implementations

impl Clone for PartialFormatErrorKind

fn clone(&self) -> PartialFormatErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PartialFormatErrorKind

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

Formats the value using the given formatter.

impl Display for PartialFormatErrorKind

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

Formats the value using the given formatter.

impl Error for PartialFormatErrorKind

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 PartialEq for PartialFormatErrorKind

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for PartialFormatErrorKind

impl StructuralPartialEq for PartialFormatErrorKind