fu 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in fu.gemspec
+gemspec

data/README.md

@@ -0,0 +1,53 @@
+![Puts the Fu in Mustache](http://2.bp.blogspot.com/-_i2s2gzRwgw/TZCLNfnXg4I/AAAAAAAAAEg/_fIOfF6cUxw/s1600/the-face-of-fu-manchu-original.jpg)
+
+Fu
+==
+
+Fu combines the logic–less portability of Mustache with the terse utility of Haml. This is what it looks like:
+
+    %ul
+      {{#children}}
+        %li {{name}}
+
+Then in the (Sinatra) app:
+
+    get "/list" do
+      fu :list, :locals => {:children => [{:name => "Arne"}, {:name => "Bjarne"}]}
+    end
+
+And you get:
+
+    <ul><li>Arne</li><li>Bjarne</li></ul>
+    
+A contrived example using all aspects of the syntax:
+
+    %h1 Hello, {{user_name}}
+    %p.text
+      This is a paragraph of 
+      text.    
+    %ul.friend_list(data-attribute1="some data", data-attribute2="{{some_mustache_data}}")
+      {{#friends}}
+        %li
+          {{>friend_partial}}
+      {{^friends}}
+        %p.error
+          You, unfortunately, have no friends.
+    
+Usage
+=====
+
+Direct:
+
+    Fu.to_mustache("%p Hello {{mustache}}")
+
+With Sinatra and Tilt:
+
+    require 'fu/tilt'
+
+Stick your fu-templates in your views-folder with the extension `.fu`.    
+
+Then, in your app:
+
+    get "/some_action" do
+      fu :some_template, :locals => {...}
+    end

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/fu.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "fu/version"
+
+Gem::Specification.new do |s|
+  s.name        = "fu"
+  s.version     = Fu::VERSION
+  s.authors     = ["Simen Svale Skogsrud"]
+  s.email       = ["simen@bengler.no"]
+  s.homepage    = ""
+  s.summary     = %q{Fu template engine}
+  s.description = %q{Fu combines the logic–less portability of Mustache with the terse utility of Haml.}
+
+  s.rubyforge_project = "fu"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "sinatra"
+  s.add_development_dependency "sinatra"
+  s.add_development_dependency "rack-test"
+  s.add_development_dependency "mustache"
+
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/fu.rb

@@ -0,0 +1,12 @@
+# Fu combines the logic–less portability of Mustache with the terse utility of Haml.
+
+require "fu/version"
+require "fu/error"
+require "fu/parser"
+require "fu/mustache"
+
+module Fu
+  def self.to_mustache(fu)
+    Fu::Mustache.new(Fu::Parser.new(fu).root).mustache
+  end
+end

data/lib/fu/error.rb

@@ -0,0 +1,20 @@
+module Fu
+  # An exception raised by Fu code.
+  class Error < StandardError
+    # The line of the template on which the error occurred.
+    #
+    # @return [Fixnum]
+    attr_reader :position
+
+    # @param message [String] The error message
+    # @param line [Fixnum] See \{#line}
+    def initialize(message = nil, position = nil)
+      super(message)
+      @position = position
+    end
+  end
+
+  # SyntaxError is the type of exception raised when Fu encounters an
+  # ill-formatted document.
+  class SyntaxError < Fu::Error; end
+end

data/lib/fu/mustache.rb

@@ -0,0 +1,62 @@
+# Renders Mustache templates from a Fu parse-tree
+
+require 'cgi'
+
+module Fu
+  class Mustache    
+    attr_reader :mustache
+    SELF_CLOSING_TAGS = %w(meta img link br hr input area param col base)
+    BLOCK_ACTIONS = %w(# ^)   # <- Mustache actions that take a block
+    NO_SPACE_CHARS = /[{}<>]/ # <- Characters that do not need to be separated by a space
+                              #    when joining elements (e.g. "<p>!</p>", not "<p> ! </p>")
+
+    def initialize(root)
+      @mustache = flatten(render_children(root))
+    end
+
+    private
+
+    # Flatten the tag_tree inserting spaces only where they have to be.
+    def flatten(tag_tree)
+      tag_tree.flatten.inject("") do |result, element| 
+        if result[-1] =~ NO_SPACE_CHARS || element[0] =~ NO_SPACE_CHARS
+          "#{result}#{element}"
+        else
+          "#{result} #{element}"
+        end
+      end
+    end
+
+    # Returns a tag-tree of nested arrays reflecting the structure of the
+    # document. E.g. ["<p>",["<em>", "Italicized text", "</em>"],"</p>"]
+    def render_children(node)
+      node.children.map { |child| self.send("render_#{child.type}", child) }
+    end
+
+    def render_text(node)
+      [CGI.escapeHTML(node.text), render_children(node)].compact
+    end
+
+    def render_mustache(node)
+      /^\s*(?<action>[#>^]?)\s*(?<identifier>.*)\s*$/ =~ node.statement
+      if BLOCK_ACTIONS.include?(action)
+        ["{{#{action}#{identifier}}}", render_children(node), "{{/#{identifier}}}"]
+      else
+        ["{{#{node.statement}}}", render_children(node)]
+      end
+    end
+
+    def render_element(node)
+      tag = (node.tag || 'div').downcase
+      attributes = (node.attributes||{}).dup
+      attributes[:class] = [attributes[:class], node.css_classes].flatten.compact.join(' ')
+      attributes[:id] = node.dom_id
+      attribute_string = attributes.select{|k,v| v && !v.empty?}.map{|k,v| "#{k}=\"#{v}\""}.map{|s| " #{s}"}.join
+      if SELF_CLOSING_TAGS.include?(tag) && node.children.empty?
+        ["<#{tag}#{attribute_string}/>"]
+      else
+        ["<#{tag}#{attribute_string}>", render_children(node), "</#{tag}>"]
+      end
+    end
+  end
+end

data/lib/fu/parser.rb

@@ -0,0 +1,90 @@
+# Parses Fu templates
+
+require 'strscan'
+require 'ostruct'
+
+module Fu
+  class Parser
+    attr_reader :root
+
+    def initialize(text)
+      @root = OpenStruct.new(:type => :root, :children => [])
+      scanner = StringScanner.new(text.gsub(/\t/, '  '))
+      parse_children(@root, scanner)
+    end
+
+    private
+
+    def parse_children(parent, scanner, parent_indent = -1)
+      indent = (scanner.check(/\ +/) || '').size
+      while indent > parent_indent && !scanner.eos? do
+        node = parse_line(parent, scanner)
+        parse_children(node, scanner, indent)
+        indent = (scanner.check(/\ +/) || '').size 
+      end
+    end
+
+    def parse_line(parent, scanner)
+      scanner.scan(/[^\S\n]*/) # Consume any leading spaces
+      node = OpenStruct.new(:parent => parent, :children => [])
+      parent.children << node
+      # If present, the line must open with tag or script
+      if element_statement = scanner.scan(/\%[a-zA-Z0-9\-_]+/) # e.g. '%video'
+        node.type = :element
+        node.tag = element_statement[1..-1]
+      elsif mustache_statement = scanner.scan(/\{\{[^\S\n]*[#\^][^\S\n]*[a-zA-Z0-9_]+[^\S\n]*\}\}/) # e.g. = {{#comments}}
+        node.type = :mustache
+        node.statement = mustache_statement.scan(/[#\^]\s*[a-zA-Z0-9_]+/).flatten.first
+      end
+
+      # Classes and id's may be added, e.g. #my_special_header_id.alert.featured
+      while scan = scanner.scan(/[\.\#][a-zA-Z0-9\-_]+/) do 
+        unless node.type.nil? || node.type == :element
+          raise SyntaxError.new("Can only attach id's or classes to elements", scanner.pos) 
+        end
+        node.type = :element
+        node.tag ||= 'div'
+        case scan[0]
+        when '.' then (node.css_classes ||= []) << scan[1..-1]
+        when '#' then node.dom_id = scan[1..-1]    
+        end      
+      end
+
+      # Attributes-section, e.g. (hidden=true, data-bananas="one, two, five")
+      if node.type == :element && scan = scanner.scan(/[^\S\n]*\(/) # Match opening '('
+        node.attributes ||= {}
+        begin
+          scanner.scan(/\s*/) # Ditch whitespace 
+          key = scanner.scan(/[a-zA-Z0-9\-_]+/)
+          value = nil
+          raise SyntaxError.new("Expected '='", scanner.pos) unless scanner.scan(/\s*\=\s*/)          
+          if quote = scanner.scan(/['"]/)
+            value = scanner.scan(/[^\n]*?(?<!\\)#{'\\'+quote}/).chomp(quote) # Consume anything until a matching, unescaped quote
+          else
+            value = scanner.scan(/[a-zA-Z0-9\-_]+/) # Simple values need not be quoted
+          end
+          node.attributes[key] = value
+          raise SyntaxError.new("Expected attribute value", scanner.pos) unless value
+          scanner.scan(/\s*,/) # Discard whitespace and optional commas
+        end until scanner.scan(/\s*\)/) # Match ending ')'
+      end
+
+      # Any plaintext?
+      scan = scanner.scan(/[^\n]+/)
+      unless scan.nil? || scan.strip.empty?
+        if node.type # Is this a trailing child like e.g.: %h1.title This is a trailing child
+          node.children << OpenStruct.new(
+            :parent => node, :children => [], 
+            :type => :text, :text => scan.strip
+          )  
+        else # This very node is teh text!
+          node.type = :text
+          node.text = scan.strip
+        end
+      end
+
+      scanner.scan(/\n/) # Consume end of line
+      node
+    end
+  end
+end

data/lib/fu/tilt.rb

@@ -0,0 +1,31 @@
+# Makes Fu available through Tilt, also contains a utility
+# function that will be added to Sinatra if Sinatra is 
+# defined.
+
+require 'tilt'
+require 'mustache'
+
+module Tilt
+  class FuTemplate < Template
+    self.default_mime_type = "text/html"
+    def initialize_engine
+      return if defined? ::Fu
+      require_template_library 'fu'
+    end
+
+    def prepare; end
+
+    def evaluate(scope, locals, &block)      
+      Mustache.render(Fu.to_mustache(data), locals.merge(scope.is_a?(Hash) ? scope : {}).merge({:yield => block.nil? ? '' : block.call}))
+    end
+  end
+  register FuTemplate, 'fu'
+end
+
+if defined?(Sinatra)
+  module Sinatra::Templates
+    def fu(template, options={}, locals={})
+      render :fu, template, options, locals
+    end
+  end
+end

data/lib/fu/version.rb

@@ -0,0 +1,3 @@
+module Fu
+  VERSION = "0.0.1"
+end

data/spec/fixtures/views/list.fu

@@ -0,0 +1,3 @@
+%ul
+  {{#children}}
+    %li {{name}}

data/spec/fu_spec.rb

@@ -0,0 +1,96 @@
+require 'spec_helper'
+describe Fu::Mustache do
+  it "can build a div from a single class" do
+    Fu.to_mustache(".klass").should eq '<div class="klass"></div>'
+  end
+
+  it "can add multiple classes by appending" do
+    Fu.to_mustache(".klass.odd").should eq '<div class="klass odd"></div>'
+  end
+
+  it "allows tag type to be specified on the line" do
+    Fu.to_mustache("%video").should eq "<video></video>"    
+  end
+
+  it "knows that some tags are self closing" do
+    Fu.to_mustache("%br").should eq "<br/>"
+  end
+
+  it "can specify a tag name, classes and a dom-id just by piling on statements" do
+    result = Fu.to_mustache("%tag.klass1.klass2#identifier")
+    result.should =~ /^\<tag\ /
+    result.should =~ /class\=\"klass1 klass2\"/
+    result.should =~ /id\=\"identifier\"/
+  end
+
+  it "handles inline text children" do
+    Fu.to_mustache("%h1 This is a title").should eq "<h1>This is a title</h1>"
+  end
+
+  it "allows the designer to provide arbitrary attributes" do
+    result = Fu.to_mustache <<-END
+      %tag (a=1, b=2, data-c  = 
+        "Dette er en stor verdi")
+    END
+    result.should eq '<tag a="1" b="2" data-c="Dette er en stor verdi"></tag>'
+  end
+
+  it "inserts children as sub nodes and concatenates sibling nodes" do
+    result = Fu.to_mustache <<-END
+      %section
+        %p
+          This is
+          some text
+          for this paragraph.
+            This is added too
+        But this is outside        
+    END
+    result.should eq "<section><p>This is some text for this paragraph. This is added too</p>But this is outside</section>"
+  end
+
+  it "handles complex hierarchies with attributes and cdata and multiple siblings at the root level" do
+    result = Fu.to_mustache <<-END
+      %section
+        %h1.header This is a header
+        %p(data-bananas="healthy but radioactive")
+          This is body
+          %details
+            %ul.big_list
+              %li Item 1
+              %li Item 2
+              %li Item 3
+          %details.secondary
+            %p
+              Some details
+      %section.number2
+        Other stuff 
+    END
+    result.should eq '<section><h1 class="header">This is a header</h1><p data-bananas="healthy but radioactive">This is body<details><ul class="big_list"><li>Item 1</li><li>Item 2</li><li>Item 3</li></ul></details><details class="secondary"><p>Some details</p></details></p></section><section class="number2">Other stuff</section>'
+  end
+
+  it "handles mustache sections" do
+    result = Fu.to_mustache <<-END
+      {{#children}}
+        {{name}} and {{address}}
+    END
+    result.should eq "{{#children}}{{name}} and {{address}}{{/children}}"
+  end
+
+  it "handles mustache inverted sections" do
+    result = Fu.to_mustache <<-END
+      {{^children}}
+        {{name}} and {{address}}
+    END
+    result.should eq "{{^children}}{{name}} and {{address}}{{/children}}"
+  end
+
+
+  it "handles mustache in attributes" do
+    Fu.to_mustache('%p(data-bingo="{{bingo}}")').should eq '<p data-bingo="{{bingo}}"></p>'
+  end
+
+  it "handles escaped quote characters in attribute values" do
+    Fu.to_mustache('%p(data-quoted="\\"")').should eq '<p data-quoted="\""></p>'
+  end
+
+end

data/spec/fu_tilt_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+require 'sinatra'
+require 'rack/test'
+require 'fu/tilt'
+
+class FuApp < Sinatra::Base
+  set :root, File.dirname(__FILE__)+"/fixtures"
+  get "/list" do
+    fu :list, :locals => {:children => [{:name => "Arne"}, {:name => "Bjarne"}]}
+  end
+end
+
+describe "API v1 posts" do
+  include Rack::Test::Methods
+
+  def app
+    FuApp
+  end
+
+  it "'s alive" do
+    get "/list"
+    last_response.body.should eq "<ul><li>Arne</li><li>Bjarne</li></ul>"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler.require

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification
+name: fu
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Simen Svale Skogsrud
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-12 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70166767622680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70166767622680
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: &70166767645740 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70166767645740
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: &70166767651400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70166767651400
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: &70166768253840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70166768253840
+- !ruby/object:Gem::Dependency
+  name: mustache
+  requirement: &70166771869320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70166771869320
+description: Fu combines the logic–less portability of Mustache with the terse utility
+  of Haml.
+email:
+- simen@bengler.no
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- fu.gemspec
+- lib/fu.rb
+- lib/fu/error.rb
+- lib/fu/mustache.rb
+- lib/fu/parser.rb
+- lib/fu/tilt.rb
+- lib/fu/version.rb
+- spec/fixtures/views/list.fu
+- spec/fu_spec.rb
+- spec/fu_tilt_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: fu
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Fu template engine
+test_files:
+- spec/fixtures/views/list.fu
+- spec/fu_spec.rb
+- spec/fu_tilt_spec.rb
+- spec/spec_helper.rb