specters 3.0.0

HTTP client with full TLS, HTTP/2, and HTTP/3 fingerprint control
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
87
88

use std::io;

pub type WebSocketResult<T> = std::result::Result<T, WebSocketError>;

#[derive(Debug, thiserror::Error)]
pub enum WebSocketError {
    #[error("WebSocket handshake failed for {url}: expected status 101, got {status}")]
    InvalidStatus { url: String, status: u16 },

    #[error("WebSocket handshake failed for {url}: invalid Sec-WebSocket-Accept")]
    InvalidAccept { url: String },

    #[error("WebSocket handshake failed for {url}: unexpected subprotocol")]
    UnexpectedSubprotocol { url: String },

    #[error("WebSocket handshake failed for {url}: unexpected extension")]
    UnexpectedExtension { url: String },

    #[error("WebSocket protocol error for {url}: {message}")]
    Protocol { url: String, message: String },

    #[error("WebSocket UTF-8 error for {url}: {message}")]
    Utf8 { url: String, message: String },

    #[error("WebSocket size limit exceeded for {url}: {message}")]
    LimitExceeded { url: String, message: String },

    #[error("WebSocket connection closed for {url}")]
    ConnectionClosed { url: String },

    #[error("WebSocket timeout for {url}: {operation}")]
    Timeout { url: String, operation: String },

    #[error("WebSocket I/O error for {url}: {source}")]
    Io {
        url: String,
        #[source]
        source: io::Error,
    },

    #[error("WebSocket URL error: {0}")]
    Url(#[from] url::ParseError),
}

impl WebSocketError {
    pub(crate) fn protocol(url: &url::Url, message: impl Into<String>) -> Self {
        Self::Protocol {
            url: url.to_string(),
            message: message.into(),
        }
    }

    pub(crate) fn utf8(url: &url::Url, message: impl Into<String>) -> Self {
        Self::Utf8 {
            url: url.to_string(),
            message: message.into(),
        }
    }

    pub(crate) fn limit_exceeded(url: &url::Url, message: impl Into<String>) -> Self {
        Self::LimitExceeded {
            url: url.to_string(),
            message: message.into(),
        }
    }

    pub(crate) fn connection_closed(url: &url::Url) -> Self {
        Self::ConnectionClosed {
            url: url.to_string(),
        }
    }

    pub(crate) fn io(url: &url::Url, source: io::Error) -> Self {
        Self::Io {
            url: url.to_string(),
            source,
        }
    }

    pub(crate) fn close_code(&self) -> Option<crate::websocket::CloseCode> {
        match self {
            Self::Protocol { .. } => Some(crate::websocket::CloseCode::Protocol),
            Self::Utf8 { .. } => Some(crate::websocket::CloseCode::Invalid),
            Self::LimitExceeded { .. } => Some(crate::websocket::CloseCode::Size),
            _ => None,
        }
    }
}