Enum MigrateError 

pub enum MigrateError {
    Io {
        action: String,
        path: PathBuf,
        reason: String,
    },
    Primitive(PrimitiveError),
    UnreadableDirectory {
        path: PathBuf,
        reason: String,
    },
    Journal(String),
    Interrupted(String),
}

What: Why a migration step stopped. String is owned text; PathBuf is an owned path. Why: Each variant has its own wording and its own remedy in the report.

In TS you’d write (pseudocode):

type MigrateError = { kind: 'io'; ... } | { kind: 'primitive'; ... } | { kind: 'unreadable-directory'; ... } | ...;

Variants

Io

An ordinary file operation failed.

Fields

action: String

What was being done, in words.

path: PathBuf

The path involved.

reason: String

The operating system’s words.

Primitive(PrimitiveError)

A kernel primitive failed (ioctl, clone, exchange).

UnreadableDirectory

A directory this user cannot list or search; the migration stops instead of leaving its subtree out.

Fields

path: PathBuf

The directory.

reason: String

The operating system’s words.

Journal(String)

The journal file is unreadable or has an unknown shape.

Interrupted(String)

The run stopped at the named test point.

Implementations

impl MigrateError

pub fn io(action: &str, path: &Path, error: &Error) -> MigrateError

What: An I/O failure with the action and path, from a std::io::Error. Why: One constructor keeps every message in the same shape.

In TS you’d write (pseudocode):

const io = (action: string, path: string, error: Error) => new MigrateError(...);

Trait Implementations

impl Clone for MigrateError

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MigrateError

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

Formats the value using the given formatter.

impl Display for MigrateError

Prints the cause in plain words.

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

Formats the value using the given formatter.

impl Eq for MigrateError

impl Error for MigrateError

A migration error is an error value.

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<PrimitiveError> for MigrateError

A primitive failure is a migration failure.

fn from(error: PrimitiveError) -> MigrateError

Converts to this type from the input type.

impl PartialEq for MigrateError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MigrateError