Struct Checker 

pub struct Checker { /* private fields */ }

Throttled release checker.

Implementations

impl Checker

pub fn new(cfg: &Update) -> Option<Self>

Build a checker honouring cfg, or None when checking is off.

The Option had no None arm: every caller that asked for a checker got one, so [update] mode = "off" was honoured by the notify path alone (see [cached_update], which matches on the mode itself) and ignored everywhere else. POST /api/upgrade therefore called the GitHub releases API on a deck configured never to check - and so did every unit test that reached that route, unauthenticated, against GitHub’s 60-per-hour-per-address limit.

An operator who writes mode = "off" means it. The button is still theirs to press; what it may not do is go to the network behind a configuration that says not to.

pub fn should_check(&self) -> bool

Is a check due?

pub async fn newer_release(&self) -> Result<Option<LatestRelease>>

Ask the forge now: is there a release newer than this build?

Unlike Checker::cached_update this method does not consult Checker::should_check itself - it has two callers, and they throttle differently. POST /api/upgrade calls it unconditionally, because the caller there is an operator who just pressed a button and is owed an answer about the state of the world rather than about the last time magi looked. magi web’s background recheck (web::run_update_recheck) calls Checker::should_check itself first and only reaches here when it says yes, which is what keeps that task’s network use to at most once per [update] interval no matter how often it polls.

pub fn cached_update(&self) -> Option<LatestRelease>

A newer release already known from a previous run.

pub fn format_banner(&self, latest: &LatestRelease) -> String

One-line “a newer version exists” banner.

Trait Implementations

impl Clone for Checker

fn clone(&self) -> Checker

Returns a duplicate of the value.

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

Performs copy-assignment from source.