scxml 0.2.0

W3C SCXML statechart library — parse, validate, export, and simulate Harel statecharts. Framework-agnostic, WASM-ready, rkyv zero-copy.
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

use crate::error::{Result, ScxmlError};
use crate::model::Statechart;

/// Parse a JSON representation of a statechart into a [`Statechart`].
///
/// The JSON schema matches the serde serialization of [`Statechart`]:
/// a direct JSON mapping of the Rust model types.
pub fn parse_json(json: &str) -> Result<Statechart> {
    serde_json::from_str(json).map_err(|e| ScxmlError::Json(e.to_string()))
}

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

    #[test]
    fn parse_simple_json() {
        let json = r#"{
            "initial": "draft",
            "states": [
                {
                    "id": "draft",
                    "kind": "atomic",
                    "transitions": [
                        { "event": "submit", "targets": ["review"], "actions": [] }
                    ],
                    "on_entry": [],
                    "on_exit": [],
                    "children": [],
                    "initial": null
                },
                {
                    "id": "review",
                    "kind": "atomic",
                    "transitions": [
                        { "event": "approve", "targets": ["approved"], "actions": [] }
                    ],
                    "on_entry": [],
                    "on_exit": [],
                    "children": [],
                    "initial": null
                },
                {
                    "id": "approved",
                    "kind": "final",
                    "transitions": [],
                    "on_entry": [],
                    "on_exit": [],
                    "children": [],
                    "initial": null
                }
            ]
        }"#;

        let chart = parse_json(json).unwrap();
        assert_eq!(chart.initial.as_str(), "draft");
        assert_eq!(chart.states.len(), 3);
    }
}