via 2.0.0-gm.32

An async multi-threaded web framework for people who appreciate simplicity.
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

use futures_channel::mpsc::{self, Receiver, Sender};
use futures_core::FusedFuture;
use std::future::Future;
use std::ops::ControlFlow;
use std::pin::Pin;
use std::task::{Context, Poll};

use crate::error::Error;

#[cfg(feature = "tokio-tungstenite")]
pub use tungstenite::protocol::{CloseFrame, Message, frame::Utf8Bytes};

#[cfg(all(feature = "tokio-websockets", not(feature = "tokio-tungstenite")))]
pub use tokio_websockets::{CloseCode, Message};

pub struct Channel {
    tx: Sender<Message>,
    rx: Receiver<Message>,
}

struct Send<'a> {
    tx: &'a mut Sender<Message>,
    message: Option<Message>,
}

fn disconnect_error() -> ControlFlow<Error, Error> {
    ControlFlow::Break(Error::new(
        "failed to send ws message. channel disconnected.",
    ))
}

impl Channel {
    pub fn send(&mut self, message: impl Into<Message>) -> impl Future<Output = super::Result> {
        Send {
            tx: &mut self.tx,
            message: Some(message.into()),
        }
    }

    pub async fn recv(&mut self) -> Option<Message> {
        self.rx.recv().await.ok()
    }
}

impl Channel {
    pub(super) fn new() -> (Self, Self) {
        let (tx1, rx2) = mpsc::channel(1);
        let (tx2, rx1) = mpsc::channel(1);

        (Self { tx: tx1, rx: rx1 }, Self { tx: tx2, rx: rx2 })
    }

    pub(super) fn rx(&mut self) -> &mut Receiver<Message> {
        &mut self.rx
    }

    pub(super) fn tx(&mut self) -> &mut Sender<Message> {
        &mut self.tx
    }
}

impl Future for Send<'_> {
    type Output = super::Result;

    fn poll(mut self: Pin<&mut Self>, context: &mut Context) -> Poll<Self::Output> {
        if let Some(message) = self.message.take() {
            let Poll::Ready(_) = Pin::new(&mut self.tx)
                .poll_ready(context)
                .map_err(|_| disconnect_error())?
            else {
                self.message = Some(message);
                return Poll::Pending;
            };

            self.tx.try_send(message).map_err(|_| disconnect_error())?;
        }

        Poll::Ready(Ok(()))
    }
}

impl FusedFuture for Send<'_> {
    fn is_terminated(&self) -> bool {
        self.message.is_none()
    }
}