Skip to main content

WireFormatError

Enum WireFormatError 

Source
#[non_exhaustive]
pub enum WireFormatError { VersionMismatch { got: u16, expected: u16, }, InvalidMagic, KindMismatch { got: u8, expected: u8, }, UnsupportedKind { kind: u8, }, UnsupportedFlags { flags: u8, }, TypeNameMismatch { got: String, expected: &'static str, }, MalformedHeader(String), Codec(String), }
Expand description

Errors produced by Sassi’s binary wire container.

Sassi values cross runtime and process boundaries inside a fixed binary header followed by a postcard-encoded body. The header captures the wire major, kind discriminator, optional flags, and the cached type name so readers can reject incompatible payloads before touching the body. Postcard’s own error type is intentionally not part of the public surface — its detail is folded into Codec so the wire format can evolve without leaking the codec choice.

Variants (Non-exhaustive)§

This enum is marked as 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.
§

VersionMismatch

The wire major is not understood by this crate.

Fields

§got: u16

Major version found in the wire header.

§expected: u16

Major version this crate can read.

§

InvalidMagic

The byte stream does not start with Sassi’s wire magic.

§

KindMismatch

The byte stream is a different Sassi wire kind than the caller expected.

Fields

§got: u8

Kind byte found in the wire header.

§expected: u8

Kind byte required by the decode path.

§

UnsupportedKind

The byte stream uses a reserved or unsupported wire kind.

Fields

§kind: u8

Reserved or unsupported kind byte.

§

UnsupportedFlags

The byte stream sets flags this crate does not understand.

Fields

§flags: u8

Unsupported flags byte.

§

TypeNameMismatch

The header names a different cached type.

Fields

§got: String

Type name found in the wire header.

§expected: &'static str

Type name required by the decode path.

§

MalformedHeader(String)

The fixed header or variable type-name segment is malformed.

§

Codec(String)

The postcard body failed to encode or decode.

Trait Implementations§

Source§

impl Debug for WireFormatError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for WireFormatError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for WireFormatError

1.30.0 · Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more
Source§

impl From<WireFormatError> for BackendError

Source§

fn from(source: WireFormatError) -> Self

Converts to this type from the input type.
Source§

impl From<WireFormatError> for InsertError

Source§

fn from(source: WireFormatError) -> Self

Converts to this type from the input type.
Source§

impl From<WireFormatError> for PunnuSnapshotError

Source§

fn from(source: WireFormatError) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more