Struct ActiveClock 

pub struct ActiveClock {
    pub banked_secs: u64,
    pub since: Option<i64>,
}

A stopwatch that runs only while the thing it measures is actually working.

Wall-clock age and working time are different questions, and the difference is the whole point of this type: a run paused overnight is twelve hours old and spent eleven of them doing nothing. Age comes from started_at; this is what a reader means by “how long has this taken”.

Kept as banked seconds plus the start of the span in progress, rather than a single total, so a reader that polls between writes still sees the number climb instead of stepping once per heartbeat.

Fields

banked_secs: u64

Seconds banked from spans that have already ended.

since: Option<i64>

When the span in progress began, or None while the clock is stopped.

Implementations

impl ActiveClock

pub fn observe(&mut self, now: i64, running: bool)

Start or stop the clock to match running, banking the span that ends.

Idempotent: called every persist tick with the same answer, it does nothing, so only genuine transitions move the accounting.

pub fn settle(&mut self, as_of: i64)

Close the span in progress at as_of, banking it.

For a clock read back from disk: whatever the run was doing stopped when the daemon holding it did, which is the last moment the record was written - not now. Without this, a run reloaded after the daemon was down for a day comes back claiming a day’s work.

pub fn total_secs(&self, now: i64) -> u64

Working seconds at now, counting the span in progress.

Trait Implementations

impl Clone for ActiveClock

fn clone(&self) -> ActiveClock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ActiveClock

impl Debug for ActiveClock

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

Formats the value using the given formatter.

impl Default for ActiveClock

fn default() -> ActiveClock

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ActiveClock

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ActiveClock

impl PartialEq for ActiveClock

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ActiveClock

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ActiveClock