Enum ExtractionError 

pub enum ExtractionError {
    Io(Error),
    UnsupportedFormat,
    InvalidArchive(String),
    PathTraversal {
        path: PathBuf,
    },
    SymlinkEscape {
        path: PathBuf,
    },
    HardlinkEscape {
        path: PathBuf,
    },
    ZipBomb {
        compressed: u64,
        uncompressed: u64,
        ratio: f64,
    },
    InvalidPermissions {
        path: PathBuf,
        mode: u32,
    },
    QuotaExceeded {
        resource: QuotaResource,
    },
    SecurityViolation {
        reason: String,
    },
    SourceNotFound {
        path: PathBuf,
    },
    SourceNotAccessible {
        path: PathBuf,
    },
    OutputExists {
        path: PathBuf,
    },
    InvalidCompressionLevel {
        level: u8,
    },
    UnknownFormat {
        path: PathBuf,
    },
    InvalidConfiguration {
        reason: String,
    },
}

Errors that can occur during archive extraction.

Variants

Io(Error)

I/O operation failed.

UnsupportedFormat

Archive format is unsupported or unrecognized.

InvalidArchive(String)

Archive is corrupted or invalid.

PathTraversal

Path traversal attempt detected.

Fields

path: PathBuf

The path that attempted traversal.

SymlinkEscape

Symlink points outside extraction directory.

Fields

path: PathBuf

The symlink path.

HardlinkEscape

Hardlink target not in extraction directory.

Fields

path: PathBuf

The hardlink path.

ZipBomb

Potential zip bomb detected.

Fields

compressed: u64

Compressed size in bytes.

uncompressed: u64

Uncompressed size in bytes.

ratio: f64

Compression ratio.

InvalidPermissions

File permissions are invalid or unsafe.

Fields

path: PathBuf

The file path.

mode: u32

The permission mode.

QuotaExceeded

Extraction quota exceeded.

Fields

resource: QuotaResource

Description of the exceeded resource.

SecurityViolation

Operation not permitted by security policy.

Fields

reason: String

Reason for the violation.

SourceNotFound

Source path not found.

Fields

path: PathBuf

The source path.

SourceNotAccessible

Source path is not accessible.

Fields

path: PathBuf

The source path.

OutputExists

Output file already exists.

Fields

path: PathBuf

The output path.

InvalidCompressionLevel

Invalid compression level.

Fields

level: u8

The invalid compression level.

UnknownFormat

Cannot determine archive format.

Fields

path: PathBuf

The path with unknown format.

InvalidConfiguration

Invalid configuration provided.

Fields

reason: String

Reason for the configuration error.

Implementations

impl ExtractionError

pub const fn is_security_violation(&self) -> bool

Returns true if this error represents a security violation.

Security violations include:

• Path traversal attempts
• Symlink escapes
• Hardlink escapes
• Zip bombs
• Invalid permissions
• Quota exceeded
• General security policy violations

Examples

use exarch_core::ExtractionError;
use std::path::PathBuf;

let err = ExtractionError::PathTraversal {
    path: PathBuf::from("../etc/passwd"),
};
assert!(err.is_security_violation());

let err = ExtractionError::UnsupportedFormat;
assert!(!err.is_security_violation());

pub const fn is_recoverable(&self) -> bool

Returns true if this error is potentially recoverable.

Recoverable errors are those where extraction might continue with different inputs or configurations. Non-recoverable errors typically indicate fundamental issues with the archive format.

Examples

use exarch_core::ExtractionError;
use std::path::PathBuf;

let err = ExtractionError::PathTraversal {
    path: PathBuf::from("../etc/passwd"),
};
assert!(err.is_recoverable()); // Could skip this entry

let err = ExtractionError::InvalidArchive("corrupted header".to_string());
assert!(!err.is_recoverable()); // Cannot continue

pub fn context(&self) -> Option<&str>

Returns a context string for this error, if available.

The context provides additional information about what operation was being performed when the error occurred.

Examples

use exarch_core::ExtractionError;

let err = ExtractionError::InvalidArchive("bad header".to_string());
assert_eq!(err.context(), Some("bad header"));

let err = ExtractionError::UnsupportedFormat;
assert_eq!(err.context(), None);

pub const fn quota_resource(&self) -> Option<&QuotaResource>

Returns the quota resource that was exceeded, if applicable.

Trait Implementations

impl Debug for ExtractionError

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

Formats the value using the given formatter.

impl Display for ExtractionError

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

Formats the value using the given formatter.

impl Error for ExtractionError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for ExtractionError

fn from(source: Error) -> Self

Converts to this type from the input type.