Struct Ledger 

pub struct Ledger {
    pub schema: String,
    pub entries: Vec<Entry>,
}

Every local integration this clone recorded, newest last.

Fields

schema: String

The shape version this document declares.

entries: Vec<Entry>

One entry per branch; a re-integration replaces its predecessor.

Implementations

impl Ledger

pub fn parse(text: &str) -> Result<Self, String>

Parse a stored ledger.

An absent file is an empty ledger, because a clone that never integrated locally has recorded nothing. Malformed content refuses rather than reading as empty: an empty ledger authorizes no deletion, so a silent downgrade would be safe, but it would also hide a defect that loses real evidence.

Errors

The detail of what could not be read: invalid JSON, or a schema this binary does not know.

pub fn render(&self) -> Result<String, String>

The stored form, one trailing newline.

Errors

A serialization defect in this binary.

pub fn record(&mut self, entry: Entry)

Record one integration, replacing any earlier entry for the same branch: a branch name is reused, and the ledger answers for the branch standing now.

pub fn proof(&self, branch: &str, tip: &str) -> Option<&Entry>

The proof this ledger offers for one branch at one observed tip.

The tip must match exactly, re-observed by the caller at the moment of action. A branch that advanced after its integration has work the trunk does not carry, so it is not a candidate at all.

pub fn names(&self, branch: &str) -> bool

Whether this ledger holds any entry for one branch, at whatever tip. The prune reports use it to tell a branch that was never integrated from one that advanced after it was.

pub fn forget(&mut self, branch: &str)

Forget one branch’s entry, after the branch itself is gone.

Trait Implementations

impl Clone for Ledger

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Ledger

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

Formats the value using the given formatter.

impl Default for Ledger

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Ledger

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Ledger

impl PartialEq for Ledger

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Ledger

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 Ledger