Enum Operation 

pub enum Operation {
    Add {
        path: Vec<Strand>,
        value: Value,
    },
    Remove {
        path: Vec<Strand>,
    },
    Replace {
        path: Vec<Strand>,
        value: Value,
    },
    Change {
        path: Vec<Strand>,
        value: Value,
    },
    Copy {
        path: Vec<Strand>,
        from: Vec<Strand>,
    },
    Move {
        path: Vec<Strand>,
        from: Vec<Strand>,
    },
    Test {
        path: Vec<Strand>,
        value: Value,
    },
}

A type representing an delta change to a value.

Variants

Add

Fields

path: Vec<Strand>

value: Value

Remove

Fields

path: Vec<Strand>

Replace

Fields

path: Vec<Strand>

value: Value

Change

Fields

path: Vec<Strand>

value: Value

Copy

Fields

path: Vec<Strand>

from: Vec<Strand>

Move

Fields

path: Vec<Strand>

from: Vec<Strand>

Test

Fields

path: Vec<Strand>

value: Value

Implementations

impl Operation

pub fn walk_revisioned_variant_name( wire_revision: u16, discriminant: u32, ) -> Option<&'static str>

Resolve a wire discriminant at wire_revision to the variant identifier at that revision. Returns None if no such variant exists at that revision.

Generated by the revisioned derive.

pub fn walk_revisioned_variant_table( wire_revision: u16, ) -> &'static [(&'static str, u32)]

Variant name + discriminant pairs at wire_revision. Returns an empty slice if the revision is unknown. Generated by the revisioned derive.

impl Operation

pub const REVISION: u16 = 1u16

The revision number of this type, as declared via #[revisioned(revision = N)].

impl Operation

pub fn array_index(token: &str) -> Option<usize>

The array index a JSON Pointer reference token names, if it names one.

RFC 6901 §4 spells an array index as 0 or [1-9][0-9]*. str::parse is wider than that grammar — it also accepts a leading + and leading zeroes — and those spellings name distinct object members, so the parsed value is re-rendered and compared to reject them. The result is bounded by usize on the target, which is the range an index part can address.

pub fn path_to_parts(path: &[Strand]) -> Vec<Part>

Maps the reference tokens of a JSON Pointer to the parts that select the value it points at.

A token spelled as an array index becomes an index part, which selects the element at that position in an array and the member of that name in an object — the two readings RFC 6901 gives a token, and they agree only because the spelling is canonical, so the member name an index part derives is the token itself. Every other token becomes a field part carrying it verbatim, which keeps members named 007, +3 or -1 addressable.

Every pointer that Value::patch resolves is mapped here, so that a caller deciding whether a pointer may be applied — see Document::check_patch_read_pointers — judges the same location the patch will reach.

pub fn into_object(self) -> Object

Converts the operation to a JSON patch object.

pub fn operation_from_object(object: &Object) -> Result<Operation, PatchError>

Returns the operaton encoded in the object, or an error if the object does not contain a valid operation.

pub fn value_to_operations(value: Value) -> Result<Vec<Operation>, PatchError>

Turns a value into a list of operations if the value has the right structure.

pub fn operations_to_value(operations: Vec<Operation>) -> Value

Trait Implementations

impl Clone for Operation

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 Operation

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

Formats the value using the given formatter.

impl DeserializeRevisioned for Operation

fn deserialize_revisioned<R: Read>(reader: &mut R) -> Result<Self, Error>

Deserializes a new instance of the struct from the specified reader.

impl Eq for Operation

impl Hash for Operation

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Operation

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

Equality operator ==.

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

Inequality operator !=.

impl Revisioned for Operation

fn revision() -> u16

Returns the current revision of this type.

fn type_id() -> TypeId

where Self: 'static,

Returns the type id of this type.

impl SerializeRevisioned for Operation

fn serialize_revisioned<W: Write>(&self, writer: &mut W) -> Result<(), Error>

Serializes the struct using the specified writer.

impl SkipCheckRevisioned for Operation

fn skip_check_revisioned<R: Read>(reader: &mut R) -> Result<(), Error>

impl SkipRevisioned for Operation

fn skip_revisioned<R: Read>(reader: &mut R) -> Result<(), Error>

fn skip_revisioned_slice(reader: &mut SliceReader<'_>) -> Result<(), Error>

Consume through bytes backed by SliceReader without allocating a buffer for bulk segments.

impl StructuralPartialEq for Operation

impl ToSql for Operation

fn fmt_sql(&self, f: &mut String, fmt: SqlFormat)

Format the type to a SQL string.

fn to_sql(&self) -> String

Convert the type to a SQL string.

fn to_sql_pretty(&self) -> String

Convert the type to a pretty-printed SQL string with indentation.

impl WalkRevisioned for Operation

type Walker<'r, R: BorrowedReader + 'r> = OperationWalker<'r, R>

Walker produced by walk_revisioned.

fn walk_revisioned<'r, R: BorrowedReader>( reader: &'r mut R, ) -> Result<Self::Walker<'r, R>, Error>

Read the type’s revision-level prefix and return a walker positioned at the start of the body.