Enum Freshness 

pub enum Freshness {
    Current,
    Stale,
    Pending,
}

How a reading stands against the repository as it is now.

use majordomus_cli::capability::readings::{read, Freshness, Patience};
use majordomus_cli::synthetic::SyntheticRepository;
use std::time::Duration;

let repo = SyntheticRepository::small().unwrap();
let ctx = repo.context().unwrap();
// a caller with no patience at all is told the first reading is pending, or handed it
// when the worker was quicker than the caller: never anything in between
let none = Patience { cold: Duration::ZERO, moved: Duration::ZERO };
let first = read(&ctx, "plan.status", serde_json::json!({}), none);
assert!(matches!(first.freshness, Freshness::Pending | Freshness::Current));
// and a caller that waits is handed a current one; nothing here moved the repository,
// so nothing is `Freshness::Stale`
let waited = read(&ctx, "plan.status", serde_json::json!({}), Patience::WAIT);
assert_eq!(waited.freshness, Freshness::Current);
assert_ne!(waited.freshness, Freshness::Stale);

Variants

Current

Read in the repository as it is now.

Stale

Read before the repository last moved.

Pending

Never read in this process; the first reading has not arrived.

Trait Implementations

impl Clone for Freshness

fn clone(&self) -> Freshness

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Freshness

impl Debug for Freshness

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

Formats the value using the given formatter.

impl Eq for Freshness

impl PartialEq for Freshness

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Freshness