ringline-quic 0.3.0

QUIC transport layer wrapping quinn-proto for ringline
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

# ringline-quic

**QUIC protocol support via quinn-proto.**

Wraps [quinn-proto](https://docs.rs/quinn-proto)'s sans-IO QUIC state machine
and exposes an event-based [`QuicEndpoint`] API for use with ringline's UDP
support.

## Quick Start

```rust,ignore
use ringline_quic::{QuicConfig, QuicEndpoint, QuicEvent};

// Feed incoming datagrams:
quic.handle_datagram(Instant::now(), data, peer);
while let Some(event) = quic.poll_event() {
    match event {
        QuicEvent::NewConnection(conn) => { /* ... */ }
        QuicEvent::StreamReadable { conn, stream } => {
            let mut buf = [0u8; 4096];
            let (n, fin) = quic.stream_recv(conn, stream, &mut buf)?;
            quic.stream_send(conn, stream, &buf[..n])?;
        }
        _ => {}
    }
}
// Drain outgoing packets:
while let Some((dest, data)) = quic.poll_send() {
    udp.send_to(dest, &data)?;
}
```

## Features

- Event-driven API wrapping quinn-proto's sans-IO state machine
- Connection and stream management
- Integrates with ringline's UDP support (`UdpCtx`)