http-request 8.91.109

http-request is a lightweight, efficient library for building, sending, and handling HTTP/HTTPS requests in Rust applications. It provides a simple and intuitive API, allowing developers to easily interact with web services, whether they use the "HTTP" or "HTTPS" protocol. The library supports various HTTP methods, custom headers, request bodies, timeout, automatic handling of redirects (including detecting redirect loops), and enhanced response body decoding (both automatic and manual), enabling fast and secure communication. Whether working with secure "HTTPS" connections or standard "HTTP" requests, the library is optimized for performance, minimal resource usage, and easy integration into Rust projects.
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

use crate::*;

/// Configuration for HTTP requests.
///
/// Contains settings like timeout, redirect handling, and proxy configuration.
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct Config {
    /// Request timeout in milliseconds.
    pub(crate) timeout: u64,
    /// Parsed URL components for the request.
    pub(crate) url_obj: HttpUrlComponents,
    /// Whether to follow redirects automatically.
    pub(crate) redirect: bool,
    /// Maximum number of redirects to follow.
    pub(crate) max_redirect_times: usize,
    /// Current number of redirects followed.
    pub(crate) redirect_times: usize,
    /// HTTP version to use (1.1 or 2).
    pub(crate) http_version: HttpVersion,
    /// Buffer size for reading responses.
    pub(crate) buffer: usize,
    /// Whether to decode response bodies automatically.
    pub(crate) decode: bool,
    /// Optional proxy configuration.
    pub(crate) proxy: Option<ProxyConfig>,
}

/// Proxy server configuration.
///
/// Contains proxy type, host/port, and optional authentication.
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct ProxyConfig {
    /// Type of proxy (HTTP/HTTPS/SOCKS5).
    pub(crate) proxy_type: ProxyType,
    /// Proxy server hostname or IP address.
    pub(crate) host: String,
    /// Proxy server port number.
    pub(crate) port: u16,
    /// Optional username for proxy authentication.
    pub(crate) username: Option<String>,
    /// Optional password for proxy authentication.
    pub(crate) password: Option<String>,
}

/// Supported proxy types.
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum ProxyType {
    /// HTTP proxy.
    Http,
    /// HTTPS proxy.
    Https,
    /// SOCKS5 proxy.
    Socks5,
}