Struct Updater 

pub struct Updater { /* private fields */ }

Reusable update coordinator.

Implementations

impl Updater

pub fn preflight_stage(&self) -> Result<()>

Checks whether the installed executable is safe to update before a transport starts downloading artifact bytes.

Updater::stage repeats this check so callers cannot bypass it or rely on stale preflight state.

pub async fn stage<R>( &self, reader: R, directive: &UpdateDirective, ) -> Result<StagedArtifact>

where R: AsyncRead + Unpin,

impl Updater

pub async fn migrate_state_file( &self, new_state_file: impl Into<PathBuf>, ) -> Result<MigrationOutcome>

Moves this executable’s durable state authority to a new idle marker path.

An initial migration refuses to run while any marker, marker temporary, staged artifact, or rollback artifact exists. Once authority already names the destination, a retry only confirms the directory boundary and does not reject transaction state created through the returned updater. Both success variants carry the updater bound to the new state path; callers must retain it even when the authority rename’s directory sync is reported as indeterminate. Retrying the same migration is idempotent.

pub async fn install( &self, validated: ValidatedArtifact, previous_version: impl Into<String>, ) -> Result<InstallOutcome>

pub async fn recover_on_startup( &self, running_version: &str, ) -> Result<RecoveryAction>

pub async fn confirm_success( &self, running_version: &str, ) -> Result<ConfirmationOutcome>

impl Updater

pub async fn validate( &self, staged: StagedArtifact, ) -> Result<ValidatedArtifact>

Executes --version and consumes the staged artifact on success.

impl Updater

pub fn new(layout: UpdateLayout, policy: UpdatePolicy) -> Self

pub fn layout(&self) -> &UpdateLayout

pub fn policy(&self) -> &UpdatePolicy

Trait Implementations

impl Clone for Updater

fn clone(&self) -> Updater

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Updater

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

Formats the value using the given formatter.