Struct AsyncZipArchive 

pub struct AsyncZipArchive<R: AsyncRead + AsyncSeek + Unpin> { /* private fields */ }

Async ZIP archive reader implementing AsyncArchiveReader.

This type wraps the async-zip crate’s ZipFileReader and provides async access to ZIP archive entries without blocking the tokio runtime.

Type Parameters

• R - The underlying reader type, must implement:
  • [AsyncRead]: For reading data
  • [AsyncSeek]: For random access to ZIP entries
  • Unpin: Required by tokio’s async traits

Common types that satisfy these bounds:

• tokio::fs::File
• std::io::Cursor<Vec<u8>>
• tokio::io::BufReader<File>

Implementations

impl<R: AsyncRead + AsyncSeek + Unpin> AsyncZipArchive<R>

pub async fn new(reader: R) -> Result<Self>

Creates a new async ZIP archive reader.

Arguments

• reader - Any async reader implementing AsyncRead + AsyncSeek + Unpin

Returns

An initialized AsyncZipArchive ready to read entries.

Errors

Returns Lib3mfError::Io if:

• The ZIP file header cannot be read
• The ZIP central directory is corrupt or missing
• The file is not a valid ZIP archive

Implementation Notes

• Wraps the reader in a BufReader for efficient I/O
• Uses tokio_util::compat to bridge tokio and futures AsyncRead traits
• Reads the ZIP central directory during construction

Examples

use lib3mf_async::zip::AsyncZipArchive;
use tokio::fs::File;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let file = File::open("model.3mf").await?;
    let archive = AsyncZipArchive::new(file).await?;
    // Archive is ready to read entries
    Ok(())
}

Trait Implementations

impl<R: AsyncRead + AsyncSeek + Unpin + Send + Sync> AsyncArchiveReader for AsyncZipArchive<R>

fn read_entry<'life0, 'life1, 'async_trait>( &'life0 mut self, name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Reads the content of an archive entry by name.

fn entry_exists<'life0, 'life1, 'async_trait>( &'life0 mut self, name: &'life1 str, ) -> Pin<Box<dyn Future<Output = bool> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Checks if an archive entry exists.

fn list_entries<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lists all entry names in the archive.