Enum RefreshOutcome 

pub enum RefreshOutcome {
    Unchanged,
    Updated {
        provider_count: usize,
        model_count: usize,
    },
    Offline {
        reason: &'static str,
    },
    Failed {
        reason: String,
    },
}

Outcome of a single refresh attempt.

Why Result and not Result<_, _>: RefreshOutcome::Failed is returned as Ok(Failed) on purpose. Lazy on-call refresh should not break the caller’s success path with an Err — the snapshot still serves stale data. Callers that want to react to failure use match.

Variants

Unchanged

Snapshot unchanged (HTTP 304, mtime fresh, etc.).

Updated

Snapshot replaced with newer data.

Fields

provider_count: usize

Number of providers in the new snapshot.

model_count: usize

Number of models in the new snapshot.

Offline

No network attempted; served from stale cache or SNAP. (e.g. OXICODE_MODELS_DEV_DISABLE_FETCH=1, mtime window fresh.)

Fields

reason: &'static str

Why no network was attempted.

Failed

Refresh attempted and failed. Previous snapshot still in effect. Not an Err — see type-level doc above.

Fields

reason: String

Why the refresh failed.

Trait Implementations

impl Clone for RefreshOutcome

fn clone(&self) -> RefreshOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RefreshOutcome

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

Formats the value using the given formatter.

impl Deserialize<'static> for RefreshOutcome

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'static>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RefreshOutcome

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.