class Mustache module Sinatra module Helpers # Call this in your Sinatra routes. def mustache(template, options={}, locals={}) # Locals can be passed as options under the :locals key. locals.update(options.delete(:locals) || {}) # Grab any user-defined settings. if settings.respond_to?(:mustache) options = settings.send(:mustache).merge(options) end # If they aren't explicitly disabling layouts, try to find # one. if options[:layout] != false # Let the user pass in a layout name. layout_name = options[:layout] # If all they said was `true` (or nothing), default to :layout. layout_name = :layout if layout_name == true || !layout_name # If they passed a layout name use that. layout = mustache_class(layout_name, options) # If it's just an anonymous subclass then don't bother, otherwise # give us a layout instance. if layout.name && layout.name.empty? layout = nil else layout = layout.new end end # If instead of a symbol they gave us a Mustache class, # use that for rendering. klass = template if template.is_a?(Class) && template < Mustache # Find and cache the view class we want if we don't have # one yet. This ensures the compiled template is cached, # too - no looking up and compiling templates on each page # load. if klass.nil? klass = mustache_class(template, options) end # Does the view subclass the layout? If so we'll use the # view to render the layout so you can override layout # methods in your view - tricky. view_subclasses_layout = klass < layout.class if layout # Create a new instance for playing with. instance = klass.new # Copy instance variables set in Sinatra to the view instance_variables.each do |name| instance.instance_variable_set(name, instance_variable_get(name)) end # Render with locals. rendered = instance.render(instance.template, locals) # Now render the layout with the view we just rendered, if we # need to. if layout && view_subclasses_layout rendered = instance.render(layout.template, :yield => rendered) elsif layout rendered = layout.render(layout.template, :yield => rendered) end # That's it. rendered end # Returns a View class for a given template name. def mustache_class(template, options = {}) @template_cache.fetch(:mustache, template) do compile_mustache(template, options) end end # Given a view name and settings, finds and prepares an # appropriate view class for this view. def compile_mustache(view, options = {}) options[:templates] ||= settings.views if settings.respond_to?(:views) options[:namespace] ||= self.class unless options[:namespace].to_s.include? 'Views' options[:namespace] = options[:namespace].const_get(:Views) rescue Object end factory = Class.new(Mustache) do self.view_namespace = options[:namespace] self.view_path = options[:views] end # If we were handed :"positions.atom" or some such as the # template name, we need to remember the extension. if view.to_s.include?('.') view, ext = view.to_s.split('.') end # Try to find the view class for a given view, e.g. # :view => Hurl::Views::Index. klass = factory.view_class(view) klass.view_namespace = options[:namespace] klass.view_path = options[:views] # If there is no view class, issue a warning and use the one # we just generated to cache the compiled template. if klass == Mustache warn "No view class found for #{view} in #{factory.view_path}" klass = factory # If this is a generic view class make sure we set the # template name as it was given. That is, an anonymous # subclass of Mustache won't know how to find the # "index.mustache" template unless we tell it to. klass.template_name = view.to_s elsif ext # We got an ext (like "atom"), so look for an "Atom" class # under the current View's namespace. # # So if our template was "positions.atom", try to find # Positions::Atom. if klass.const_defined?(ext_class = ext.capitalize) # Found Positions::Atom - set it klass = klass.const_get(ext_class) else # Didn't find Positions::Atom - create it by creating an # anonymous subclass of Positions and setting that to # Positions::Atom. new_class = Class.new(klass) new_class.template_name = "#{view}.#{ext}" klass.const_set(ext_class, new_class) klass = new_class end end # Set the template path and return our class. klass.template_path = options[:templates] if options[:templates] klass end end end end