Reader

Struct Reader 

Source
pub struct Reader { /* private fields */ }
Expand description

Structure that can read, parse and extract a wpress archive file.

Implementations§

Source§

impl Reader

Source

pub fn new<P: AsRef<Path>>(path: P) -> Result<Reader, FileParseError>

Creates a new Reader with the path supplied as the source file.

Source

pub fn extract_to<P: AsRef<Path>>( &mut self, destination: P, ) -> Result<(), ExtractError>

Extracts all the files inside the archive to the provided destination directory.

§Example
use wpress_oxide::Reader;
let mut r = Reader::new("tests/reader/archive.wpress")?;
r.extract_to("tests/reader_output_0")?;
Source

pub fn extract(&mut self) -> Result<(), ExtractError>

Extracts all the files inside the archive to the current directory.

§Example
use wpress_oxide::Reader;
let mut r = Reader::new("tests/reader/archive.wpress")?;
r.extract()?;
Source

pub fn files_count(&self) -> usize

Returns number of files in the current archive.

Source

pub fn headers(&self) -> &[Header]

Returns a borrowed header slice with metadata about the files in the archive.

Source

pub fn headers_owned(&self) -> Vec<Header>

Returns a copied vector of headers or metadata about the files in the archive.

Source

pub fn extract_file<P: AsRef<Path>>( &mut self, filename: P, destination: P, ) -> Result<(), ExtractError>

Extract a single file, given either its name or complete path inside the archive, to a destination directory. Preserves the directory hierarchy of the archive during extraction.

§Examples
§Extract all files from the archive that match a filename
use wpress_oxide::Reader;
let mut r = Reader::new("tests/reader/archive.wpress")?;
r.extract_file("file.txt", "tests/reader_output_1")?;
§Extract a file with a specific path in the archive
use wpress_oxide::Reader;
let mut r = Reader::new("tests/reader/archive.wpress")?;
r.extract_file(
    "tests/writer/directory/subdirectory/file.txt",
    "tests/reader_output_2",
)?;

Auto Trait Implementations§

§

impl Freeze for Reader

§

impl RefUnwindSafe for Reader

§

impl Send for Reader

§

impl Sync for Reader

§

impl Unpin for Reader

§

impl UnwindSafe for Reader

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.