mustache 0.5.1 → 0.6.0

data/lib/mustache/context.rb

@@ -11,23 +11,66 @@ class Mustache
 
   # A Context represents the context which a Mustache template is
   # executed within. All Mustache tags reference keys in the Context.
-  class Context < Hash
+  class Context
+    # Expect to be passed an instance of `Mustache`.
     def initialize(mustache)
       @mustache = mustache
-      super()
+      @stack = [@mustache]
     end
 
+    # Adds a new object to the context's internal stack.
+    #
+    # Returns the Context.
+    def push(new)
+      @stack.unshift(new)
+      self
+    end
+    alias_method :update, :push
+
+    # Removes the most recently added object from the context's
+    # internal stack.
+    #
+    # Returns the Context.
+    def pop
+      @stack.shift
+      self
+    end
+
+    # Can be used to add a value to the context in a hash-like way.
+    #
+    # context[:name] = "Chris"
+    def []=(name, value)
+      push(name => value)
+    end
+
+    # Alias for `fetch`.
     def [](name)
-      if has_key?(name)
-        super
-      elsif has_key?(name.to_s)
-        super(name.to_s)
-      elsif @mustache.respond_to?(name)
-        @mustache.send(name)
-      elsif @mustache.raise_on_context_miss?
-        raise ContextMiss.new("Can't find #{name} in #{@mustache.inspect}")
+      fetch(name, nil)
+    end
+
+    # Similar to Hash#fetch, finds a value by `name` in the context's
+    # stack. You may specify the default return value by passing a
+    # second parameter.
+    #
+    # If no second parameter is passed (or raise_on_context_miss is
+    # set to true), will raise a ContextMiss exception on miss.
+    def fetch(name, default = :__raise)
+      @stack.each do |frame|
+        hash = frame.respond_to?(:has_key?)
+
+        if hash && frame.has_key?(name)
+          return frame[name]
+        elsif hash && frame.has_key?(name.to_s)
+          return frame[name.to_s]
+        elsif !hash && frame.respond_to?(name)
+          return frame.__send__(name)
+        end
+      end
+
+      if default == :__raise || @mustache.raise_on_context_miss?
+        raise ContextMiss.new("Can't find #{name} in #{@stack.inspect}")
       else
-        nil
+        default
       end
     end
   end

data/lib/mustache/template.rb

@@ -76,20 +76,8 @@ class Mustache
         ctxtmp = "ctx#{tmpid}"
         res << ev(<<-compiled)
         if v = ctx[#{name}]
-          v = [v] if v.is_a?(Hash) # shortcut when passed a single hash
-          if v.respond_to?(:each)
-            #{ctxtmp} = ctx.dup
-            begin
-              r = v.map { |h| ctx.update(h); #{code} }.join
-            rescue TypeError => e
-              raise TypeError,
-                "All elements in {{#{name.to_s[1..-1]}}} are not hashes!"
-            end
-            ctx.replace(#{ctxtmp})
-            r
-          else
-            #{code}
-          end
+          v = [v] unless v.is_a?(Array) # shortcut when passed non-array
+          v.map { |h| ctx.push(h); c = #{code}; ctx.pop; c }.join
         end
         compiled
         # $' = The string to the right of the last successful match

data/lib/mustache/version.rb

@@ -1,3 +1,3 @@
 class Mustache
-  Version = '0.5.1'
+  Version = '0.6.0'
 end

data/man/mustache.1

@@ -0,0 +1,138 @@
+.\" generated with Ron/v0.3
+.\" http://github.com/rtomayko/ron/
+.
+.TH "MUSTACHE" "1" "March 2010" "DEFUNKT" "Mustache Manual"
+.
+.SH "NAME"
+\fBmustache\fR \-\- Mustache processor
+.
+.SH "SYNOPSIS"
+\fBcat data.yml template.mustache | mustache\fR
+.
+.SH "DESCRIPTION"
+Mustache is a logic\-less templating system for HTML, config files,
+anything.
+.
+.P
+The \fBmustache\fR command processes a Mustache template preceded by YAML
+frontmatter from standard input and prints one or more documents to
+standard output.
+.
+.P
+YAML frontmatter beings with \fB---\fR on a single line, followed by YAML,
+ending with another \fB---\fR on a single line, e.g.
+.
+.IP "" 4
+.
+.nf
+
+\fB---
+names: [ {name: chris}, {name: mark}, {name: scott} ]
+--- \fR
+.
+.fi
+.
+.IP "" 0
+.
+.P
+If you are unfamiliar with YAML, it is a superset of JSON. Valid JSON
+should work fine.
+.
+.P
+After the frontmatter should come any valid Mustache template. See
+mustache(5) for an overview of Mustache templates.
+.
+.P
+For example:
+.
+.IP "" 4
+.
+.nf
+
+\fB{{#names}}
+  Hi {{name}}!
+{{/names}} \fR
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Now let's combine them.
+.
+.IP "" 4
+.
+.nf
+
+\fB$ cat data.yml
+---
+names: [ {name: chris}, {name: mark}, {name: scott} ]
+--- 
+$ cat template.mustache
+{{#names}}
+  Hi {{name}}!
+{{/names}}
+
+$ cat data.yml template.mustache | mustache
+Hi chris!
+Hi mark!
+Hi scott!
+\fR
+.
+.fi
+.
+.IP "" 0
+.
+.P
+If you provide multiple YAML documents (as delimited by \fB---\fR), your
+template will be rendered multiple times. Like a mail merge.
+.
+.P
+For example:
+.
+.IP "" 4
+.
+.nf
+
+\fB$ cat data.yml
+---
+name: chris
+---
+name: mark
+---
+name: scott
+--- 
+$ cat template.mustache
+Hi {{name}}!
+
+$ cat data.yml template.mustache | mustache
+Hi chris!
+Hi mark!
+Hi scott!
+\fR
+.
+.fi
+.
+.IP "" 0
+.
+.SH "INSTALLATION"
+If you have RubyGems installed:
+.
+.IP "" 4
+.
+.nf
+
+\fBgem install mustache \fR
+.
+.fi
+.
+.IP "" 0
+.
+.SH "COPYRIGHT"
+Mustache is Copyright (C) 2009 Chris Wanstrath
+.
+.P
+Original CTemplate by Google
+.
+.SH "SEE ALSO"
+mustache(5), mustache(7), gem(1),\fIhttp://defunkt.github.com/mustache/\fR

data/man/mustache.1.html

@@ -0,0 +1,168 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv='content-type' value='text/html;charset=utf8'>
+  <meta name='generator' value='Ron/v0.3'>
+  <title>mustache(1) -- Mustache processor</title>
+  <style type='text/css'>
+    body {margin:0}
+    #man, #man code, #man pre, #man tt, #man kbd, #man samp {
+      font-family:consolas,monospace;
+      font-size:16px;
+      line-height:1.3;
+      color:#343331;
+      background:#fff; }
+    #man { max-width:89ex; text-align:justify; margin:0 25px 25px 25px }
+    #man h1, #man h2, #man h3 { color:#232221;clear:left }
+    #man h1 { font-size:28px; margin:15px 0 30px 0; text-align:center }
+    #man h2 { font-size:18px; margin-bottom:0; margin-top:10px; line-height:1.3; }
+    #man h3 { font-size:16px; margin:0 0 0 4ex; }
+    #man p, #man ul, #man ol, #man dl, #man pre { margin:0 0 18px 0; }
+    #man pre {
+      color:#333231;
+      background:#edeceb;
+      padding:5px 7px;
+      margin:0px 0 20px 0;
+      border-left:2ex solid #ddd}
+    #man pre + h2, #man pre + h3 {
+      margin-top:22px;
+    }
+    #man h2 + pre, #man h3 + pre {
+      margin-top:5px;
+    }
+    #man > p, #man > ul, #man > ol, #man > dl, #man > pre { margin-left:8ex; }
+    #man dt { margin:0; clear:left }
+    #man dt.flush { float:left; width:8ex }
+    #man dd { margin:0 0 0 9ex }
+    #man code, #man strong, #man b { font-weight:bold; color:#131211; }
+    #man pre code { font-weight:normal; color:#232221; background:inherit }
+    #man em, var, u {
+      font-style:normal; color:#333231; border-bottom:1px solid #999; }
+    #man h1.man-title { display:none; }
+    #man ol.man, #man ol.man li { margin:2px 0 10px 0; padding:0;
+      float:left; width:33%; list-style-type:none;
+      text-transform:uppercase; font-size:18px; color:#999;
+      letter-spacing:1px;}
+    #man ol.man { width:100%; }
+    #man ol.man li.tl { text-align:left }
+    #man ol.man li.tc { text-align:center;letter-spacing:4px }
+    #man ol.man li.tr { text-align:right }
+    #man ol.man a { color:#999 }
+    #man ol.man a:hover { color:#333231 }
+  </style>
+</head>
+<body>
+<div id='man'>
+
+<h1 class='man-title'>mustache(1)</h1>
+
+<ol class='head man'>
+  <li class='tl'>mustache(1)</li>
+  <li class='tc'>Mustache Manual</li>
+  <li class='tr'>mustache(1)</li>
+</ol>
+
+<h2 id='NAME'>NAME</h2>
+<p><code>mustache</code> -- Mustache processor</p>
+<h2>SYNOPSIS</h2>
+
+<p><code>cat data.yml template.mustache | mustache</code></p>
+
+<h2>DESCRIPTION</h2>
+
+<p>Mustache is a logic-less templating system for HTML, config files,
+anything.</p>
+
+<p>The <code>mustache</code> command processes a Mustache template preceded by YAML
+frontmatter from standard input and prints one or more documents to
+standard output.</p>
+
+<p>YAML frontmatter beings with <code>---</code> on a single line, followed by YAML,
+ending with another <code>---</code> on a single line, e.g.</p>
+
+<pre><code>---
+names: [ {name: chris}, {name: mark}, {name: scott} ]
+---
+</code></pre>
+
+<p>If you are unfamiliar with YAML, it is a superset of JSON. Valid JSON
+should work fine.</p>
+
+<p>After the frontmatter should come any valid Mustache template. See
+mustache(5) for an overview of Mustache templates.</p>
+
+<p>For example:</p>
+
+<pre><code>{{#names}}
+  Hi {{name}}!
+{{/names}}
+</code></pre>
+
+<p>Now let's combine them.</p>
+
+<pre><code>$ cat data.yml
+---
+names: [ {name: chris}, {name: mark}, {name: scott} ]
+---
+
+$ cat template.mustache
+{{#names}}
+  Hi {{name}}!
+{{/names}}
+
+$ cat data.yml template.mustache | mustache
+Hi chris!
+Hi mark!
+Hi scott!
+</code></pre>
+
+<p>If you provide multiple YAML documents (as delimited by <code>---</code>), your
+template will be rendered multiple times. Like a mail merge.</p>
+
+<p>For example:</p>
+
+<pre><code>$ cat data.yml
+---
+name: chris
+---
+name: mark
+---
+name: scott
+---
+
+$ cat template.mustache
+Hi {{name}}!
+
+$ cat data.yml template.mustache | mustache
+Hi chris!
+Hi mark!
+Hi scott!
+</code></pre>
+
+<h2>INSTALLATION</h2>
+
+<p>If you have RubyGems installed:</p>
+
+<pre><code>gem install mustache
+</code></pre>
+
+<h2>COPYRIGHT</h2>
+
+<p>Mustache is Copyright (C) 2009 Chris Wanstrath</p>
+
+<p>Original CTemplate by Google</p>
+
+<h2>SEE ALSO</h2>
+
+<p>mustache(5), mustache(7), gem(1),
+<a href="http://defunkt.github.com/mustache/">http://defunkt.github.com/mustache/</a></p>
+
+<ol class='foot man'>
+  <li class='tl'>DEFUNKT</li>
+  <li class='tc'>March 2010</li>
+  <li class='tr'>mustache(1)</li>
+</ol>
+
+</div>
+</body>
+</html>

data/man/mustache.1.ron

@@ -0,0 +1,94 @@
+mustache(1) -- Mustache processor
+=================================
+
+## SYNOPSIS
+
+`cat data.yml template.mustache | mustache`
+
+
+## DESCRIPTION
+
+Mustache is a logic-less templating system for HTML, config files,
+anything.
+
+The `mustache` command processes a Mustache template preceded by YAML
+frontmatter from standard input and prints one or more documents to
+standard output.
+
+YAML frontmatter beings with `---` on a single line, followed by YAML,
+ending with another `---` on a single line, e.g.
+
+    ---
+    names: [ {name: chris}, {name: mark}, {name: scott} ]
+    ---
+
+If you are unfamiliar with YAML, it is a superset of JSON. Valid JSON
+should work fine.
+
+After the frontmatter should come any valid Mustache template. See
+mustache(5) for an overview of Mustache templates.
+
+For example:
+
+    {{#names}}
+      Hi {{name}}!
+    {{/names}}
+
+Now let's combine them.
+
+    $ cat data.yml
+    ---
+    names: [ {name: chris}, {name: mark}, {name: scott} ]
+    ---
+
+    $ cat template.mustache
+    {{#names}}
+      Hi {{name}}!
+    {{/names}}
+
+    $ cat data.yml template.mustache | mustache
+    Hi chris!
+    Hi mark!
+    Hi scott!
+
+If you provide multiple YAML documents (as delimited by `---`), your
+template will be rendered multiple times. Like a mail merge.
+
+For example:
+
+    $ cat data.yml
+    ---
+    name: chris
+    ---
+    name: mark
+    ---
+    name: scott
+    ---
+
+    $ cat template.mustache
+    Hi {{name}}!
+
+    $ cat data.yml template.mustache | mustache
+    Hi chris!
+    Hi mark!
+    Hi scott!
+
+
+## INSTALLATION
+
+If you have RubyGems installed:
+
+    gem install mustache
+
+
+## COPYRIGHT
+
+Mustache is Copyright (C) 2009 Chris Wanstrath
+
+Original CTemplate by Google
+
+
+## SEE ALSO
+
+mustache(5), mustache(7), gem(1),
+<http://defunkt.github.com/mustache/>