rb-tmpl 0.1.0

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.swp
+*.swo

data/Gemfile

@@ -0,0 +1,10 @@
+source 'http://rubygems.org'
+
+# Specify your gem's dependencies in rb-tmpl.gemspec
+gemspec
+
+group :development do
+	gem 'rspec'
+	gem 'fakefs'
+end
+

data/Rakefile

@@ -0,0 +1,5 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+desc 'Run specs'
+RSpec::Core::RakeTask.new(:spec)

data/lib/rb-tmpl/version.rb

@@ -0,0 +1,3 @@
+module RbTmpl
+  VERSION = "0.1.0"
+end

data/lib/rb-tmpl.rb

@@ -0,0 +1,101 @@
+require 'cgi' 
+
+module RbTmpl
+	class Tmpl
+		attr_reader :template_search_paths
+		attr_reader :template_extensions
+
+		def initialize
+			@template_search_paths = []
+			@template_extensions = []
+
+			@templates = {}
+			@compiled_templates = {}
+		end
+
+		def add(name, template)
+			name = name.to_s
+			@templates[name] = template
+			@compiled_templates.delete(name)
+		end
+
+		def call(name, data = nil)
+			name = name.to_s
+			code = compiled(name)
+			return '' if code.nil?
+			data = HashWrapper.new(data) if data.kind_of?(Hash)
+			bind = data.instance_eval{ binding } unless data.nil?
+			eval(code, bind)
+		end
+
+	protected
+		class HashWrapper
+			def initialize(hash)
+				@hash = hash
+			end
+
+			def method_missing(method, *arguments, &block)
+				@hash[method] || @hash[method.to_s]
+			end
+
+			def respond_to(method, include_private)
+				super || @hash.key?(method) || @hash.key?(method.to_s)
+			end
+		end
+
+		def find_file(name)
+			@template_search_paths.map do |path|
+				file = File.join(path, name)
+				ext_files = @template_extensions.map do |ext|
+					File.join(path, name + '.' + ext)
+				end
+				[file] + ext_files
+			end.
+				flatten.
+				find{ |file| File.exist?(file) }
+		end
+
+		def find_by_file(name)
+			file = find_file(name)
+			file.nil? ? nil : File.read(file)
+		end
+
+		def find(name)
+			return @templates[name] ||= find_by_file(name)
+		end	
+
+		def compiled(name)
+			@compiled_templates[name] ||= compile(find(name))
+		end
+
+		def compile(template)
+			template = template.
+				gsub(/\\/, '\\\\').
+				gsub(/'/, '\\\\\'').
+				gsub(/\$\{([^\}]*)\}/, '{{= \1}}')
+			code = "__='"
+			code << template.gsub(/\{\{[^\}]*\}\}/) do |full_tag|
+				tag_contents = full_tag[2...-2].strip
+				_, closing_slash, tag, args = tag_contents.match(/^(\/?)([^\s]+)(.*)/).to_a
+				if args
+					args = args.
+						strip.
+						gsub('$index', '__i').
+						gsub('$value', '__val')
+				end
+				is_closing = closing_slash == '/'
+				tag_code = case
+					when is_closing    then 'end'
+					when tag == '='    then "__<<CGI.escapeHTML((#{args}).to_s)"
+					when tag == 'html' then "__<<(#{args}).to_s"
+					when tag == 'if'   then 'if ' + args 
+					when tag == 'else' then 'else'
+					when tag == 'each' then '(' + args + ').each_with_index do|__val,__i|'
+				end
+				"';#{tag_code};__<<'"
+			end
+			code << "';__"
+			code
+		end
+	end
+end

data/rb-tmpl.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "rb-tmpl/version"
+
+Gem::Specification.new do |s|
+  s.name        = "rb-tmpl"
+  s.version     = RbTmpl::VERSION
+  s.authors     = ["Sijmen J. Mulder"]
+  s.email       = ["sjmulder@gmail.com"]
+  s.homepage    = "https://github.com/sjmulder/rb-tmpl"
+  s.summary     = %q{A Ruby implementation of jquery-tmpl}
+  s.description = %q{With rb-tmpl you can re-use jquery-tmpl templates on the server, saving you from having to do the same work twice.}
+
+  s.rubyforge_project = "rb-tmpl"
+
+  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"]
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'fakefs'
+require 'lib/rb-tmpl.rb'
+
+include RbTmpl

data/spec/tmpl_spec.rb

@@ -0,0 +1,183 @@
+require 'spec/spec_helper.rb'
+
+describe Tmpl do
+	it 'loads templates from the add method' do
+		tmpl = Tmpl.new
+		tmpl.add(:test, 'Foo')
+		tmpl.call(:test) == 'Foo'
+	end
+
+	it 'accepts strings and symbols' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, 'Foo')
+		tmpl.add('bar', 'Bar')
+		tmpl.call(:foo).should == 'Foo'
+		tmpl.call(:bar).should == 'Bar'
+		tmpl.call('foo').should  == 'Foo'
+		tmpl.call('bar').should  == 'Bar'
+	end
+
+	it 'escapes single quotes' do
+		tmpl = Tmpl.new
+		tmpl.add(:test, '\'Hello!\'')
+		tmpl.call(:test).should == '\'Hello!\''
+	end
+
+	it 'escapes escape sequences' do
+		tmpl = Tmpl.new
+		tmpl.add(:test, 'Dear mum,\n')
+		tmpl.call(:test).should == 'Dear mum,\n'
+	end
+
+	it 'loads templates from disk' do
+		tmpl = Tmpl.new
+		tmpl.template_search_paths << 'templates'
+		tmpl.template_search_paths << 'templates/sub/'
+		FileUtils.mkdir('templates')
+		FileUtils.mkdir('templates/sub')
+		File.open('templates/foo', 'w'){ |f| f.write('Foo') }
+		File.open('templates/sub/bar', 'w'){ |f| f.write('Bar') }
+		tmpl.call(:foo).should == 'Foo'
+		tmpl.call(:bar).should == 'Bar'
+	end
+
+	it 'supports extensions for template files' do
+		tmpl = Tmpl.new
+		tmpl.template_search_paths << '.'
+		tmpl.template_extensions << 'tmpl'
+		File.open('foo.tmpl', 'w'){ |f| f.write('Foo') }
+		tmpl.call(:foo).should == 'Foo'
+	end
+
+	it 'gives added templates precedence over disk templates' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, 'Memory')
+		tmpl.template_search_paths << '.'
+		File.open('foo', 'w'){ |f| f.write('Disk') }
+		tmpl.call(:foo).should == 'Memory'
+	end
+	
+	it 'gives files without extensions precence over those with' do
+		tmpl = Tmpl.new
+		tmpl.template_search_paths << '.'
+		tmpl.template_extensions << 'tmpl'
+		File.open('foo', 'w'){ |f| f.write('Without') }
+		File.open('foo.tmpl', 'w'){ |f| f.write('With') }
+		tmpl.call(:foo).should == 'Without'
+	end
+
+	it 'searches template paths and extensions in order' do
+		tmpl = Tmpl.new
+		tmpl.template_search_paths << 'dir1' << 'dir2'
+		tmpl.template_extensions << 'ext1' << 'ext2'
+		FileUtils.mkdir('dir1')
+		FileUtils.mkdir('dir2')
+		File.open('dir1/foo.ext1', 'w'){ |f| f.write('1') }
+		File.open('dir1/foo.ext2', 'w'){ |f| f.write('2') }
+		File.open('dir2/foo', 'w'){ |f| f.write('3') }
+		File.open('dir2/foo.ext1', 'w'){ |f| f.write('4') }
+		tmpl.call(:foo).should == '1'
+	end
+
+	it 'supports {{=}} with data from an object' do
+		class BarData
+			def bar; 'Bar'; end
+		end
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '{{= bar}}')
+		tmpl.call(:foo, BarData.new).should == 'Bar'
+	end
+
+	it 'supports {{=}} with data from a hash' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '{{= bar}}')
+		tmpl.call(:foo, { :bar => 'Bar' }).should == 'Bar'
+	end
+
+	it 'escapes HTML in {{=}}' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '{{= evil}}')
+		tmpl.call(:foo, { :evil => '<script>' }).should == '&lt;script&gt;'
+	end
+
+	it 'supports ${} shorthand' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '${bar}')
+		tmpl.call(:foo, { :bar => 'Bar' }).should == 'Bar'
+	end
+
+	it 'supports {{html}}' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '{{html code}}')
+		tmpl.call(:foo, { :code => '<script>' }).should == '<script>'
+	end
+
+	it 'supports {{if}}' do
+		template =
+			'{{if t}}t{{/if}}' +
+			'{{if f}}f{{/if}}'
+		tmpl = Tmpl.new
+		tmpl.add(:foo, template)
+		tmpl.call(:foo, { :t => true, :f => false }).should == 't'
+	end
+
+	it 'supports {{else}}' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '{{if f}}t{{else}}f{{/if}}')
+		tmpl.call(:foo, { :f => false }).should == 'f'
+	end
+
+	it 'supports {{each}}' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '{{each list}}${$index}${$value}{{/each}}')
+		data = { :list => [ 'a', 'b' ] }
+		tmpl.call(:foo, data).should == '0a1b'
+	end
+
+	it 'supports {{each(i,x)}}' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '{{each(i,x) list}}${i}${x}{{/each}}')
+		data = { :list => [ 'a', 'b' ] }
+		tmpl.call(:foo, data).should == '0a1b'
+	end
+
+	it 'supports {{tmpl}}' do
+		tmpl = Tmp.new
+		tmpl.add(:foo, '{{tmpl bar}}')
+		tmpl.add(:bar, '?{x}')
+		tmpl.call(:foo, {:x => 'Yay'}).should == 'Yay'
+	end
+
+	it 'supports {{tmpl(data)}}' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '${var},{{tmpl(sub) bar}}')
+		tmpl.add(:bar, '${var}')
+		data = {:var => 'outer', :sub => {:var => 'inner'}}
+		tmpl.call(:foo, data).should == 'outer,inner'
+	end
+
+	it 'supports basic expressions' do
+		tmpl = Tmpl.new
+		tmpl.add(:eq_t, '{{if 1 == 1}}y{{/if}}')
+		tmpl.add(:eq_f, '{{if 1 == 2}}n{{/if}}')
+		tmpl.add(:lt_f, '{{if 1 < 1}}n{{/if}}')
+		tmpl.add(:lt_t, '{{if 1 < 2}}y{{/if}}')
+		tmpl.add(:eq_var_t, '{{if var == 1}}y{{/if}}')
+		tmpl.add(:eq_var_f, '{{if var == 2}}n{{/if}}')
+		tmpl.call(:eq_t).should == 'y'
+		tmpl.call(:eq_f).should == ''
+		tmpl.call(:lt_f).should == ''
+		tmpl.call(:lt_t).should == 'y'
+		tmpl.call(:eq_var_t, {:var => 1}).should == 'y'
+		tmpl.call(:eq_var_f, {:var => 1}).should == 'n'
+	end
+
+	it 'supports method calls' do
+		tmpl = Tmpl.new
+		tmpl.add(:foo, '?{list.length}')
+		tmpl.call(:foo, {:list => [1, 2]}).call == '2'
+	end
+
+	it 'substitutes common JavaScript expressions'
+	it 'substitutes common JavaScript methods'
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: rb-tmpl
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Sijmen J. Mulder
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-26 00:00:00 Z
+dependencies: []
+
+description: With rb-tmpl you can re-use jquery-tmpl templates on the server, saving you from having to do the same work twice.
+email: 
+- sjmulder@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Rakefile
+- lib/rb-tmpl.rb
+- lib/rb-tmpl/version.rb
+- rb-tmpl.gemspec
+- spec/spec_helper.rb
+- spec/tmpl_spec.rb
+homepage: https://github.com/sjmulder/rb-tmpl
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: rb-tmpl
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: A Ruby implementation of jquery-tmpl
+test_files: 
+- spec/spec_helper.rb
+- spec/tmpl_spec.rb