28 releases
| 0.8.4 | Oct 13, 2021 |
|---|---|
| 0.8.3 | Mar 21, 2020 |
| 0.8.1 | Feb 21, 2020 |
| 0.7.0 | Aug 28, 2019 |
| 0.5.2 | Jun 26, 2015 |
#26 in Template engine
3,963 downloads per month
Used in 34 crates
(23 directly)
63KB
1K
SLoC
Horrorshow
A macro-based html templating library, compatible with stable rust (currently requires rust >= 1.37).
Features
This crate will degrade gracefully when compiled without std (disable the "std"
feature) and even without alloc (disable the "alloc" feature).
When compiled with alloc but without std:
Template::write_to_io()is not defined.- Templates may only emit errors implementing
ToStringand all such errors are immediately converted to strings.
When compiled with just core:
RenderBoxis no longer defined (no allocation).- The
Template::into_string()andTemplate::write_to_string()are no longer defined. The only template rendering method available isTemplate::write_to_fmt(). - Templates may only emit static
&strerrors, and only the first is recorded.
Example:
#[macro_use]
extern crate horrorshow;
use horrorshow::prelude::*;
use horrorshow::helper::doctype;
fn main() {
let actual = format!("{}", html! {
: doctype::HTML;
html {
head {
title : "Hello world!";
}
body {
// attributes
h1(id="heading") {
// Insert escaped text
: "Hello! This is <html />"
}
p {
// Insert raw text (unescaped)
: Raw("Let's <i>count</i> to 10!")
}
ol(id="count") {
// You can embed for loops, while loops, and if statements.
@ for i in 0..10 {
li(first? = (i == 0)) {
// Format some text.
: format_args!("{}", i+1)
}
}
}
// You need semi-colons for tags without children.
br; br;
p {
// You can also embed closures.
|tmpl| {
tmpl << "Easy!";
}
}
}
}
});
let expected = "\
<!DOCTYPE html>\
<html>\
<head>\
<title>Hello world!</title>\
</head>\
<body>\
<h1 id=\"heading\">Hello! This is <html /></h1>\
<p>Let's <i>count</i> to 10!</p>\
<ol id=\"count\">\
<li first>1</li>\
<li>2</li>\
<li>3</li>\
<li>4</li>\
<li>5</li>\
<li>6</li>\
<li>7</li>\
<li>8</li>\
<li>9</li>\
<li>10</li>\
</ol>\
<br /><br />\
<p>Easy!</p>\
</body>\
</html>";
assert_eq!(expected, actual);
}