Struct Mutations 

pub struct Mutations<V> { /* private fields */ }

A collection of mutations collected during observation.

It is the return type for flush operations.

Behavior

• If no mutations are pushed, into_inner returns None.
• If exactly one mutation is pushed, it is returned as-is.
• If multiple mutations are pushed, they are wrapped in a Batch.

Example

use morphix::{Mutation, MutationKind, Mutations};

let mut mutations = Mutations::new();

mutations.insert("a", MutationKind::Replace(42).into());
mutations.insert("b", MutationKind::Truncate(1).into());

let result = mutations.into_inner();
assert!(matches!(result, Some(Mutation { kind: MutationKind::Batch(_), .. })));

Implementations

impl<V> Mutations<V>

pub fn new() -> Self

Creates a new empty collection.

pub fn with_capacity(capacity: usize) -> Self

Creates a new empty collection with a specified capacity hint.

The capacity hint is used when the internal storage needs to be converted to a Batch to hold multiple mutations.

pub fn into_inner(self) -> Option<Mutation<V>>

Consumes the batch and returns the collected mutation.

pub fn extend(&mut self, mutations: impl Into<Self>)

Merges another collection of mutations into this one.

If the incoming collection contains a Batch with an empty path, its inner mutations are flattened into this collection rather than being nested.

pub fn insert(&mut self, segment: impl Into<PathSegment>, mutations: Self)

Inserts mutations at a specified path segment.

The incoming mutations will have the given segment prepended to their path before being added to this collection.

pub fn insert2( &mut self, segment1: impl Into<PathSegment>, segment2: impl Into<PathSegment>, mutations: Self, )

Inserts mutations at a two-level path.

This is a convenience method primarily used for enum named variants, where mutations need to be inserted at a path like variant_name.field_name.

pub fn len(&self) -> usize

Returns the number of top-level mutations in this collection.

A top-level mutation is one with an empty path. If this collection contains a Batch with an empty path, this returns the number of mutations in that batch. Otherwise, it returns 1 if a mutation exists, or 0 if the collection is empty.

pub fn is_empty(&self) -> bool

Returns true if this collection contains no mutations.

Trait Implementations

impl<V: Clone> Clone for Mutations<V>

fn clone(&self) -> Mutations<V>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<V: Debug> Debug for Mutations<V>

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

Formats the value using the given formatter.

impl<V> Default for Mutations<V>

fn default() -> Self

Returns the “default value” for a type.

impl<V> From<MutationKind<V>> for Mutations<V>

fn from(kind: MutationKind<V>) -> Self

Converts to this type from the input type.

impl<V> From<Mutations<V>> for Option<Mutation<V>>

fn from(value: Mutations<V>) -> Self

Converts to this type from the input type.

impl<V: PartialEq> PartialEq for Mutations<V>

fn eq(&self, other: &Mutations<V>) -> 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<V: Eq> Eq for Mutations<V>

impl<V> StructuralPartialEq for Mutations<V>