Enum ExtractError 

pub enum ExtractError {
    Io(String),
    TarballTooLarge {
        path: PathBuf,
        actual: u64,
        limit: u64,
    },
    TooManyEntries {
        limit: u64,
    },
    EntryTooLarge {
        path: String,
        actual: u64,
        limit: u64,
    },
    ExtractedTooLarge {
        limit: u64,
    },
    UnsafePath {
        path: String,
        reason: &'static str,
    },
    DisallowedEntryType {
        path: String,
        kind: &'static str,
    },
    ManifestMismatch {
        expected_id: String,
        expected_version: Version,
        got_id: String,
        got_version: Version,
    },
    ManifestInvalid {
        path: PathBuf,
        reason: String,
    },
    BinaryMissing {
        path: PathBuf,
    },
    JoinError(String),
}

Errors surfaced by the tarball extraction pipeline.

Variants

Io(String)

IO read/write/rename/remove against the local filesystem failed.

TarballTooLarge

Tarball file size exceeds the configured max_tarball_bytes.

Fields

path: PathBuf

Path of the offending tarball.

actual: u64

Actual size in bytes.

limit: u64

Configured limit.

TooManyEntries

Number of entries (files + dirs) exceeds the configured max_entries.

Fields

limit: u64

Configured limit.

EntryTooLarge

One entry’s header-declared size exceeds max_entry_bytes.

Fields

path: String

Entry path inside the tarball.

actual: u64

Header-declared size.

limit: u64

Per-entry limit.

ExtractedTooLarge

Sum of all entry sizes exceeds max_extracted_bytes.

Fields

limit: u64

Configured limit.

UnsafePath

Entry path was absolute, contained .., was Windows-prefixed, or included NUL bytes.

Fields

path: String

Offending entry path as it appeared in the tarball.

reason: &'static str

Why the path was rejected.

DisallowedEntryType

Entry type was not in the allowed set (regular file or directory).

Fields

path: String

Entry path as it appeared in the tarball.

kind: &'static str

Disallowed entry kind label (e.g. "symlink", "hardlink").

ManifestMismatch

Manifest extracted from the tarball does not match the manifest the resolver advertised. The mismatch implies tarball/registry tampering or a publish convention violation; staging is cleaned up.

Fields

expected_id: String

Expected plugin id (from the resolver).

expected_version: Version

Expected plugin version (from the resolver).

got_id: String

Plugin id observed in the tarball’s nexo-plugin.toml.

got_version: Version

Plugin version observed in the tarball’s nexo-plugin.toml.

ManifestInvalid

Manifest file at the given path could not be parsed as a valid PluginManifest.

Fields

path: PathBuf

Path on disk where the manifest was expected.

reason: String

Parse failure reason.

BinaryMissing

bin/<plugin_id> was not present after extraction. Indicates a publish convention violation upstream.

Fields

path: PathBuf

Path on disk where the binary was expected.

JoinError(String)

tokio::task::spawn_blocking join failure (panic in the sync extract task, or runtime shutdown mid-extract).

Trait Implementations

impl Debug for ExtractError

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

Formats the value using the given formatter.

impl Display for ExtractError

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

Formats the value using the given formatter.

impl Error for ExtractError

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.