pite-core 0.1.0

Node tree, handles, props and lifecycle dispatch for Pite.
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

// SPDX-License-Identifier: MIT OR Apache-2.0
use thiserror::Error;

/// Errors produced by the core tree and its registries.
#[derive(Debug, Error)]
pub enum CoreError {
    #[error("node id must not be empty")]
    EmptyNodeId,

    #[error("node `{0}` already exists in the tree")]
    DuplicateNode(String),

    #[error("node `{id}` does not exist")]
    UnknownNode { id: String },

    #[error("node `{child}` references parent `{parent}`, which does not exist")]
    MissingParent { child: String, parent: String },

    #[error("the root node cannot be removed")]
    RemoveRoot,

    #[error("node type `{0}` is not registered")]
    UnknownNodeType(String),

    #[error("node `{0}` has an empty name")]
    EmptyNodeName(String),

    #[error("reparenting `{child}` under `{parent}` would create a cycle")]
    Cycle { child: String, parent: String },
}

/// Convenience alias for core results.
pub type Result<T> = std::result::Result<T, CoreError>;

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn errors_render_readable_messages() {
        assert_eq!(
            CoreError::DuplicateNode("root".into()).to_string(),
            "node `root` already exists in the tree"
        );
    }
}