123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547 |
- use crate::{
- core::{operation::*, DeltaIter, FlowyStr, Interval, OperationTransformable, MAX_IV_LEN},
- errors::{ErrorBuilder, OTError, OTErrorCode},
- };
- use bytes::Bytes;
- use serde::de::DeserializeOwned;
- use std::{
- cmp::{min, Ordering},
- fmt,
- iter::FromIterator,
- str,
- str::FromStr,
- };
- // TODO: optimize the memory usage with Arc_mut or Cow
- #[derive(Clone, Debug, PartialEq, Eq)]
- pub struct Delta<T: Attributes> {
- pub ops: Vec<Operation<T>>,
- pub base_len: usize,
- pub target_len: usize,
- }
- impl<T> Default for Delta<T>
- where
- T: Attributes,
- {
- fn default() -> Self {
- Self {
- ops: Vec::new(),
- base_len: 0,
- target_len: 0,
- }
- }
- }
- impl<T> fmt::Display for Delta<T>
- where
- T: Attributes,
- {
- fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
- // f.write_str(&serde_json::to_string(self).unwrap_or("".to_owned()))?;
- f.write_str("[ ")?;
- for op in &self.ops {
- f.write_fmt(format_args!("{} ", op))?;
- }
- f.write_str("]")?;
- Ok(())
- }
- }
- impl<T> FromIterator<Operation<T>> for Delta<T>
- where
- T: Attributes,
- {
- fn from_iter<I: IntoIterator<Item = Operation<T>>>(ops: I) -> Self {
- let mut operations = Delta::default();
- for op in ops {
- operations.add(op);
- }
- operations
- }
- }
- impl<T> Delta<T>
- where
- T: Attributes,
- {
- pub fn new() -> Self { Self::default() }
- #[inline]
- pub fn with_capacity(capacity: usize) -> Self {
- Self {
- ops: Vec::with_capacity(capacity),
- base_len: 0,
- target_len: 0,
- }
- }
- pub fn add(&mut self, op: Operation<T>) {
- match op {
- Operation::Delete(i) => self.delete(i),
- Operation::Insert(i) => self.insert(&i.s, i.attributes),
- Operation::Retain(r) => self.retain(r.n, r.attributes),
- }
- }
- pub fn delete(&mut self, n: usize) {
- if n == 0 {
- return;
- }
- self.base_len += n as usize;
- if let Some(Operation::Delete(n_last)) = self.ops.last_mut() {
- *n_last += n;
- } else {
- self.ops.push(OpBuilder::delete(n).build());
- }
- }
- pub fn insert(&mut self, s: &str, attributes: T) {
- let s: FlowyStr = s.into();
- if s.is_empty() {
- return;
- }
- self.target_len += s.count_utf16_code_units();
- let new_last = match self.ops.as_mut_slice() {
- [.., Operation::<T>::Insert(insert)] => {
- //
- insert.merge_or_new_op(&s, attributes)
- },
- [.., Operation::<T>::Insert(pre_insert), Operation::Delete(_)] => {
- //
- pre_insert.merge_or_new_op(&s, attributes)
- },
- [.., op_last @ Operation::<T>::Delete(_)] => {
- let new_last = op_last.clone();
- *op_last = OpBuilder::<T>::insert(&s).attributes(attributes).build();
- Some(new_last)
- },
- _ => Some(OpBuilder::<T>::insert(&s).attributes(attributes).build()),
- };
- match new_last {
- None => {},
- Some(new_last) => self.ops.push(new_last),
- }
- }
- pub fn retain(&mut self, n: usize, attributes: T) {
- if n == 0 {
- return;
- }
- self.base_len += n as usize;
- self.target_len += n as usize;
- if let Some(Operation::<T>::Retain(retain)) = self.ops.last_mut() {
- if let Some(new_op) = retain.merge_or_new(n, attributes) {
- self.ops.push(new_op);
- }
- } else {
- self.ops.push(OpBuilder::<T>::retain(n).attributes(attributes).build());
- }
- }
- /// Applies an operation to a string, returning a new string.
- pub fn apply(&self, s: &str) -> Result<String, OTError> {
- let s: FlowyStr = s.into();
- if s.count_utf16_code_units() != self.base_len {
- return Err(ErrorBuilder::new(OTErrorCode::IncompatibleLength).build());
- }
- let mut new_s = String::new();
- let code_point_iter = &mut s.code_point_iter();
- for op in &self.ops {
- match &op {
- Operation::Retain(retain) => {
- for c in code_point_iter.take(retain.n as usize) {
- new_s.push_str(str::from_utf8(c.0).unwrap_or(""));
- }
- },
- Operation::Delete(delete) => {
- for _ in 0..*delete {
- code_point_iter.next();
- }
- },
- Operation::Insert(insert) => {
- new_s += &insert.s;
- },
- }
- }
- Ok(new_s)
- }
- /// Computes the inverse of an operation. The inverse of an operation is the
- /// operation that reverts the effects of the operation
- pub fn invert_str(&self, s: &str) -> Self {
- let mut inverted = Delta::default();
- let chars = &mut s.chars();
- for op in &self.ops {
- match &op {
- Operation::Retain(retain) => {
- inverted.retain(retain.n, T::default());
- // TODO: use advance_by instead, but it's unstable now
- // chars.advance_by(retain.num)
- for _ in 0..retain.n {
- chars.next();
- }
- },
- Operation::Insert(insert) => {
- inverted.delete(insert.count_of_utf16_code_units());
- },
- Operation::Delete(delete) => {
- inverted.insert(&chars.take(*delete as usize).collect::<String>(), op.get_attributes());
- },
- }
- }
- inverted
- }
- /// Checks if this operation has no effect.
- #[inline]
- pub fn is_noop(&self) -> bool { matches!(self.ops.as_slice(), [] | [Operation::Retain(_)]) }
- pub fn is_empty(&self) -> bool { self.ops.is_empty() }
- pub fn extend(&mut self, other: Self) { other.ops.into_iter().for_each(|op| self.add(op)); }
- }
- impl<T> OperationTransformable for Delta<T>
- where
- T: Attributes,
- {
- fn compose(&self, other: &Self) -> Result<Self, OTError>
- where
- Self: Sized,
- {
- let mut new_delta = Delta::default();
- let mut iter = DeltaIter::new(self);
- let mut other_iter = DeltaIter::new(other);
- while iter.has_next() || other_iter.has_next() {
- if other_iter.is_next_insert() {
- new_delta.add(other_iter.next_op().unwrap());
- continue;
- }
- if iter.is_next_delete() {
- new_delta.add(iter.next_op().unwrap());
- continue;
- }
- let length = min(
- iter.next_op_len().unwrap_or(MAX_IV_LEN),
- other_iter.next_op_len().unwrap_or(MAX_IV_LEN),
- );
- let op = iter
- .next_op_with_len(length)
- .unwrap_or_else(|| OpBuilder::retain(length).build());
- let other_op = other_iter
- .next_op_with_len(length)
- .unwrap_or_else(|| OpBuilder::retain(length).build());
- // debug_assert_eq!(op.len(), other_op.len(), "Composing delta failed,");
- match (&op, &other_op) {
- (Operation::Retain(retain), Operation::Retain(other_retain)) => {
- let composed_attrs = retain.attributes.compose(&other_retain.attributes)?;
- new_delta.add(OpBuilder::retain(retain.n).attributes(composed_attrs).build())
- },
- (Operation::Insert(insert), Operation::Retain(other_retain)) => {
- let mut composed_attrs = insert.attributes.compose(&other_retain.attributes)?;
- composed_attrs.remove_empty();
- new_delta.add(OpBuilder::insert(op.get_data()).attributes(composed_attrs).build())
- },
- (Operation::Retain(_), Operation::Delete(_)) => {
- new_delta.add(other_op);
- },
- (a, b) => {
- debug_assert_eq!(a.is_insert(), true);
- debug_assert_eq!(b.is_delete(), true);
- continue;
- },
- }
- }
- Ok(new_delta)
- }
- fn transform(&self, other: &Self) -> Result<(Self, Self), OTError>
- where
- Self: Sized,
- {
- if self.base_len != other.base_len {
- return Err(ErrorBuilder::new(OTErrorCode::IncompatibleLength)
- .msg(format!(
- "cur base length: {}, other base length: {}",
- self.base_len, other.base_len
- ))
- .build());
- }
- let mut a_prime = Delta::default();
- let mut b_prime = Delta::default();
- let mut ops1 = self.ops.iter().cloned();
- let mut ops2 = other.ops.iter().cloned();
- let mut next_op1 = ops1.next();
- let mut next_op2 = ops2.next();
- loop {
- match (&next_op1, &next_op2) {
- (None, None) => break,
- (Some(Operation::Insert(insert)), _) => {
- // let composed_attrs = transform_attributes(&next_op1, &next_op2, true);
- a_prime.insert(&insert.s, insert.attributes.clone());
- b_prime.retain(insert.count_of_utf16_code_units(), insert.attributes.clone());
- next_op1 = ops1.next();
- },
- (_, Some(Operation::Insert(o_insert))) => {
- let composed_attrs = transform_op_attribute(&next_op1, &next_op2)?;
- a_prime.retain(o_insert.count_of_utf16_code_units(), composed_attrs.clone());
- b_prime.insert(&o_insert.s, composed_attrs);
- next_op2 = ops2.next();
- },
- (None, _) => {
- return Err(ErrorBuilder::new(OTErrorCode::IncompatibleLength).build());
- },
- (_, None) => {
- return Err(ErrorBuilder::new(OTErrorCode::IncompatibleLength).build());
- },
- (Some(Operation::Retain(retain)), Some(Operation::Retain(o_retain))) => {
- let composed_attrs = transform_op_attribute(&next_op1, &next_op2)?;
- match retain.cmp(&o_retain) {
- Ordering::Less => {
- a_prime.retain(retain.n, composed_attrs.clone());
- b_prime.retain(retain.n, composed_attrs.clone());
- next_op2 = Some(OpBuilder::retain(o_retain.n - retain.n).build());
- next_op1 = ops1.next();
- },
- Ordering::Equal => {
- a_prime.retain(retain.n, composed_attrs.clone());
- b_prime.retain(retain.n, composed_attrs.clone());
- next_op1 = ops1.next();
- next_op2 = ops2.next();
- },
- Ordering::Greater => {
- a_prime.retain(o_retain.n, composed_attrs.clone());
- b_prime.retain(o_retain.n, composed_attrs.clone());
- next_op1 = Some(OpBuilder::retain(retain.n - o_retain.n).build());
- next_op2 = ops2.next();
- },
- };
- },
- (Some(Operation::Delete(i)), Some(Operation::Delete(j))) => match i.cmp(&j) {
- Ordering::Less => {
- next_op2 = Some(OpBuilder::delete(*j - *i).build());
- next_op1 = ops1.next();
- },
- Ordering::Equal => {
- next_op1 = ops1.next();
- next_op2 = ops2.next();
- },
- Ordering::Greater => {
- next_op1 = Some(OpBuilder::delete(*i - *j).build());
- next_op2 = ops2.next();
- },
- },
- (Some(Operation::Delete(i)), Some(Operation::Retain(o_retain))) => {
- match i.cmp(&o_retain) {
- Ordering::Less => {
- a_prime.delete(*i);
- next_op2 = Some(OpBuilder::retain(o_retain.n - *i).build());
- next_op1 = ops1.next();
- },
- Ordering::Equal => {
- a_prime.delete(*i);
- next_op1 = ops1.next();
- next_op2 = ops2.next();
- },
- Ordering::Greater => {
- a_prime.delete(o_retain.n);
- next_op1 = Some(OpBuilder::delete(*i - o_retain.n).build());
- next_op2 = ops2.next();
- },
- };
- },
- (Some(Operation::Retain(retain)), Some(Operation::Delete(j))) => {
- match retain.cmp(&j) {
- Ordering::Less => {
- b_prime.delete(retain.n);
- next_op2 = Some(OpBuilder::delete(*j - retain.n).build());
- next_op1 = ops1.next();
- },
- Ordering::Equal => {
- b_prime.delete(retain.n);
- next_op1 = ops1.next();
- next_op2 = ops2.next();
- },
- Ordering::Greater => {
- b_prime.delete(*j);
- next_op1 = Some(OpBuilder::retain(retain.n - *j).build());
- next_op2 = ops2.next();
- },
- };
- },
- }
- }
- Ok((a_prime, b_prime))
- }
- fn invert(&self, other: &Self) -> Self {
- let mut inverted = Delta::default();
- if other.is_empty() {
- return inverted;
- }
- tracing::trace!("🌜Calculate invert delta");
- tracing::trace!("current: {}", self);
- tracing::trace!("other: {}", other);
- let mut index = 0;
- for op in &self.ops {
- let len: usize = op.len() as usize;
- match op {
- Operation::Delete(n) => {
- invert_from_other(&mut inverted, other, op, index, index + *n);
- index += len;
- },
- Operation::Retain(_) => {
- match op.has_attribute() {
- true => invert_from_other(&mut inverted, other, op, index, index + len),
- false => {
- tracing::trace!("invert retain: {} by retain {} {}", op, len, op.get_attributes());
- inverted.retain(len as usize, op.get_attributes())
- },
- }
- index += len;
- },
- Operation::Insert(_) => {
- tracing::trace!("invert insert: {} by delete {}", op, len);
- inverted.delete(len as usize);
- },
- }
- }
- tracing::trace!("🌛invert result: {}", inverted);
- inverted
- }
- }
- /// Removes trailing retain operation with empty attributes, if present.
- pub fn trim<T>(delta: &mut Delta<T>)
- where
- T: Attributes,
- {
- if let Some(last) = delta.ops.last() {
- if last.is_retain() && last.is_plain() {
- delta.ops.pop();
- }
- }
- }
- fn invert_from_other<T: Attributes>(
- base: &mut Delta<T>,
- other: &Delta<T>,
- operation: &Operation<T>,
- start: usize,
- end: usize,
- ) {
- tracing::trace!("invert op: {} [{}:{}]", operation, start, end);
- let other_ops = DeltaIter::from_interval(other, Interval::new(start, end)).ops();
- other_ops.into_iter().for_each(|other_op| match operation {
- Operation::Delete(n) => {
- tracing::trace!("invert delete: {} by add {}", n, other_op);
- base.add(other_op);
- },
- Operation::Retain(_retain) => {
- tracing::trace!(
- "invert attributes: {:?}, {:?}",
- operation.get_attributes(),
- other_op.get_attributes()
- );
- let inverted_attrs = operation.get_attributes().invert(&other_op.get_attributes());
- base.retain(other_op.len(), inverted_attrs);
- },
- Operation::Insert(_) => {
- log::error!("Impossible to here. Insert operation should be treated as delete")
- },
- });
- }
- fn transform_op_attribute<T: Attributes>(
- left: &Option<Operation<T>>,
- right: &Option<Operation<T>>,
- ) -> Result<T, OTError> {
- if left.is_none() {
- if right.is_none() {
- return Ok(T::default());
- }
- return Ok(right.as_ref().unwrap().get_attributes());
- }
- let left = left.as_ref().unwrap().get_attributes();
- let right = right.as_ref().unwrap().get_attributes();
- // TODO: replace with anyhow and thiserror.
- Ok(left.transform(&right)?.0)
- }
- impl<T> Delta<T>
- where
- T: Attributes + DeserializeOwned,
- {
- pub fn from_json(json: &str) -> Result<Self, OTError> {
- let delta = serde_json::from_str(json).map_err(|e| {
- tracing::trace!("Deserialize failed: {:?}", e);
- tracing::trace!("{:?}", json);
- e
- })?;
- Ok(delta)
- }
- pub fn from_bytes<B: AsRef<[u8]>>(bytes: B) -> Result<Self, OTError> {
- let json = str::from_utf8(bytes.as_ref())?.to_owned();
- let val = Self::from_json(&json)?;
- Ok(val)
- }
- }
- impl<T> Delta<T>
- where
- T: Attributes + serde::Serialize,
- {
- pub fn to_json(&self) -> String { serde_json::to_string(self).unwrap_or_else(|_| "".to_owned()) }
- pub fn to_bytes(&self) -> Bytes {
- let json = self.to_json();
- Bytes::from(json.into_bytes())
- }
- }
- impl<T> FromStr for Delta<T>
- where
- T: Attributes,
- {
- type Err = ();
- fn from_str(s: &str) -> Result<Delta<T>, Self::Err> {
- let mut delta = Delta::with_capacity(1);
- delta.add(Operation::Insert(s.into()));
- Ok(delta)
- }
- }
- impl<T> std::convert::TryFrom<Vec<u8>> for Delta<T>
- where
- T: Attributes + DeserializeOwned,
- {
- type Error = OTError;
- fn try_from(bytes: Vec<u8>) -> Result<Self, Self::Error> { Delta::from_bytes(bytes) }
- }
- impl<T> std::convert::TryFrom<Bytes> for Delta<T>
- where
- T: Attributes + DeserializeOwned,
- {
- type Error = OTError;
- fn try_from(bytes: Bytes) -> Result<Self, Self::Error> { Delta::from_bytes(&bytes) }
- }
|