meslin 0.0.4

Ergonomic messaging for Rust
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

use crate::*;

/// A wrapper around [`flume::Sender`].
pub struct Sender<P> {
    sender: flume::Sender<P>,
}

/// Re-export of [`flume::Receiver`].
pub use flume::Receiver;

impl<P> Sender<P> {
    pub fn inner(&self) -> &flume::Sender<P> {
        &self.sender
    }

    pub fn into_inner(self) -> flume::Sender<P> {
        self.sender
    }

    pub fn inner_mut(&mut self) -> &mut flume::Sender<P> {
        &mut self.sender
    }

    pub fn from_inner(sender: flume::Sender<P>) -> Self {
        Self { sender }
    }
}

impl<P> IsSender for Sender<P> {
    type With = ();

    fn is_closed(&self) -> bool {
        self.sender.is_disconnected()
    }

    fn capacity(&self) -> Option<usize> {
        self.sender.capacity()
    }

    fn len(&self) -> usize {
        self.sender.len()
    }

    fn receiver_count(&self) -> usize {
        self.sender.receiver_count()
    }

    fn sender_count(&self) -> usize {
        self.sender.sender_count()
    }
}

impl<P: Send> SendsProtocol for Sender<P> {
    type Protocol = P;

    async fn send_protocol_with(
        this: &Self,
        protocol: Self::Protocol,
        _with: (),
    ) -> Result<(), SendError<(Self::Protocol, ())>> {
        this.sender
            .send_async(protocol)
            .await
            .map_err(|e| SendError((e.0, ())))
    }

    fn send_protocol_blocking_with(
        this: &Self,
        protocol: Self::Protocol,
        _with: (),
    ) -> Result<(), SendError<(Self::Protocol, ())>> {
        this.sender.send(protocol).map_err(|e| SendError((e.0, ())))
    }

    fn try_send_protocol_with(
        this: &Self,
        protocol: Self::Protocol,
        _with: (),
    ) -> Result<(), TrySendError<(Self::Protocol, ())>> {
        this.sender.try_send(protocol).map_err(|e| match e {
            flume::TrySendError::Disconnected(protocol) => TrySendError::Closed((protocol, ())),
            flume::TrySendError::Full(protocol) => TrySendError::Full((protocol, ())),
        })
    }
}

impl<P> Clone for Sender<P> {
    fn clone(&self) -> Self {
        Self {
            sender: self.sender.clone(),
        }
    }
}

impl<P> std::fmt::Debug for Sender<P> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("Sender")
            .field("sender", &self.sender)
            .finish()
    }
}

pub fn bounded<P>(cap: usize) -> (Sender<P>, flume::Receiver<P>) {
    let (sender, receiver) = flume::bounded(cap);
    (Sender { sender }, receiver)
}

pub fn unbounded<P>() -> (Sender<P>, flume::Receiver<P>) {
    let (sender, receiver) = flume::unbounded();
    (Sender { sender }, receiver)
}