Enum PackageError 

pub enum PackageError {
    ManifestNotFound {
        path: String,
    },
    ParseError(Error),
    Io(Error),
    BuildFailed(String),
    SignatureNotFound {
        path: String,
    },
    SignatureInvalid {
        path: String,
    },
    ArchiveError(String),
    InvalidArchive(String),
    InvalidManifest(String),
    PathTraversal {
        entry: String,
    },
    AbsolutePath {
        entry: String,
    },
    SymlinkRejected {
        entry: String,
    },
    HardlinkRejected {
        entry: String,
    },
    SizeLimitExceeded {
        limit: u64,
        actual: u64,
    },
    TooManyEntries {
        limit: u32,
    },
}

Errors that can occur when loading a package manifest.

Variants

ManifestNotFound

The package.toml file was not found in the given directory.

Fields

path: String

ParseError(Error)

The manifest file could not be parsed as valid TOML or failed schema validation (the [metadata] section didn’t match M).

Io(Error)

An I/O error occurred reading the manifest file.

BuildFailed(String)

Build failed.

SignatureNotFound

Package signature file not found.

Fields

path: String

SignatureInvalid

Package signature is invalid (no trusted key verified it).

Fields

path: String

ArchiveError(String)

An error occurred creating or reading an archive.

InvalidArchive(String)

The archive does not contain a valid package.

InvalidManifest(String)

Manifest passed serde parsing but failed cross-section validation (e.g. runtime = "python" without a [python] section, or unknown runtime value).

PathTraversal

Archive entry contains a .. component that would escape dest.

Fields

entry: String

AbsolutePath

Archive entry has an absolute path (root or drive prefix).

Fields

entry: String

SymlinkRejected

Archive contains a symlink entry, which could be used to overwrite arbitrary files outside dest on a follow-up write.

Fields

entry: String

HardlinkRejected

Archive contains a hardlink entry, same threat model as symlinks.

Fields

entry: String

SizeLimitExceeded

Cumulative decompressed size exceeded the configured cap.

Fields

limit: u64

actual: u64

TooManyEntries

Archive contains more entries than the configured cap allows.

Fields

limit: u32

Trait Implementations

impl Debug for PackageError

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

Formats the value using the given formatter.

impl Display for PackageError

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

Formats the value using the given formatter.

impl Error for PackageError

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 PackageError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for PackageError

fn from(source: Error) -> Self

Converts to this type from the input type.