Struct Days 

pub struct Days(pub BTreeMap<Date, BTreeMap<String, DayBlock>>);

Each day’s changes, by day: $XDG_DATA_HOME/sioul/health-days.toml, shared with your own devices as the health file is (the sharing’s health part). Days more than two weeks past are dropped.

Tuple Fields

0: BTreeMap<Date, BTreeMap<String, DayBlock>>

Implementations

impl Days

pub fn default_path() -> PathBuf

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

The days’ changes; none when there is no file. One that no longer reads (edited by hand) is copied aside first (health-days.toml.unreadable): saving over it then loses nothing.

pub fn change_file<R>( path: &Path, today: Date, change: impl FnOnce(&mut Days) -> R, ) -> Result<R, String>

Read, changed by change and written back, all under the file’s lock, which the sharing takes too: a change is set over the file as it is then, never over a copy read earlier. Returns what change returns.

pub fn save(&self, path: &Path, today: Date) -> Result<(), String>

Written next to its place, then moved: never half a file. Yours alone. Days more than two weeks before today go, and blocks left as usual. Under the file’s lock, which the sharing takes too.

fn write(&self, path: &Path, today: Date) -> Result<(), String>

pub fn get(&self, date: Date, key: &str) -> Option<&DayBlock>

A block’s change on a day, if any.

pub fn change( &mut self, date: Date, key: &str, change: impl FnOnce(&mut DayBlock), )

The block key of date changed by change; back to usual when nothing is left of the change.

pub fn forget(&mut self, date: Date, key: &str)

A block’s change taken back: as usual that day (an added one: gone).

pub fn removed_usual(&mut self, kind: &str, index: usize)

A usual block taken out of the settings (its kind, its place): its changes go, and those of the blocks after it follow them to their new place (“meal:2” becomes “meal:1”).

pub fn new_key(&self, date: Date, now_ms: i64) -> String

A key for a block added on date, from now in milliseconds: two devices adding one the same day never name theirs alike.

Trait Implementations

impl Clone for Days

fn clone(&self) -> Days

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Days

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

Formats the value using the given formatter.

impl Default for Days

fn default() -> Days

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Days

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Days

impl PartialEq for Days

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Days

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 Days