volt 0.4.12 → 0.4.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 08c77c87d772570f8364780a35f43715d6d508da
-  data.tar.gz: c44668cc7839b2d56194f4eaf555224fa5d945d4
+  metadata.gz: 905771711030eddcecc7a47be637a9a32d935718
+  data.tar.gz: cb0e6dcf3ba7a19bcc1544069d209a3f8508a023
 SHA512:
-  metadata.gz: 9bf1d352e1daccbbc308246157d17c5893d4b77ae50d02d2859ba4d51e745d38ab008dade5ee15a7f78db752c20a0e7eb53b1c2038895adcd87f157bff4b6b03
-  data.tar.gz: 1096504bef8576a640d64228acc99de1ff4956f437b5650ba274be8a22565212d454c02c9e8a45d68537175a623aa07a3af80a7468051c8827c47b3e3203600b
+  metadata.gz: 8ffded87588ef61e162316878a4ef29d26c0d61d1d85f480cc48ab169c16e5ee938cf8f80ffd8cdb1171679376cb2f423d5389eacd47919660e5e4bfb8879669
+  data.tar.gz: 99d9f82057294e409f44bc061a848caf780ecaf3967e4b211265837d11c1cc4bdc66afbc5505c4a74c054af7b2805756cde8f6a56040fd2d7a265dfead1454f7

data/Readme.md

@@ -346,6 +346,59 @@ Models trigger events when their data is updated.  Currently models emit three e
     # => item removed
 
 
+## Automatic Model Conversion
+
+### Hash -> Model
+
+For convience, when placing a hash inside of another model, it is automatically converted into a model.  Models are similar to hashes, but provide support for things like persistance and triggering reactive events.
+
+    user = Model.new
+    user._name = 'Ryan'
+    user._profiles = {
+      twitter: 'http://www.twitter.com/ryanstout',
+      dribbble: 'http://dribbble.com/ryanstout'
+    }
+    
+    user._name
+    # => "Ryan"
+    user._profiles._twitter
+    # => "http://www.twitter.com/ryanstout"
+    user._profiles.class
+    # => Model
+    
+    
+Models are accessed differently from hashes.  Instead of using model[:symbol] to access, you call a method model.method_name.  This provides a dynamic unified store where setters and getters can be added without changing any access code.
+
+### Array -> ArrayModel
+
+Arrays inside of models are automatically converted to an instance of ArrayModel.  ArrayModels behave the same as a normal Array except that they can handle things like being bound to backend data and triggering reactive events.
+
+    model = Model.new
+    model._items << {_name: 'item 1'}
+    model._items.class
+    # => ArrayModel
+    
+    model._items[0].class
+    # => Model
+    model._items[0]
+    
+
+
+To convert a Model or an ArrayModel back to a normal hash, call .to_h or .to_a respectively.  To convert them to a JavaScript Object (for passing to some JavaScript code), call .to_n (to native).
+
+    user = Model.new
+    user._name = 'Ryan'
+    user._profiles = {
+      twitter: 'http://www.twitter.com/ryanstout',
+      dribbble: 'http://dribbble.com/ryanstout'
+    }
+    
+    user._profiles.to_h
+    # => {twitter: 'http://www.twitter.com/ryanstout', dribbble: 'http://dribbble.com/ryanstout'}
+    
+    items = ArrayModel.new([1,2,3,4])
+    items
+
 # Controllers
 
 A controller can be any class in Volt, however it is common to have that class inherit from ModelController.  A model controller lets you specify a model that the controller works off of.  This is a common pattern in Volt.  To assign the current model, simply set @model to one of the provided models in the initializer.

data/VERSION

@@ -1 +1 @@
-0.4.12
+0.4.14

data/lib/volt/models/model.rb

@@ -224,6 +224,10 @@ class Model
     "<#{self.class.to_s}:#{object_id} #{attributes.inspect}>"
   end
   
+  def [](val)
+    raise "Models do not support hash style lookup.  Hashes inserted into other models are converted to models, see https://github.com/voltrb/volt#automatic-model-conversion"
+  end
+  
   
   private
     # Clear the previous value and assign a new one

data/lib/volt/page/bindings/content_binding.rb

@@ -22,8 +22,9 @@ class ContentBinding < BaseBinding
     # Exception values display the exception as a string
     value = value.to_s
     
-    # Update the text in this section
-    section.text = value
+    # Update the html in this section
+    # TODO: Move the formatter into another class.
+    section.html = value.gsub("\n", "<br />\n")
   end
 
   def remove

data/lib/volt/page/targets/attribute_section.rb

@@ -14,6 +14,10 @@ class AttributeSection
     set_content_and_rezero_bindings(text, {})
   end
   
+  def html=(value)
+    set_content_and_rezero_bindings(value, {})
+  end
+  
 	# Takes in our html and bindings, and rezero's the comment names, and the
 	# bindings.  Returns an updated bindings hash
 	def set_content_and_rezero_bindings(html, bindings)

data/lib/volt/page/targets/dom_section.rb

@@ -21,6 +21,10 @@ class DomSection < BaseSection
       this.$range().insertNode(document.createTextNode(#{value}));
     }
   end
+  
+  def html=(value)
+    set_content_and_rezero_bindings(value, {})
+  end
 
   def remove
     range = self.range()
@@ -69,9 +73,11 @@ class DomSection < BaseSection
     %x{
       temp_div = document.createElement('div');
       var doc = jQuery.parseHTML(html);
-  
-      for (var i=0;i < doc.length;i++) {
-        temp_div.appendChild(doc[i]);
+      
+      if (doc) {
+        for (var i=0;i < doc.length;i++) {
+          temp_div.appendChild(doc[i]);
+        }
       }
     }
 

data/templates/project/app/home/controllers/index_controller.rb

@@ -3,5 +3,7 @@ class IndexController < ModelController
 
   def initialize
     super
+    
+    # Add controller setup code here
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: volt
 version: !ruby/object:Gem::Version
-  version: 0.4.12
+  version: 0.4.14
 platform: ruby
 authors:
 - Ryan Stout
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-28 00:00:00.000000000 Z
+date: 2014-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor