Merge pull request #149 from mikeric/local-binders-and-config

Local config, binders and formatters

@@ -131,7 +131,7 @@ describe('Rivets.Binding', function() {
     });
     });
 
 
     it('applies any formatters to the value before performing the routine', function() {
     it('applies any formatters to the value before performing the routine', function() {
-      rivets.formatters.awesome = function(value) { return 'awesome ' + value; };
+      view.formatters.awesome = function(value) { return 'awesome ' + value; };
       binding.formatters.push('awesome');
       binding.formatters.push('awesome');
       spyOn(binding.binder, 'routine');
       spyOn(binding.binder, 'routine');
       binding.set('sweater');
       binding.set('sweater');
@@ -167,7 +167,7 @@ describe('Rivets.Binding', function() {
   describe('publishTwoWay()', function() {
   describe('publishTwoWay()', function() {
 
 
     it('applies a two-way read formatter to function same as a single-way', function() {
     it('applies a two-way read formatter to function same as a single-way', function() {
-      rivets.formatters.awesome = {
+      view.formatters.awesome = {
         read: function(value) { return 'awesome ' + value; },
         read: function(value) { return 'awesome ' + value; },
       };
       };
       binding.formatters.push('awesome');
       binding.formatters.push('awesome');
@@ -300,7 +300,7 @@ describe('Rivets.Binding', function() {
 
 
   describe('formattedValue()', function() {
   describe('formattedValue()', function() {
     it('applies the current formatters on the supplied value', function() {
     it('applies the current formatters on the supplied value', function() {
-      rivets.formatters.awesome = function(value) { return 'awesome ' + value; };
+      view.formatters.awesome = function(value) { return 'awesome ' + value; };
       binding.formatters.push('awesome');
       binding.formatters.push('awesome');
       expect(binding.formattedValue('hat')).toBe('awesome hat');
       expect(binding.formattedValue('hat')).toBe('awesome hat');
     });
     });
@@ -311,15 +311,9 @@ describe('Rivets.Binding', function() {
       expect(binding.formattedValue('hat')).toBe('model awesome hat');
       expect(binding.formattedValue('hat')).toBe('model awesome hat');
     });
     });
 
 
-    it('uses formatters from the bind options', function() {
-      opts.formatters = { optAwesome: function(value) { return 'option awesome ' + value; } };
-      binding.formatters.push("optAwesome");
-      expect(binding.formattedValue('hat')).toBe('option awesome hat');
-    });
-
     describe('with a multi-argument formatter string', function() {
     describe('with a multi-argument formatter string', function() {
       beforeEach(function() {
       beforeEach(function() {
-        rivets.formatters.awesome = function(value, prefix) {
+        view.formatters.awesome = function(value, prefix) {
           return prefix + ' awesome ' + value;
           return prefix + ' awesome ' + value;
         };
         };
         binding.formatters.push('awesome super');
         binding.formatters.push('awesome super');

@@ -11,12 +11,12 @@ unless String::trim then String::trim = -> @replace /^\s+|\s+$/g, ''
 
 
 # A single binding between a model attribute and a DOM element.
 # A single binding between a model attribute and a DOM element.
 class Rivets.Binding
 class Rivets.Binding
-  # All information about the binding is passed into the constructor; the DOM
-  # element, the type of binding, the model object and the keypath at which
-  # to listen for changes.
-  constructor: (@el, @type, @model, @keypath, @options = {}) ->
-    unless @binder = Rivets.binders[type]
-      for identifier, value of Rivets.binders
+  # All information about the binding is passed into the constructor; the
+  # containing view, the DOM node, the type of binding, the model object and the
+  # keypath at which to listen for changes.
+  constructor: (@view, @el, @type, @model, @keypath, @options = {}) ->
+    unless @binder = @view.binders[type]
+      for identifier, value of @view.binders
         if identifier isnt '*' and identifier.indexOf('*') isnt -1
         if identifier isnt '*' and identifier.indexOf('*') isnt -1
           regexp = new RegExp "^#{identifier.replace('*', '.+')}$"
           regexp = new RegExp "^#{identifier.replace('*', '.+')}$"
           if regexp.test type
           if regexp.test type
@@ -24,7 +24,7 @@ class Rivets.Binding
             @args = new RegExp("^#{identifier.replace('*', '(.+)')}$").exec type
             @args = new RegExp("^#{identifier.replace('*', '(.+)')}$").exec type
             @args.shift()
             @args.shift()
 
 
-    @binder or= Rivets.binders['*']
+    @binder or= @view.binders['*']
 
 
     if @binder instanceof Function
     if @binder instanceof Function
       @binder = {routine: @binder}
       @binder = {routine: @binder}
@@ -43,7 +43,7 @@ class Rivets.Binding
       else if @options?.bindingOptions?.formatters?[id] instanceof Function
       else if @options?.bindingOptions?.formatters?[id] instanceof Function
         @options.bindingOptions.formatters[id]
         @options.bindingOptions.formatters[id]
       else
       else
-        Rivets.formatters[id]
+        @view.formatters[id]
 
 
       if formatter?.read instanceof Function
       if formatter?.read instanceof Function
         value = formatter.read value, args...
         value = formatter.read value, args...
@@ -67,7 +67,7 @@ class Rivets.Binding
     @set if @options.bypass
     @set if @options.bypass
       @model[@keypath]
       @model[@keypath]
     else
     else
-      Rivets.config.adapter.read @model, @keypath
+      @view.config.adapter.read @model, @keypath
 
 
   # Publishes the value currently set on the input element back to the model.
   # Publishes the value currently set on the input element back to the model.
   publish: =>
   publish: =>
@@ -77,10 +77,10 @@ class Rivets.Binding
       args = formatter.split /\s+/
       args = formatter.split /\s+/
       id = args.shift()
       id = args.shift()
 
 
-      if Rivets.formatters[id]?.publish
-        value = Rivets.formatters[id].publish value, args...
+      if @view.formatters[id]?.publish
+        value = @view.formatters[id].publish value, args...
 
 
-    Rivets.config.adapter.publish @model, @keypath, value
+    @view.config.adapter.publish @model, @keypath, value
 
 
   # Subscribes to the model for changes at the specified keypath. Bi-directional
   # Subscribes to the model for changes at the specified keypath. Bi-directional
   # routines will also listen for changes on the element to propagate them back
   # routines will also listen for changes on the element to propagate them back
@@ -91,8 +91,8 @@ class Rivets.Binding
     if @options.bypass
     if @options.bypass
       @sync()
       @sync()
     else
     else
-      Rivets.config.adapter.subscribe @model, @keypath, @sync
-      @sync() if Rivets.config.preloadData
+      @view.config.adapter.subscribe @model, @keypath, @sync
+      @sync() if @view.config.preloadData
 
 
     if @options.dependencies?.length
     if @options.dependencies?.length
       for dependency in @options.dependencies
       for dependency in @options.dependencies
@@ -104,14 +104,14 @@ class Rivets.Binding
           model = @view.models[dependency.shift()]
           model = @view.models[dependency.shift()]
           keypath = dependency.join '.'
           keypath = dependency.join '.'
 
 
-        Rivets.config.adapter.subscribe model, keypath, @sync
+        @view.config.adapter.subscribe model, keypath, @sync
 
 
   # Unsubscribes from the model and the element.
   # Unsubscribes from the model and the element.
   unbind: =>
   unbind: =>
     @binder.unbind?.call @, @el
     @binder.unbind?.call @, @el
 
 
     unless @options.bypass
     unless @options.bypass
-      Rivets.config.adapter.unsubscribe @model, @keypath, @sync
+      @view.config.adapter.unsubscribe @model, @keypath, @sync
 
 
     if @options.dependencies?.length
     if @options.dependencies?.length
       for dependency in @options.dependencies
       for dependency in @options.dependencies
@@ -123,19 +123,26 @@ class Rivets.Binding
           model = @view.models[dependency.shift()]
           model = @view.models[dependency.shift()]
           keypath = dependency.join '.'
           keypath = dependency.join '.'
 
 
-        Rivets.config.adapter.unsubscribe model, keypath, @sync
+        @view.config.adapter.unsubscribe model, keypath, @sync
 
 
 # A collection of bindings built from a set of parent elements.
 # A collection of bindings built from a set of parent elements.
 class Rivets.View
 class Rivets.View
   # The DOM elements and the model objects for binding are passed into the
   # The DOM elements and the model objects for binding are passed into the
-  # constructor.
-  constructor: (@els, @models, @options) ->
+  # constructor along with any local options that should be used throughout the
+  # context of the view and it's bindings.
+  constructor: (@els, @models, @options = {}) ->
     @els = [@els] unless (@els.jquery || @els instanceof Array)
     @els = [@els] unless (@els.jquery || @els instanceof Array)
+
+    for option in ['config', 'binders', 'formatters']
+      @[option] = {}
+      @[option][k] = v for k, v of @options[option] if @options[option]
+      @[option][k] ?= v for k, v of Rivets[option]
+
     @build()
     @build()
 
 
   # Regular expression used to match binding attributes.
   # Regular expression used to match binding attributes.
   bindingRegExp: =>
   bindingRegExp: =>
-    prefix = Rivets.config.prefix
+    prefix = @config.prefix
     if prefix then new RegExp("^data-#{prefix}-") else /^data-/
     if prefix then new RegExp("^data-#{prefix}-") else /^data-/
 
 
   # Parses the DOM tree and builds Rivets.Binding instances for every matched
   # Parses the DOM tree and builds Rivets.Binding instances for every matched
@@ -151,14 +158,14 @@ class Rivets.View
         for attribute in node.attributes
         for attribute in node.attributes
           if bindingRegExp.test attribute.name
           if bindingRegExp.test attribute.name
             type = attribute.name.replace bindingRegExp, ''
             type = attribute.name.replace bindingRegExp, ''
-            unless binder = Rivets.binders[type]
-              for identifier, value of Rivets.binders
+            unless binder = @binders[type]
+              for identifier, value of @binders
                 if identifier isnt '*' and identifier.indexOf('*') isnt -1
                 if identifier isnt '*' and identifier.indexOf('*') isnt -1
                   regexp = new RegExp "^#{identifier.replace('*', '.+')}$"
                   regexp = new RegExp "^#{identifier.replace('*', '.+')}$"
                   if regexp.test type
                   if regexp.test type
                     binder = value
                     binder = value
 
 
-            binder or= Rivets.binders['*']
+            binder or= @binders['*']
 
 
             if binder.block
             if binder.block
               skipNodes.push n for n in node.getElementsByTagName '*'
               skipNodes.push n for n in node.getElementsByTagName '*'
@@ -167,10 +174,6 @@ class Rivets.View
         for attribute in attributes or node.attributes
         for attribute in attributes or node.attributes
           if bindingRegExp.test attribute.name
           if bindingRegExp.test attribute.name
             options = {}
             options = {}
-
-            if @options? and typeof @options is 'object'
-                options.bindingOptions = @options
-
             type = attribute.name.replace bindingRegExp, ''
             type = attribute.name.replace bindingRegExp, ''
             pipes = (pipe.trim() for pipe in attribute.value.split '|')
             pipes = (pipe.trim() for pipe in attribute.value.split '|')
             context = (ctx.trim() for ctx in pipes.shift().split '<')
             context = (ctx.trim() for ctx in pipes.shift().split '<')
@@ -189,10 +192,7 @@ class Rivets.View
               if dependencies = context.shift()
               if dependencies = context.shift()
                 options.dependencies = dependencies.split /\s+/
                 options.dependencies = dependencies.split /\s+/
 
 
-              binding = new Rivets.Binding node, type, model, keypath, options
-              binding.view = @
-
-              @bindings.push binding
+              @bindings.push new Rivets.Binding @, node, type, model, keypath, options
 
 
         attributes = null if attributes
         attributes = null if attributes
 
 
@@ -344,7 +344,7 @@ Rivets.binders =
   "each-*":
   "each-*":
     block: true
     block: true
     bind: (el, collection) ->
     bind: (el, collection) ->
-      el.removeAttribute ['data', Rivets.config.prefix, @type].join('-').replace '--', '-'
+      el.removeAttribute ['data', @view.config.prefix, @type].join('-').replace '--', '-'
     unbind: (el, collection) ->
     unbind: (el, collection) ->
       view.unbind() for view in @iterated if @iterated?
       view.unbind() for view in @iterated if @iterated?
     routine: (el, collection) ->
     routine: (el, collection) ->
@@ -372,7 +372,7 @@ Rivets.binders =
             @marker
             @marker
 
 
           @marker.parentNode.insertBefore itemEl, previous.nextSibling ? null
           @marker.parentNode.insertBefore itemEl, previous.nextSibling ? null
-          view = new Rivets.View(itemEl, data)
+          view = new Rivets.View(itemEl, data, @view.options)
           view.bind()
           view.bind()
           @iterated.push view
           @iterated.push view