[![Build Status](https://travis-ci.org/softmoth/p6-Template-Mustache.svg?branch=master)](https://travis-ci.org/softmoth/p6-Template-Mustache) [![Windows Status](https://ci.appveyor.com/api/projects/status/github/softmoth/p6-Template-Mustache?branch=master&passingText=Windows%20-%20OK&failingText=Windows%20-%20FAIL&pendingText=Windows%20-%20pending&svg=true)](https://ci.appveyor.com/project/softmoth/p6-Template-Mustache/branch/master) Raku implementation of Mustache templates, [http://mustache.github.io/](http://mustache.github.io/). Synopsis ======== use Template::Mustache; # Call .render as a class method Template::Mustache.render('Hello, {{planet}}!', { planet => 'world' }).say; # Or instantiate an instance my $stache = Template::Mustache.new: :from<./views>; # Subroutines are called say $stache.render('The time is {{time}}', { time => { ~DateTime.new(now).local } }); my @people = { :name('James T. Kirk'), :title }, { :name('Wesley'), :title('Dread Pirate'), :emcee }, { :name('Dana Scully'), :title('Special Agent') }, ; # See this template in ./t/views/roster.mustache $stache.render('roster', { :@people }).say; my %context = event => 'Masters of the Universe Convention', :@people, ; my %partials = welcome => qq:b{Welcome to the {{event}}! We’re pleased to have you here.\n\n}, ; # See this result in ./t/50-readme.t Template::Mustache.render(q:to/EOF/, {{> welcome}} {{> roster}} Dinner at 7PM in the Grand Ballroom. Bring a chair! EOF %context, :from([%partials, './views']) ).say; Extensions ========== Template inheritence -------------------- Support for `hogan.js`-style [template inheritence](https://github.com/groue/GRMustache/blob/master/Guides/template_inheritance.md) is available. More Examples and Tests ======================= The Mustache spec provides a wealth of examples to demonstrate exactly how the format behaves. [https://github.com/mustache/spec/tree/master/specs/](https://github.com/mustache/spec/tree/master/specs/) To run tests, # Using Raku's prove6 tool: zef install App::Prove6 prove6 -Ilib -v # or using Perl's prove: RAKULIB=./lib prove -e raku -v All spec tests pass: [https://travis-ci.org/softmoth/p6-Template-Mustache](https://travis-ci.org/softmoth/p6-Template-Mustache). The perl6 branch just updates the .json files to match the .yml sources (needed until someone writes a compliant YAML parser in Raku … hint, hint), and adds Raku lambda code strings for that portion of the specs. An updated copy of the tests is distributed in `t/specs`. To check against the official (outdated) specs repository, clone it into `../mustache-spec`: # Ensure you are using the default 'perl6' branch, not 'master' git clone git@github.com:softmoth/mustache-spec.git ../mustache-spec git branch -v The test file `t/specs/inheritable_partials.json` is taken from [groue/GRMustache](https:/github.com/groue/GRMustache). Other Mustache Implementations ============================== There are many, many Mustache implementations in various languages. Some of note are: * The original Ruby version [https://github.com/defunkt/mustache](https://github.com/defunkt/mustache) * Twitter's hogan.js [https://github.com/twitter/hogan.js](https://github.com/twitter/hogan.js) * mustache.java [https://github.com/spullara/mustache.java](https://github.com/spullara/mustache.java) * GRMustache (Objective C) [https://github.com/groue/GRMustache](https://github.com/groue/GRMustache) * mustache.php [https://github.com/bobthecow/mustache.php](https://github.com/bobthecow/mustache.php) TODO ==== * full object support (with method calls; currently the object is just stringified) * global helpers (context items that float at the top of the stack) * database loader * pragmas (FILTERS?) License ======= [Artistic License 2.0](http://www.perlfoundation.org/artistic_license_2_0)