credence-lib 0.0.6

An unfussy web server designed for straightforward authoring and scalable performance
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

use super::{super::super::configuration::*, filters::*};

use {
    ::axum::http::*,
    kutil::{http::*, std::immutable::*},
    minijinja::{Error, *},
    serde::*,
    std::{path::*, result::Result},
};

const DEFAULT_TEMPLATE_CONTENT: &str = include_str!("default.jinja");

/// Default [datetime format](https://time-rs.github.io/book/api/format-description.html).
pub const DEFAULT_DATE_TIME_FORMAT: &str = "[month repr:long] [day padding:none], [year]";

//
// Templates
//

/// Templates.
#[derive(Clone, Debug)]
pub struct Templates {
    /// Jinja environment.
    pub jinja_environment: Environment<'static>,
}

impl Templates {
    /// Constructor.
    pub fn new(configuration: &FilesConfiguration) -> Self {
        let mut jinja_environment = Environment::new(); // don't use ::default()!
        jinja_environment.set_loader(path_loader_with_default(&configuration.templates));
        jinja_environment.set_keep_trailing_newline(true);
        jinja_environment.set_lstrip_blocks(true);
        jinja_environment.set_trim_blocks(true);

        jinja_environment.add_global("DATE_FORMAT", DEFAULT_DATE_TIME_FORMAT);
        minijinja_contrib::add_to_environment(&mut jinja_environment);

        jinja_environment.add_global("ASSETS_PATH", configuration.assets.to_string_lossy());
        jinja_environment.add_filter("fileversion", fileversion_filter);

        jinja_environment.add_filter("parentpath", parentpath_filter);

        Self { jinja_environment }
    }

    /// Render template.
    pub async fn render<ContextT>(&self, template_name: &str, context: ContextT) -> Result<ByteString, StatusCode>
    where
        ContextT: Serialize,
    {
        let template = self.jinja_environment.get_template(template_name).map_err_internal_server("get template")?;
        template.render(context).map(|string| string.into()).map_err_internal_server("render template")
    }
}

fn path_loader_with_default<'path, PathT>(
    path: PathT,
) -> impl Fn(&str) -> Result<Option<String>, Error> + 'static + Send + Sync
where
    PathT: AsRef<Path> + 'path,
{
    let loader = path_loader(path);
    move |path| {
        loader(path).map(|template| {
            template.or_else(|| if path == DEFAULT_TEMPLATE { Some(DEFAULT_TEMPLATE_CONTENT.into()) } else { None })
        })
    }
}