Struct compress_tools::ArchiveIteratorBuilder

pub struct ArchiveIteratorBuilder<R>where
    R: Read + Seek,{ /* private fields */ }

Implementations

impl<R> ArchiveIteratorBuilder<R>where R: Read + Seek,

A builder to generate an archive iterator over the contents of an archive, streaming the contents of each entry in small chunks. The default configuration is identical to ArchiveIterator::from_read.

Example

use compress_tools::{ArchiveContents, ArchiveIteratorBuilder};
use std::path::Path;
use std::ffi::OsStr;

let source = std::fs::File::open("tests/fixtures/tree.tar").expect("Failed to open file");
let decode_utf8 = |bytes: &[u8]| Ok(std::str::from_utf8(bytes)?.to_owned());

for content in ArchiveIteratorBuilder::new(source)
    .decoder(decode_utf8)
    .filter(|name, stat| Path::new(name).file_name() == Some(OsStr::new("foo")) || stat.st_size == 42)
    .build()
    .expect("Failed to initialize archive")
    {
        if let ArchiveContents::StartOfEntry(name, _stat) = content {
            println!("{name}");
        }
    }

pub fn new(source: R) -> ArchiveIteratorBuilder<R>

Create a new builder for an archive iterator. Default configuration is identical to ArchiveIterator::from_read.

pub fn decoder(self, decoder: DecodeCallback) -> ArchiveIteratorBuilder<R>

Use a custom decoder to decode filenames of archive entries. By default an UTF-8 decoder (decode_utf8) is used.

pub fn filter<F>(self, filter: F) -> ArchiveIteratorBuilder<R>where F: Fn(&str, &stat) -> bool + 'static,

Use a filter to skip unwanted entries and their decompression. By default all entries are iterated.

pub fn build(self) -> Result<ArchiveIterator<R>>

Finish the builder and generate the configured ArchiveIterator.