qubit-http 0.5.0

General-purpose HTTP infrastructure for Rust with unified client semantics, secure logging, and built-in SSE decoding
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

/*******************************************************************************
 *
 *    Copyright (c) 2025 - 2026 Haixing Hu.
 *
 *    SPDX-License-Identifier: Apache-2.0
 *
 *    Licensed under the Apache License, Version 2.0.
 *
 ******************************************************************************/

use parse_display::FromStr as DeriveFromStr;
use serde::{Deserialize, Serialize};

/// URL scheme selector used when constructing the proxy URL for reqwest.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize, DeriveFromStr)]
#[serde(rename_all = "snake_case")]
#[display(style = "snake_case")]
pub enum ProxyType {
    /// HTTP proxy.
    #[default]
    #[display("http")]
    #[from_str(regex = "(?i)http")]
    Http,
    /// HTTPS proxy.
    #[display("https")]
    #[from_str(regex = "(?i)https")]
    Https,
    /// SOCKS5 proxy.
    #[display("socks5h")]
    #[from_str(regex = "(?i)socks5h|socks5")]
    Socks5,
}

impl ProxyType {
    /// Returns the URL scheme string embedded in `proxy_url` for reqwest.
    ///
    /// # Parameters
    /// - `self`: Proxy kind.
    ///
    /// # Returns
    /// `"http"`, `"https"`, or `"socks5h"` (SOCKS5 with remote DNS).
    pub fn scheme(self) -> &'static str {
        match self {
            ProxyType::Http => "http",
            ProxyType::Https => "https",
            ProxyType::Socks5 => "socks5h",
        }
    }
}