Struct PlanBuilder 

pub struct PlanBuilder { /* private fields */ }

Accumulating builder for a multi-patch Plan.

Construct via PlanBuilder::new, feed each patch in chain order via PlanBuilder::add_patch, then consume with PlanBuilder::finish. For a one-shot single-patch build, the three-line dance PlanBuilder::new().add_patch(name, reader)?.finish() (the add_patch call returning &mut Self is not supported — use a let mut) is the canonical form; there is no freestanding convenience wrapper.

Implementations

impl PlanBuilder

pub fn new() -> Self

Start a new, empty builder.

pub fn add_patch<R: Read>( &mut self, name: impl Into<String>, reader: ZiPatchReader<R>, ) -> Result<()>

Read reader to completion, appending the patch to the chain.

Mid-chain destructive ops (RemoveAll, DeleteFile, AddFile@file_offset=0) retroactively prune accumulated regions from earlier patches at this point.

Errors

• IndexError::DuplicatePatch if name matches a patch already added to this builder. The chain protocol is order-sensitive; adding the same patch twice is almost always a caller bug.
• Any parser error surfaced by reader.next_chunk().

Panics

Panics if the chain grows past u32::MAX patches.

pub fn finish(self) -> Plan

Consume the builder and return the accumulated Plan.

Emits a single info! summary event carrying the final patch / target / region / fs_op counts so a subscriber sees one completion record per fully-built plan regardless of how many add_patch calls fed it.

Trait Implementations

impl Debug for PlanBuilder

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

Formats the value using the given formatter.

impl Default for PlanBuilder

fn default() -> Self

Returns the “default value” for a type.