Enum ParseError 

#[non_exhaustive]
pub enum ParseError {
    Io {
        source: Error,
    },
    InvalidMagic,
    UnknownChunkTag(ChunkTag),
    UnknownSqpkCommand(u8),
    ChecksumMismatch {
        tag: ChunkTag,
        expected: u32,
        actual: u32,
    },
    InvalidField {
        context: &'static str,
    },
    OversizedChunk(usize),
    UnknownFileOperation(u8),
    Utf8Error(FromUtf8Error),
    Decompress {
        source: Error,
    },
    Decode {
        context: &'static str,
        message: String,
    },
    NegativeFileOffset(i64),
    TruncatedPatch,
}

Failures produced by the parsing layer (crate::chunk).

Surfaced by crate::ZiPatchReader::new, crate::open_patch, and crate::ZiPatchReader::next_chunk. None of these variants involve the filesystem of the install target — they describe shapes the parser rejected.

#[non_exhaustive]: parse-error vocabulary grows as the parser surfaces new structural failure modes.

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.

Io

I/O failure reading from the patch source.

Fields

source: Error

Underlying std::io::Error from the patch source.

InvalidMagic

The 12-byte ZiPatch magic header was missing or did not match.

UnknownChunkTag(ChunkTag)

A 4-byte chunk tag was not recognised by the parser.

UnknownSqpkCommand(u8)

A SQPK sub-command byte was not recognised by the parser.

ChecksumMismatch

A chunk’s recorded CRC32 did not match the computed CRC32.

Fields

tag: ChunkTag

Tag of the chunk whose checksum failed.

expected: u32

CRC32 stored in the patch file.

actual: u32

CRC32 computed over the actual chunk bytes.

InvalidField

A field value failed a parser invariant (e.g. negative size).

Fields

context: &'static str

Human-readable description of which field was invalid and why.

OversizedChunk(usize)

A chunk declared a size larger than the parser’s maximum (512 MiB).

UnknownFileOperation(u8)

A SqpkFile operation byte was not recognised.

Utf8Error(FromUtf8Error)

A UTF-8 decode failed when reading a path or name field.

Decompress

DEFLATE decompression of a SqpkCompressedBlock payload failed.

Surfaced both by the standalone SqpkCompressedBlock::decompress_into helper (a parse-side API on the chunk type) and propagated up through apply when the apply layer drives block decompression.

Fields

source: Error

Underlying std::io::Error returned by the decompressor.

Decode

A binary decode (via the underlying binrw parser) failed.

The third-party error type is not exposed in this variant — only the field context (where parsing failed) and the formatted message (what went wrong) are surfaced. Callers should treat this as an opaque “the wire format was malformed at this field” signal.

Fields

context: &'static str

Static description of which field or chunk failed to decode.

message: String

Formatted message from the underlying decoder.

NegativeFileOffset(i64)

A SqpkFile carried a negative file_offset that cannot be applied.

TruncatedPatch

Stream ended without an EOF_ chunk; download or copy was truncated.

Trait Implementations

impl Debug for ParseError

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

Formats the value using the given formatter.

impl Display for ParseError

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

Formats the value using the given formatter.

impl Error for ParseError

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 ParseError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ParseError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for ParseError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for ApplyError

fn from(source: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(source: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseError> for IndexError

fn from(source: ParseError) -> Self

Converts to this type from the input type.