12 releases (6 breaking)

0.9.0 Feb 12, 2018
0.8.2 Oct 11, 2017
0.8.1 Aug 3, 2017
0.8.0 Nov 14, 2016
0.4.0 Dec 14, 2014
Download history 3256/week @ 2019-12-02 3856/week @ 2019-12-09 1795/week @ 2019-12-16 1286/week @ 2019-12-23 1014/week @ 2019-12-30 1475/week @ 2020-01-06 1731/week @ 2020-01-13 1688/week @ 2020-01-20 1637/week @ 2020-01-27 1402/week @ 2020-02-03 1059/week @ 2020-02-10 981/week @ 2020-02-17 1211/week @ 2020-02-24 1031/week @ 2020-03-02 1328/week @ 2020-03-09 1349/week @ 2020-03-16

10,751 downloads per month
Used in 42 crates (17 directly)

MIT/Apache

77KB
2K SLoC

Mustache Ohloh statistics Build Status

Inspired by ctemplate and et, Mustache is a framework-agnostic way to render logic-free views.

As ctemplates says, "It emphasizes separating logic from presentation: it is impossible to embed application logic in this template language."

rust-mustache is a rust implementation of Mustache.

Documentation

The different Mustache tags are documented at mustache(5).

Documentation for this library is here.

Install

Install it through Cargo!

[dependencies]
mustache = "*"

Basic example

#[macro_use]
extern crate serde_derive;
extern crate mustache;

use std::io;
use mustache::MapBuilder;

#[derive(Serialize)]
struct Planet {
    name: String,
}

fn main() {
    // First the string needs to be compiled.
    let template = mustache::compile_str("hello {{name}}").unwrap();

    // You can either use an encodable type to print "hello Mercury".
    let planet = Planet { name: "Mercury".into() };
    template.render(&mut io::stdout(), &planet).unwrap();
    println!("");

    // ... or you can use a builder to print "hello Venus".
    let data = MapBuilder::new()
        .insert_str("name", "Venus")
        .build();

    template.render_data(&mut io::stdout(), &data).unwrap();
    println!("");

    // ... you can even use closures.
    let mut planets = vec!("Jupiter", "Mars", "Earth");

    let data = MapBuilder::new()
        .insert_fn("name", move |_| {
            planets.pop().unwrap().into()
        })
        .build();

    // prints "hello Earth"
    template.render_data(&mut io::stdout(), &data).unwrap();
    println!("");

    // prints "hello Mars"
    template.render_data(&mut io::stdout(), &data).unwrap();
    println!("");

    // prints "hello Jupiter"
    template.render_data(&mut io::stdout(), &data).unwrap();
    println!("");
}

Testing

Simply clone and run:

# If you want to run the test cases, you'll need the spec as well.
git submodule init
git submodule update

cargo test

# If you want to test the readme example, we're currently using the unstable feature to do so.
cargo +nightly test --features unstable

License

See LICENSE File

Dependencies

~275–395KB