Struct Row 

pub struct Row {
    pub rev: Rev,
    pub label: String,
    pub touched: usize,
    pub written: Option<Written>,
    pub tags: Vec<String>,
}

One rev as a reader sees it. Owned, so a view can carry the rows away from the history they were read off.

Fields

rev: Rev

label: String

touched: usize

How many entities the act named — blockworx log‘s count column. The panel shows the entities’ scope instead, so this is the dump’s alone.

written: Option<Written>

What the manifest row behind this one records beyond the commit. None for a scratch session.

tags: Vec<String>

What this rev is called, where tag rows named it — alphabetical, and empty for an untagged rev.

Implementations

impl Row

fn kind_written(&self) -> Option<RowKind>

fn wall_time(&self) -> Option<WallTime>

pub fn kind_of(&self) -> Kind

What this rev did to its neighbours, without the rev it did it to. A session keeping no rows has only its commits, and a commit is an edit.

pub fn is_inverse(&self) -> bool

Whether this rev is an inverse rather than a design decision — rendered muted and italic in the panel so a reader scanning for when something changed can read past it. A session with no rows has only the label it wrote, which still says so.

pub fn undone(&self) -> Option<Rev>

Which rev this one took back, where the row says so — what the panel’s Undo — <original> is titled from.

pub fn kind(&self) -> String

The row’s kind column: Self::kind_of and the rev it names.

pub fn scope_names(&self) -> &[String]

The scope line: the blocks the act happened inside, outermost first, as its author saw them spelled. Empty at the document root and for a session that recorded no path.

pub fn initials(&self) -> String

The author’s initials, for the row’s avatar. Two at most, and a name with nothing in it shows nothing rather than a placeholder letter.

pub fn time(&self) -> String

The clock time this rev was written, without its date: the day is in the group heading, so the row says only the time. Empty for a session that carried no clock.

fn time_in(&self, zone: &TimeZone) -> String

pub fn since(&self, now: WallTime) -> String

How long ago this was written, as a person would say it — “3 hours ago”. The viewing pill’s half of the clock; the history row says the time instead. Empty for a session that carried no clock, and for a row whose stamp is in now’s future (a clock that went backwards, or a container written on another machine).

pub fn full_when(&self) -> String

The whole instant as a reader would say it — what the time hovers to and what the picked rev’s card shows in full.

fn full_when_in(&self, zone: &TimeZone) -> String

pub fn day(&self) -> Option<Day>

The day this rev was written. None for a session that carried no clock — there is no day to group it under.

fn day_in(&self, zone: &TimeZone) -> Option<Day>

pub fn author(&self) -> &str

pub fn when(&self) -> String

The wall time as a person reads it, in this machine’s own zone. Empty for a session that never carried one.

fn when_in(&self, zone: &TimeZone) -> String

Self::when against a named zone — the seam a test pins so its expected text does not depend on where the machine is.

Trait Implementations

impl Clone for Row

fn clone(&self) -> Row

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Row

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Row

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Row

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Row

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Row

impl StructuralPartialEq for Row