Struct SnapshotMeta 

#[non_exhaustive]
pub struct SnapshotMeta {
    pub generation: u64,
    pub loaded_at: Instant,
}

What is true of the snapshot currently installed.

The operator’s questions — which generation is live, how stale is it — answered without the program having to record anything itself. Read it through ConfigCell::meta or Dynamic::meta. (Re-exported at the crate root as dynamic_config::SnapshotMeta.)

For operators, not for correctness. Metadata deliberately does not live on the read path: load is one atomic load and stays that way, so the value and its metadata are two loads and a reload landing between them leaves the pair one install apart. Code that needs the value and its generation to agree should carry a generation inside the configuration type.

Instant rather than a wall clock, because the question this answers is “how long ago”, which is a duration — and a wall clock can go backwards under NTP while a staleness check must not.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

generation: u64

Installs since the process started. Monotonic; zero before the first.

loaded_at: Instant

When this snapshot was installed.

Trait Implementations

impl Clone for SnapshotMeta

fn clone(&self) -> SnapshotMeta

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SnapshotMeta

impl Debug for SnapshotMeta

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

Formats the value using the given formatter.

impl Eq for SnapshotMeta

impl PartialEq for SnapshotMeta

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SnapshotMeta