Enum ArchiveReadError 

#[non_exhaustive]
pub enum ArchiveReadError {
    Io(Error),
    NonUtf8Path(Vec<u8>),
    NoTargetPrefix(Utf8PathBuf),
    InvalidComponent {
        path: Utf8PathBuf,
        component: String,
    },
    UnsupportedEntryType {
        path: Utf8PathBuf,
        entry_type: EntryType,
    },
    ChecksumRead {
        path: Utf8PathBuf,
        error: Error,
    },
    InvalidChecksum {
        path: Utf8PathBuf,
        expected: u32,
        actual: u32,
    },
    MetadataFileNotFound(&'static Utf8Path),
    MetadataDeserializeError {
        path: &'static Utf8Path,
        error: Error,
    },
    PackageGraphConstructError {
        path: &'static Utf8Path,
        error: Box<Error>,
    },
}

An error occurred while reading a file.

Returned as part of both ArchiveCreateError and ArchiveExtractError.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Io(Error)

An I/O error occurred while reading the archive.

NonUtf8Path(Vec<u8>)

A path wasn’t valid UTF-8.

NoTargetPrefix(Utf8PathBuf)

A file path within the archive didn’t begin with “target/”.

InvalidComponent

A file path within the archive had an invalid component within it.

Fields

path: Utf8PathBuf

The path that had an invalid component.

component: String

The invalid component.

UnsupportedEntryType

An archive entry was of an unsupported type: a symlink, hard link, device, FIFO, or other non-file type.

Fields

path: Utf8PathBuf

The path with the unsupported entry type.

entry_type: EntryType

The entry type.

ChecksumRead

An error occurred while reading a checksum.

Fields

path: Utf8PathBuf

The path for which there was a checksum read error.

error: Error

The error that occurred.

InvalidChecksum

An entry had an invalid checksum.

Fields

path: Utf8PathBuf

The path that had an invalid checksum.

expected: u32

The expected checksum.

actual: u32

The actual checksum.

MetadataFileNotFound(&'static Utf8Path)

A metadata file wasn’t found.

MetadataDeserializeError

An error occurred while deserializing a metadata file.

Fields

path: &'static Utf8Path

The name of the metadata file.

error: Error

The deserialize error.

PackageGraphConstructError

An error occurred while building a PackageGraph.

Fields

path: &'static Utf8Path

The name of the metadata file.

error: Box<Error>

The error.

Trait Implementations

impl Debug for ArchiveReadError

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

Formats the value using the given formatter.

impl Display for ArchiveReadError

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

Formats the value using the given formatter.

impl Error for ArchiveReadError

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.