Struct TextCrdt 

pub struct TextCrdt(/* private fields */);

A collaborative text CRDT based on RGA (Replicated Growable Array).

This is a thin wrapper around Rga<char> that provides text-specific convenience methods like insert_str, remove_range, and Display.

Example

use crdt_kit::prelude::*;

let mut t1 = TextCrdt::new(1);
t1.insert_str(0, "hello").unwrap();

let mut t2 = TextCrdt::new(2);
t2.insert_str(0, "world").unwrap();

t1.merge(&t2);
t2.merge(&t1);

// Both replicas converge to the same text.
assert_eq!(t1.to_string(), t2.to_string());

Implementations

impl TextCrdt

pub fn new(actor: NodeId) -> Self

Create a new empty text CRDT for the given node.

pub fn fork(&self, new_actor: NodeId) -> Self

Create a fork of this replica with a different node ID.

pub fn insert(&mut self, index: usize, ch: char) -> Result<(), TextError>

Insert a character at the given visible index.

pub fn insert_str(&mut self, index: usize, s: &str) -> Result<(), TextError>

Insert a string at the given visible index.

pub fn remove(&mut self, index: usize) -> Result<(), TextError>

Remove (tombstone) the character at the given visible index.

pub fn remove_range( &mut self, start: usize, count: usize, ) -> Result<(), TextError>

Remove a range of characters starting at start with the given count.

pub fn len(&self) -> usize

Return the number of visible (non-deleted) characters.

pub fn is_empty(&self) -> bool

Check whether the visible text is empty.

pub fn actor(&self) -> NodeId

Get this replica’s node ID.

Trait Implementations

impl Clone for TextCrdt

fn clone(&self) -> TextCrdt

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Crdt for TextCrdt

fn merge(&mut self, other: &Self)

Merge another replica’s state into this one.

impl Debug for TextCrdt

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

Formats the value using the given formatter.

impl DeltaCrdt for TextCrdt

type Delta = RgaDelta<char>

The type of delta produced by this CRDT.

fn delta(&self, other: &Self) -> TextDelta

Generate a delta containing changes in self that other does not have.

fn apply_delta(&mut self, delta: &TextDelta)

Apply a delta to this replica’s state.

impl Display for TextCrdt

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

Formats the value using the given formatter.

impl PartialEq for TextCrdt

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

const CURRENT_VERSION: u8 = 1

Current schema version for this CRDT type’s serialization format.

const CRDT_TYPE: CrdtType = CrdtType::TextCrdt

The CRDT type identifier for the envelope.

impl Eq for TextCrdt

impl StructuralPartialEq for TextCrdt