rullst-core 12.3.0

Core runtime, routing engine, and telemetry for the Rullst framework suite.
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

//! Event dispatch generated by `#[live_component]`.

use crate::live::LiveComponent;
use serde_json::json;

#[derive(Default)]
struct Chat {
    sent: usize,
    cleared: usize,
    withdrawn: usize,
}

#[crate::live_component]
impl Chat {
    #[live_event]
    fn send(&mut self) {
        self.sent += 1;
    }

    #[live_event]
    fn clear(&mut self) {
        self.cleared += 1;
    }

    #[live_event]
    async fn withdraw(&mut self, _payload: serde_json::Value) {
        self.withdrawn += 1;
    }

    pub fn render(&self) -> String {
        format!(
            "<div id=\"chat\">{} {} {}</div>",
            self.sent, self.cleared, self.withdrawn
        )
    }
}

impl Chat {
    fn counts(&self) -> (usize, usize, usize) {
        (self.sent, self.cleared, self.withdrawn)
    }
}

#[tokio::test]
async fn only_the_explicit_event_field_selects_one_handler() {
    let mut chat = Chat::default();

    // A form field whose value names another handler does not run it.
    chat.handle_event(json!({"rullst_event": "send", "message": "clear"}))
        .await;
    assert_eq!(chat.counts(), (1, 0, 0));

    // Without an event field, payload keys and string values never dispatch.
    chat.handle_event(json!({"send": "", "message": "clear"}))
        .await;
    chat.handle_event(json!({"a": "withdraw", "b": "withdraw", "withdraw": "x"}))
        .await;
    assert_eq!(chat.counts(), (1, 0, 0));

    // `action` and `event` remain explicit fields; each message runs once.
    chat.handle_event(json!({"action": "withdraw"})).await;
    chat.handle_event(json!({"event": "clear", "send": "send"}))
        .await;
    assert_eq!(chat.counts(), (1, 1, 1));

    // A non-string event field and unknown event names dispatch nothing.
    chat.handle_event(json!({"rullst_event": 1, "send": "send"}))
        .await;
    chat.handle_event(json!({"rullst_event": "unknown", "clear": "clear"}))
        .await;
    chat.handle_event(json!(["send", "clear"])).await;
    assert_eq!(chat.counts(), (1, 1, 1));
    assert_eq!(LiveComponent::render(&chat), "<div id=\"chat\">1 1 1</div>");
}