ling-net 2030.0.0

Async networking — HTTP, WebSocket, QUIC, and peer-to-peer
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

use std::collections::HashMap;

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum HttpMethod { Get, Post, Put, Patch, Delete, Head, Options }

impl HttpMethod {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::Get     => "GET",    Self::Post    => "POST",
            Self::Put     => "PUT",    Self::Patch   => "PATCH",
            Self::Delete  => "DELETE", Self::Head    => "HEAD",
            Self::Options => "OPTIONS",
        }
    }
}

#[derive(Debug, Clone)]
pub struct Request {
    pub method:  HttpMethod,
    pub url:     String,
    pub headers: HashMap<String, String>,
    pub body:    Option<Vec<u8>>,
}

impl Request {
    pub fn get(url: impl Into<String>) -> Self {
        Self { method: HttpMethod::Get, url: url.into(), headers: HashMap::new(), body: None }
    }

    pub fn post(url: impl Into<String>, body: impl Into<Vec<u8>>) -> Self {
        Self { method: HttpMethod::Post, url: url.into(), headers: HashMap::new(), body: Some(body.into()) }
    }

    pub fn header(mut self, key: impl Into<String>, val: impl Into<String>) -> Self {
        self.headers.insert(key.into(), val.into());
        self
    }
}

#[derive(Debug, Clone)]
pub struct Response {
    pub status:  u16,
    pub headers: HashMap<String, String>,
    pub body:    Vec<u8>,
}

impl Response {
    pub fn ok(body: impl Into<Vec<u8>>) -> Self {
        Self { status: 200, headers: HashMap::new(), body: body.into() }
    }

    pub fn text(&self) -> &str {
        std::str::from_utf8(&self.body).unwrap_or("")
    }

    pub fn is_success(&self) -> bool { self.status >= 200 && self.status < 300 }
}