Struct Encoder 

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

A resumable pack encoder. Retain the repository and selected order unchanged until EOF. read performs at most one object-body read, bounded by its output slice. The cursor owns hash/framing state, never object or pack-sized storage.

Implementations

impl<'a> Encoder<'a>

pub fn new( repository: &impl Repository, order: Option<&'a [usize]>, ) -> Result<Self>

Encode all objects (None) or the supplied unique indices, in order. Invalid selections fail before the first output byte.

pub fn read( &mut self, repository: &impl Repository, output: &mut [u8], ) -> Result<usize>

Return bytes to stage for transport. Preserve unsent bytes at the host; calling again advances the cursor. Zero means complete, never pending. Backend read failures leave the failed read resumable. After any failure, discard bytes in that call’s output slice. Earlier successful pulls stand.

pub fn selection(&self) -> Option<&'a [usize]>

Immutable selection retained by this cursor. None denotes all objects. This is metadata only; reading it never advances encoding.

pub fn checksum(&self) -> Option<ObjectId>

Checksum becomes available after its complete trailer has been drained.