templebars 0.0.6 → 0.0.7

data/Gemfile.lock

@@ -1,64 +1,29 @@
 PATH
   remote: .
   specs:
-    templebars (0.0.5)
+    templebars (0.0.6)
       execjs
-      railties (>= 3.2.0)
+      sprockets (>= 2.0.3)
+      tilt
 
 GEM
   remote: http://rubygems.org/
   specs:
-    actionpack (3.2.1)
-      activemodel (= 3.2.1)
-      activesupport (= 3.2.1)
-      builder (~> 3.0.0)
-      erubis (~> 2.7.0)
-      journey (~> 1.0.1)
-      rack (~> 1.4.0)
-      rack-cache (~> 1.1)
-      rack-test (~> 0.6.1)
-      sprockets (~> 2.1.2)
-    activemodel (3.2.1)
-      activesupport (= 3.2.1)
-      builder (~> 3.0.0)
-    activesupport (3.2.1)
-      i18n (~> 0.6)
-      multi_json (~> 1.0)
-    builder (3.0.0)
-    erubis (2.7.0)
-    execjs (1.3.0)
+    execjs (1.3.1)
       multi_json (~> 1.0)
     hike (1.2.1)
-    i18n (0.6.0)
-    journey (1.0.3)
-    json (1.6.6)
-    multi_json (1.2.0)
+    multi_json (1.3.6)
     rack (1.4.1)
-    rack-cache (1.2)
-      rack (>= 0.4)
-    rack-ssl (1.3.2)
-      rack
-    rack-test (0.6.1)
-      rack (>= 1.0)
-    railties (3.2.1)
-      actionpack (= 3.2.1)
-      activesupport (= 3.2.1)
-      rack-ssl (~> 1.3.2)
-      rake (>= 0.8.7)
-      rdoc (~> 3.4)
-      thor (~> 0.14.6)
     rake (0.9.2.2)
-    rdoc (3.12)
-      json (~> 1.4)
-    sprockets (2.1.2)
+    sprockets (2.1.3)
       hike (~> 1.2)
       rack (~> 1.0)
       tilt (~> 1.1, != 1.3.0)
-    thor (0.14.6)
     tilt (1.3.3)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  rake
   templebars!

data/README.md

@@ -1,37 +1,66 @@
 # templebars
 
-`templebars` allows you to precomile Handlebars templates and make them available globally in a `Templates` object. (This can be set via `Templebars::Rails::GLOBAL`) Create files with a "handlebars", "hbs", or "hb" extension inside of a `templates/` directory in any `assets/javascripts/` directory:
+`templebars` allows you to precomile [Handlebars][handlebars] templates
+in Rails and make them available globally on the client-side in a
+`Templates` object.
 
-```
-app/assets/javascripts/templates/todo_item.js.handlebars
-```
+## Adding Templebars to Rails 3.1+
 
-You can then access it like any other JavaScript asset:
+Add `templebars` to your `Gemfile` in the `assets` group:
 
 ```ruby
-javascript_include_tag( "templates/todo_item" )
+group :assets do
+  ...
+  gem 'templebars'
+end
 ```
 
-The above template would be stored as `Templates.todo_item`.
+And run `bundle install` to install it.
 
-## Handlebars
+Then, you'll need to include the Handlebars runtime in your JavaScript
+manifest (`app/assets/javascripts/application.js`):
+
+```javascript
+//= require handlebars.runtime
+```
 
-This gem also provides Handlebars 1.0.beta.6 to the Rails assert pipeline via `handlebars`. You can include it in other JS files:
+If you still need to compile Handlebars templates on the client side,
+you'll want to require the full `handlebars`, instead:
 
-```js
+```javascript
 //= require handlebars
 ```
 
-You can also include it via a regular ol' `javascript_include_tag` call:
+## Adding templates
 
-```ruby
-javascript_include_tag( "handlebars" )
+Place your templates in `app/assets/templates/` and require all of them
+in your JavaScript manifest (`application.js`):
+
+```javascript
+//= require_tree ../templates
 ```
 
-## Installation
+Your template file names must be suffixed with the ".handlebars" or
+".hbs" extensions in order for Templebars to handle them.
+
+## Using templates
+
+Your templates will be available on the client side via their paths in a
+global `Templates` object. For example, a template at
+`app/assets/templates/user.handlebars` can be rendered with:
+
+```javascript
+Templates['user'](context);
+```
+
+And a template at `app/assets/templates/users/detail.handlebars` with:
+
+```javascript
+Templates['users/detail'](context);
+```
 
-Add this to your Gemfile, preferably in the `:assets` gem group:
+*This gem is maintained by [Stovepipe Studios][stovepipe].*
 
-    gem "templebars"
+[stovepipe]: http://www.stovepipestudios.com
+[handlebars]: http://handlebarsjs.com/
 
-Done. Go forth, grasshopper.

data/lib/templebars/rails/templates.rb

@@ -11,21 +11,23 @@ module Templebars
         "application/javascript"
       end
 
-      def initialize_engine; end
-
       def prepare; end
 
       def evaluate( scope, locals, &block )
-        global = Templebars::Rails::GLOBAL
-        setup_global = "('undefined' == typeof #{global}) && (#{global} = {})"
         name = scope.logical_path.sub( /^templates\//, "" )
-        precompiled_js = precompile( data )
-        template_declaration = "#{global}[\"#{name}\"] = Handlebars.template(#{precompiled_js});"
-        "#{setup_global}\n#{template_declaration}\n"
+        register_template_js( name, precompile( data ) )
       end
 
       protected
 
+      def register_template_js( name, precompiled_js )
+        global = Templebars::Rails::GLOBAL
+        <<-JS
+          this.#{global} || (this.#{global} = {});
+          this.#{global}["#{name}"] = Handlebars.template(#{precompiled_js});
+        JS
+      end
+
       def precompile( template )
         runtime.call( "Handlebars.precompile", template, { data: {} } )
       end
@@ -35,13 +37,13 @@ module Templebars
       end
 
       def handlebars_js
-        path = File.join( File.dirname(__FILE__), "..", "..", "..", "vendor", "assets", "javascripts", "handlebars.js" )
+        path = File.expand_path( "../../../vendor/assets/javascripts/handlebars.js" )
         File.read( path )
       end
     end
 
     Sprockets.register_engine '.handlebars', HandlebarsTemplate
     Sprockets.register_engine '.hbs', HandlebarsTemplate
-    Sprockets.register_engine '.hb', HandlebarsTemplate
   end
 end
+

data/lib/templebars/rails/version.rb

@@ -1,6 +1,6 @@
 module Templebars
   module Rails
-    VERSION = "0.0.6"
-    HANDLEBARSJS_VERSION = "1.0.beta.5"
+    VERSION = "0.0.7"
+    HANDLEBARSJS_VERSION = "1.0.beta.6"
   end
 end

data/templebars.gemspec

@@ -14,8 +14,10 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = ">= 1.3.6"
   s.rubyforge_project         = "templebars"
 
-  s.add_dependency "railties", ">= 3.2.0"
+  s.add_dependency "sprockets", ">= 2.0.3"
   s.add_dependency "execjs"
+  s.add_dependency "tilt"
+  s.add_development_dependency "rake"
 
   s.files        = `git ls-files`.split("\n")
   s.require_path = 'lib'

data/vendor/assets/javascripts/handlebars.runtime.js

@@ -0,0 +1,223 @@
+// lib/handlebars/base.js
+var Handlebars = {};
+
+Handlebars.VERSION = "1.0.beta.6";
+
+Handlebars.helpers  = {};
+Handlebars.partials = {};
+
+Handlebars.registerHelper = function(name, fn, inverse) {
+  if(inverse) { fn.not = inverse; }
+  this.helpers[name] = fn;
+};
+
+Handlebars.registerPartial = function(name, str) {
+  this.partials[name] = str;
+};
+
+Handlebars.registerHelper('helperMissing', function(arg) {
+  if(arguments.length === 2) {
+    return undefined;
+  } else {
+    throw new Error("Could not find property '" + arg + "'");
+  }
+});
+
+var toString = Object.prototype.toString, functionType = "[object Function]";
+
+Handlebars.registerHelper('blockHelperMissing', function(context, options) {
+  var inverse = options.inverse || function() {}, fn = options.fn;
+
+
+  var ret = "";
+  var type = toString.call(context);
+
+  if(type === functionType) { context = context.call(this); }
+
+  if(context === true) {
+    return fn(this);
+  } else if(context === false || context == null) {
+    return inverse(this);
+  } else if(type === "[object Array]") {
+    if(context.length > 0) {
+      for(var i=0, j=context.length; i<j; i++) {
+        ret = ret + fn(context[i]);
+      }
+    } else {
+      ret = inverse(this);
+    }
+    return ret;
+  } else {
+    return fn(context);
+  }
+});
+
+Handlebars.registerHelper('each', function(context, options) {
+  var fn = options.fn, inverse = options.inverse;
+  var ret = "";
+
+  if(context && context.length > 0) {
+    for(var i=0, j=context.length; i<j; i++) {
+      ret = ret + fn(context[i]);
+    }
+  } else {
+    ret = inverse(this);
+  }
+  return ret;
+});
+
+Handlebars.registerHelper('if', function(context, options) {
+  var type = toString.call(context);
+  if(type === functionType) { context = context.call(this); }
+
+  if(!context || Handlebars.Utils.isEmpty(context)) {
+    return options.inverse(this);
+  } else {
+    return options.fn(this);
+  }
+});
+
+Handlebars.registerHelper('unless', function(context, options) {
+  var fn = options.fn, inverse = options.inverse;
+  options.fn = inverse;
+  options.inverse = fn;
+
+  return Handlebars.helpers['if'].call(this, context, options);
+});
+
+Handlebars.registerHelper('with', function(context, options) {
+  return options.fn(context);
+});
+
+Handlebars.registerHelper('log', function(context) {
+  Handlebars.log(context);
+});
+;
+// lib/handlebars/utils.js
+Handlebars.Exception = function(message) {
+  var tmp = Error.prototype.constructor.apply(this, arguments);
+
+  for (var p in tmp) {
+    if (tmp.hasOwnProperty(p)) { this[p] = tmp[p]; }
+  }
+
+  this.message = tmp.message;
+};
+Handlebars.Exception.prototype = new Error;
+
+// Build out our basic SafeString type
+Handlebars.SafeString = function(string) {
+  this.string = string;
+};
+Handlebars.SafeString.prototype.toString = function() {
+  return this.string.toString();
+};
+
+(function() {
+  var escape = {
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#x27;",
+    "`": "&#x60;"
+  };
+
+  var badChars = /&(?!\w+;)|[<>"'`]/g;
+  var possible = /[&<>"'`]/;
+
+  var escapeChar = function(chr) {
+    return escape[chr] || "&amp;";
+  };
+
+  Handlebars.Utils = {
+    escapeExpression: function(string) {
+      // don't escape SafeStrings, since they're already safe
+      if (string instanceof Handlebars.SafeString) {
+        return string.toString();
+      } else if (string == null || string === false) {
+        return "";
+      }
+
+      if(!possible.test(string)) { return string; }
+      return string.replace(badChars, escapeChar);
+    },
+
+    isEmpty: function(value) {
+      if (typeof value === "undefined") {
+        return true;
+      } else if (value === null) {
+        return true;
+      } else if (value === false) {
+        return true;
+      } else if(Object.prototype.toString.call(value) === "[object Array]" && value.length === 0) {
+        return true;
+      } else {
+        return false;
+      }
+    }
+  };
+})();;
+// lib/handlebars/runtime.js
+Handlebars.VM = {
+  template: function(templateSpec) {
+    // Just add water
+    var container = {
+      escapeExpression: Handlebars.Utils.escapeExpression,
+      invokePartial: Handlebars.VM.invokePartial,
+      programs: [],
+      program: function(i, fn, data) {
+        var programWrapper = this.programs[i];
+        if(data) {
+          return Handlebars.VM.program(fn, data);
+        } else if(programWrapper) {
+          return programWrapper;
+        } else {
+          programWrapper = this.programs[i] = Handlebars.VM.program(fn);
+          return programWrapper;
+        }
+      },
+      programWithDepth: Handlebars.VM.programWithDepth,
+      noop: Handlebars.VM.noop
+    };
+
+    return function(context, options) {
+      options = options || {};
+      return templateSpec.call(container, Handlebars, context, options.helpers, options.partials, options.data);
+    };
+  },
+
+  programWithDepth: function(fn, data, $depth) {
+    var args = Array.prototype.slice.call(arguments, 2);
+
+    return function(context, options) {
+      options = options || {};
+
+      return fn.apply(this, [context, options.data || data].concat(args));
+    };
+  },
+  program: function(fn, data) {
+    return function(context, options) {
+      options = options || {};
+
+      return fn(context, options.data || data);
+    };
+  },
+  noop: function() { return ""; },
+  invokePartial: function(partial, name, context, helpers, partials, data) {
+    options = { helpers: helpers, partials: partials, data: data };
+
+    if(partial === undefined) {
+      throw new Handlebars.Exception("The partial " + name + " could not be found");
+    } else if(partial instanceof Function) {
+      return partial(context, options);
+    } else if (!Handlebars.compile) {
+      throw new Handlebars.Exception("The partial " + name + " could not be compiled when running in runtime-only mode");
+    } else {
+      partials[name] = Handlebars.compile(partial);
+      return partials[name](context, options);
+    }
+  }
+};
+
+Handlebars.template = Handlebars.VM.template;
+;

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: templebars
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,22 +9,22 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-05 00:00:00.000000000 Z
+date: 2012-05-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: railties
-  requirement: &70233412557020 !ruby/object:Gem::Requirement
+  name: sprockets
+  requirement: &70293659066120 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 3.2.0
+        version: 2.0.3
   type: :runtime
   prerelease: false
-  version_requirements: *70233412557020
+  version_requirements: *70293659066120
 - !ruby/object:Gem::Dependency
   name: execjs
-  requirement: &70233412556460 !ruby/object:Gem::Requirement
+  requirement: &70293659065680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,7 +32,29 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70233412556460
+  version_requirements: *70293659065680
+- !ruby/object:Gem::Dependency
+  name: tilt
+  requirement: &70293659083960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70293659083960
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70293659083520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70293659083520
 description: This gem provides Handlebars magic for your Rails 3 application.
 email:
 - tyson@stovepipestudios.com
@@ -53,6 +75,7 @@ files:
 - lib/templebars/rails/version.rb
 - templebars.gemspec
 - vendor/assets/javascripts/handlebars.js
+- vendor/assets/javascripts/handlebars.runtime.js
 homepage: http://rubygems.org/gems/templebars
 licenses: []
 post_install_message: 
@@ -78,3 +101,4 @@ signing_key:
 specification_version: 3
 summary: Use precompiled Handlebars templates with Rails 3
 test_files: []
+has_rdoc: