Struct SymlinkEntryBuilder 

pub struct SymlinkEntryBuilder(/* private fields */);

A builder for creating a symbolic link NormalEntry.

The entry data is the UTF-8 encoded link target path, fixed at construction time; this builder does not implement Write.

Implementations

impl SymlinkEntryBuilder

pub fn new( name: EntryName, source: EntryReference, ) -> Result<SymlinkEntryBuilder, Error>

Creates a builder that stores the link target without compression or encryption.

Errors

Returns an error if initialization fails.

pub fn new_with_options( name: EntryName, source: EntryReference, option: impl WriteOption, ) -> Result<SymlinkEntryBuilder, Error>

Creates a builder with the given write options; the link target is compressed and encrypted accordingly.

When option.encryption() is Encryption::NO, the cipher mode recorded in the header is CipherMode::CBC regardless of option.cipher_mode(), matching the wire representation produced by the legacy link constructors.

Errors

Returns an error if initialization fails.

pub fn metadata(&mut self, metadata: Metadata) -> &mut SymlinkEntryBuilder

Sets the metadata of the entry, replacing any previously set metadata.

The raw file size and compressed size recorded in the given metadata are ignored; build() computes them.

pub fn add_extra_chunk<T>(&mut self, chunk: T) -> &mut SymlinkEntryBuilder

where T: Into<RawChunk>,

Adds extra chunk to the entry.

pub fn build(self) -> Result<NormalEntry, Error>

Consumes this builder and returns the constructed NormalEntry.

Errors

Returns an error if an I/O error occurs while building entry into buffer.