serv4rs 0.1.7

serv4rs is a powerful, pragmatic, and extremely fast web framework for Rust
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

use std::env;
use std::sync::{Arc, RwLock};

use actix_web::{HttpRequest, HttpResponse};
use serde::Serialize;
use tera::{Context, Tera};

use crate::error::Error;

/// A trait for making certain types of response handling easier.
pub trait Render {
    /// Shorthand for rendering a template, with a specific HTTP response code.
    fn render(&self, code: usize, template: &str, context: Context) -> std::result::Result<HttpResponse, Error>;

    /// Shorthand for returning a JSON payload.
    fn json<S: Serialize>(&self, code: usize, payload: S) -> std::result::Result<HttpResponse, Error>;

    /// Shorthand for returning a text/plain payload.
    fn text<S: Serialize>(&self, code: usize, payload: S) -> std::result::Result<HttpResponse, Error>;

    /// Handy redirects helper.
    fn redirect(&self, location: &str) -> std::result::Result<HttpResponse, Error>;
}

impl Render for HttpRequest {
    fn render(
        &self,
        code: usize,
        template: &str,
        mut context: Context,
    ) -> std::result::Result<HttpResponse, Error> {

        let data: Option<&Arc<RwLock<Tera>>> = self.app_data();

        for (k, v) in env::vars() {
            if k.starts_with("JELLY_") {
                context.insert(&k, &v);
            }
        }

        if let Some(eng) = data {
            let engine = eng.read().map_err(|e| {
                Error::Generic(format!("Error acquiring template read lock: {:?}", e))
            })?;

            let body = engine.render(template, &context).map_err(Error::from)?;

            Ok(match code {
                200 => HttpResponse::Ok(),
                400 => HttpResponse::BadRequest(),
                404 => HttpResponse::NotFound(),
                _ => HttpResponse::Ok(),
            }
            .content_type("text/html; charset=utf-8")
            .body(body))
        } else {
            Err(Error::Generic(
                "Unable to locate Templates cache".to_string(),
            ))
        }
    }

    fn json<S: Serialize>(&self, code: usize, payload: S) -> std::result::Result<HttpResponse, Error> {
        let o = serde_json::to_string(&payload)?;

        Ok(match code {
            200 => HttpResponse::Ok(),
            400 => HttpResponse::BadRequest(),
            404 => HttpResponse::NotFound(),
            _ => HttpResponse::Ok(),
        }
        .content_type("application/json")
        .body(o))
    }

    fn text<S: Serialize>(&self, code: usize, payload: S) -> std::result::Result<HttpResponse, Error> {
        let o = serde_json::to_string(&payload)?;

        Ok(match code {
            200 => HttpResponse::Ok(),
            400 => HttpResponse::BadRequest(),
            404 => HttpResponse::NotFound(),
            _ => HttpResponse::Ok(),
        }
        .content_type("text/plain")
        .body(o))
    }

    fn redirect(&self, location: &str) -> std::result::Result<HttpResponse, Error> {
        Ok(HttpResponse::Found()
            .append_header((actix_web::http::header::LOCATION, location))
            .finish())
    }

}