Enum MigrationError 

pub enum MigrationError {
    StepFailed {
        name: &'static str,
        from: GenomeSchemaVersion,
        to: GenomeSchemaVersion,
        reason: String,
    },
    MissingMigrator {
        from: GenomeSchemaVersion,
        target: GenomeSchemaVersion,
    },
    InvalidRegistry(String),
    DowngradeRefused {
        from: GenomeSchemaVersion,
        target: GenomeSchemaVersion,
    },
    DetectionFailed(String),
}

Errors emitted by migrators and by the chain machinery itself.

Variants

StepFailed

A migrator returned an error during its migrate call.

Fields

name: &'static str

from: GenomeSchemaVersion

to: GenomeSchemaVersion

reason: String

MissingMigrator

The runner needed a migrator for a version but the registry didn’t have one. Indicates a gap in the chain.

Fields

from: GenomeSchemaVersion

target: GenomeSchemaVersion

InvalidRegistry(String)

A migrator’s declared to_version is not exactly from_version + 1, or two migrators share a from_version. The runner refuses to start in either case; see the README’s “registry MUST be contiguous” rule.

DowngradeRefused

The genome’s detected schema version is newer than the requested target. Forward-only migrations are by design.

Fields

from: GenomeSchemaVersion

target: GenomeSchemaVersion

DetectionFailed(String)

detect_schema_version could not resolve the input genome.

Trait Implementations

impl Debug for MigrationError

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

Formats the value using the given formatter.

impl Display for MigrationError

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

Formats the value using the given formatter.

impl Error for MigrationError

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.