yrs_tree 0.4.1

A Rust library implementing a CRDT-based tree data structure powered by Yrs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

use std::{error::Error, fmt};

use crate::node::NodeId;

/// Errors that can occur when manipulating a tree.
#[derive(Clone)]
pub enum TreeError {
    Cycle(NodeId, NodeId),
    MissingParent(NodeId),
    InvalidTarget(NodeId),
    UnsupportedOperation(String),
    InvalidId(String),
    BadYrsDoc(String),
    TreePoisoned(Box<TreeError>),
}

impl Error for TreeError {}

impl fmt::Debug for TreeError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            TreeError::Cycle(child, parent) => write!(f, "Cycle({} -> {})", child, parent),
            TreeError::MissingParent(parent) => write!(f, "MissingParent({})", parent),
            TreeError::InvalidTarget(target) => write!(f, "InvalidTarget({})", target),
            TreeError::UnsupportedOperation(operation) => {
                write!(f, "UnsupportedOperation({})", operation)
            }
            TreeError::InvalidId(id) => write!(f, "InvalidId({})", id),
            TreeError::BadYrsDoc(msg) => write!(f, "BadYrsDoc({})", msg),
            TreeError::TreePoisoned(msg) => write!(f, "TreePoisoned({})", msg),
        }
    }
}

impl fmt::Display for TreeError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            TreeError::Cycle(child, parent) => {
                write!(f, "Operation would create a cycle: {} -> {}", child, parent)
            }
            TreeError::MissingParent(parent) => {
                write!(f, "Requested parent node does not exist: {}", parent)
            }
            TreeError::InvalidTarget(target) => {
                write!(f, "Invalid target: {}", target)
            }
            TreeError::UnsupportedOperation(operation) => {
                write!(f, "Unsupported operation: {}", operation)
            }
            TreeError::InvalidId(id) => write!(f, "Invalid ID: {}", id),
            TreeError::BadYrsDoc(msg) => write!(f, "Malformed Yrs doc: {}", msg),
            TreeError::TreePoisoned(msg) => write!(f, "Tree has been poisoned: {}", msg),
        }
    }
}