#html #template

horrorshow

a templating library written in rust macros

27 releases

✓ Uses Rust 2018 edition

0.8.3 Mar 21, 2020
0.8.1 Feb 21, 2020
0.7.0 Aug 28, 2019
0.6.6 Mar 16, 2019
0.5.2 Jun 26, 2015

#5 in Template engine

Download history 61/week @ 2019-12-15 95/week @ 2019-12-22 57/week @ 2019-12-29 38/week @ 2020-01-05 429/week @ 2020-01-12 39/week @ 2020-01-19 48/week @ 2020-01-26 44/week @ 2020-02-02 77/week @ 2020-02-09 108/week @ 2020-02-16 170/week @ 2020-02-23 63/week @ 2020-03-01 126/week @ 2020-03-08 597/week @ 2020-03-15 759/week @ 2020-03-22 276/week @ 2020-03-29

607 downloads per month
Used in 19 crates (12 directly)

MIT/Apache

62KB
1K SLoC

Horrorshow

Build Status Documentation crates.io

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 ToString and all such errors are immediately converted to strings.

When compiled with just core:

  • RenderBox is no longer defined (no allocation).
  • The Template::into_string() and Template::write_to_string() are no longer defined. The only template rendering method available is Template::write_to_fmt().
  • Templates may only emit static &str errors, 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 &lt;html /&gt;</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);
}

No runtime deps