Struct Revision 

pub struct Revision {
    pub patch: Patch,
    pub duplicates: Vec<(String, String)>,
    pub resulting_data_hash: Sha256Hex,
}

A commit on a governance entry: an RFC 6902 patch from its previous version to the next.

Nothing is overwritten. The entry keeps the data it was signed with, and its latest version is derived by applying every revision’s patch in chain order, as git derives a checkout from its commits. See AmendmentDraft::revision.

A value a patch adds (add, replace, test) lives in the amendment, which redaction cannot reach yet; removals, moves and copies carry no content.

Fields

patch: Patch

From the previous version to this one

duplicates: Vec<(String, String)>

For each remove of a duplicate, the removed path and the path it duplicated: what a later redaction of the one must also erase from the stored original. Not test ops, which would carry the values.

resulting_data_hash: Sha256Hex

What the entry’s data hashes to after patch

Implementations

impl Revision

pub fn validate(&self) -> Result<(), ReviseError>

Everything wrong with it that is checkable without data: an empty patch, or a duplicate the patch does not remove

pub fn remove_duplicates( data: &Value, pairs: &[(&str, &str)], ) -> Result<Edit, ReviseError>

An Edit removing each (path, same_as) pair’s path, whose value is byte-identical (as canonical_json) to same_as’s, which it leaves in place

Trait Implementations

impl Clone for Revision

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 Revision

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Revision

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Revision

impl PartialEq for Revision

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Revision

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 Revision