Struct Timers 

pub struct Timers {
    pub version: u32,
    pub running: BTreeMap<String, Entry>,
}

Fields

version: u32

running: BTreeMap<String, Entry>

org/KEY -> when it started.

Implementations

impl Timers

pub fn load(path: &Path) -> Self

Read them, or start empty.

Unlike the queue cache, an unreadable file here loses work somebody did: it is still not an error to read, because refusing to start a new timer because an old file is corrupt helps nobody, but it is logged rather than passed over in silence.

pub fn save(&mut self, path: &Path) -> Result<()>

Write them back.

pub fn get(&self, org: &str, key: &str) -> Option<&Entry>

The timer for this issue in this organisation.

pub fn start( &mut self, org: &str, profile: &str, key: &str, at: Timestamp, ) -> Result<(), &Entry>

Start one, refusing to replace a timer that is already running.

Replacing it would throw away however long it had been running, which is exactly the data the command exists to keep.

pub fn take(&mut self, org: &str, key: &str) -> Option<Entry>

Take one off the list.

pub fn elsewhere(&self, org: &str, key: &str) -> Option<&Entry>

The same issue key running in some other organisation.

What this answers is the confusing case: a timer was started as work and stopped as personal, and “no timer running” would be a true sentence that sends somebody looking in the wrong place.

pub fn all(&self) -> Vec<&Entry>

Everything running, oldest first — the one most likely to be forgotten.

Trait Implementations

impl Clone for Timers

fn clone(&self) -> Timers

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Timers

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

Formats the value using the given formatter.

impl Default for Timers

fn default() -> Timers

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Timers

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Timers

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

where __S: Serializer,

Serialize this value into the given Serde serializer.