Struct MigrationReport 

#[non_exhaustive]
pub struct MigrationReport { /* private fields */ }

What AppRoot::migrate_from_with did: the MigrationOutcome plus what an opt-in migration did with links, special files and reparse points. The lists describe this call’s work only (they are empty when the outcome is NothingToMigrate; the state file holds the record of an earlier call). The one exception is a rerun that retries the omissions of a ReadyWithOmissions migration: its migrated_links are the links created now, and omitted_optional_links and skipped_reparse_points are what is still unresolved.

Implementations

impl MigrationReport

pub fn state(&self) -> MigrationState

How far the migration got. A returned report is Ready or ReadyWithOmissions; an incomplete migration is an error, and its state is read with AppRoot::migration_state.

pub fn skipped_reparse_points(&self) -> &[SkippedReparsePoint]

Junctions and other Windows reparse points skipped on request (see MigrateOptions::skip_reparse_points). None is ever followed, copied or recreated.

pub fn outcome(&self) -> &MigrationOutcome

The same value migrate_from returns.

pub fn into_outcome(self) -> MigrationOutcome

pub fn migrated_links(&self) -> &[MigratedLink]

Symlinks recreated in the app root (as link entries, never followed).

pub fn skipped_specials(&self) -> &[SkippedSpecial]

Sockets and FIFOs skipped (see MigrateOptions::skip_ephemeral_specials).

pub fn omitted_optional_links(&self) -> &[OmittedLink]

Links the caller’s policy marked optional and that could not be created. A required link that cannot be created is an error instead (AppRootError::link_not_created).

pub fn complete(&self) -> bool

True only for MigrationState::Ready: false when an optional link was omitted or a reparse point was skipped. Skipped ephemeral specials (sockets, FIFOs) do not make a migration incomplete. For AlreadyMigrated this is the value the earlier state recorded.

Trait Implementations

impl Clone for MigrationReport

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 MigrationReport

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

Formats the value using the given formatter.

impl Eq for MigrationReport

impl PartialEq for MigrationReport

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MigrationReport