Enum SqpkCommand 

#[non_exhaustive]
pub enum SqpkCommand {
    AddData(Box<SqpkAddData>),
    DeleteData(SqpkDeleteData),
    ExpandData(SqpkExpandData),
    Header(SqpkHeader),
    TargetInfo(SqpkTargetInfo),
    File(Box<SqpkFile>),
    Index(SqpkIndex),
    PatchInfo(SqpkPatchInfo),
}

Sub-command of a SQPK chunk; the variant is selected by the command byte.

Each variant wraps the parsed body of its corresponding sub-command. AddData and File are heap-allocated to keep the enum from inflating the stack when used in iterators — SqpkAddData can carry a large inline data Vec, and SqpkFile carries both a path and a Vec of compressed blocks.

Two variants — Index and PatchInfo — carry metadata consumed by the indexed ZiPatch reader (not yet implemented) and have no direct filesystem effect; their crate::apply::Apply arms return Ok(()) immediately.

Unknown sub-command bytes are never silently ignored: they surface as ZiPatchError::UnknownSqpkCommand during parsing.

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.

AddData(Box<SqpkAddData>)

SQPK A — write a data payload into a .dat file at a block offset, then zero a trailing range of blocks. See SqpkAddData.

DeleteData(SqpkDeleteData)

SQPK D — overwrite a contiguous block range with empty-block markers, logically freeing those blocks in the SqPack archive. See SqpkDeleteData.

ExpandData(SqpkExpandData)

SQPK E — extend a .dat file into previously unallocated space by writing empty-block markers. See SqpkExpandData.

Header(SqpkHeader)

SQPK H — write a 1024-byte SqPack header into a .dat or .index file at offset 0 (version header) or 1024 (secondary header). See SqpkHeader.

TargetInfo(SqpkTargetInfo)

SQPK T — declares the target platform and region for all subsequent path-resolution operations in this patch. See SqpkTargetInfo.

File(Box<SqpkFile>)

SQPK F — file-level operation: add a file from inline block payloads, delete a file, remove all files in an expansion folder, or create a directory tree. See SqpkFile and SqpkFileOperation.

Index(SqpkIndex)

SQPK I — add or remove a single SqPack index entry. Carries the index hash and block location for use by the indexed ZiPatch reader; has no direct apply effect. See SqpkIndex.

PatchInfo(SqpkPatchInfo)

SQPK X — patch install info: status, version, and declared post-patch install size. Metadata only; not applied to the filesystem. See SqpkPatchInfo.

Trait Implementations

impl Apply for SqpkCommand

Dispatch an SqpkCommand to its specific apply function.

• SqpkCommand::TargetInfo — updates ApplyContext::platform in place.
• SqpkCommand::Index and SqpkCommand::PatchInfo — metadata only; returns Ok(()) without touching the filesystem.
• All other variants — delegate to the write/delete functions below.

fn apply(&self, ctx: &mut ApplyContext) -> Result<()>

Apply this chunk to ctx.

impl Clone for SqpkCommand

fn clone(&self) -> SqpkCommand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SqpkCommand

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

Formats the value using the given formatter.

impl PartialEq for SqpkCommand

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

impl StructuralPartialEq for SqpkCommand