tentacle 0.7.6

Minimal implementation for a multiplexed p2p network framework.
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

//! Adapter that exposes a `quinn` bidirectional stream pair (one
//! [`quinn::SendStream`] + one [`quinn::RecvStream`]) as a single tokio
//! [`AsyncRead`] + [`AsyncWrite`] handle, so it can carry the same
//! length-prefixed protocol layer used by the yamux backend.

use std::pin::Pin;

use tokio::io::{AsyncRead, AsyncWrite};

/// A `quinn` bidirectional stream packaged as a single
/// `AsyncRead + AsyncWrite` so the protocol layer (`Substream<U>`,
/// `client_select`, `server_select`, …) can sit on top of QUIC the
/// same way it sits on top of yamux.
#[derive(Debug)]
pub struct QuicBiStream {
    pub(crate) send: quinn::SendStream,
    pub(crate) recv: quinn::RecvStream,
}

impl QuicBiStream {
    /// Wrap a quinn bidirectional stream pair into an `AsyncRead + AsyncWrite`
    /// substream usable by the protocol layer.
    pub(crate) fn new(send: quinn::SendStream, recv: quinn::RecvStream) -> Self {
        Self { send, recv }
    }
}

impl AsyncRead for QuicBiStream {
    fn poll_read(
        mut self: std::pin::Pin<&mut Self>,
        cx: &mut std::task::Context<'_>,
        buf: &mut tokio::io::ReadBuf<'_>,
    ) -> std::task::Poll<std::io::Result<()>> {
        Pin::new(&mut self.recv).poll_read(cx, buf)
    }
}

impl AsyncWrite for QuicBiStream {
    fn poll_write(
        mut self: Pin<&mut Self>,
        cx: &mut std::task::Context<'_>,
        buf: &[u8],
    ) -> std::task::Poll<std::io::Result<usize>> {
        AsyncWrite::poll_write(Pin::new(&mut self.send), cx, buf)
    }

    fn poll_flush(
        mut self: Pin<&mut Self>,
        cx: &mut std::task::Context<'_>,
    ) -> std::task::Poll<std::io::Result<()>> {
        Pin::new(&mut self.send).poll_flush(cx)
    }

    fn poll_shutdown(
        mut self: Pin<&mut Self>,
        cx: &mut std::task::Context<'_>,
    ) -> std::task::Poll<std::io::Result<()>> {
        Pin::new(&mut self.send).poll_shutdown(cx)
    }
}