Class: Mustache::Template

Inherits:
Object
  • Object
show all
Defined in:
lib/mustache/template.rb

Overview

A Template represents a Mustache template. It compiles and caches a raw string template into something usable.

The idea is this: when handed a Mustache template, convert it into a Ruby string by transforming Mustache tags into interpolated Ruby.

You shouldn't use this class directly, instead:

>> Mustache.render(template, hash)

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(source) ⇒ Template

Expects a Mustache template as a string along with a template path, which it uses to find partials.



22
23
24
# File 'lib/mustache/template.rb', line 22

def initialize(source)
  @source = source
end

Instance Attribute Details

#sourceObject (readonly)

Returns the value of attribute source



18
19
20
# File 'lib/mustache/template.rb', line 18

def source
  @source
end

Instance Method Details

#compile(src = @source) ⇒ Object Also known as: to_s

Does the dirty work of transforming a Mustache template into an interpolation-friendly Ruby string.



48
49
50
# File 'lib/mustache/template.rb', line 48

def compile(src = @source)
  Generator.new.compile(tokens(src))
end

#partialsArray

Returns an array of partials.

Partials that belong to sections are included, but the section name is not preserved

Returns:

  • (Array)

    Returns an array of partials.



102
103
104
105
106
107
108
109
110
# File 'lib/mustache/template.rb', line 102

def partials
  Template.recursor(tokens, []) do |token, section|
    if token[1] == :partial
      [ new_token=token, new_section=section, result=token[2], stop=true ]
    else
      [ new_token=token, new_section=section, result=nil, stop=false ]
    end
  end.flatten.reject(&:nil?).uniq
end

#render(context) ⇒ Object

Renders the `@source` Mustache template using the given `context`, which should be a simple hash keyed with symbols.

The first time a template is rendered, this method is overriden and from then on it is “compiled”. Subsequent calls will skip the compilation step and run the Ruby version of the template directly.



33
34
35
36
37
38
39
40
41
42
43
44
# File 'lib/mustache/template.rb', line 33

def render(context)
  # Compile our Mustache template into a Ruby string
  compiled = "def render(ctx) #{compile} end"

  # Here we rewrite ourself with the interpolated Ruby version of
  # our Mustache template so subsequent calls are very fast and
  # can skip the compilation stage.
  instance_eval(compiled, __FILE__, __LINE__ - 1)

  # Call the newly rewritten version of #render
  render(context)
end

#sectionsArray

Returns an array of sections.

Sections that belong to other sections will be of the form `section1.childsection`

Returns:

  • (Array)

    Returns an array of section.



85
86
87
88
89
90
91
92
93
94
# File 'lib/mustache/template.rb', line 85

def sections
  Template.recursor(tokens, []) do |token, section|
    if [:section, :inverted_section].include?(token[1])
      new_section=(section + [token[2][2][0]])
      [ new_token=token[4], new_section, result=new_section.join('.'), stop=false ]
    else
      [ new_token=token, new_section=section, result=nil, stop=false ]
    end
  end.flatten.reject(&:nil?).uniq
end

#tagsArray

Returns an array of tags.

Tags that belong to sections will be of the form `section1.tag`.

Returns:

  • (Array)

    Returns an array of tags.



67
68
69
70
71
72
73
74
75
76
77
# File 'lib/mustache/template.rb', line 67

def tags
  Template.recursor(tokens, []) do |token, section|
    if [:etag, :utag].include?(token[1])
      [ new_token=nil, new_section=nil, result=((section + [token[2][2][0]]).join('.')), stop=true ]
    elsif [:section, :inverted_section].include?(token[1])
      [ new_token=token[4], new_section=(section + [token[2][2][0]]), result=nil, stop=false ]
    else
      [ new_token=token, new_section=section, result=nil, stop=false ]
    end
  end.flatten.reject(&:nil?).uniq
end

#tokens(src = @source) ⇒ Array

Returns an array of tokens for a given template.

Returns:

  • (Array)

    Array of tokens.



57
58
59
# File 'lib/mustache/template.rb', line 57

def tokens(src = @source)
  Parser.new.compile(src)
end