Struct Journal 

pub struct Journal<'a> { /* private fields */ }

The sayings of one investigation, kept in a store.

tree is what lets several investigations share one store without seeing each other, and it is in the name for the same reason a study’s is: a name is the one part of this that cannot be refactored later.

Implementations

impl<'a> Journal<'a>

pub fn of(tree: impl Into<String>, kept: &'a dyn Store) -> Self

pub fn say( &self, commit: &str, verdict: Option<Verdict>, who: &str, prose: &str, ) -> Result<u32, Trouble>

Says something about a commit, and returns which slot it landed in.

Claims rather than binds, so two people saying something at the same moment both get heard: whoever is told the slot is taken asks for the next one, exactly as a worker does with a trial.

pub fn all(&self) -> Result<Vec<Saying>, Trouble>

Everything anybody said in this investigation, oldest first.

A scan and no fetches: the prose stays a digest until somebody asks to read it.

pub fn verdicts(&self) -> Result<BTreeMap<String, Verdict>, Trouble>

What each commit’s verdict is: the last one anybody claimed.

Notes in between are not verdicts and do not overwrite one — somebody writing down what they saw has not thereby changed their mind.

pub fn read(&self, saying: &Saying) -> Result<String, Trouble>

The prose of one saying.