Enum BundleError 

pub enum BundleError {
    Io(Error),
    Json(Error),
    BadMagic {
        expected: String,
        found: String,
    },
    BadVersion {
        found: u32,
        supported: u32,
    },
    MissingManifest(String),
    ChecksumMismatch {
        path: String,
        expected: String,
        actual: String,
    },
    MissingMember(String),
    UnexpectedMember(String),
    UnsafePath(String),
    MalformedStream(String),
    SizeMismatch {
        path: String,
        expected: u64,
        actual: u64,
    },
}

A project-bundle error.

Variants

Io(Error)

An underlying IO error (tar read/write, staging-file read, extraction write).

Json(Error)

The MANIFEST JSON failed to (de)serialize.

BadMagic

The first entry’s magic did not match — not a boatramp project bundle.

Fields

expected: String

The expected magic (BUNDLE_MAGIC).

found: String

What the bundle carried.

BadVersion

The bundle format version is not one this build reads.

Fields

found: u32

The version the bundle declared.

supported: u32

The version this build supports (BUNDLE_FORMAT_VERSION).

MissingManifest(String)

The bundle’s first entry was not the MANIFEST.

ChecksumMismatch

A member’s extracted bytes did not match the manifest checksum.

Fields

path: String

The offending member path.

expected: String

The checksum the manifest recorded.

actual: String

The checksum of the bytes actually in the bundle.

MissingMember(String)

A member named in the manifest was absent from the bundle.

UnexpectedMember(String)

A member present in the bundle was not described by the manifest.

UnsafePath(String)

A member path is unsafe (absolute or contains a ../. traversal component).

MalformedStream(String)

A v2 bundle is structurally malformed — a sidecar without its data member, a member without its preceding sidecar, a mismatched pairing, or a member out of declared order.

SizeMismatch

A member’s streamed byte count did not match the size it declared (sidecar/manifest).

Fields

path: String

The offending member path.

expected: u64

The size the sidecar (v2) or manifest (v1) declared.

actual: u64

The bytes actually streamed.

Trait Implementations

impl Debug for BundleError

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

Formats the value using the given formatter.

impl Display for BundleError

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

Formats the value using the given formatter.

impl Error for BundleError

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 BundleError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for BundleError

fn from(source: Error) -> Self

Converts to this type from the input type.