Struct ExtractOptions 

pub struct ExtractOptions {
    pub overwrite: OverwritePolicy,
    pub path_safety: PathSafety,
    pub link_policy: LinkPolicy,
    pub limits: ResourceLimits,
    pub threads: Threads,
    pub preserve_metadata: PreserveMetadata,
    pub password: Option<Password>,
    pub progress: Option<Box<dyn ProgressReporter>>,
}

Options for extraction operations.

Fields

overwrite: OverwritePolicy

Policy for handling existing files.

path_safety: PathSafety

Path safety validation policy.

link_policy: LinkPolicy

Symbolic link handling policy.

limits: ResourceLimits

Resource limits for extraction.

threads: Threads

Thread configuration.

preserve_metadata: PreserveMetadata

Metadata preservation options.

password: Option<Password>

Available on crate feature aes only.

Password for encrypted archives.

progress: Option<Box<dyn ProgressReporter>>

Progress reporter for tracking extraction progress (optional).

Implementations

impl ExtractOptions

pub fn new() -> Self

Creates extraction options with default settings.

pub fn overwrite(self, policy: OverwritePolicy) -> Self

Sets the overwrite policy.

pub fn path_safety(self, policy: PathSafety) -> Self

Sets the path safety policy.

pub fn link_policy(self, policy: LinkPolicy) -> Self

Sets the link policy.

pub fn limits(self, limits: ResourceLimits) -> Self

Sets the resource limits.

pub fn threads(self, threads: Threads) -> Self

Sets the thread configuration.

pub fn preserve_metadata(self, preserve: PreserveMetadata) -> Self

Sets the metadata preservation options.

pub fn password(self, password: impl Into<Password>) -> Self

Available on crate feature aes only.

Sets the password for encrypted archives.

pub fn progress(self, reporter: impl ProgressReporter + 'static) -> Self

Sets the progress reporter.

pub fn clone_settings(&self) -> Self

Clones all settings except the progress reporter.

This is useful when you need to extract multiple archives with the same settings but can’t clone the options due to the non-Clone progress reporter.

Example

use zesven::read::{ExtractOptions, OverwritePolicy};

let base = ExtractOptions::new().overwrite(OverwritePolicy::Skip);
archive1.extract(dest1, (), &base.clone_settings())?;
archive2.extract(dest2, (), &base.clone_settings())?;

Trait Implementations

impl Debug for ExtractOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ExtractOptions

fn default() -> ExtractOptions

Returns the “default value” for a type.