Struct Commit 

pub struct Commit {
    pub format_version: u16,
    pub parents: Vec<ContentHash>,
    pub tree: BTreeMap<String, TreeEntry>,
    pub author: String,
    pub message: String,
    pub resolves: Option<ContentHash>,
}

A content-addressed commit: parents, a path→entry tree, metadata.

Fields

format_version: u16

Wire-format version; see FORMAT_VERSION.

parents: Vec<ContentHash>

Parent commit ids (0 = root, 2+ = merge).

tree: BTreeMap<String, TreeEntry>

Path → entry, sorted (BTreeMap) so serialization is canonical.

author: String

Author identity string (key-backed from L8 onward).

message: String

Commit message.

resolves: Option<ContentHash>

The commit whose TreeEntry::Conflict this commit resolves, when it is a resolution — resolution-as-linked-change, as metadata on the existing shape (DECISIONS.md D15: never a new merge substrate). A conflict is a value (invariant 6): the link points at the conflicted commit, which stays in history untouched. Additive (default + skip_serializing_if), so commits written before the field existed decode as None and re-serialize byte-identically — invariant 1.

Implementations

impl Commit

pub fn is_conflicted(&self) -> bool

Whether any tree entry is an unresolved TreeEntry::Conflict.

pub fn validate_resolves(&self, store: &dyn ChunkStore) -> Result<(), ViewError>

Validates this commit’s resolves link against store.

A Some link must name a commit the store holds whose tree still carries an unresolved TreeEntry::Conflict — anything else is refused, never silently dropped: a dangling link admitted once would replay forever as a claim about a conflict nobody can load. None validates trivially (most commits resolve nothing).

Errors

Returns ViewError::Resolution when the link is dangling or the referenced commit has no conflict to resolve.

pub fn put(&self, store: &mut dyn ChunkStore) -> Result<ContentHash, ViewError>

Stores this commit in store and returns its content address.

Errors

Propagates ViewError::Store from the underlying store.

pub fn get(store: &dyn ChunkStore, id: &ContentHash) -> Result<Self, ViewError>

Loads the commit at id from store, verifying its address.

Errors

Returns ViewError::Store on lookup/verification failure and ViewError::Decode when the bytes are not a commit.

Trait Implementations

impl Clone for Commit

fn clone(&self) -> Commit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Commit

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Commit

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Commit

fn eq(&self, other: &Commit) -> 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 Commit

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 Commit

impl StructuralPartialEq for Commit