Struct EntryWriter 

pub struct EntryWriter<'a, W>
where
    W: AsyncWrite + Unpin,
{ /* private fields */ }

A streaming writer for a single file entry in a ZIP archive.

Obtained from ZipWriter::append_file. Data written through this writer is compressed with DEFLATE and streamed to the underlying output.

Important

The close method must be called after all data is written to finalize the deflate frame and write the Data Descriptor. Dropping without closing will lose the entry.

Implementations

impl<W: AsyncWrite + Unpin> EntryWriter<'_, W>

pub fn set_mtime(&mut self, mtime: SystemTime) -> &mut Self

Set the modification time for this entry.

The timestamp is stored in the Central Directory using MS-DOS format and as an extended timestamp extra field (0x5455).

pub fn set_permissions(&mut self, mode: u32) -> &mut Self

Set Unix file permissions for this entry.

Provide permission bits including setuid/setgid/sticky (e.g., 0o4755, 0o2755). The crate automatically adds the file type bit (S_IFREG for files, S_IFDIR for directories).

pub async fn close(self) -> Result<(), ZipError>

Finalize the deflate frame, compute the CRC-32 checksum, and write the Data Descriptor.

This consumes the EntryWriter, flushes the deflate encoder, extracts the compressed size, computes the CRC-32 of the uncompressed data, and writes the trailing CRC-32 and sizes (Data Descriptor) after the compressed data. The inner writer is returned to the parent ZipWriter.

Errors

Returns ZipError if close is called more than once, if the deflate encoder fails to shut down (I/O error), or if writing the Data Descriptor fails (I/O error).

Trait Implementations

impl<W: AsyncWrite + Unpin> AsyncWrite for EntryWriter<'_, W>

fn poll_write( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &[u8], ) -> Poll<Result<usize>>

Attempt to write bytes from buf into the object.

fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>

Attempts to flush the object, ensuring that any buffered data reach their destination.

fn poll_shutdown(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>

Initiates or attempts to shut down this writer, returning success when the I/O connection has completely shut down.

fn poll_write_vectored( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &[IoSlice<'_>], ) -> Poll<Result<usize, Error>>

Like poll_write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

Determines if this writer has an efficient poll_write_vectored implementation.

impl<W> Drop for EntryWriter<'_, W>

where W: AsyncWrite + Unpin,

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<'__pin, 'a, W> Unpin for EntryWriter<'a, W>

where PinnedFieldsOf<__Origin<'__pin, 'a, W>>: Unpin, W: AsyncWrite + Unpin,