Enum ReloadError 

#[non_exhaustive]
pub enum ReloadError {
    Drain(String),
    SchemaIncompat {
        kind: String,
        reason: String,
    },
    Persist(FnError),
    Plugin(PluginError),
    PluginNotFound(String),
}

Errors produced by the hot-reload pipeline.

Surfaced by crate::reload::ReloadDispatcher::dispatch and by the host’s Uni::reload / Uni::remove_plugin entry points. Each variant maps to a distinct failure mode of the §11.2 epoch-fenced cutover: a drain-state-machine failure, a per-kind schema-compat rejection, a persistence/round-trip failure on a stateful surface, or a generic plugin-framework error wrapped through.

Reload failures abort the cutover before the new plugin’s surfaces are committed to the registry, so the registry stays consistent with the still-active old plugin.

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.

Drain(String)

The drain state machine rejected the request.

SchemaIncompat

A per-kind schema-compat check rejected the new provider.

Holds the kind name (e.g., "crdt:lww-register") and a human-readable explanation of the incompatibility.

Fields

kind: String

Per-kind discriminator with a kind:value prefix ("crdt:lww-register", "logical-type:geo.point").

reason: String

Human-readable explanation of the incompatibility.

Persist(FnError)

A stateful surface failed to persist/round-trip during reload.

Plugin(PluginError)

The new plugin’s register() (or other framework op) failed.

PluginNotFound(String)

The host lookup for a plugin handle came up empty.

Implementations

impl ReloadError

pub fn schema_incompat( kind: impl Into<String>, reason: impl Into<String>, ) -> Self

Convenience constructor for a schema-incompatibility rejection.

Trait Implementations

impl Debug for ReloadError

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

Formats the value using the given formatter.

impl Display for ReloadError

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

Formats the value using the given formatter.

impl Error for ReloadError

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.