Struct Row 

pub struct Row {
    pub rev: Rev,
    pub kind: RowKind,
    pub wall_time: WallTime,
    pub author: Identity,
    pub label: String,
    pub scope: ScopePath,
    pub scope_names: Vec<String>,
    pub camera: Camera,
    pub touched: Vec<EntityRef>,
    pub truncated: bool,
    pub hash: Digest,
    pub parent: Digest,
}

One line of manifest.jsonl.

Fields

rev: Rev

kind: RowKind

wall_time: WallTime

author: Identity

label: String

scope: ScopePath

Where the author was standing: every scope is a coordinate space of its own, so a camera without one means nothing.

scope_names: Vec<String>

The same path as its author saw it spelled, outermost first. Recorded at seal beside the ids rather than resolved at read time, so a row still reads its own path after the blocks along it are renamed or deleted. Empty at the root.

camera: Camera

touched: Vec<EntityRef>

The entities the act named, in EntityRef’s narration spelling — the grep index, advisory in the same sense scope has always been.

truncated: bool

Whether TOUCHED cut the list short.

hash: Digest

The blake3 of the rev file this row names. A tag has no rev file of its own and stamps the head it was appended under, which is what makes a tag written against another history detectable.

parent: Digest

The digest of the previous row’s canonical bytes, or Digest::genesis for the first.

Implementations

impl Row

pub fn canonical_bytes(&self) -> Vec<u8>

The bytes this row is written as, and the bytes its successor’s parent hashes over: serde_json with object keys sorted and no whitespace. One definition for both, so a round trip through the file cannot break the chain that verifies it.

pub fn digest(&self) -> Digest

The link the next row carries as its parent.

pub fn digest_as_written(&self, line: &str) -> Digest

The same link, computed against the line a file actually holds, so a row an older build spelled differently still links as it did.

pub fn naming(touched: Vec<EntityRef>) -> (Vec<EntityRef>, bool)

The names of the entities touched holds, cut to TOUCHED.

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 StructuralPartialEq for Row