roplat 0.2.0

roplat: just a robot operation system
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

use std::future::Future;
use tokio::sync::mpsc;

use crate::rhythm::Rhythm;

/// 事件触发器（发送端）。
pub struct EventTrigger<T> {
    tx: mpsc::Sender<T>,
}

impl<T: Send + 'static> EventTrigger<T> {
    /// 触发一次事件。
    pub fn fire(&self, payload: T) {
        let _ = self.tx.blocking_send(payload);
    }
}

/// 事件节律（接收端）。
pub struct EventRhythm<T> {
    rx: mpsc::Receiver<T>,
}

impl<T: Send + 'static> Rhythm for EventRhythm<T> {
    type Yield = T;
    type Feed = ();

    type Output = ();
    type Error = crate::RoplatError;

    async fn drive<N, F, Fut>(
        &mut self,
        mut nodes: N,
        mut op_domain: F,
    ) -> (Self::Output, N)
    where
        N: Send,
        F: FnMut(N, Self::Yield) -> Fut + Send,
        Fut: Future<Output = (Self::Feed, N)> + Send,
    {
        while let Some(payload) = self.rx.recv().await {
            let ((), returned_nodes) = op_domain(nodes, payload).await;
            nodes = returned_nodes;
        }
        ((), nodes)
    }
}

// ============================================================================
// C. 构造器 (Builder)
// ============================================================================

/// 创建一�?(资源, 节律)
///
/// 返回 `(EventTrigger, EventRhythm)` 对。
pub fn create_event_channel<T>(buffer_size: usize) -> (EventTrigger<T>, EventRhythm<T>) {
    let (tx, rx) = mpsc::channel(buffer_size);
    (EventTrigger { tx }, EventRhythm { rx })
}