Function apply_patch_file 

pub fn apply_patch_file(
    patch_path: impl AsRef<Path>,
    install_root: impl AsRef<Path>,
) -> ApplyResult<()>

One-shot: open patch_path and apply every chunk to install_root with all defaults.

Equivalent to:

let reader = zipatch_rs::open_patch(patch_path)?;
zipatch_rs::ApplyConfig::new(install_root).apply_patch(reader)?;

The returned ApplyResult surfaces parsing failures as ApplyError::Parse and apply-side failures as their respective ApplyError variants, so a single match arm covers both layers.

Use the two-step form (open_patch + ApplyConfig::apply_patch) when you need to install an ApplyObserver, a apply::CheckpointSink, a custom apply::Vfs, a non-default Platform, or to reuse one ApplySession across multiple patches.

Errors

Returns the first failure surfaced by either layer:

• ApplyError::Parse wrapping a ParseError for header, chunk, or stream-shape problems (including the initial file open).
• ApplyError::Io for filesystem failures against install_root.
• ApplyError::UnsupportedPlatform if the patch declares a platform this build does not know how to resolve SqPack paths for.

Example

zipatch_rs::apply_patch_file(
    "H2017.07.11.0000.0000a.patch",
    "/opt/ffxiv/game",
).unwrap();