agave-event-system 0.2.0

A local pub-sub system used by agave validators to publish events to outside processes.
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

use wincode_dynamic::SerializedSize;

// The function is hidden from docs as it's only intended for macro expansion.
#[doc(hidden)]
pub const fn event_queue_cell_size(
    size: SerializedSize,
    max_serialized_size: Option<usize>,
) -> usize {
    match size {
        SerializedSize::Static(size) => size,
        SerializedSize::Dynamic(lower_bound) => match max_serialized_size {
            Some(max_serialized_size) if max_serialized_size > lower_bound => max_serialized_size,
            Some(_) => {
                panic!(
                    "`max_serialized_size` must be greater than wincode's dynamic serialized-size \
                     lower bound"
                )
            }
            None => {
                panic!(
                    "event has a dynamic serialized size; specify `max_serialized_size` in the \
                     `#[event(...)]` attribute"
                )
            }
        },
    }
}

#[cfg(test)]
mod tests {
    use {super::event_queue_cell_size, wincode_dynamic::SerializedSize};

    #[test]
    fn static_size_uses_wincode_upper_bound() {
        assert_eq!(event_queue_cell_size(SerializedSize::Static(8), None), 8);
        assert_eq!(
            event_queue_cell_size(SerializedSize::Static(8), Some(16)),
            8
        );
    }

    #[test]
    fn dynamic_size_uses_explicit_upper_bound() {
        assert_eq!(
            event_queue_cell_size(SerializedSize::Dynamic(8), Some(16)),
            16
        );
    }

    #[test]
    #[should_panic(expected = "event has a dynamic serialized size")]
    fn dynamic_size_requires_explicit_upper_bound() {
        event_queue_cell_size(SerializedSize::Dynamic(8), None);
    }

    #[test]
    #[should_panic(expected = "must be greater than")]
    fn dynamic_size_rejects_bound_equal_to_lower_bound() {
        event_queue_cell_size(SerializedSize::Dynamic(8), Some(8));
    }

    #[test]
    #[should_panic(expected = "must be greater than")]
    fn dynamic_size_rejects_bound_below_lower_bound() {
        event_queue_cell_size(SerializedSize::Dynamic(8), Some(7));
    }
}