Enum AlpineError 

#[non_exhaustive]
pub enum AlpineError {
    #[non_exhaustive]
    Config {
        reason: String,
    },
    #[non_exhaustive]
    Container {
        subject: String,
        reason: String,
    },
    #[non_exhaustive]
    Signature {
        subject: String,
        reason: String,
    },
    #[non_exhaustive]
    Digest {
        subject: String,
        expected: String,
        actual: String,
    },
    #[non_exhaustive]
    Index {
        subject: String,
        reason: String,
    },
    #[non_exhaustive]
    Pin {
        unheld: Vec<UnheldPin>,
    },
    #[non_exhaustive]
    PlanDocument {
        reason: String,
    },
    #[non_exhaustive]
    Resolve {
        reason: String,
    },
    #[non_exhaustive]
    Collision {
        owner: String,
        claimant: String,
        path: String,
    },
    #[non_exhaustive]
    Script {
        package: String,
        script: &'static str,
        status: ExitStatus,
    },
    Launch(Error),
    Cancelled,
    Fetch(FetchError),
    #[non_exhaustive]
    Io {
        op: &'static str,
        path: PathBuf,
        source: Error,
    },
}

A failure provisioning an Alpine rootfs.

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.

#[non_exhaustive]

Config

The configuration cannot be provisioned from as it stands.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: String

What is wrong with it, and what to do instead.

#[non_exhaustive]

Container

An apk container is malformed, truncated, or carries something the reader refuses.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

subject: String

What was being read: a package’s path, or the URL of an index.

reason: String

What was wrong with it.

#[non_exhaustive]

Signature

A signature was not accepted: it did not verify against the key set, or the signature member was refused on its own terms.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

subject: String

What was being verified: a package’s path, or the URL of an index.

reason: String

Why the signature was not accepted.

#[non_exhaustive]

Digest

Bytes did not have the digest the archive recorded for them.

The container held together; what it carries is not what something that vouched for it said it would be. Either a mirror served a package that is not the one the index named, or the package’s own file tree is not the one its metadata names.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

subject: String

What was being checked: a package’s file name, or the identity of its control segment.

expected: String

The digest that was expected, as the archive spells it.

actual: String

The digest the bytes actually have.

#[non_exhaustive]

Index

An index’s records are not the ones the format defines.

The container held together and its signature verified; what it carries is not a readable set of records.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

subject: String

The URL of the index.

reason: String

What was wrong with it.

#[non_exhaustive]

Pin

A pin could not be held: the repositories no longer supply a package at the version and with the bytes a plan recorded.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

unheld: Vec<UnheldPin>

Every package that could not be held, in name order.

#[non_exhaustive]

PlanDocument

A plan document could not be read, or a plan could not be written as one.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: String

What was wrong with it.

#[non_exhaustive]

Resolve

The closure the repositories offer is not one that can be installed.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

reason: String

What could not be resolved, and what the repositories offer instead.

#[non_exhaustive]

Collision

Two packages ship the same path and neither says it may take it from the other.

apk warns, skips the file, and records the package as broken. A root is something a caller goes on to build on, so this layer refuses instead rather than publish a tree whose contents depend on which package was unpacked first.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

owner: String

The package that laid the path down.

claimant: String

The package that would have overwritten it.

path: String

The path both ship.

#[non_exhaustive]

Script

An install script did not succeed.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

package: String

The package whose script it was.

script: &'static str

Which script it was: pre-install, post-install or trigger.

status: ExitStatus

How it ended.

Launch(Error)

A cage could not be built or run.

Cancelled

The bootstrap’s observer asked it to stop.

Surfaces to a caller as super::ProvisionError::Cancelled.

Fetch(FetchError)

Fetching from the archive failed.

#[non_exhaustive]

Io

A host I/O operation failed.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

op: &'static str

What the operation was doing.

path: PathBuf

The path concerned.

source: Error

The underlying error.

Implementations

impl AlpineError

pub fn io( op: &'static str, path: impl Into<PathBuf>, source: Error, ) -> AlpineError

A host I/O failure, naming what the operation was doing and the path it concerned.

Arguments run operation, then locator, then cause, which is the order every constructor in the crate takes them in.

pub fn at( op: &'static str, path: impl Into<PathBuf>, ) -> impl FnOnce(Error) -> AlpineError

The same failure as a map_err argument: names the operation and the path now, and takes the cause when it arrives.

Trait Implementations

impl Debug for AlpineError

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

Formats the value using the given formatter.

impl Display for AlpineError

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

Formats the value using the given formatter.

impl Error for AlpineError

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<FetchError> for AlpineError

fn from(err: FetchError) -> AlpineError

Converts to this type from the input type.