Struct PackWriter 

pub struct PackWriter { /* private fields */ }

Builds a packfile in memory, enforcing entry/payload caps and recording entries in insertion order. Call Self::finish to obtain the final packfile bytes (header + entries + trailer).

Implementations

impl PackWriter

pub fn new() -> Self

Create an empty writer.

pub fn push_raw( &mut self, hash_of_bytes: Hash, bytes: Vec<u8>, ) -> Result<Hash, PackError>

Append a raw object entry. bytes is the fully serialised object payload; hash_of_bytes is the BLAKE3 of those same bytes — callers usually have it on hand from the object store, so we take it explicitly to avoid an extra BLAKE3 pass over the same buffer. Returns the same hash for chaining.

pub fn push_delta( &mut self, base_hash: &Hash, delta_stream: &[u8], ) -> Result<(), PackError>

Append a delta entry. base_hash MUST refer to an earlier raw entry in this pack OR an object already in the destination store. delta_stream MUST be a valid SPEC-DELTA stream — we don’t re-validate here (the writer is trusted), but the reader will.

pub fn entry_count(&self) -> usize

Number of entries pushed so far. Useful for sizing diagnostics.

pub fn finish(self) -> Result<Vec<u8>, PackError>

Serialise the pack: header + entries + trailer. The trailer is BLAKE3(everything_before_trailer). The whole pack’s BLAKE3 is the on-disk pack key — see pack_key.

Trait Implementations

impl Debug for PackWriter

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

Formats the value using the given formatter.

impl Default for PackWriter

fn default() -> PackWriter

Returns the “default value” for a type.