12 releases (6 breaking)

Uses old Rust 2015

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 3089/week @ 2021-05-28 3220/week @ 2021-06-04 3367/week @ 2021-06-11 3117/week @ 2021-06-18 3592/week @ 2021-06-25 3247/week @ 2021-07-02 3310/week @ 2021-07-09 3105/week @ 2021-07-16 2946/week @ 2021-07-23 3261/week @ 2021-07-30 2724/week @ 2021-08-06 3011/week @ 2021-08-13 3600/week @ 2021-08-20 2542/week @ 2021-08-27 2335/week @ 2021-09-03 3362/week @ 2021-09-10

11,551 downloads per month
Used in 57 crates (25 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

~260–385KB