handlebars 0.3.0 → 0.3.1

data/README.mdown

@@ -6,18 +6,18 @@ This uses [therubyracer][1] to bind to the _actual_ JavaScript implementation of
 
 ## Usage
 
-Simple stuff
+### Simple stuff
 
     require 'handlebars'
     handlebars = Handlebars::Context.new
     template = handlebars.compile("{{say}}{{what}}")
     template.call(:say => "Hey", :what => "Yuh!") #=> "Hey Yuh!"
 
-With functions as properties
+### functions as properties
 
     template.call(:say => "Hey", :what => lambda {|this| ("yo" * 2) + "!"}) #=> "Hey yoyo!"
 
-Register block helpers:
+### Block Helpers:
 
     handlebars.register_helper(:twice) do |block|
       "#{block.call}#{block.call}"
@@ -25,6 +25,41 @@ Register block helpers:
     template = handlebars.compile({{#twice}}Hurray!{{/twice}})
     template.call #=> Hurray!Hurray!
 
+### Safe Strings
+
+By default, handlebars will escape strings that are returned by your block helpers. To
+mark a string as safe:
+
+    template = handlebars.compile("{{safe}}")
+    template.call(:safe => proc {Handlebars::SafeString.new("<pre>Totally Safe!<pre>")})
+
+### Partials
+
+You can directly register partials
+
+    handlebars.register_partial("whoami", " I am {{who}}")
+    handlebars.compile("{{>whoami}}").call(:who => 'Legend') #=> I am Legend
+
+Partials can also be dynamically looked up by defining a partial_missing behavior:
+
+    handlebars.partial_missing do |name|
+      "unable to find >#{name}"
+    end
+    handlebars.compile("{{>missing}}").call #=> unable to find >missing
+    
+Missing partials can also be returned as a function:
+
+    count = 0
+    handlebars.partial_missing do |name|
+      lambda do |this, context, options|
+        count += 1
+        "#{count} miss(es) when trying to look up a partial"
+      end
+    end
+    t = handlebars.compile("{{>missing}}")
+    t.call #=> 1 miss(es) when trying to look up a partial
+    t.call #=> 2 miss(es) when tyring to look up a partial
+
 ## Hack
 
     git clone git@github.com:cowboyd/handlebars.rb.git #git it
@@ -33,13 +68,6 @@ Register block helpers:
     rspec spec/ #test it
 
 
-## Rubygems
-
-  Handlebars is available via the [hbs][3] gem on rubygems.org. There is also a
-  [handlebars][4] gem, which is a pure-ruby implementation that appears to no longer be maintained.
-
 [1]: http://github.com/cowboyd/therubyracer "The Ruby Racer"
 [2]: http://github.com/wycats/handlebars.js "Handlebars JavaScript templating library"
-[3]: http://rubygems.org/gems/hbs "handelbars gem in JavaScript"
-[4]: http://rubygems.org/gems/handlebars "pure ruby handlebars gem"
 

data/lib/handlebars.rb

@@ -1,6 +1,7 @@
 
 module Handlebars
-    autoload :Context,    'handlebars/context'
-    autoload :Template,   'handlebars/template'
-    autoload :SafeString, 'handlebars/safe_string'
+  autoload :Context,    'handlebars/context'
+  autoload :Template,   'handlebars/template'
+  autoload :Partials,   'handlebars/partials'
+  autoload :SafeString, 'handlebars/safe_string'
 end

data/lib/handlebars/context.rb

@@ -20,6 +20,7 @@ module Handlebars
         @js.require("handlebars/compiler/#{compiler_module}")
       end
       @js.require('handlebars/runtime')
+      @partials = handlebars.partials = Handlebars::Partials.new
     end
     
     def compile(*args)
@@ -34,6 +35,10 @@ module Handlebars
       handlebars.registerPartial(name, content)
     end
 
+    def partial_missing(&fn)
+      @partials.partial_missing = fn
+    end
+
     def handlebars
       @js.require('handlebars/base')
     end

data/lib/handlebars/partials.rb

@@ -0,0 +1,23 @@
+module Handlebars
+  class Partials
+    attr_accessor :partial_missing
+
+    def initialize
+      @partials = {}
+    end
+    
+    def []=(name, value)
+      @partials[name.to_s] = value
+    end
+    
+    def [](name)
+      if @partials.has_key?(name.to_s)
+        return @partials[name.to_s]
+      elsif @partial_missing
+        return @partial_missing[name]
+      else
+        yield
+      end
+    end
+  end
+end

data/lib/handlebars/version.rb

@@ -1,3 +1,3 @@
 module Handlebars
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

data/spec/handlebars_spec.rb

@@ -3,7 +3,7 @@ require 'handlebars'
 describe(Handlebars::Context) do
 
   describe "a simple template" do
-    let(:t) {subject.compile("Hello {{name}}")}
+    let(:t) {compile("Hello {{name}}")}
     it "allows simple subsitution" do
       t.call(:name => 'World').should eql "Hello World"
     end
@@ -28,22 +28,40 @@ describe(Handlebars::Context) do
     end
 
     it "correctly passes context and implementation" do
-      t = subject.compile("it's so {{#alsowith weather}}*{{summary}}*{{/alsowith}}!")
+      t = compile("it's so {{#alsowith weather}}*{{summary}}*{{/alsowith}}!")
       t.call(:weather => {:summary => "sunny"}).should eql "it's so *sunny*!"
     end
 
     it "doesn't nee a context or arguments to the call" do
-      t = subject.compile("{{#twice}}Hurray!{{/twice}}")
+      t = compile("{{#twice}}Hurray!{{/twice}}")
       t.call.should eql "Hurray!Hurray!"
     end
   end
 
   describe "registering Partials" do
     before do
-      subject.register_partial('legend', 'I am {{legend}}')
+      subject.register_partial('legend', 'I am {{who}}')
     end
     it "renders partials" do
-      t = subject.compile("{{> legend}}").call(:legend => 'Legend!').should eql "I am Legend!"
+      compile("{{> legend}}").call(:who => 'Legend!').should eql "I am Legend!"
+    end
+  end
+
+  describe "dynamically loading partial" do
+    it "can be done with a string" do
+      subject.partial_missing do |name|
+        "unable to find >#{name}"
+      end
+      compile("I am {{>missing}}").call().should eql "I am unable to find >missing"
+    end
+
+    it "can be done with a function" do
+      subject.partial_missing do |name|
+        lambda do |this, context, options|
+          "unable to find >#{name}"
+        end
+      end
+      compile("I am {{>missing}}").call().should eql "I am unable to find >missing"
     end
   end
 
@@ -53,4 +71,8 @@ describe(Handlebars::Context) do
       t.call(:safe => lambda {|this, *args| Handlebars::SafeString.new("<pre>totally safe</pre>")}).should eql "<pre>totally safe</pre>"
     end
   end
+
+  def compile(*args)
+    subject.compile(*args)
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: handlebars
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-06 00:00:00.000000000 Z
+date: 2012-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: therubyracer
-  requirement: &2152688600 !ruby/object:Gem::Requirement
+  requirement: &2153055500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 0.10.0
   type: :runtime
   prerelease: false
-  version_requirements: *2152688600
+  version_requirements: *2153055500
 - !ruby/object:Gem::Dependency
   name: commonjs
-  requirement: &2152687860 !ruby/object:Gem::Requirement
+  requirement: &2153054020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: 0.2.3
   type: :runtime
   prerelease: false
-  version_requirements: *2152687860
+  version_requirements: *2153054020
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2152686640 !ruby/object:Gem::Requirement
+  requirement: &2153051440 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,7 +43,7 @@ dependencies:
         version: '2.0'
   type: :development
   prerelease: false
-  version_requirements: *2152686640
+  version_requirements: *2153051440
 description: Uses the actual JavaScript implementation of Handlebars, but supports
   using Ruby objects as template contexts and Ruby procs as view functions and named
   helpers
@@ -62,6 +62,7 @@ files:
 - handlebars.gemspec
 - lib/handlebars.rb
 - lib/handlebars/context.rb
+- lib/handlebars/partials.rb
 - lib/handlebars/safe_string.rb
 - lib/handlebars/template.rb
 - lib/handlebars/version.rb