Struct ZipExtractor 

pub struct ZipExtractor<R: Read + Seek> { /* private fields */ }

A ULS ZIP archive that can stream DAT files.

Implementations

impl ZipExtractor<BufReader<File>>

pub fn open<P: AsRef<Path>>(path: P) -> Result<Self, ZipError>

Open a ULS ZIP file.

pub fn stats(&mut self) -> Result<ArchiveStats, ZipError>

Get statistics about the archive.

pub fn count_all_records( &mut self, ) -> Result<HashMap<String, usize>, ParseError>

Count records in all DAT files in the archive.

impl<R: Read + Seek> ZipExtractor<R>

pub fn new(archive: ZipArchive<R>) -> Self

Create from an existing archive reader.

pub fn list_dat_files(&mut self) -> Vec<String>

List all DAT files in the archive.

pub fn list_files(&mut self) -> Vec<String>

List all files in the archive.

pub fn file_size(&mut self, name: &str) -> Result<u64, ZipError>

Get the size of a file in the archive.

pub fn stream_dat(&mut self, name: &str) -> Result<impl Read + '_, ZipError>

Stream a DAT file from the archive without extracting to disk. Returns a reader that can be used with DatReader.

pub fn process_dat_streaming<F>( &mut self, dat_name: &str, callback: F, ) -> Result<usize, ParseError>

where F: FnMut(ParsedLine) -> bool,

Process a DAT file streaming from the archive, calling a callback for each record. This is the most memory-efficient way to process large ULS archives.

pub fn get_file_creation_date(&mut self) -> Option<String>

Extract the canonical file creation date from the counts file in the archive.

FCC data files contain a counts file with a line like: File Creation Date: Sun Jan 18 12:01:25 EST 2026

This is the authoritative date for when the FCC generated the data file. Returns None if the counts file doesn’t exist or can’t be parsed.