Struct Ledger 

pub struct Ledger { /* private fields */ }

Where live-run records are kept.

One file per run rather than one file with many lines: a run ending is a deletion, and deleting a file is atomic in a way that rewriting a shared file after a crash is not.

Implementations

impl Ledger

pub fn open(root: impl Into<PathBuf>) -> Result<Self>

Opens — and creates — the directory live records are kept in.

Errors

Returns an error when the directory cannot be created.

pub fn starting(&self, live: &Live) -> Result<()>

Records that a run is about to start.

Call this before spawning. The record is the only evidence the run existed if the supervisor does not survive to write another.

Errors

Returns an error when the record cannot be written.

pub fn finished(&self, run: &RunId) -> Result<()>

Forgets a run that has been seen to finish.

Errors

Returns an error when the record exists and cannot be removed.

pub fn live(&self) -> Result<Vec<Live>>

Every run recorded as started and not recorded as finished.

Errors

Returns an error when the directory cannot be read.

pub fn root(&self) -> &Path

The directory records are kept in.

Trait Implementations

impl Clone for Ledger

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Ledger

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

Formats the value using the given formatter.