Struct Builder 

pub struct Builder<B> { /* private fields */ }

A stateful format-neutral archive construction engine.

Create this wrapper with ArchiveBuilder::builder or ArchiveBuilder::builder_with_policy.

Implementations

impl<B: ArchiveBuilder> Builder<B>

pub async fn add_entry<P, D>( &mut self, path: P, data: D, metadata: EntryMetadata, ) -> Result<(), BuildError<B::Error>>

where P: AsRef<Path>, D: AsRef<[u8]>,

Adds one regular file from an in-memory byte buffer.

pub async fn add_directory<P: AsRef<Path>>( &mut self, source: P, ) -> Result<(), BuildError<B::Error>>

Recursively adds a filesystem directory beneath its UTF-8 basename.

Entries are visited in deterministic sorted order and files are streamed with bounded memory. Source symbolic links are rejected by default; BuilderPolicy::symlink_policy can instead preserve them. A late traversal or validation failure may leave partial output and poison this builder.

pub async fn finish(self) -> Result<(), BuildError<B::Error>>

Finalizes and consumes this archive builder.

Callers that need to retain access to an output sink should lend it to the format writer before wrapping it rather than transferring ownership.