Enum PluginError 

#[non_exhaustive]
pub enum PluginError {
    ManifestParse(String),
    AbiUnsupported {
        plugin: String,
        required: String,
        supported: Vec<u64>,
    },
    CapabilityRequired(Capability),
    CapabilityDenied(Capability),
    DuplicateRegistration(QName),
    DependencyMissing {
        dependent: String,
        dep_id: String,
        req: String,
    },
    DependencyCycle(Vec<String>),
    SignatureInvalid(String),
    HashMismatch {
        expected: String,
        actual: String,
    },
    WasmInstantiate(String),
    LuaParse(String),
    RhaiParse(String),
    InvalidQName(String),
    LogicalTypeConflict(String),
    StorageSchemeConflict(String),
    Internal(String),
}

Errors surfaced by the plugin framework itself.

PluginError covers framework operations: manifest parsing, capability checks, registration validation, dependency resolution, WASM loading, signing. Per-invocation errors from plugin code are represented by FnError instead.

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.

ManifestParse(String)

The supplied manifest could not be parsed.

AbiUnsupported

The manifest’s abi range does not intersect any host-supported major.

Fields

plugin: String

Plugin id reporting the mismatch.

required: String

Required ABI range from the manifest.

supported: Vec<u64>

Host-supported major versions.

CapabilityRequired(Capability)

A registration was attempted without the required capability.

CapabilityDenied(Capability)

A capability the plugin requested was denied by the host loader.

DuplicateRegistration(QName)

Two registrations attempted to claim the same qualified name.

DependencyMissing

A depends_on entry referenced a missing or version-incompatible plugin.

Fields

dependent: String

Plugin id whose manifest declared the dependency.

dep_id: String

Missing dependency id.

req: String

Version requirement from the manifest.

DependencyCycle(Vec<String>)

A cycle was detected in the dependency graph.

SignatureInvalid(String)

The manifest’s signature failed verification against the trust root.

HashMismatch

The plugin’s hash did not match the pinned blake3 digest.

Fields

expected: String

Hash declared in the manifest.

actual: String

Hash actually computed at load.

WasmInstantiate(String)

WASM component instantiation failed (loader-side).

LuaParse(String)

Lua source parse / compile failed.

RhaiParse(String)

Rhai source parse / compile failed.

InvalidQName(String)

A qualified name failed to parse.

LogicalTypeConflict(String)

A logical type registration conflicted with an existing extension type.

StorageSchemeConflict(String)

Storage scheme already registered.

Internal(String)

Catch-all for genuinely internal errors that don’t map to a variant above.

Implementations

impl PluginError

pub fn internal(message: impl Into<String>) -> Self

Construct an PluginError::Internal with a descriptive message.

Trait Implementations

impl Debug for PluginError

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

Formats the value using the given formatter.

impl Display for PluginError

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

Formats the value using the given formatter.

impl Error for PluginError

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<PluginError> for ReloadError

fn from(source: PluginError) -> Self

Converts to this type from the input type.