Struct ChunkRecord 

#[non_exhaustive]
pub struct ChunkRecord {
    pub chunk: Chunk,
    pub tag: ChunkTag,
    pub body_offset: u64,
    pub bytes_read: u64,
}

One chunk yielded by ZiPatchReader::next_chunk together with the stream-position metadata the parser observed while reading it.

Bundling the chunk with its byte-position metadata in one record lets downstream consumers (the apply driver, the crate::index::PlanBuilder, the zipatch dump CLI) avoid a second round of accessor calls against the reader to learn where the chunk sat in the stream. Each field describes one fact the parser knew at the moment the chunk was yielded; see the per-field docs.

#[non_exhaustive]: stream-position metadata may grow (e.g. compressed payload size, header-only byte count) as new index-builder needs surface.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

chunk: Chunk

The parsed chunk itself.

tag: ChunkTag

The 4-byte ASCII wire tag of the chunk (FHDR, SQPK, EOF_, …).

Exposed alongside Self::chunk so consumers can attach the tag to a progress event without re-matching on the Chunk enum.

body_offset: u64

Absolute patch-file offset of the chunk’s body — the byte right after the 8-byte [body_len: u32 BE, tag: [u8; 4]] frame header.

Index builders use this to compute absolute patch-file offsets for SqpkAddData::data, SqpkFile block payloads, and SqpkHeader::header_data without re-walking the stream.

bytes_read: u64

Running total of bytes consumed from the patch stream, including the 12-byte magic header, the chunk this record describes, and every preceding chunk frame.

Equivalent to the crate::ChunkEvent::bytes_read field at the same emission point; used for the bytes_applied / total_patch_size progress-bar ratio.

Trait Implementations

impl Debug for ChunkRecord

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

Formats the value using the given formatter.