velen 0.1.3

A simple package for making REST APIs
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

# Velen

### Just another REST framework

### How to use


#### Import

<code>
use velen::{server::create_server, server_models::{Request, Response}};
</code>

#### Create server instance

<code>
let mut server = create_server();
</code>

#### Register endpoints

<code>
server.get("/get", get_handler);
    
server.post("/add", post_handler);</code>

#### Start listening

<code>
server.listen("127.0.0.1", 3333, server_start_handler);</code>

#### Example handlers

<code>
<pre>
fn get_handler(_: Request, mut res: Response) {
    res.set_status_code(200);
    res.set_header("Content-Type", "application/json");
    struct GoodResponse {
        message: String,
    }
    impl Display for GoodResponse {
        fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
            write!(f, "{{\"message\": \"{}\"}}", self.message)
        }
    }
    let good_response = GoodResponse {
        message: "I'm good, thank you very much Sir!".to_string(),
    };
    res.send(good_response.to_string());
}
fn post_handler(req: Request, mut res: Response) {
    res.set_status_code(200);
    res.set_header("Content-Type", "application/json");
    struct GoodResponse {
        message: String,
    }
    impl Display for GoodResponse {
        fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
            write!(f, "{{\"message\": \"{}\"}}", self.message)
        }
    }
    let good_response = GoodResponse {
        message: format!("Received query parameters x={:?}, y={:?}", req.query_params.get("x").unwrap(), req.query_params.get("y").unwrap()),
    };
    res.send(good_response.to_string());
}</pre></code>

#### Limitations

- Only GET and POST are implemented
- Only application/json is supported, so don't try to upload files 
- During sending a response `set_status_code` has to be called before `set_header`
- No multithreading
#### TODO
- Fix above limitations