Struct PackDecodeCursor 

pub struct PackDecodeCursor<'a> { /* private fields */ }

A store-less pack decoder that pauses at an unresolved external base.

Self::new performs the same framing and allocation preflight as decode_entries_with. Each successful entry reaches the sink exactly once across calls to Self::resume; a missing base leaves its frame at the cursor so the caller can supply that base and resume. Other errors end the decode. The same cumulative budget spans every resume call.

Implementations

impl<'a> PackDecodeCursor<'a>

pub fn new(pack: &'a [u8], limits: DecodeLimits) -> Result<Self, PackError>

Preflight one content-addressed pack without fetching external bases.

Errors

Invalid framing, unsupported content, or a decoded-size claim over limits is returned before the sink observes any entry.

pub fn set_max_decoded_bytes(&mut self, max: u64) -> Result<(), PackError>

Set the remaining decode’s allocation cap. A caller retaining external objects beside this cursor can lower the cap as those objects accumulate. Earlier claims and live bases stay charged.

Errors

PackError::PackfileTooLarge if bytes already charged exceed max; the previous cap is kept in that case.

pub fn resume<B: DeltaBaseSource>( &mut self, bases: &mut B, sink: impl FnMut(DecodedEntry<'_>) -> Result<(), PackError>, ) -> Result<DecodeReport, PackError>

Continue from the first unprocessed frame.

Errors

PackError::DeltaBaseMissing leaves the current frame ready to retry after bases gains that id. Any other error is terminal. The sink may have seen earlier entries when either error is returned.

Trait Implementations

impl<'a> Debug for PackDecodeCursor<'a>

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

Formats the value using the given formatter.