Struct ZipHandler 

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

A handler for reading EPUB files as ZIP archives.

This struct wraps a ZipArchive and provides convenience methods for reading specific files needed for EPUB parsing:

• Locating the OPF file via META-INF/container.xml
• Reading text files (XML, HTML, CSS, etc.)
• Reading binary files (images, fonts, etc.)

Example

use std::path::Path;
use epub_parser::utils::ZipHandler;

let mut handler = ZipHandler::new(Path::new("book.epub"))?;
let opf_path = handler.get_opf_path()?;
println!("OPF location: {}", opf_path);

Implementations

impl ZipHandler<File>

pub fn new(path: &Path) -> Result<Self, Error>

Creates a new ZipHandler from a file path.

Arguments

• path - The path to the EPUB file.

Returns

Returns Ok(ZipHandler) on success, or an error if the file cannot be opened or is not a valid ZIP archive.

Errors

Returns an error if:

• The file does not exist
• The file cannot be opened
• The file is not a valid ZIP archive

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

pub fn new_from_reader(reader: R) -> Result<Self, Error>

Creates a new ZipHandler from any reader that implements Read + Seek.

This is useful for parsing EPUBs from memory (e.g., byte buffers) or network streams.

Arguments

• reader - Any type implementing Read + Seek (e.g., Cursor<Vec<u8>>).

Returns

Returns Ok(ZipHandler) on success, or an error if the reader does not contain a valid ZIP archive.

Example

use std::io::Cursor;
use epub_parser::utils::ZipHandler;

let data = vec![0u8; 100]; // In practice, this would be EPUB data
// handler = ZipHandler::new_from_reader(Cursor::new(data))?;

pub fn get_opf_path(&mut self) -> Result<String, Error>

Locates the OPF (Open Package Format) file path.

EPUB files contain a META-INF/container.xml file that specifies the location of the OPF file. This method parses that XML and returns the path to the OPF file.

Returns

Returns the path to the OPF file as a string (e.g., “OEBPS/content.opf”).

Errors

Returns Error::MissingContainer if META-INF/container.xml is missing. Returns Error::MissingOpf if the OPF path cannot be found.

pub fn read_file(&mut self, path: &str) -> Result<String, Error>

Reads a file from the ZIP archive as a UTF-8 string.

Arguments

• path - The path to the file within the ZIP archive.

Returns

Returns the file contents as a String.

Errors

Returns an error if:

• The file does not exist in the archive
• The file cannot be read
• The file contains invalid UTF-8

pub fn read_file_as_bytes(&mut self, path: &str) -> Result<Vec<u8>, Error>

Reads a file from the ZIP archive as raw bytes.

This is useful for binary files like images and fonts.

Arguments

• path - The path to the file within the ZIP archive.

Returns

Returns the file contents as a Vec<u8>.

Errors

Returns an error if the file does not exist or cannot be read.