Enum UpgradeError 

pub enum UpgradeError {
    FromInvalid {
        from: String,
        reason: String,
    },
    ModuleEmpty {
        kind: &'static str,
    },
    ModuleInvalid {
        kind: &'static str,
        module: String,
        reason: String,
    },
    EmptyScript,
    AbsoluteScript {
        script: PathBuf,
    },
    ParentEscapeScript {
        script: PathBuf,
    },
    NonLispExtensionScript {
        script: PathBuf,
    },
    DuplicateFrom {
        from: String,
    },
    FromNotBeforeVersao {
        from: String,
        versao: String,
    },
    RestartNotExclusive {
        from: String,
        restart_count: usize,
        other_kinds: Vec<&'static str>,
    },
    StateChangeWithoutPriorLoad {
        from: String,
        script: PathBuf,
    },
    PurgeWithoutPriorLoad {
        from: String,
        kind: &'static str,
        module: String,
    },
    DuplicateCleanup {
        from: String,
        module: String,
        kinds: Vec<&'static str>,
    },
    DuplicateLoadModule {
        from: String,
        module: String,
    },
    DuplicateStateChange {
        from: String,
        script: PathBuf,
    },
    StateChangeAfterCleanup {
        from: String,
        script: PathBuf,
        prior_cleanup_kind: &'static str,
        prior_cleanup_module: String,
    },
    StateChangeWithoutOnStateChangeCallback {
        from: String,
        script: PathBuf,
    },
}

Variants

FromInvalid

Fields

from: String

reason: String

ModuleEmpty

Fields

kind: &'static str

ModuleInvalid

Fields

kind: &'static str

module: String

reason: String

EmptyScript

AbsoluteScript

Fields

script: PathBuf

ParentEscapeScript

Fields

script: PathBuf

NonLispExtensionScript

Fields

script: PathBuf

DuplicateFrom

Fields

from: String

FromNotBeforeVersao

Fields

from: String

versao: String

RestartNotExclusive

Fields

from: String

restart_count: usize

other_kinds: Vec<&'static str>

StateChangeWithoutPriorLoad

Fields

from: String

script: PathBuf

PurgeWithoutPriorLoad

Fields

from: String

kind: &'static str

module: String

DuplicateCleanup

Fields

from: String

module: String

kinds: Vec<&'static str>

DuplicateLoadModule

Fields

from: String

module: String

DuplicateStateChange

Fields

from: String

script: PathBuf

StateChangeAfterCleanup

Fields

from: String

script: PathBuf

prior_cleanup_kind: &'static str

prior_cleanup_module: String

StateChangeWithoutOnStateChangeCallback

Fields

from: String

script: PathBuf

Implementations

impl UpgradeError

pub fn state_change_without_prior_load(from: &str, script: &Path) -> Self

Construct an UpgradeError::StateChangeWithoutPriorLoad naming the offending (:from <prior-versao>) and (:state-change <script>) pair. Folds the uniform Self::StateChangeWithoutPriorLoad { from: from.to_string(), script: script.to_path_buf() } two-field struct-literal onto one substrate primitive so every wire-up on this variant reads through one dispatch rather than the pre-lift three-line open-coded block. The from string threads verbatim from UpgradeFromEntry::prior_versao and the script path from UpgradeInstruction::declared_path at the call site.

pub fn duplicate_state_change(from: &str, script: &Path) -> Self

Construct an UpgradeError::DuplicateStateChange naming the offending (:from <prior-versao>) and (:state-change <script>) pair. Folds the uniform Self::DuplicateStateChange { from: from.to_string(), script: script.to_path_buf() } two-field struct-literal onto one substrate primitive so every wire-up on this variant reads through one dispatch rather than the pre-lift three-line open-coded block. The from string threads verbatim from UpgradeFromEntry::prior_versao and the script path from UpgradeInstruction::declared_path at the call site.

pub fn state_change_without_on_state_change_callback( from: &str, script: &Path, ) -> Self

Construct an UpgradeError::StateChangeWithoutOnStateChangeCallback naming the offending (:from <prior-versao>) and (:state-change <script>) pair. Folds the uniform Self::StateChangeWithoutOnStateChangeCallback { from: from.to_string(), script: script.to_path_buf() } two-field struct-literal onto one substrate primitive so every wire-up on this variant reads through one dispatch rather than the pre-lift three-line open-coded block. The from string threads verbatim from UpgradeFromEntry::prior_versao and the script path from UpgradeInstruction::declared_path at the call site.

impl UpgradeError

pub fn absolute_script(script: &Path) -> Self

Construct an UpgradeError::AbsoluteScript naming the offending (:state-change <script>). Folds the uniform Self::AbsoluteScript { script: script.to_path_buf() } one-field struct-literal onto one substrate primitive so every closure passed to crate::render::require_sandboxed_lisp_path at UpgradeInstruction::validate on this variant reads through one dispatch rather than the pre-lift three-line open-coded block. The script path threads verbatim from UpgradeInstruction::declared_path at the call site.

pub fn parent_escape_script(script: &Path) -> Self

Construct an UpgradeError::ParentEscapeScript naming the offending (:state-change <script>). Folds the uniform Self::ParentEscapeScript { script: script.to_path_buf() } one-field struct-literal onto one substrate primitive so every closure passed to crate::render::require_sandboxed_lisp_path at UpgradeInstruction::validate on this variant reads through one dispatch rather than the pre-lift three-line open-coded block. The script path threads verbatim from UpgradeInstruction::declared_path at the call site.

pub fn non_lisp_extension_script(script: &Path) -> Self

Construct an UpgradeError::NonLispExtensionScript naming the offending (:state-change <script>). Folds the uniform Self::NonLispExtensionScript { script: script.to_path_buf() } one-field struct-literal onto one substrate primitive so every closure passed to crate::render::require_sandboxed_lisp_path at UpgradeInstruction::validate on this variant reads through one dispatch rather than the pre-lift three-line open-coded block. The script path threads verbatim from UpgradeInstruction::declared_path at the call site.

Trait Implementations

impl Debug for UpgradeError

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

Formats the value using the given formatter.

impl Display for UpgradeError

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

Formats the value using the given formatter.

impl Eq for UpgradeError

impl Error for UpgradeError

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 PartialEq for UpgradeError

fn eq(&self, other: &UpgradeError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for UpgradeError