Implement Helpers.

examples/helpers.html

@@ -0,0 +1,2 @@
+Hi {{name}}.
+Hi {{name|ucase}}.

examples/helpers.js

@@ -0,0 +1,8 @@
+var helpers_helpers = {
+  ucase: function(s) {return s.toUpperCase(); }
+};
+
+var helpers = {
+  name: "Chris"
+};
+

examples/helpers.txt

@@ -0,0 +1,2 @@
+Hi Chris.
+Hi CHRIS.

examples/helpers_error.html

@@ -0,0 +1,3 @@
+Hi {{name}}.
+Hi {{name|ucase}}.
+Hi {{name|lcase}}.

examples/helpers_error.js

@@ -0,0 +1,8 @@
+var helpers_error_helpers = {
+  ucase: function(s) {return s.toUpperCase(); }
+};
+
+var helpers_error = {
+  name: "Chris"
+};
+

examples/helpers_error.txt

@@ -0,0 +1 @@
+ERROR: Helper 'lcase' is not a registered helper

examples/helpers_pipe.html

@@ -0,0 +1,2 @@
+Hi {{name}}.
+Hi {{name|ucase|bangify}}.

examples/helpers_pipe.js

@@ -0,0 +1,9 @@
+var helpers_pipe_helpers = {
+  ucase: function(s) {return s.toUpperCase(); },
+  bangify: function(s) {return "!" + s + "!"}
+};
+
+var helpers_pipe = {
+  name: "Chris"
+};
+

examples/helpers_pipe.txt

@@ -0,0 +1,2 @@
+Hi Chris.
+Hi !CHRIS!.

mustache.js

@@ -13,6 +13,7 @@ var Mustache = function() {
     ctag: "}}",
     pragmas: {},
     buffer: [],
+    helper_functions: {},
     pragmas_implemented: {
       "IMPLICIT-ITERATOR": true
     },
@@ -269,7 +270,12 @@ var Mustache = function() {
       }
 
       var value;
-
+      var helpers;
+
+      // check for helper e.g. name = "name|helperfun"
+      var helpers = name.split("|");
+      name = helpers.shift();
+
       // check for dot notation eg. foo.bar
       if(name.match(/([a-z_]+)\./ig)){
         var childValue = this.walk_context(name, context);
@@ -286,8 +292,22 @@ var Mustache = function() {
       }
 
       if(typeof value === "function") {
-        return value.apply(context);
+        value = value.apply(context);
+      }
+
+      var number_of_helpers = helpers.length;
+      if(number_of_helpers > 0) {
+        for(var idx = 0; idx < number_of_helpers; idx++) {
+          var helper = helpers[idx];
+          if(!this.helper_functions[helper]
+            || typeof this.helper_functions[helper] != "function") {
+              throw {message:
+                "Helper '" + helper + "' is not a registered helper"};
+          }
+          value = this.helper_functions[helper].apply(context, [value]);
+        }
       }
+
       if(value !== undefined) {
         return value;
       }
@@ -408,11 +428,14 @@ var Mustache = function() {
     /*
       Turns a template and view into HTML
     */
-    to_html: function(template, view, partials, send_fun) {
-      var renderer = new Renderer();
+    to_html: function(template, view, partials, send_fun, helpers) {
+      var renderer = new Renderer(helpers);
       if(send_fun) {
         renderer.send = send_fun;
       }
+      if(helpers) {
+        renderer.helper_functions = helpers;
+      }
       renderer.render(template, view || {}, partials);
       if(!send_fun) {
         return renderer.buffer.join("\n");

test/mustache_spec.rb

@@ -84,9 +84,10 @@ def load_test(dir, name, partial=false)
           runner = <<-JS
             try {
               #{@boilerplate}
+              var #{testname}_helpers = null;
               #{view}
               var template = #{template};
-              var result = Mustache.to_html(template, #{testname});
+              var result = Mustache.to_html(template, #{testname}, null, null, #{testname}_helpers);
               print(result);
             } catch(e) {
               print('ERROR: ' + e.message);
@@ -102,6 +103,7 @@ def load_test(dir, name, partial=false)
           runner = <<-JS
             try {
               #{@boilerplate}
+              var #{testname}_helpers = null;
               #{view}
               var chunks = [];
               var sendFun = function(chunk) {
@@ -110,7 +112,7 @@ def load_test(dir, name, partial=false)
                 }
               }
               var template = #{template};
-              Mustache.to_html(template, #{testname}, null, sendFun);
+              Mustache.to_html(template, #{testname}, null, sendFun, #{testname}_helpers);
               print(chunks.join("\\n"));
             } catch(e) {
               print('ERROR: ' + e.message);
@@ -132,10 +134,11 @@ def load_test(dir, name, partial=false)
           runner = <<-JS
             try {
               #{@boilerplate}
+              var #{testname}_helpers = null;
               #{view}
               var template = #{template};
               var partials = {"partial": #{partial}};
-              var result = Mustache.to_html(template, partial_context, partials);
+              var result = Mustache.to_html(template, partial_context, partials, null, #{testname}_helpers);
               print(result);
             } catch(e) {
               print('ERROR: ' + e.message);
@@ -152,7 +155,8 @@ def load_test(dir, name, partial=false)
           runner = <<-JS
             try {
               #{@boilerplate}
-              #{view};
+              var #{testname}_helpers = null;
+              #{view}
               var template = #{template};
               var partials = {"partial": #{partial}};
               var chunks = [];
@@ -161,7 +165,7 @@ def load_test(dir, name, partial=false)
                   chunks.push(chunk);
                 }
               }
-              Mustache.to_html(template, partial_context, partials, sendFun);
+              Mustache.to_html(template, partial_context, partials, sendFun, #{testname}_helpers);
               print(chunks.join("\\n"));
             } catch(e) {
               print('ERROR: ' + e.message);