Enum MigrationState 

#[non_exhaustive]
pub enum MigrationState {
    Ready,
    ReadyWithOmissions,
    Incomplete,
}

How far a migration into an app root got. Recorded in the versioned state file (MIGRATION_STATE); read it with AppRoot::migration_state or MigrationReport::state.

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.

Ready

Everything in the recorded scope was migrated & verified. Whole-tree scope also writes the historical marker MIGRATION_MARKER.

ReadyWithOmissions

Every required entry is in place. Only entries the caller declared disposable are missing, and each is recorded (optional links that could not be created, reparse points skipped on request). The destination is usable. The historical marker is not written, so a reader of an earlier version does not take it for a complete move; a rerun retries the omitted links.

Incomplete

The copy was started and not finished (interrupted, or stopped by a failure such as a required link the destination cannot create). The destination is not usable: the old root stays the authority. A rerun verifies and finishes the copy. No historical marker exists.

Implementations

impl MigrationState

pub fn as_str(self) -> &'static str

The name written in the state file: ready, ready_with_omissions or incomplete.

pub fn is_usable(self) -> bool

True when the destination may be used as the app’s data root (Ready or ReadyWithOmissions).

Trait Implementations

impl Clone for MigrationState

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MigrationState

impl Debug for MigrationState

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

Formats the value using the given formatter.

impl Eq for MigrationState

impl PartialEq for MigrationState

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MigrationState