h3x 0.2.0

High-performance zero-copy DHTTP/3 implementation
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

//! Error types for the WebTransport protocol layer.

use snafu::Snafu;

use crate::{
    quic::{ConnectionError, StreamError},
    stream_id::StreamId,
};

// ============================================================================
// Registration errors
// ============================================================================

/// Errors from [`WebTransportProtocol::register`](super::WebTransportProtocol::register).
#[derive(Debug, Snafu)]
#[snafu(visibility(pub(super)))]
pub enum RegisterError {
    #[snafu(display("session already registered for {session_id}"))]
    AlreadyRegistered { session_id: StreamId },

    #[snafu(display("session registry lock poisoned"))]
    RegistryPoisoned,
}

// ============================================================================
// Stream-opening errors
// ============================================================================

/// Errors from [`WebTransportSession::open_bi`](super::WebTransportSession::open_bi)
/// and [`WebTransportSession::open_uni`](super::WebTransportSession::open_uni).
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[derive(Debug, Clone, Snafu)]
#[snafu(visibility(pub))]
pub enum OpenStreamError {
    #[snafu(display("failed to open QUIC stream"))]
    Open { source: ConnectionError },

    #[snafu(display("failed to write stream routing header"))]
    WriteHeader { source: StreamError },
}

// ============================================================================
// Session-closed error
// ============================================================================

/// The WebTransport session has been closed and no more streams will arrive.
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[derive(Debug, Clone, Snafu)]
#[snafu(display("webtransport session closed"))]
pub struct Closed;

// ============================================================================
// Datagram errors
// ============================================================================

/// Errors from datagram operations on [`WebTransportSession`](super::WebTransportSession).
#[derive(Debug, Snafu)]
#[snafu(visibility(pub(super)))]
pub enum DatagramError {
    #[snafu(display("datagrams are not yet supported"))]
    Unsupported,
}