trenni 1.0.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+rvm:
+  - "1.8.7"
+  - "1.9.2"
+  - "1.9.3"
+  - jruby-18mode # JRuby in 1.8 mode
+  - jruby-19mode # JRuby in 1.9 mode
+  - rbx-18mode
+  - rbx-19mode

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in trenni.gemspec
+gemspec
+
+group :test do
+	gem "rake"
+end

data/README.md

@@ -0,0 +1,70 @@
+# Trenni
+
+[![Build Status](https://secure.travis-ci.org/ioquatix/relaxo.png)](http://travis-ci.org/ioquatix/relaxo)
+
+Trenni is a templating system that evaluates textual strings containing Ruby
+code. It compiles templates into native Ruby code including string 
+interpolations which means that you generally get the best possible speed.
+
+In addition, Trenni includes an SGML/XML builder to assist with the generation
+of valid nicely formatted markup.
+
+* Released under the MIT license.
+* Copyright (c) 2012 [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams/).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'trenni'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install trenni
+
+## Usage
+
+Trenni templates work essentially the same way as all other templating systems:
+
+	template = Trenni::Template.new('<?r items.each do |item| ?>#{item}<?r end ?>')
+	
+	items = 1..4
+	
+	assert_equal "1234", template.result(binding)
+
+The code above demonstraights the only two constructs, `<?r expression ?>` and `#{output}`.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+Copyright (c) 2012 Samuel G. D. Williams.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+	t.libs << 'test'
+end
+
+desc "Run tests"
+task :default => :test

data/lib/trenni.rb

@@ -0,0 +1,22 @@
+# Copyright (c) 2012 Samuel G. D. Williams. <http://www.oriontransfer.co.nz>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'trenni/builder'
+require 'trenni/template'

data/lib/trenni/builder.rb

@@ -0,0 +1,125 @@
+# Copyright (c) 2011 Samuel G. D. Williams. <http://www.oriontransfer.co.nz>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Trenni
+	
+	INSTRUCT_ATTRIBUTES = [
+		['version', '1.0'],
+		['encoding', 'UTF-8']
+	].freeze
+	
+	class Builder
+		def initialize(options = {})
+			@output = options[:output] || StringIO.new
+			
+			@options = options
+			
+			@level = [0]
+			@children = [0]
+		end
+		
+		def indent?
+			@options[:indent] != nil
+		end
+		
+		def indent
+			if indent?
+				@options[:indent] * (@level.size - 1)
+			else
+				''
+			end
+		end
+		
+		def instruct(attributes = nil)
+			attributes ||= INSTRUCT_ATTRIBUTES
+			
+			@output.puts "<?xml#{attributes_xml(attributes)}?>"
+		end
+		
+		def doctype(attributes = 'html')
+			if Array === attributes
+				text = ''
+				attributes.each do |value|
+					if value.match(/[\s"]/)
+						value = '"' + value.gsub('"', '&quot;') + '"'
+					end
+					
+					text += ' ' + value
+				end
+			else
+				text = ' ' + attributes
+			end
+			
+			@output.puts "<!DOCTYPE#{text}>"
+		end
+		
+		def tag(name, attributes = {}, &block)
+			if block_given?
+				@output.puts if indent? and @level.last > 0
+				@output.write indent + "<#{name}#{attributes_xml(attributes)}>"
+				@output.puts if indent?
+				
+				@level[@level.size-1] += 1
+				
+				@level << 0
+				yield self
+				@level.pop
+				
+				@output.puts if indent?
+				@output.write indent + "</#{name}>"
+			else
+				@output.write indent + "<#{name}#{attributes_xml(attributes)}/>"
+			end
+		end
+		
+		def text(data)
+			if indent?
+				data.split(/\n/).each_with_index do |line, i|
+					@output.puts if i > 0
+					@output.write indent + line
+				end
+			else
+				@output.write data
+			end
+		end
+		
+		def options(options)
+			saved_options = @options
+			@options = options
+			
+			yield
+			
+			@options = saved_options
+		end
+		
+		protected
+		
+		def attributes_xml(attributes)
+			buffer = ''
+			
+			attributes.each do |key, value|
+				buffer += " #{key}=\"#{value.gsub('"', '&quot;')}\""
+			end
+			
+			return buffer
+		end
+	end
+	
+end

data/lib/trenni/template.rb

@@ -0,0 +1,169 @@
+# Copyright (c) 2011 Samuel G. D. Williams. <http://www.oriontransfer.co.nz>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'strscan'
+
+module Trenni
+	# The output variable that will be used in templates:
+	OUT = '_out'
+	
+	class Template
+		# Returns the output produced by calling the given block.
+		def self.capture(*args, &block)
+			out = eval(OUT, block.binding)
+			top = out.size
+			
+			block.call *args
+			
+			return out.pop(out.size - top).join
+		end
+		
+		# Returns the buffer used for capturing output.
+		def self.buffer(binding)
+			eval(OUT, binding)
+		end
+		
+		class Buffer
+			def initialize
+				@parts = []
+			end
+
+			attr :parts
+
+			def text(text)
+				text = text.gsub('\\', '\\\\\\').gsub('@', '\\@')
+
+				@parts << "#{OUT} << %q@#{text}@ ; "
+			end
+
+			def expression(text)
+				@parts << "#{text} ; "
+			end
+
+			def output(text)
+				@parts << "#{OUT} << (#{text}) ; "
+			end
+
+			def code
+				parts = ["#{OUT} = [] ; "] + @parts + ["#{OUT}.join"]
+
+				code = parts.join
+			end
+		end
+
+		class Scanner < StringScanner
+			TEXT = /([^<#]|<(?!\?r)|#(?!\{)){1,1024}/m
+			
+			def initialize(callback, string)
+				@callback = callback
+				super(string)
+			end
+
+			def parse
+				until eos?
+					pos = self.pos
+
+					scan_text
+					scan_expression
+
+					if pos == self.pos
+						raise StandardError.new "Could not scan current input #{self.pos} #{eos?}!"
+					end
+				end
+			end
+
+			def scan_text
+				if scan(TEXT)
+					@callback.text(matched)
+				end
+			end
+
+			def scan_expression
+				if scan(/\#\{/)
+					level = 1
+					code = ""
+
+					until eos? || level == 0
+						if scan(/[^"'\{\}]+/m)
+							code << matched
+						end
+
+						if scan(/"(\\"|[^"])*"/m)
+							code << matched
+						end
+
+						if scan(/'(\\'|[^'])*'/m)
+							code << matched
+						end
+
+						if scan(/\{/)
+							code << matched
+							level += 1
+						end
+
+						if scan(/\}/)
+							code << matched if level > 1
+							level -= 1
+						end
+					end
+
+					if level == 0
+						@callback.output(code)
+					else
+						raise StandardError.new "Could not find end of expression #{self}!"
+					end
+				elsif scan(/<\?r/)
+					if scan_until(/(.*?)\?>/m)
+						@callback.expression(self[1])
+					else
+						raise StandardError.new "Could not find end of expression #{self}!"
+					end
+				end
+			end
+		end
+
+		def self.load(path)
+			return self.new(File.read(path), path)
+		end
+
+		def initialize(template, filename = '<Trenni>')
+			@template = template
+			@filename = filename
+			compile!
+		end
+
+		def evaluate(binding)
+			eval(@code, binding, @filename)
+		end
+		
+		alias result evaluate
+		
+		protected
+		
+		def compile!(filename = @filename)
+			buffer = Buffer.new
+			scanner = Scanner.new(buffer, @template)
+			
+			scanner.parse
+			
+			@code = buffer.code
+		end
+	end
+end

data/lib/trenni/version.rb

@@ -0,0 +1,23 @@
+# Copyright 2012 Samuel G. D. Williams. <http://www.oriontransfer.co.nz>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Trenni
+	VERSION = "1.0.0"
+end

data/test/test_builder.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/env ruby
+
+# Copyright (c) 2007, 2012 Samuel G. D. Williams. <http://www.oriontransfer.co.nz>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'pathname'
+require 'test/unit'
+require 'stringio'
+
+require 'trenni'
+
+class BuilderTest < Test::Unit::TestCase
+	def test_tags
+		output = StringIO.new
+		
+		builder = Trenni::Builder.new(:output => output)
+
+		builder.instruct
+		builder.tag('foo', 'bar' => 'baz') do
+			builder.text("apples and oranges")
+		end
+		
+		assert_equal output.string, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<foo bar=\"baz\">apples and oranges</foo>"
+	end
+	
+	def test_html
+		output = $stdout
+		
+		builder = Trenni::Builder.new(:output => output, :indent => "\t")
+		builder.options(:indent => "\t") do
+			builder.doctype
+			builder.tag('html') do
+				builder.tag('head') do
+					builder.tag('title') do
+						builder.text('Hello World')
+					end
+				end
+				builder.tag('body') do
+				end
+			end
+		end
+	end
+end

data/test/test_template.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby
+
+# Copyright (c) 2007, 2012 Samuel G. D. Williams. <http://www.oriontransfer.co.nz>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'pathname'
+require 'test/unit'
+require 'stringio'
+
+require 'trenni'
+
+class TemplateTest < Test::Unit::TestCase
+	def test_template_each
+		template = Trenni::Template.new('<?r items.each do |item| ?>#{item}<?r end ?>')
+		
+		items = 1..4
+		assert_equal "1234", template.result(binding)
+	end
+end

data/trenni.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'trenni/version'
+
+Gem::Specification.new do |gem|
+	gem.name          = "trenni"
+	gem.version       = Trenni::VERSION
+	gem.authors       = ["Samuel Williams"]
+	gem.email         = ["samuel.williams@oriontransfer.co.nz"]
+	gem.description   = <<-EOF
+	Trenni is a templating system that evaluates textual strings containing Ruby
+	code. It compiles templates into native Ruby code including string 
+	interpolations which means that you generally get the best possible speed.
+	
+	In addition, Trenni includes an SGML/XML builder to assist with the generation
+	of valid nicely formatted markup.
+	EOF
+	gem.summary       = %q{A fast native templating system that compiles directly to Ruby code.}
+	gem.homepage      = "https://github.com/ioquatix/trenni"
+
+	gem.files         = `git ls-files`.split($/)
+	gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+	gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+	gem.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: trenni
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Samuel Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-25 00:00:00.000000000 Z
+dependencies: []
+description: ! "\tTrenni is a templating system that evaluates textual strings containing
+  Ruby\n\tcode. It compiles templates into native Ruby code including string \n\tinterpolations
+  which means that you generally get the best possible speed.\n\t\n\tIn addition,
+  Trenni includes an SGML/XML builder to assist with the generation\n\tof valid nicely
+  formatted markup.\n"
+email:
+- samuel.williams@oriontransfer.co.nz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- lib/trenni.rb
+- lib/trenni/builder.rb
+- lib/trenni/template.rb
+- lib/trenni/version.rb
+- test/test_builder.rb
+- test/test_template.rb
+- trenni.gemspec
+homepage: https://github.com/ioquatix/trenni
+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'
+      segments:
+      - 0
+      hash: 4320630080508960898
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4320630080508960898
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A fast native templating system that compiles directly to Ruby code.
+test_files:
+- test/test_builder.rb
+- test/test_template.rb