codama-nodes 0.9.0

Node specifications and helpers for the Codama standard
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

use crate::{
    CamelCaseString, DefaultValueStrategy, Docs, HasName, InstructionInputValueNode,
    StructFieldTypeNode, StructTypeNode, TypeNode,
};
use codama_nodes_derive::node;

#[node]
pub struct InstructionArgumentNode {
    // Data.
    pub name: CamelCaseString,
    #[serde(skip_serializing_if = "crate::is_default")]
    pub default_value_strategy: Option<DefaultValueStrategy>,
    #[serde(default, skip_serializing_if = "crate::is_default")]
    pub docs: Docs,

    // Children.
    pub r#type: TypeNode,
    #[serde(skip_serializing_if = "crate::is_default")]
    pub default_value: Option<InstructionInputValueNode>,
}

impl InstructionArgumentNode {
    pub fn new<T, U>(name: T, r#type: U) -> Self
    where
        T: Into<CamelCaseString>,
        U: Into<TypeNode>,
    {
        Self {
            name: name.into(),
            default_value_strategy: None,
            docs: Docs::default(),
            r#type: r#type.into(),
            default_value: None,
        }
    }
}

impl HasName for InstructionArgumentNode {
    fn name(&self) -> &CamelCaseString {
        &self.name
    }
}

impl From<StructFieldTypeNode> for InstructionArgumentNode {
    fn from(value: StructFieldTypeNode) -> Self {
        Self {
            name: value.name,
            default_value_strategy: value.default_value_strategy,
            docs: value.docs,
            r#type: value.r#type,
            default_value: value.default_value.map(InstructionInputValueNode::from),
        }
    }
}

impl From<StructTypeNode> for Vec<InstructionArgumentNode> {
    fn from(val: StructTypeNode) -> Self {
        val.fields
            .into_iter()
            .map(InstructionArgumentNode::from)
            .collect()
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::{ArgumentValueNode, NumberTypeNode, U32};

    #[test]
    fn new() {
        let node = InstructionArgumentNode::new("my_argument", NumberTypeNode::le(U32));
        assert_eq!(node.name, CamelCaseString::new("myArgument"));
        assert_eq!(node.r#type, TypeNode::Number(NumberTypeNode::le(U32)));
    }

    #[test]
    fn direct_instantiation() {
        let node = InstructionArgumentNode {
            name: "myArgument".into(),
            default_value_strategy: Some(DefaultValueStrategy::Optional),
            docs: vec!["Hello".to_string()].into(),
            r#type: NumberTypeNode::le(U32).into(),
            default_value: Some(ArgumentValueNode::new("myOtherArgument").into()),
        };

        assert_eq!(node.name, CamelCaseString::new("myArgument"));
        assert_eq!(
            node.default_value_strategy,
            Some(DefaultValueStrategy::Optional)
        );
        assert_eq!(*node.docs, vec!["Hello".to_string()]);
        assert_eq!(node.r#type, TypeNode::Number(NumberTypeNode::le(U32)));
        assert_eq!(
            node.default_value,
            Some(InstructionInputValueNode::Argument(ArgumentValueNode::new(
                "myOtherArgument"
            )))
        );
    }

    #[test]
    fn to_json() {
        let node = InstructionArgumentNode::new("myArgument", NumberTypeNode::le(U32));
        let json = serde_json::to_string(&node).unwrap();
        assert_eq!(
            json,
            r#"{"kind":"instructionArgumentNode","name":"myArgument","type":{"kind":"numberTypeNode","format":"u32","endian":"le"}}"#
        );
    }

    #[test]
    fn from_json() {
        let json = r#"{"kind":"instructionArgumentNode","name":"myArgument","type":{"kind":"numberTypeNode","format":"u32","endian":"le"}}"#;
        let node: InstructionArgumentNode = serde_json::from_str(json).unwrap();
        assert_eq!(
            node,
            InstructionArgumentNode::new("myArgument", NumberTypeNode::le(U32))
        );
    }
}