ructe 0.18.2

Rust Compiled Templates, efficient type-safe web page templates.
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
96
97
98
99

#![feature(test)]
extern crate test;
use ructe::templates::{Html, ToHtml};
use std::io::Write;
use test::bench::{black_box, Bencher};

#[bench]
fn raw(b: &mut Bencher) {
    let mut buf = Vec::with_capacity(500);
    b.iter(|| {
        buf.clear();
        black_box(Html("Hello <World>").to_html(&mut buf)).unwrap();
    });
}
#[bench]
fn raw_baseline(b: &mut Bencher) {
    let mut buf = Vec::with_capacity(500);
    b.iter(|| {
        buf.clear();
        black_box(write!(&mut buf, "{}", "Hello <World>")).unwrap();
    });
}

#[bench]
fn escaped_no_op(b: &mut Bencher) {
    let mut buf = Vec::with_capacity(500);
    b.iter(|| {
        buf.clear();
        black_box("Hello World!!".to_html(&mut buf)).unwrap();
    });
}

/// Note: Numbers can't contain anything that should be escaped, so
/// with proper specialization, this should be as fast as
/// escaped_nums_h and escaped_nums_baseline.
#[bench]
fn escaped_nums(b: &mut Bencher) {
    let mut buf = Vec::with_capacity(500);
    b.iter(|| {
        buf.clear();
        black_box(12_345.to_html(&mut buf)).unwrap();
    });
}

/// Turn of escapeing for the number by claiming it to be pre-escaped.
#[bench]
fn escaped_nums_h(b: &mut Bencher) {
    let mut buf = Vec::with_capacity(500);
    b.iter(|| {
        buf.clear();
        black_box(Html(12_345).to_html(&mut buf)).unwrap();
    });
}

/// Raw rust write of the same number for comparision.
#[bench]
fn escaped_nums_baseline(b: &mut Bencher) {
    let mut buf = Vec::with_capacity(500);
    b.iter(|| {
        buf.clear();
        black_box(write!(&mut buf, "{}", 12_345)).unwrap();
    });
}

#[bench]
fn escaped_short_impl(b: &mut Bencher) {
    let mut buf = Vec::with_capacity(500);
    b.iter(|| {
        buf.clear();
        black_box("Hello <World>".to_html(&mut buf)).unwrap();
    });
}

#[bench]
fn escaped_short_dyn(b: &mut Bencher) {
    let mut buf = Vec::with_capacity(500);
    b.iter(|| {
        buf.clear();
        let mut dynwrite: &mut dyn Write = black_box(&mut buf);
        black_box("Hello <World>".to_html(&mut dynwrite)).unwrap();
    });
}

#[bench]
fn escaped_long(b: &mut Bencher) {
    let mut buf = Vec::with_capacity(1000);
    let text = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, \
                sed do eiusmod tempor incididunt ut labore et dolore magna \
                aliqua. Ut enim ad minim veniam, quis nostrud exercitation \
                ullamco laboris nisi ut aliquip ex ea commodo consequat.\n \
                Duis aute irure dolor in reprehenderit <in> voluptate velit \
                esse cillum dolore eu fugiat nulla pariatur. Excepteur sint \
                occaecat cupidatat non proident, sunt in culpa qui officia \
                deserunt mollit anim id est laborum.\n";
    b.iter(|| {
        buf.clear();
        black_box(text.to_html(&mut buf)).unwrap();
    });
}