Enum ApplyMode 

#[non_exhaustive]
pub enum ApplyMode {
    Write,
    DryRun,
}

Selects whether ApplyContext mutates the filesystem or runs in no-op verification mode.

Default is ApplyMode::Write. Override with ApplyContext::with_mode.

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.

Write

Normal apply: open files for write, truncate, unlink, and create directories as each chunk demands. This is the mode every existing caller has been using implicitly.

DryRun

Walk every chunk end-to-end — resolve paths, decompress every DEFLATE block, validate every chunk-trailer CRC32 — but never open a file for write and never mutate the filesystem. Filesystem reads still happen: RemoveAll’s directory walk still enumerates entries (so a missing or wrong install surfaces as an error), but the fs::remove_file inside is suppressed. ensure_dir_all / create_dir_all are suppressed by the same token — a dry-run will therefore NOT fail just because an expected parent directory is absent, since in Write mode that absence would have been silently corrected by create_dir_all. The trade-off favours “tell me whether this patch will parse and decompress cleanly” over “tell me whether every directory it would have created already exists”.

CRC validation is exercised for free because chunk trailers are validated by crate::ZiPatchReader during parsing; a dry-run that drives the iterator implicitly catches CRC mismatches.

Dry-run does not surface seek/flush failures that a real apply might: the [NullWriter] sink has no backing buffer to flush, so the mid-flush errors a real BufWriter over std::fs::File could raise on seek are absent in this mode.

Trait Implementations

impl Clone for ApplyMode

fn clone(&self) -> ApplyMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ApplyMode

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

Formats the value using the given formatter.

impl PartialEq for ApplyMode

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

impl Eq for ApplyMode

impl StructuralPartialEq for ApplyMode