unit-rs 0.2.0

A safe wrapper around NGINX Unit's libunit.
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

// An example inspired by the official example application written in C:
// https://github.com/nginx/unit/blob/bba97134e9/src/test/nxt_unit_app_test.c

use std::io::Write;

use unit_rs::{Request, Unit, UnitResult};

fn main() {
    let mut unit = Unit::new().unwrap();

    unit.set_request_handler(request_handler);

    unit.run();
}

fn request_handler(req: Request) -> UnitResult<()> {
    // Create and send a response.
    let headers = &[("Content-Type", "text/plain")];
    req.send_response(200, headers, "Hello world!\n")?;

    // NGINX Unit uses "Transfer-Encoding: chunked" by default, and can send
    // additional chunks after the initial response was already sent to the
    // client.
    req.send_chunks_with_writer(4096, |w| {
        write!(w, "Request data:\n")?;
        write!(w, "  Method: {}\n", req.method())?;
        write!(w, "  Protocol: {}\n", req.version())?;
        write!(w, "  Remote addr: {}\n", req.remote())?;
        write!(w, "  Local addr: {}\n", req.local())?;
        write!(w, "  Server name: {}\n", req.server_name())?;
        write!(w, "  Target: {}\n", req.target())?;
        write!(w, "  Path: {}\n", req.path())?;
        write!(w, "  Query: {}\n", req.query())?;
        write!(w, "  Fields:\n")?;
        for (name, value) in req.fields() {
            write!(w, "    {}: {}\n", name, value).unwrap();
        }
        write!(w, "  Body:\n    ").unwrap();

        w.copy_from_reader(req.body())?;

        Ok(())
    })?;

    Ok(())
}