Struct Archive 

pub struct Archive<'s, S: RangeSource> { /* private fields */ }

Complete original central-directory census. Names occupy one pooled buffer; entry order is never replaced by a map’s unique-name interpretation.

Implementations

impl<'s, S: RangeSource> Archive<'s, S>

pub fn ltv_query<'q, 'v, W: Work>(&'v self, work: &'q W) -> Query<'q, 'v, 's, S>

where 'v: 'q,

Borrows this actual source with no allocation or account clone.

impl<'s, S: RangeSource> Archive<'s, S>

pub async fn read<W: Work>( source: &'s S, session: &'s Session, work: &W, ) -> Result<Self, Error<S::Error>>

Reads original ZIP/ZIP64 metadata under source AND current execution. No payload is inflated and no filesystem path is acquired.

pub fn stamp(&self) -> Stamp<S::Document, S::Generation>

Immutable source metadata captured before directory acquisition.

pub fn len(&self) -> usize

Number of original occurrences, including duplicates and invalid entries.

pub fn is_empty(&self) -> bool

Whether the original directory contains no members.

pub fn comment_span(&self) -> Span

Original archive comment bytes, distinct from a filename/MIME hint.

pub fn directory_span(&self) -> Span

Original directory enclosure.

pub fn member<W: Work>( &self, ordinal: usize, work: &W, ) -> Result<Option<Member<'_, 's, S>>, Error<S::Error>>

Selects by original ordinal after current/source admission. No lookup chooses one copy of a duplicated name or drops malformed occurrences.

pub fn original<W: Work>( &self, id: MemberId<S::Document, S::Generation>, work: &W, ) -> Result<Member<'_, 's, S>, Error<S::Error>>

Selects an existing ID only within its exact original source view.

pub fn faults<'v, 'q, W: Work>( &'v self, work: &'q W, ) -> SourceResult<impl Iterator<Item = Result<Fault, Error<S::Error>>> + use<'v, 'q, 's, S, W>, S>

Visits every negative fact in original discovery order under this query. Refusal is returned once and permanently fuses traversal.

pub fn find<W: Work>( &self, name: &[u8], work: &W, ) -> Result<Names<'_, 's, S>, Error<S::Error>>

Exact original-name lookup. The result keeps the complete duplicate range; no Unicode/case normalization or filesystem interpretation occurs.