Struct Unroll 

pub struct Unroll<R> { /* private fields */ }

Archive unroller

NOTE: Currently supported .tar.gz archives only.

Implementations

impl<R> Unroll<R>

pub const fn create_dest_path(self, flag: bool) -> Self

Create destination directory when it doesn’t exists

Default: true

pub const fn cleanup_dest_dir(self, flag: bool) -> Self

Cleanup destination directory before extraction

Default: true

pub const fn fix_invalid_dest(self, flag: bool) -> Self

Try to fix destination path when it is not a valid

For example, when destination already exists and it is not a directory, it will be removed

Default: true

pub const fn cleanup_on_error(self, flag: bool) -> Self

Cleanup already extracted data when errors occurs

Default: true

pub const fn strip_components(self, num_of_components: usize) -> Self

Strip the number of leading components from file names on extraction

Default: 0

pub const fn strip_when_alone(self, flag: bool) -> Self

Strip the leading components only when it’s alone

Default: false

impl<R> Unroll<R>

pub fn to<D>(self, path: D) -> Status

where R: Read, D: AsRef<Path>,

Extract contents to specified directory

Errors

• Destination directory does not exists when create_dest_path is not set
• Destination directory is not empty when cleanup_dest_dir is not set
• Destination path is not a directory when fix_invalid_dest is not set
• Required number of path components cannot be stripped when strip_when_alone is not set

Trait Implementations

impl<R> From<Result<R, Error>> for Unroll<R>

fn from(source: Result<R>) -> Self

Converts to this type from the input type.