zrquic 0.1.6

A low-level quic library based on `quiche` focusing on non-blocking and masive connection management.
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

//! Types for handle this crate's errors.

use std::task::Poll;

/// A `poll` error.
#[derive(Debug, PartialEq, Eq, thiserror::Error)]
pub enum Error {
    /// A quic protocol error.
    #[error(transparent)]
    Quiche(#[from] quiche::Error),

    /// The operation needs to block to complete, but the blocking operation was
    /// requested to not occur.
    ///
    /// Should retry this operation later.
    #[error("Retry this operation later.")]
    Retry,

    /// Resource is busy, should retry this operation later.
    #[error("Resource is busy.")]
    Busy,

    /// Resource is not found.
    #[error("Resource is not found.")]
    NotFound,

    #[error("Failed to validate client address.")]
    ValidateAddress,
}

impl From<Error> for std::io::Error {
    fn from(value: Error) -> Self {
        match value {
            Error::Quiche(error) => std::io::Error::other(error),
            Error::Retry | Error::Busy => {
                std::io::Error::new(std::io::ErrorKind::WouldBlock, value)
            }

            Error::NotFound => std::io::Error::new(std::io::ErrorKind::NotFound, value),
            Error::ValidateAddress => std::io::Error::other(value),
        }
    }
}

/// Short for `std::result::Result<T, crate::poll::Error>`
pub type Result<T> = std::result::Result<T, Error>;

/// A trait to filter `WouldBlock` like errors and convert them into `Poll::Pending`
pub trait WouldBlock<T> {
    fn would_block(self) -> Poll<Result<T>>;
}

impl<T> WouldBlock<T> for Result<T> {
    fn would_block(self) -> Poll<Result<T>> {
        match self {
            Err(Error::Busy) | Err(Error::Retry) => Poll::Pending,
            _ => Poll::Ready(self),
        }
    }
}