mustache 0.5.1 → 0.6.0

data/man/mustache.5.ron

@@ -0,0 +1,220 @@
+mustache(5) -- Logic-less templates.
+====================================
+
+## SYNOPSIS
+
+A typical Mustache template:
+
+    Hello {{name}}
+    You have just won ${{value}}!
+    {{#in_ca}}
+    Well, ${{taxed_value}}, after taxes.
+    {{/in_ca}}
+
+Given the following hash:
+
+    {
+      "name": "Chris",
+      "value": 10000,
+      "taxed_value": 10000 - (10000 * 0.4),
+      "in_ca": true
+    }
+
+Will produce the following:
+
+    Hello Chris
+    You have just won $10000!
+    Well, $6000.0, after taxes.
+
+
+## DESCRIPTION
+
+Mustache can be used for HTML, config files, source code -
+anything. It works by expanding tags in a template using values
+provided in a hash or object.
+
+We call it "logic-less" because there are no if statements, else
+clauses, or for loops. Instead there are only tags. Some tags are
+replaced with a value, some nothing, and others a series of
+values. This document explains the different types of Mustache tags.
+
+
+## TAG TYPES
+
+Tags are indicated by the double mustaches. `{{name}}` is a tag. Let's
+talk about the different types of tags.
+
+
+### Variables
+
+The most basic tag is the variable. A `{{name}}` tag in a basic
+template will try to call the `name` method on your view. If there is
+no `name` method, an exception will be raised.
+
+All variables are HTML escaped by default. If you want to return
+unescaped HTML, use the triple mustache: `{{{name}}}`.
+
+By default a variable "miss" returns an empty string. This can usually
+be configured in your Mustache library.
+
+Template:
+
+    * {{name}}
+    * {{age}}
+    * {{company}}
+    * {{{company}}}
+
+Hash:
+
+    {
+      "name": "Chris",
+      "company": "<b>GitHub</b>"
+    }
+
+Output:
+
+    * Chris
+    *
+    * &lt;b&gt;GitHub&lt;/b&gt;
+    * <b>GitHub</b>
+
+### Boolean Sections
+
+A section begins with a pound and ends with a slash. That is,
+`{{#person}}` begins a "person" section while `{{/person}}` ends it.
+
+If the `person` key exists and calling it returns false, the HTML
+between the pound and slash will not be displayed.
+
+If the `person` method exists and calling it returns true, the HTML
+between the pound and slash will be rendered and displayed.
+
+Template:
+
+    {{#person}}
+      Shown!
+    {{/person}}
+    {{#anything_else}}
+      Never shown!
+    {{/anything_else}}
+
+Hash:
+
+    {
+      "person": true
+    }
+
+Output:
+
+    Shown!
+
+### Enumerable Sections
+
+Enumerable sections are syntactically identical to boolean sections in
+that they begin with a pound and end with a slash. The difference,
+however, is in the view: if the method called returns an enumerable,
+the section is repeated as the enumerable is iterated over.
+
+Each item in the enumerable is expected to be a hash which will then
+become the context of the corresponding iteration. In this way we can
+construct loops.
+
+Template:
+
+    {{#repo}}
+      <b>{{name}}</b>
+    {{/repo}}
+
+Hash:
+
+    {
+      "repo": [
+        { "name": "resque" },
+        { "name": "hub" },
+        { "name": "rip" },
+      ]
+    }
+
+Output:
+
+    <b>resque</b>
+    <b>hub</b>
+    <b>rip</b>
+
+
+### Comments
+
+Comments begin with a bang and are ignored. The following template:
+
+    <h1>Today{{! ignore me }}.</h1>
+
+Will render as follows:
+
+    <h1>Today.</h1>
+
+
+### Partials
+
+Partials begin with a greater than sign, like `{{> box}}`.
+
+It is useful to think of partials as a "template expansion" - that is,
+the actual partial tag will be replaced with the content of the
+partial. Therefor partials share the current context.
+
+For example, this template and partial:
+
+    base.mustache:
+    <h2>Names</h2>
+    {{# names }}
+      {{> user }}
+    {{/ names }}
+
+    user.mustache:
+    <strong>{{ name }}</strong>
+
+Can be thought of as a single, expanded template:
+
+    <h2>Names</h2>
+    {{# names }}
+      <strong>{{ name }}</strong>
+    {{/ names }}
+
+
+### Set Delimiter
+
+Set Delimiter tags start with an equal sign and change the tag
+delimiters from {{ and }} to custom strings.
+
+Consider the following contrived example:
+
+    * {{ default_tags }}
+    {{=<% %>=}}
+    * <% erb_style_tags %>
+    <%={{ }}=%>
+    * {{ default_tags_again }}
+
+Here we have a list with three items. The first item uses the default
+tag style, the second uses erb style as defined by the Set Delimiter
+tag, and the third returns to the default style after yet another Set
+Delimiter declaration.
+
+According to [ctemplates][ct], this "is useful for languages like TeX, where
+double-braces may occur in the text and are awkward to use for
+markup."
+
+Custom delimiters may not contain whitespace or the equals sign.
+
+[ct]: http://google-ctemplate.googlecode.com/svn/trunk/doc/howto.html
+
+
+## COPYRIGHT
+
+Mustache is Copyright (C) 2009 Chris Wanstrath
+
+Original CTemplate by Google
+
+
+## SEE ALSO
+
+mustache(1), mustache(7), gem(1),
+<http://defunkt.github.com/mustache/>

data/test/helper.rb

@@ -11,3 +11,4 @@ require 'comments'
 require 'passenger'
 require 'delimiters'
 require 'double_section'
+require 'nested_objects'

data/test/mustache_test.rb

@@ -21,17 +21,17 @@ end_passenger
     <li><a href="#Blue">blue</a></li>
     </ul>
 end_complex
+  end
 
-# TODO: Preserve indentation
-# http://github.com/defunkt/mustache/issues#issue/2
-#     assert_equal <<-end_complex, ComplexView.render
-# <h1>Colors</h1>
-#   <ul>
-#       <li><strong>red</strong></li>
-#       <li><a href="#Green">green</a></li>
-#       <li><a href="#Blue">blue</a></li>
-#   </ul>
-# end_complex
+  def test_nested_objects
+    assert_equal <<-end_complex, NestedObjects.render
+<h1>Colors</h1>
+<ul>
+  <li><strong>red</strong></li>
+    <li><a href="#Green">green</a></li>
+    <li><a href="#Blue">blue</a></li>
+    </ul>
+end_complex
   end
 
   def test_single_line_sections
@@ -178,14 +178,17 @@ data
                                                      :deploy_to => '/var/www/example.com' )
   end
 
-  def test_reports_type_errors_in_sections
+  def test_doesnt_execute_what_it_doesnt_need_to
     instance = Mustache.new
-    instance[:list] = [ :item, 1234 ]
-    instance.template = '{{#list}} <li>{{item}}</li> {{/list}}'
-
-    assert_raise TypeError do
-      instance.render
+    instance[:show] = false
+    instance.instance_eval do
+      def die
+        raise "bummer"
+      end
     end
+    instance.template = '{{#show}} <li>{{die}}</li> {{/show}} yay'
+
+    assert_equal "yay", instance.render
   end
 
   def test_reports_unclosed_sections

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: mustache
 version: !ruby/object:Gem::Version 
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors: 
 - Chris Wanstrath
@@ -9,68 +9,49 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-15 00:00:00 -08:00
-default_executable: mustache
+date: 2010-03-08 00:00:00 -08:00
+default_executable: 
 dependencies: []
 
-description: Mustache is a framework-agnostic way to render logic-free views.
+description: |
+  Inspired by ctemplate, 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.
+  
+  Think of Mustache as a replacement for your views. Instead of views
+  consisting of ERB or HAML with random helpers and arbitrary logic,
+  your views are broken into two parts: a Ruby class and an HTML
+  template.
+
 email: chris@ozmm.org
 executables: 
 - mustache
 extensions: []
 
-extra_rdoc_files: 
-- LICENSE
-- README.md
+extra_rdoc_files: []
+
 files: 
-- .gitignore
-- .kick
-- CONTRIBUTORS
-- HISTORY.md
-- LICENSE
 - README.md
 - Rakefile
-- benchmarks/complex.erb
-- benchmarks/complex.haml
-- benchmarks/helper.rb
-- benchmarks/simple.erb
-- benchmarks/speed.rb
-- bin/mustache
-- contrib/mustache.vim
-- contrib/tpl-mode.el
-- examples/comments.mustache
-- examples/comments.rb
-- examples/complex_view.mustache
-- examples/complex_view.rb
-- examples/delimiters.mustache
-- examples/delimiters.rb
-- examples/double_section.mustache
-- examples/double_section.rb
-- examples/escaped.mustache
-- examples/escaped.rb
-- examples/inner_partial.mustache
-- examples/inner_partial.txt
-- examples/namespaced.mustache
-- examples/namespaced.rb
-- examples/partial_with_module.mustache
-- examples/partial_with_module.rb
-- examples/passenger.conf
-- examples/passenger.rb
-- examples/simple.mustache
-- examples/simple.rb
-- examples/template_partial.mustache
-- examples/template_partial.rb
-- examples/template_partial.txt
-- examples/unescaped.mustache
-- examples/unescaped.rb
-- lib/mustache.rb
+- LICENSE
 - lib/mustache/context.rb
 - lib/mustache/sinatra.rb
 - lib/mustache/template.rb
 - lib/mustache/version.rb
-- lib/rack/bug/panels/mustache_panel.rb
+- lib/mustache.rb
 - lib/rack/bug/panels/mustache_panel/mustache_extension.rb
 - lib/rack/bug/panels/mustache_panel/view.mustache
+- lib/rack/bug/panels/mustache_panel.rb
+- bin/mustache
+- man/mustache.1
+- man/mustache.1.html
+- man/mustache.1.ron
+- man/mustache.5
+- man/mustache.5.html
+- man/mustache.5.ron
 - test/autoloading_test.rb
 - test/helper.rb
 - test/mustache_test.rb
@@ -80,8 +61,8 @@ homepage: http://github.com/defunkt/mustache
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -103,19 +84,5 @@ rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
 summary: Mustache is a framework-agnostic way to render logic-free views.
-test_files: 
-- test/autoloading_test.rb
-- test/helper.rb
-- test/mustache_test.rb
-- test/partial_test.rb
-- examples/comments.rb
-- examples/complex_view.rb
-- examples/delimiters.rb
-- examples/double_section.rb
-- examples/escaped.rb
-- examples/namespaced.rb
-- examples/partial_with_module.rb
-- examples/passenger.rb
-- examples/simple.rb
-- examples/template_partial.rb
-- examples/unescaped.rb
+test_files: []
+

data/.gitignore

@@ -1 +0,0 @@
-docs

data/.kick

@@ -1,26 +0,0 @@
-# take control of the growl notifications
-module GrowlHacks
-  def growl(type, subject, body, *args, &block)
-    case type
-    when Kicker::GROWL_NOTIFICATIONS[:succeeded]
-      puts subject = "Success"
-      body = body.split("\n").last
-    when Kicker::GROWL_NOTIFICATIONS[:failed]
-      subject = "Failure"
-      puts body
-      body = body.split("\n").last
-    else
-      return nil
-    end
-    super(type, subject, body, *args, &block)
-  end
-end
-
-Kicker.send :extend, GrowlHacks
-
-# no logging
-Kicker::Utils.module_eval do
-  def log(message)
-    nil
-  end
-end

data/CONTRIBUTORS

@@ -1,7 +0,0 @@
-* Chris Wanstrath
-* Francesc Esplugas
-* Magnus Holm
-* Nicolas Sanguinetti
-* Jan-Erik Rediger
-* Michael Daines
-* Aaron Patterson