spot 0.1.6

HTTP server framework that emphezies simplicity and minimalism. Inspired by Flask and Exress.js
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

use std::collections::HashMap;

pub struct Response {
    /// Status code for the response
    pub status: u16,
    /// The response body. If there is no body this is empty
    pub body: Vec<u8>,
    /// Contains all the desired response headers. No headers are added automatically except for content-length and content-type when adding a body
    pub headers: HashMap<String, String>,
}

impl Response {
    /// Creates a new http response object
    pub fn new(status: u16, body: Vec<u8>, headers: HashMap<String, String>) -> Response {
        return Response {
            status: status,
            body: body,
            headers: headers,
        };
    }

    /// Updates the response status
    pub fn status(&mut self, new_status: u16) {
        self.status = new_status;
    }

    /// Adds a new header to the response
    pub fn header(&mut self, name_ref: impl AsRef<str>, value_ref: impl AsRef<str>) {
        let name = name_ref.as_ref().to_string();
        let value = value_ref.as_ref().to_string();
        if self.headers.contains_key(&name) {
            self.headers.remove(&name);
        }
        self.headers.insert(name, value);
    }

    /// Adds a body from a String to the request, overwrites previous body, then adds content length and content type "text/plain".
    pub fn body(&mut self, data_ref: impl AsRef<str>) {
        let data = data_ref.as_ref().to_string();
        self.body = data.as_bytes().to_vec();
        // Sets the content length header so that the client knows how far to read
        self.header(String::from("content-length"), self.body.len().to_string());
        self.header(String::from("content-type"), String::from("text/plain"));
    }

    /// Adds a body from a byte array, then sets the content-length header to be equal to the size of the array
    pub fn body_bytes(&mut self, data: Vec<u8>) {
        self.body = data;
        self.header(String::from("content-length"), self.body.len().to_string());
    }

    /// Converts the reponse to an array of bytes in order to write it over the TCP stream. This always writes in the HTTP/1.1 format
    pub fn to_http(self) -> Vec<u8> {
        let mut http: Vec<u8> = Vec::new();
        http.extend_from_slice(format!("HTTP/1.1 {} \n", self.status).as_bytes());
        for (key, value) in self.headers {
            http.extend_from_slice(format!("{}: {}\n", key, value).as_bytes());
        }
        // append newline
        http.push(10);
        http.extend_from_slice(&self.body);
        return http;
    }
}