Struct ExtractionOptions 

#[non_exhaustive]
pub struct ExtractionOptions {
    pub atomic: bool,
    pub skip_duplicates: bool,
}

Options controlling extraction behavior (non-security).

Separate from SecurityConfig to keep security settings focused. These options control operational behavior like atomicity.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

atomic: bool

Extract atomically: use a temp dir in the same parent as the output directory, rename on success, and delete on failure.

When enabled, extraction is all-or-nothing: if extraction fails, the output directory will not be created. This prevents partial extraction artifacts from remaining on disk.

Note: cleanup is best-effort if the process is terminated via SIGKILL.

skip_duplicates: bool

Skip duplicate entries silently instead of aborting.

When true (default), if an archive contains two entries with the same destination path, the second entry is skipped and a warning is recorded in ExtractionReport. When false, duplicate entries cause an error.

Implementations

impl ExtractionOptions

pub fn with_atomic(self, atomic: bool) -> Self

Enables or disables atomic extraction.

When enabled, extraction is all-or-nothing: the output directory is not created if extraction fails.

Examples

use exarch_core::ExtractionOptions;

let opts = ExtractionOptions::default().with_atomic(true);
assert!(opts.atomic);

pub fn with_skip_duplicates(self, skip: bool) -> Self

Enables or disables skipping duplicate entries silently.

Examples

use exarch_core::ExtractionOptions;

let opts = ExtractionOptions::default().with_skip_duplicates(false);
assert!(!opts.skip_duplicates);

Trait Implementations

impl Clone for ExtractionOptions

fn clone(&self) -> ExtractionOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExtractionOptions

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

Formats the value using the given formatter.

impl Default for ExtractionOptions

fn default() -> Self

Returns the “default value” for a type.