Enum PartSource 

#[non_exhaustive]
pub enum PartSource {
    Patch {
        patch_idx: u32,
        offset: u64,
        kind: PatchSourceKind,
        decoded_skip: u16,
    },
    Zeros,
    EmptyBlock {
        units: u32,
    },
    Unavailable,
}

Where a Region’s bytes come from.

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.

Patch

Bytes live in the source patch file at Plan::patches[patch_idx]. offset is absolute within that patch file, not chunk-relative — the builder has already added the chunk’s body position. kind selects raw vs DEFLATE-encoded.

Fields

patch_idx: u32

Index into Plan::patches selecting which patch file holds the bytes.

offset: u64

Absolute byte offset within the patch file where the source bytes begin.

kind: PatchSourceKind

How the source bytes are encoded at that offset.

decoded_skip: u16

For PatchSourceKind::Deflated sources only: bytes to skip in the decompressed output before writing this region. Always 0 for PatchSourceKind::Raw. Used when a single DEFLATE block is split across two regions by a cross-patch overlap — both halves share (patch_idx, offset, kind) but slice the decompressed output differently.

Zeros

Region is a run of zero bytes (e.g. an SqpkAddData block_delete_number trailing zero-fill).

EmptyBlock

Region is the canonical SqPack empty-block payload covering units 128-byte blocks (SqpkDeleteData / SqpkExpandData).

Fields

units: u32

Number of 128-byte SqPack blocks (total length = units * 128).

Unavailable

Region exists in the plan but its source bytes are not reachable from the PatchSource the applier will be given. The builder does not emit this variant from any in-tree chunk parser; it is provided for hand-constructed plans (or deserialized plans) that intentionally name a region without backing bytes. crate::index::IndexApplier::execute surfaces these as crate::ZiPatchError::IndexSourceUnavailable, and crate::index::Verifier always flags them as needing repair.

Trait Implementations

impl Clone for PartSource

fn clone(&self) -> PartSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PartSource

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

Formats the value using the given formatter.

impl PartialEq for PartSource

fn eq(&self, other: &PartSource) -> 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 PartSource

impl StructuralPartialEq for PartSource