ice 0.1.0

data/.gitignore

@@ -0,0 +1,23 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+.idea
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Nate Kidwell
+
+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/README.markdown

@@ -0,0 +1,84 @@
+# ice
+
+This project allows user-submitted templates to be written in the javascript programming language.  It is similar to Liquid in terms of safety, but uses javascript to leverage the powers of a language most developers are familiar with.
+
+It runs the templates through an erb-ish parser and then uses the [TheRubyRacer Gem](http://github.com/cowboyd/therubyracer) to interpet the javascript using Google's V8 javascript engine.  Your users can then write ice templates like:
+
+    <table>
+        <tr><th>Name</th><th>Email</th></tr>
+        <% for (i = 0; i < users.length; i++) { %>
+            <tr>
+                <td><%= user.name %></td><td><%= mail_to(user.email) %></td>
+            </tr>
+        <% } %>
+    </table>
+
+## Why another templating engine when there is Liquid
+
+Liquid is excellent but has several disadvantages
+
+* Hard to extend without knowing liquid internals
+* Introduces yet-another-language, whereas many designers are already familiar with javascript
+* Doesn't allow template editors to use a rich object model and create their own functions
+* Doesn't have a rich set of support libraries like javascript brings to the table.
+
+Note that we're still big fans of liquid.  In fact, we call this project "ice" as a tribute (keeping the metaphor alive, we use "Cubes" where they have "Drops").
+
+Laminate uses the Lua language, which is a slight improvement, but still is unfamiliar to most developers.
+
+
+## to_ice
+
+Every object is revealed to the templates via their to_ice method.  This helps filter the objects that are passed into the javascript, so people editing the page only have access to a sanitized version of your data.
+
+Instances of some classes like String and Numeric just return themselves as the result of to_ice.  Hashes and Arrays run to_ice recursively on their members.
+
+## ActiveRecord modifications
+
+To make life easy, since most complex objects passed to the templates will be subclasses of ActiveRecord::Base, the default to_ice behaviour of ActiveRecord is to pass itself in to a class with the same name, but followed by the word "Cube".
+
+Therefore calling to_ice on instance of a User class will invoke
+
+    UserCube.new self
+
+## BaseCube Class
+
+In order for everything to work easily, you can have your cubes inherit from our Ice::BaseCube class.  Your cubes inheriting from it can then determine what additional attributes they want to reveal.  For example
+
+    class BookCube < Ice::BaseCube
+      revealing :title, :author_id, :genre_id
+    end
+
+would provide a cube with access to the title, author_id and genre properties of the underlying ActiveRecord.
+
+These cubes also have belongs_to and has_many associations, so you can write things like:
+
+    class ArticleCube < Ice::BaseCube
+      has_many :comments, :tags
+      belongs_to :author, :section
+    end
+
+This brings in association helper functions such as comment_ids, num_comments, has_comments, comments, author_id, and author.
+
+Note that all revealed functions and associations are also sanitized via to_ice.
+
+## Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add spec for it. This is important so I don't break it in a future version unintentionally.  In fact, try to write your specs in a test-first manner.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request.
+
+## Todo
+
+* Allow .ice view files
+* Add in form builders from clots project
+* Break form builders and helpers out into separate javascript project that can be included in other frameworks like CakePHP
+* Allow mappings for other ORMs than ActiveRecord
+* Haml support
+
+## Copyright
+
+Copyright (c) 2010 Nate Kidwell. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "ice"
+    gem.summary = "User templates written in javascript"
+    gem.description = "User templates written in javascript"
+    gem.email = "nate@ludicast.com"
+    gem.homepage = "http://github.com/ludicast/ice"
+    gem.authors = ["Nate Kidwell"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_dependency "therubyracer", "0.7.0"
+    gem.add_dependency "active_support"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "ice #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/ice_js/History.md

@@ -0,0 +1,5 @@
+
+0.0.1 / YYYY-MM-DD
+------------------
+
+* Initial release

data/ice_js/Readme.md

@@ -0,0 +1,29 @@
+
+# YourLib
+
+Description
+
+## License 
+
+(The MIT License)
+
+Copyright (c) 2009 Your Name <Your Email>
+
+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/ice_js/lib/path_helper.js

@@ -0,0 +1,17 @@
+function view_path(item) {
+  return "/" + item.class_path + "/" + item.id
+}
+
+function edit_path(item) {
+  return "/" + item.class_path + "/" + item.id + "/edit"
+}
+
+function view_link(item, opts) {
+  label = (opts && opts.label) || "View"
+  return "<a href=\"" + view_path(item) + "\">" + label + "</a>"
+}
+
+function edit_link(item, opts) {
+  label = (opts && opts.label) || "Edit"
+  return "<a href=\"" + edit_path(item) + "\">" + label + "</a>"
+}

data/ice_js/spec/commands/example_command.rb

@@ -0,0 +1,19 @@
+
+# uncomment and call with `$ jspec example `
+
+# command :example do |c|
+#   c.syntax = 'jspec example [options]'
+#   c.description = 'Just an example command'
+#   c.option '-f', '--foo string', 'Does some foo with <string>'
+#   c.option '-b', '--bar [string]', 'Does some bar with [string]'
+#   c.example 'Do some foo', 'jspec example --foo bar'
+#   c.example 'Do some bar', 'jspec example --bar'
+#   c.when_called do |args, options|
+#     p args
+#     p options.__hash__
+#     # options.foo
+#     # options.bar
+#     # options.__hash__[:foo]
+#     # options.__hash__[:bar]
+#   end 
+# end

data/ice_js/spec/dom.html

@@ -0,0 +1,22 @@
+<html>
+	<head>
+		<link type="text/css" rel="stylesheet" href="/Users/natekidwell/.rvm/gems/ruby-1.9.1-p378/gems/jspec-4.3.1/lib/jspec.css" />
+		<script src="/Users/natekidwell/.rvm/gems/ruby-1.9.1-p378/gems/jspec-4.3.1/lib/jspec.js"></script>
+		<script src="/Users/natekidwell/.rvm/gems/ruby-1.9.1-p378/gems/jspec-4.3.1/lib/jspec.xhr.js"></script>
+		<script src="../lib/path_helper.js"></script>
+		<script src="unit/spec.helper.js"></script>
+		<script>
+			function runSuites() {
+				JSpec
+				.exec('unit/spec.js')
+				.run({ fixturePath: 'fixtures' })
+				.report()
+			}
+		</script>
+	</head>
+	<body class="jspec" onLoad="runSuites();">
+		<div id="jspec-top"><h2 id="jspec-title">JSpec <em><script>document.write(JSpec.version)</script></em></h2></div>
+		<div id="jspec"></div>
+		<div id="jspec-bottom"></div>
+	</body>
+</html>

data/ice_js/spec/node.js

@@ -0,0 +1,10 @@
+
+require.paths.unshift('spec', '/Users/natekidwell/.rvm/gems/ruby-1.9.1-p378/gems/jspec-4.3.1/lib', 'lib')
+require('jspec')
+require('unit/spec.helper')
+require('yourlib')
+
+JSpec
+  .exec('spec/unit/spec.js')
+  .run({ reporter: JSpec.reporters.Terminal, fixturePath: 'spec/fixtures', failuresOnly: true })
+  .report()

data/ice_js/spec/rhino.js

@@ -0,0 +1,10 @@
+
+load('/Users/natekidwell/.rvm/gems/ruby-1.9.1-p378/gems/jspec-4.3.1/lib/jspec.js')
+load('/Users/natekidwell/.rvm/gems/ruby-1.9.1-p378/gems/jspec-4.3.1/lib/jspec.xhr.js')
+load('lib/yourlib.js')
+load('spec/unit/spec.helper.js')
+
+JSpec
+.exec('spec/unit/spec.js')
+.run({ reporter: JSpec.reporters.Terminal, fixturePath: 'spec/fixtures' })
+.report()

data/ice_js/spec/server.html

@@ -0,0 +1,18 @@
+<html>
+	<head>
+		<script src="/jspec/jspec.js"></script>
+		<script src="/jspec/jspec.xhr.js"></script>
+		<script src="/lib/yourlib.js"></script>
+		<script src="/spec/unit/spec.helper.js"></script>
+		<script>
+			function runSuites() {
+				JSpec
+				.exec('unit/spec.js')
+				.run({ reporter: JSpec.reporters.Server, verbose: true, failuresOnly: true, fixturePath: '/spec/fixtures' })
+				.report()
+			}
+		</script>
+	</head>
+	<body class="jspec" onLoad="runSuites();">
+	</body>
+</html>

data/ice_js/spec/server.rb

@@ -0,0 +1,4 @@
+
+get '/lib/*' do |path|
+  send_file File.dirname(__FILE__) + '/../lib/' + path
+end

data/ice_js/spec/unit/spec.js

@@ -0,0 +1,40 @@
+
+describe 'path_helper'
+  before_each
+    user = {id:1, class_path:'users'}
+  end
+
+  describe 'for paths'
+    it "should generate view path from item"
+      view_path(user).should.eql "/users/1"
+    end
+
+    it "should generate edit path from item"
+      edit_path(user).should.eql "/users/1/edit"
+    end
+  end
+
+
+  describe "for links"
+    describe "without parameters"
+      it "should generate view link from item"
+        view_link(user).should.eql "<a href=\"/users/1\">View</a>"
+      end
+      it "should generate edit link from item"
+        edit_link(user).should.eql "<a href=\"/users/1/edit\">Edit</a>"
+      end
+    end
+
+    describe "with parameters"
+      it "should generate view link from item"
+        view_link(user, {label:"See Info"}).should.eql "<a href=\"/users/1\">See Info</a>"
+      end
+      it "should generate edit link from item"
+        edit_link(user, {label:"Change Info"}).should.eql "<a href=\"/users/1/edit\">Change Info</a>"
+      end
+    end
+
+  end
+
+
+end

data/init.rb

@@ -0,0 +1 @@
+ActiveRecord::Base.send(:include, Ice::Cubeable)

data/lib/ice.rb

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'v8'
+
+class Object
+  def to_ice
+    nil
+  end
+end
+
+[FalseClass, TrueClass, Numeric, String].each do |class_name|
+  eval "class #{class_name}
+    def to_ice
+      self
+    end
+  end"
+end
+
+class Array
+  def to_ice
+    map &:to_ice
+  end
+end
+
+class Hash
+  def to_ice
+    res = {}
+    each_pair do |key,value|
+      res[key] = value.to_ice
+    end
+    res
+  end
+end
+
+
+
+module Ice
+  def self.convert_template(template_text, vars = {})
+
+    V8::Context.new do |cxt|
+      cxt.load "#{File.dirname(__FILE__)}/parser.js"
+
+      vars.each_pair do |key, value|
+        cxt[key] = value.to_ice
+      end
+
+      cxt['____templateText'] = template_text
+
+      @evaled = cxt.eval "Jst.evaluate(Jst.compile(____templateText), {});"
+
+    end
+    @evaled
+  end
+end
+

data/lib/ice/base_cube.rb

@@ -0,0 +1,22 @@
+class BaseCube
+
+  def self.revealing(* attributes)
+    attributes.each do |attr|
+
+      define_method attr.to_sym do
+        @source.send(attr).to_ice
+      end
+    end
+  end
+
+  attr_reader :source
+
+  def to_ice
+    self
+  end
+
+  def initialize(source)
+    @source = source
+  end
+
+end

data/lib/ice/cube_association.rb

@@ -0,0 +1,38 @@
+module Ice
+  module CubeAssociation
+    def belongs_to(*args)
+      args.each do |sym|
+        belongs_to = %{
+        def #{sym}
+          @source.#{sym}.to_ice
+        end
+        def #{sym}_id
+          @source.#{sym}_id
+        end
+        }
+        class_eval belongs_to
+      end
+    end
+
+    def has_many(*args)
+      args.each do |sym|
+        has_many = %{
+        def #{sym}
+          @source.#{sym}.map(&:to_ice)
+        end
+        def has_#{sym}
+          ! @source.#{sym}.empty?
+        end
+        def num_#{sym}
+          @source.#{sym}.count
+        end
+        def #{sym.to_s.singularize}_ids
+           @source.#{sym.to_s.singularize}_ids
+        end
+        }
+        class_eval has_many
+      end
+
+    end
+  end
+end

data/lib/ice/cubeable.rb

@@ -0,0 +1,17 @@
+module Ice
+    module Cubeable
+      def get_cube_class(class_obj)
+        begin
+          cube_string = class_obj.to_s + "Cube"
+          cube_string.constantize
+        rescue
+          get_cube_class class_obj.superclass
+        end
+      end
+
+      def to_ice
+        cube_class = get_cube_class self.class
+        cube_class.new self
+      end
+    end
+end

data/lib/parser.js

@@ -0,0 +1,339 @@
+/*
+Copyright 2008, mark turansky (www.markturansky.com)
+Copyright 2010, Andrew Kelley (superjoesoftware.com)
+
+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 shall be used for Good, not Evil.
+
+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.
+
+(This is the license from www.json.org and I think it's awesome)
+*/
+
+String.prototype.endsWith = function endsWith(c) {
+    if (this.charAt(this.length - 1) == c) {
+        return true;
+    } else {
+        return false;
+    }
+};
+
+String.prototype.startsWith = function startsWith(c) {
+    if (this.charAt(0) == c) {
+        return true;
+    } else {
+        return false;
+    }
+};
+
+String.prototype.replaceAll = function replaceAll(a, b) {
+    var s = this;
+    while (s.indexOf(a) > -1) {
+        s = s.replace(a, b);
+    }
+    return s;
+};
+
+var Jst = function () {
+    // private variables:
+    var that; // reference to the public object
+
+    // all write and writeln functions eval'd by Jst
+    // concatenate to this internal variable
+    var html = "";
+
+    // private functions
+    function CharacterStack(str) {
+        var i;
+
+        this.characters = [];
+        this.peek = function peek() {
+            return this.characters[this.characters.length - 1];
+        };
+        this.pop = function pop() {
+            return this.characters.pop();
+        };
+        this.push = function push(c) {
+            this.characters.push(c);
+        };
+        this.hasMore = function hasMore() {
+            if (this.characters.length > 0) {
+                return true;
+            } else {
+                return false;
+            }
+        };
+
+        for (i = str.length; i >= 0; i -= 1) {
+            this.characters.push(str.charAt(i));
+        }
+    }
+
+    function StringWriter() {
+        this.str = "";
+        this.write = function write(s) {
+            this.str += s;
+        };
+        this.toString = function toString() {
+            return this.str;
+        };
+    }
+
+    function parseScriptlet(stack) {
+        var fragment = new StringWriter();
+        var c; // character
+
+        while (stack.hasMore()) {
+            if (stack.peek() == '%') { //possible end delimiter
+                c = stack.pop();
+                if (stack.peek() == '>') { //end delimiter
+                    // pop > so that it is not available to main parse loop
+                    stack.pop();
+                    if (stack.peek() == '\n') {
+                        fragment.write(stack.pop());
+                    }
+                    break;
+                } else {
+                    fragment.write(c);
+                }
+            } else {
+                fragment.write(stack.pop());
+            }
+        }
+        return fragment.toString();
+    }
+
+    function isOpeningDelimiter(c) {
+        if (c == "<" || c == "%lt;") {
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    function isClosingDelimiter(c) {
+        if (c == ">" || c == "%gt;") {
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    function appendExpressionFragment(writer, fragment, jstWriter) {
+        var i,j;
+        var c;
+
+        // check to be sure quotes are on both ends of a string literal
+        if (fragment.startsWith("\"") && !fragment.endsWith("\"")) {
+            //some scriptlets end with \n, especially if the script ends the file
+            if (fragment.endsWith("\n") && fragment.charAt(fragment.length - 2) == '"') {
+                //we're ok...
+            } else {
+                throw { "message":"'" + fragment + "' is not properly quoted"};
+            }
+        }
+
+        if (!fragment.startsWith("\"") && fragment.endsWith("\"")) {
+            throw { "message":"'" + fragment + "' is not properly quoted"};
+        }
+
+        // print or println?
+        if (fragment.endsWith("\n")) {
+            writer.write(jstWriter + "ln(");
+            //strip the newline
+            fragment = fragment.substring(0, fragment.length - 1);
+        } else {
+            writer.write(jstWriter + "(");
+        }
+
+        if (fragment.startsWith("\"") && fragment.endsWith("\"")) {
+            //strip the quotes
+            fragment = fragment.substring(1, fragment.length - 1);
+            writer.write("\"");
+            for (i = 0; i < fragment.length; i += 1) {
+                c = fragment.charAt(i);
+                if (c == '"') {
+                    writer.write("\\");
+                    writer.write(c);
+                }
+            }
+            writer.write("\"");
+        } else {
+            for (j = 0; j < fragment.length; j += 1) {
+                writer.write(fragment.charAt(j));
+            }
+        }
+
+        writer.write(");");
+    }
+
+    function appendTextFragment(writer, fragment) {
+        var i;
+        var c;
+
+        if (fragment.endsWith("\n")) {
+            writer.write("writeln(\"");
+        } else {
+            writer.write("write(\"");
+        }
+
+        for (i = 0; i < fragment.length; i += 1) {
+            c = fragment.charAt(i);
+            if (c == '"') {
+                writer.write("\\");
+            }
+            // we took care of the line break with print vs. println
+            if (c != '\n' && c != '\r') {
+                writer.write(c);
+            }
+        }
+
+        writer.write("\");");
+    }
+
+    function parseExpression(stack) {
+        var fragment = new StringWriter();
+        var c;
+
+        while (stack.hasMore()) {
+            if (stack.peek() == '%') { //possible end delimiter
+                c = stack.pop();
+                if (isClosingDelimiter(stack.peek())) { //end delimiter
+                    //pop > so that it is not available to main parse loop
+                    stack.pop();
+                    if (stack.peek() == '\n') {
+                        fragment.write(stack.pop());
+                    }
+                    break;
+                } else {
+                    fragment.write("%");
+                }
+            } else {
+                fragment.write(stack.pop());
+            }
+        }
+
+        return fragment.toString();
+    }
+
+    function parseText(stack) {
+        var fragment = new StringWriter();
+        var c,d;
+
+        while (stack.hasMore()) {
+            if (isOpeningDelimiter(stack.peek())) { //possible delimiter
+                c = stack.pop();
+                if (stack.peek() == '%') { // delimiter!
+                    // push c onto the stack to be used in main parse loop
+                    stack.push(c);
+                    break;
+                } else {
+                    fragment.write(c);
+                }
+            } else {
+                d = stack.pop();
+                fragment.write(d);
+                if (d == '\n') { //done with this fragment. println it.
+                    break;
+                }
+            }
+        }
+        return fragment.toString();
+    }
+
+    function safeWrite(s) {
+        s = s.toString();
+        s = s.replaceAll('&', '&amp;');
+        s = s.replaceAll('"', '&quot;');
+        s = s.replaceAll('<', '&lt;');
+        s = s.replaceAll('>', '&gt;');
+        html += s;
+    }
+
+    function safeWriteln(s) {
+        safeWrite(s + "\n");
+    }
+
+    function write(s) {
+        html += s;
+    }
+
+    function writeln(s) {
+        write(s + "\n");
+    }
+
+    that = {
+        // public methods:
+        // pre-compile a template for quicker rendering. save the return value and
+        // pass it to evaluate.
+        compile: function (src) {
+            var stack = new CharacterStack(src);
+            var writer = new StringWriter();
+
+            var c;
+            var fragment;
+            while (stack.hasMore()) {
+                if (isOpeningDelimiter(stack.peek())) { //possible delimiter
+                    c = stack.pop();
+                    if (stack.peek() == '%') { //delimiter!
+                        c = stack.pop();
+                        if (stack.peek() == "=") {
+                            // expression, escape all html
+                            stack.pop();
+                            fragment = parseExpression(stack);
+                            appendExpressionFragment(writer, fragment,
+                                "safeWrite");
+                        } else if (stack.peek() == "+") {
+                            // expression, don't escape html
+                            stack.pop()
+                            fragment = parseExpression(stack);
+                            appendExpressionFragment(writer, fragment,
+                                "write");
+                        } else {
+                            fragment = parseScriptlet(stack);
+                            writer.write(fragment);
+                        }
+                    } else { //not a delimiter
+                        stack.push(c);
+                        fragment = parseText(stack);
+                        appendTextFragment(writer, fragment);
+                    }
+                } else {
+                    fragment = parseText(stack);
+                    appendTextFragment(writer, fragment);
+                }
+            }
+            return writer.toString();
+        },
+
+        // evaluate a pre-compiled script. recommended approach
+        evaluate: function (script, args) {
+            with(args) {
+                html = "";
+                eval(script);
+                return html;
+            }
+        },
+
+        // if you're lazy, you can use this
+        evaluateSingleShot: function (src, args) {
+            return this.evaluate(this.compile(src), args);
+        }
+    };
+    return that;
+}();

data/spec/base_cube_spec.rb

@@ -0,0 +1,47 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+
+class FooClassCube < BaseCube
+  revealing :first, :second
+end
+
+
+class FooClass
+  include Ice::Cubeable
+
+  def first
+    "primero"
+  end
+
+  def second
+    @second ||= SecondClass.new
+  end
+end
+
+class SecondClass
+  def to_ice
+    "segundo"
+  end
+
+end
+
+
+describe "BaseCube" do
+  context "a cubeable class" do
+    it "should automatically to_ice the cube_class" do
+      FooClass.new.to_ice.class.should == FooClassCube
+    end
+
+    it "should retrieve revealed properties" do
+      FooClass.new.to_ice.first.should == "primero"
+    end
+
+    it "should map revealed properties via to_ice" do
+      FooClass.new.to_ice.second.should == "segundo"
+    end
+
+  end
+
+
+
+end

data/spec/cube_spec.rb

@@ -0,0 +1,120 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+class ParentObj
+  def to_ice
+    "parent"
+  end
+end
+
+class TagObj
+  def to_ice
+    @name
+  end
+
+  def initialize(name)
+    @name = name
+  end
+
+end
+
+
+class ChildModel
+  def parent
+    @parent ||= ParentObj.new
+  end
+
+  def parent_id
+    15
+  end
+
+  def tags
+    @tags ||= [TagObj.new("tag1"), TagObj.new("tag2")]
+  end
+
+  def tag_ids
+    [1, 2]
+  end
+
+  def children
+    []
+  end
+
+end
+
+
+class BaseCubeWithBelongsTo
+  extend Ice::CubeAssociation
+
+  def initialize
+    @source = ChildModel.new
+  end
+
+  belongs_to :parent
+end
+
+class BaseCubeWithHasMany
+  extend Ice::CubeAssociation
+
+  def initialize
+    @source = ChildModel.new
+  end
+
+  has_many :tags
+  has_many :children
+end
+
+describe "Cube" do
+
+  context "which has associations" do
+    context "when belongs to an item" do
+
+      it "should delegate object calls to its source object" do
+        cube = BaseCubeWithBelongsTo.new
+        cube.parent.should == "parent"
+      end
+
+      it "should delegate id calls to its source object" do
+        cube = BaseCubeWithBelongsTo.new
+        cube.parent_id.should == 15
+      end
+
+    end
+
+
+
+    context "when has many of an item" do
+
+      context "for populated collection" do
+        it "should delegate object calls to its source object" do
+          cube = BaseCubeWithHasMany.new
+          cube.tags.should == ["tag1", "tag2"]
+        end
+
+        it "should return true from has" do
+          cube = BaseCubeWithHasMany.new
+          cube.has_tags.should == true
+        end
+
+        it "should return tag count" do
+          cube = BaseCubeWithHasMany.new
+          cube.num_tags.should == 2
+        end
+
+        it "should delegate id calls to its source object" do
+          cube = BaseCubeWithHasMany.new
+          cube.tag_ids.should == [1, 2]
+        end
+      end
+
+      context "for empty collection" do
+        it "should return false from has" do
+          cube = BaseCubeWithHasMany.new
+          cube.has_children.should == false
+        end
+      end
+    end
+  end
+end
+
+
+

data/spec/ice_spec.rb

@@ -0,0 +1,94 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Ice" do
+
+
+  
+  it "converts a javascript template to html" do
+    Ice.convert_template("<%= 'hello world' %>").should == "hello world"
+  end
+
+  it "takes variables as syms" do
+    vars = {:hola => "hello", :mundo => "world" }
+    Ice.convert_template("<%= hola + ' ' + mundo %>", vars).should == "hello world"
+  end
+
+  it "takes variables as string" do
+    vars = {'hola' => "hello", 'mundo' => "world" }
+    Ice.convert_template("<%= hola + ' ' + mundo %>", vars).should == "hello world"
+  end
+
+  it "takes booleans, strings, and numbers as their value" do
+    vars = {'integer' => 1, 'float' => 1.1, 'boolean' => true, 'string' => "String"}
+    Ice.convert_template('<%= integer + " " + float + " " + boolean + " " + string %>',
+      vars).should == "1 1.1 true String"
+  end
+
+  context "to_ice function" do
+    it "should allow identical values for true" do
+      true.to_ice.should == true
+    end
+
+    it "should allow identical values for false" do
+      false.to_ice.should == false
+    end
+
+    it "should allow identical values for integer" do
+      1.to_ice.should == 1
+    end
+
+    it "should allow identical values for float" do
+      1.1.to_ice.should == 1.1
+    end
+
+    it "should allow identical values for string" do
+      "hi".to_ice.should == "hi"
+    end
+
+    it "should default to nil for an object" do
+      Object.new.to_ice.should be_nil
+    end
+    context "for array" do
+      it "should freeze elements of array" do
+        i = []
+        i.should_receive(:to_ice)
+        [i].to_ice
+      end
+      it "should return array" do
+        array = [1, "foo"]
+        array.to_ice.should == [1, "foo"]
+      end
+      it "should pass in array with details" do
+        myarray = ["one", "two", "three"]
+        vars = {"myarray" => myarray }
+        Ice.convert_template(%{<% for (var i = 0; i < myarray.length; i++) { %><p><%= myarray[i] %></p><% } %>},
+          vars).should == "<p>one</p><p>two</p><p>three</p>"
+
+      end
+
+    end
+    context "for hash" do
+      it "should freeze elements of array" do
+        i = []
+        i.should_receive(:to_ice)
+        {:var => i}.to_ice
+      end
+      it "should return hash" do
+        hash = {"foo" => 1}
+        hash.to_ice.should == {"foo" => 1}
+      end
+    end
+
+    it "should run to_ice on variables" do
+      message = Object.new
+      def message.to_ice
+        "hello world"
+      end
+
+      vars = {'message' => message }
+      Ice.convert_template("<%= message %>", vars).should == "hello world"
+    end
+  end
+
+
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'ice'
+require 'ice/cubeable'
+require 'ice/cube_association'
+require 'ice/base_cube'
+require 'spec'
+require 'spec/autorun'
+require 'active_support'
+
+
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification 
+name: ice
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Nate Kidwell
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-31 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: therubyracer
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 7
+        - 0
+        version: 0.7.0
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: active_support
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: User templates written in javascript
+email: nate@ludicast.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- ice_js/History.md
+- ice_js/Readme.md
+- ice_js/lib/path_helper.js
+- ice_js/spec/commands/example_command.rb
+- ice_js/spec/dom.html
+- ice_js/spec/node.js
+- ice_js/spec/rhino.js
+- ice_js/spec/server.html
+- ice_js/spec/server.rb
+- ice_js/spec/unit/spec.helper.js
+- ice_js/spec/unit/spec.js
+- init.rb
+- lib/ice.rb
+- lib/ice/base_cube.rb
+- lib/ice/cube_association.rb
+- lib/ice/cubeable.rb
+- lib/parser.js
+- spec/base_cube_spec.rb
+- spec/cube_spec.rb
+- spec/ice_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/ludicast/ice
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: User templates written in javascript
+test_files: 
+- spec/base_cube_spec.rb
+- spec/cube_spec.rb
+- spec/ice_spec.rb
+- spec/spec_helper.rb