blobject 0.3.7 → 0.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 708992c07f068c79b12ba29d62268cdf002e0eb2
+  data.tar.gz: bbeef31664ae8ab9dced3e8db1ea2ccb06f26f41
+SHA512:
+  metadata.gz: bdafb48ddfdb1bffd175e7374b4a19e27ac0de26fae8e0f654ccf12768057a2a8069425eb2fc3d8a24e77525897dea0f9a1b07a1d53c2d31a29e66345c965cdb
+  data.tar.gz: 5c474f2ec4bb07a7090f23641763d490fdac826a0ed009594410e149eac2951d60e2398c9ac351ebc965465209860dfcfbb467054e24a7816e827ac827733241

data/.pryrc

@@ -1,7 +1,4 @@
-$:.push File.expand_path('../lib', __FILE__)
-require 'debugger'
-require 'blobject'
-
-def reload!
-  load 'blobject.rb'
-end
+Pry.commands.alias_command 'c', 'continue'
+Pry.commands.alias_command 's', 'step'
+Pry.commands.alias_command 'n', 'next'
+Pry.commands.alias_command '...', 'whereami'

data/.yardopts

@@ -0,0 +1,2 @@
+--markup markdown
+--readme README.markdown

data/Gemfile.lock

@@ -1,42 +1,36 @@
 PATH
   remote: .
   specs:
-    blobject (0.3.6)
+    blobject (0.4.0)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    ansi (1.4.2)
-    builder (3.0.0)
-    coderay (1.0.6)
-    columnize (0.3.6)
-    debugger (1.1.3)
-      columnize (>= 0.3.1)
-      debugger-linecache (~> 1.1.1)
-      debugger-ruby_core_source (~> 1.1.2)
-    debugger-linecache (1.1.1)
-      debugger-ruby_core_source (>= 1.1.1)
-    debugger-ruby_core_source (1.1.3)
-    method_source (0.7.1)
-    minitest (3.0.1)
-    minitest-reporters (0.7.1)
+    ansi (1.4.3)
+    builder (3.2.2)
+    coderay (1.1.0)
+    method_source (0.8.2)
+    minitest (5.3.3)
+    minitest-reporters (1.0.3)
       ansi
       builder
-      minitest (>= 2.0, < 4.0)
+      minitest (>= 5.0)
       ruby-progressbar
-    pry (0.9.9.6)
-      coderay (~> 1.0.5)
-      method_source (~> 0.7.1)
-      slop (>= 2.4.4, < 3)
-    ruby-progressbar (0.0.10)
-    slop (2.4.4)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    pry-nav (0.2.3)
+      pry (~> 0.9.10)
+    ruby-progressbar (1.4.2)
+    slop (3.5.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   blobject!
-  debugger
   minitest
   minitest-reporters
   pry
+  pry-nav

data/README.markdown

@@ -1,10 +1,50 @@
-![](https://github.com/sjltaylor/blobject/raw/master/assets/blobject.png)
-![](https://github.com/sjltaylor/blobject/raw/master/assets/blob_defn.png)
+![](https://github.com/sjltaylor/blobject/raw/master/assets/blobject.png)    
 
-Getting started: `http://sjltaylor.com/blobject'
+Rdocs: [http://sjltaylor.github.com/blobject](http://sjltaylor.github.com/blobject)
 
 ## About
 
+Consider the following json sample...
+
+    {
+      "device_id": 63354,
+      "channel_no": 6,
+      "interval_ms": 15000,
+      "readings": [
+        {
+          "value": 14232,
+          "time": 1339880802
+        },
+        {
+          "value": 14232,
+          "time": 1339880817
+        }
+      ],
+      "calibration": {
+        "staff": {
+          "name": {
+            "first": "Carl",
+            "middle_initial": "I",
+            "second": "Brator"
+          }
+        },
+        "last_calibration": "2010-06-16T22:06:42+01:00"
+      }
+    }
+
+Blobject let's you do this (complete code listing, no predefined data structures):
+
+
+    data = Blobject.from_json HTTParty.get('https://raw.github.com/sjltaylor/blobject/master/spec/sample_data/sample3.json')
+    
+    full_name = "#{data.calibration.staff.name.first}#{data.calibration.staff.name.middle_initial}#{data.calibration.staff.name.second}".capitalize
+      => "Calibrator"
+
+    last_reading = data.readings.last.value if data.readings?
+      => 14232
+
+
+Blobject is convenient to creating json payloads too.
 Blobjects are *freeform* which means you can do this...
 
     data = Blobject.new
@@ -68,6 +108,23 @@ You can work with JSON data using `Blobject.from_json` and `Blobject#to_json`, i
 
 You can work with YAML data using `Blobject.from_yaml` and `Blobject#to_yaml`.
 
+## Try it out...
+
+1. Install the gem (ruby 1.9.2+ required): `sh <(curl https://raw.github.com/sjltaylor/blobject/master/try_blobject.sh)`
+2. Load data from an api...
+    payload = Blobject.from_json HTTParty.get('https://raw.github.com/sjltaylor/blobject/master/spec/sample_data/sample3.json')
+3. Inspect it
+    payload.calibration.staff.name
+    => {:first=>"Carl", :middle_initial=>"I", :second=>"Brator"}
+4. Test for optional data members
+    payload.channel_no?
+      => true
+    payload.something_that_is_not_there?
+      => false
+5. Draw your own payload
+    mine = Blobject.new my: {data: 123}
+    mine.to_json
+      => "{\"my\":{\"data\":123}}"
 
 ## Used for Configuration
 
@@ -104,7 +161,7 @@ Using a blobject we can easily avoid having to refactor our code...
     end
 
 
-## Serializing & Deserializing
+## Serialization
 
 Blobjects can be used to easily build complex payloads.
 
@@ -209,3 +266,6 @@ THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR I
 
 Copyright (c) 2012 Sam Taylor. See LICENSE.txt for
 further details.
+
+![](https://github.com/sjltaylor/blobject/raw/master/assets/blob_defn.png)
+

data/blobject.gemspec

@@ -13,12 +13,12 @@ Gem::Specification.new do |s|
   s.description = %q{Blobject provides a free flowing syntax for creating blobs of data.}
 
   s.rubyforge_project = "blobject"
-  
+
   s.add_development_dependency 'minitest'
   s.add_development_dependency 'minitest-reporters'
   s.add_development_dependency 'pry'
-  s.add_development_dependency 'debugger'
-  
+  s.add_development_dependency 'pry-nav'
+
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }

data/doc/Blobject.html

@@ -103,8 +103,7 @@
 
 <h2>Overview</h2><div class="docstring">
   <div class="discussion">
-    
-<p>Wraps a hash to provide arbitrarily nested, object-style attribute access</p>
+    <p>Wraps a hash to provide arbitrarily nested object-style attribute access</p>
 
 
   </div>
@@ -120,9 +119,8 @@
         <dt id="ProhibitedNames-constant" class="">ProhibitedNames =
           <div class="docstring">
   <div class="discussion">
-    
-<p>filter :to_ary else Blobject#to_ary returns a blobject which is not cool,
-especially if you are puts.</p>
+    <p>filter :to<em>ary else Blobject#to</em>ary returns a
+blobject which is not cool, especially if you are puts.</p>
 
 
   </div>
@@ -135,9 +133,19 @@ especially if you are puts.</p>
         <dd><pre class="code"><span class='lbracket'>[</span><span class='symbol'>:to_ary</span><span class='rbracket'>]</span></pre></dd>
       
         <dt id="VERSION-constant" class="">VERSION =
-          
+          <div class="docstring">
+  <div class="discussion">
+    <p>semver gem version</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div>
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>0.3.3</span><span class='tstring_end'>'</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>0.3.8</span><span class='tstring_end'>'</span></span></pre></dd>
       
     </dl>
   
@@ -173,9 +181,7 @@ especially if you are puts.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>get a Blobject from a json string if the yaml string describes an array, an
-array will be returned.</p>
+    <span class="summary_desc"><div class='inline'><p>get a Blobject from a json string, if the yaml string describes an array, an array will be returned.</p>
 </div></span>
   
 </li>
@@ -198,9 +204,7 @@ array will be returned.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>get a Blobject from a yaml string if the yaml string describes an array, an
-array will be returned.</p>
+    <span class="summary_desc"><div class='inline'><p>get a Blobject from a yaml string, if the yaml string describes an array, an array will be returned.</p>
 </div></span>
   
 </li>
@@ -232,8 +236,7 @@ array will be returned.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>compares Blobjects to Blobjects or Hashes.</p>
+    <span class="summary_desc"><div class='inline'><p>compares Blobjects to Blobjects or Hashes for equality.</p>
 </div></span>
   
 </li>
@@ -256,8 +259,7 @@ array will be returned.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>hash-like access to the Blobject's attributes.</p>
+    <span class="summary_desc"><div class='inline'><p>hash-like access to the Blobject&#39;s attributes.</p>
 </div></span>
   
 </li>
@@ -280,8 +282,7 @@ array will be returned.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>hash-like attribtue setter.</p>
+    <span class="summary_desc"><div class='inline'><p>hash-like attribute setter.</p>
 </div></span>
   
 </li>
@@ -304,8 +305,30 @@ array will be returned.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>returns a hash which can be serialized as json.</p>
+    <span class="summary_desc"><div class='inline'><p>for rails: <code>render json: blobject</code>.</p>
+</div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#empty%3F-instance_method" title="#empty? (instance method)">- (Boolean) <strong>empty?</strong> </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>indicates whether the blobject contains any data.</p>
 </div></span>
   
 </li>
@@ -328,8 +351,30 @@ array will be returned.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>freeze a Blobject to prevent it being modified.</p>
+    <span class="summary_desc"><div class='inline'><p>freeze a Blobject to prevent it being modified.</p>
+</div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#freeze_r-instance_method" title="#freeze_r (instance method)">- (Object) <strong>freeze_r</strong> </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>recursively freeze the Blobject include nest Blobjects in arrays.</p>
 </div></span>
   
 </li>
@@ -352,8 +397,7 @@ array will be returned.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>access the internal hash.</p>
+    <span class="summary_desc"><div class='inline'><p>access the internal hash.</p>
 </div></span>
   
 </li>
@@ -378,9 +422,8 @@ array will be returned.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>pass an optional hash of values to preload you can also pass a block, the
-new Blobject will be yield.</p>
+    <span class="summary_desc"><div class='inline'><p>pass an optional hash of values to preload
+you can also pass a block, the new Blobject will be yield.</p>
 </div></span>
   
 </li>
@@ -403,8 +446,7 @@ new Blobject will be yield.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>delegates to the internal Hash.</p>
+    <span class="summary_desc"><div class='inline'><p>delegates to the internal Hash.</p>
 </div></span>
   
 </li>
@@ -427,8 +469,7 @@ new Blobject will be yield.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>method_missing is only called the first time an attribute is used.</p>
+    <span class="summary_desc"><div class='inline'><p>method_missing is only called the first time an attribute is used.</p>
 </div></span>
   
 </li>
@@ -473,8 +514,7 @@ new Blobject will be yield.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>creates a recursive copy of the internal hash.</p>
+    <span class="summary_desc"><div class='inline'><p>creates a recursive copy of the internal hash.</p>
 </div></span>
   
 </li>
@@ -497,8 +537,7 @@ new Blobject will be yield.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>serialize the Blobject as a json string.</p>
+    <span class="summary_desc"><div class='inline'><p>serialize the Blobject as a json string.</p>
 </div></span>
   
 </li>
@@ -521,8 +560,7 @@ new Blobject will be yield.</p>
   
 
   
-    <span class="summary_desc"><div class='inline'>
-<p>serialize the Blobject as a yaml string.</p>
+    <span class="summary_desc"><div class='inline'><p>serialize the Blobject as a yaml string.</p>
 </div></span>
   
 </li>
@@ -545,9 +583,8 @@ new Blobject will be yield.</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>pass an optional hash of values to preload you can also pass a block, the
-new Blobject will be yield</p>
+    <p>pass an optional hash of values to preload
+you can also pass a block, the new Blobject will be yield</p>
 
 
   </div>
@@ -580,8 +617,7 @@ new Blobject will be yield</p>
       
       
         &mdash;
-        <div class='inline'>
-<p>the object that the method was called on</p>
+        <div class='inline'><p>the object that the method was called on</p>
 </div>
       
     </li>
@@ -608,32 +644,22 @@ new Blobject will be yield</p>
 25
 26
 27
-28
-29
-30
-31
-32
-33</pre>
+28</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 14</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span> <span class='id identifier rubyid_hash'>hash</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
 
-  <span class='ivar'>@hash</span> <span class='op'>=</span> <span class='id identifier rubyid_hash'>hash</span>
+  <span class='ivar'>@hash</span> <span class='op'>=</span> <span class='const'>Hash</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
 
-  <span class='ivar'>@hash</span><span class='period'>.</span><span class='id identifier rubyid_keys'>keys</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_key'>key</span><span class='op'>|</span>
-    <span class='kw'>unless</span> <span class='id identifier rubyid_key'>key</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>&lt;=</span> <span class='const'>Symbol</span>
-      <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='ivar'>@hash</span><span class='period'>.</span><span class='id identifier rubyid_delete'>delete</span> <span class='id identifier rubyid_key'>key</span>
-      <span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_key'>key</span><span class='period'>.</span><span class='id identifier rubyid_to_sym'>to_sym</span>
-      <span class='ivar'>@hash</span><span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_value'>value</span>
-    <span class='kw'>end</span>
+  <span class='id identifier rubyid_hash'>hash</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='op'>|</span>
+    <span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_key'>key</span><span class='period'>.</span><span class='id identifier rubyid_to_sym'>to_sym</span> <span class='kw'>unless</span> <span class='id identifier rubyid_key'>key</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span> <span class='const'>Symbol</span>
+    <span class='ivar'>@hash</span><span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_value'>value</span>
   <span class='kw'>end</span>
 
-  <span class='id identifier rubyid___visit_subtree__'>__visit_subtree__</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_node'>node</span><span class='op'>|</span>
-    <span class='kw'>if</span> <span class='id identifier rubyid_node'>node</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>&lt;=</span> <span class='const'>Hash</span>
-      <span class='ivar'>@hash</span><span class='lbracket'>[</span><span class='id identifier rubyid_name'>name</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='const'>Blobject</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span> <span class='id identifier rubyid_node'>node</span>
-    <span class='kw'>end</span>
+  <span class='ivar'>@hash</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_node'>node</span><span class='op'>|</span>
+    <span class='ivar'>@hash</span><span class='lbracket'>[</span><span class='id identifier rubyid_name'>name</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='symbol'>:__blobjectify__</span><span class='comma'>,</span> <span class='id identifier rubyid_node'>node</span><span class='rparen'>)</span>
   <span class='kw'>end</span>
 
   <span class='kw'>yield</span> <span class='kw'>self</span> <span class='kw'>if</span> <span class='id identifier rubyid_block_given?'>block_given?</span>
@@ -662,9 +688,8 @@ new Blobject will be yield</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>method_missing is only called the first time an attribute is used.
-successive calls use memoized getters, setters and checkers</p>
+    <p>method_missing is only called the first time an attribute is used. successive calls use
+memoized getters, setters and checkers</p>
 
 
   </div>
@@ -718,7 +743,8 @@ successive calls use memoized getters, setters and checkers</p>
 96
 97
 98
-99</pre>
+99
+100</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 59</span>
@@ -731,13 +757,14 @@ successive calls use memoized getters, setters and checkers</p>
   <span class='comment'># assignment in conditionals is usually a bad smell, here it helps minimize regex matching
 </span>  <span class='kw'>when</span> <span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='id identifier rubyid_method'>method</span><span class='lbracket'>[</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^\w+$</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='int'>0</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_params'>params</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span> <span class='op'>==</span> <span class='int'>0</span>
     <span class='comment'># the call is an attribute reader
-</span>    <span class='kw'>return</span> <span class='kw'>nil</span> <span class='kw'>if</span> <span class='id identifier rubyid_frozen?'>frozen?</span> <span class='kw'>and</span> <span class='kw'>not</span> <span class='ivar'>@hash</span><span class='period'>.</span><span class='id identifier rubyid_has_key?'>has_key?</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='rparen'>)</span>
-
+</span>    
+    <span class='kw'>return</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span> <span class='kw'>if</span> <span class='id identifier rubyid_frozen?'>frozen?</span> <span class='kw'>and</span> <span class='kw'>not</span> <span class='ivar'>@hash</span><span class='period'>.</span><span class='id identifier rubyid_has_key?'>has_key?</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='rparen'>)</span>
     <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span> <span class='symbol'>:__define_attribute__</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span>
 
     <span class='kw'>return</span> <span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='ivar'>@hash</span><span class='period'>.</span><span class='id identifier rubyid_has_key?'>has_key?</span> <span class='id identifier rubyid_method'>method</span>
 
-    <span class='id identifier rubyid_parent'>parent</span>          <span class='op'>=</span> <span class='kw'>self</span>
+    <span class='comment'># close the scope for storing call chain
+</span>    <span class='id identifier rubyid_parent'>parent</span>          <span class='op'>=</span> <span class='kw'>self</span>
     <span class='id identifier rubyid_nested_blobject'>nested_blobject</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
 
     <span class='id identifier rubyid_store_in_parent'>store_in_parent</span> <span class='op'>=</span> <span class='id identifier rubyid_lambda'>lambda</span> <span class='kw'>do</span>
@@ -787,9 +814,7 @@ successive calls use memoized getters, setters and checkers</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>get a Blobject from a json string if the yaml string describes an array, an
-array will be returned</p>
+    <p>get a Blobject from a json string, if the yaml string describes an array, an array will be returned</p>
 
 
   </div>
@@ -803,17 +828,17 @@ array will be returned</p>
       <pre class="lines">
 
 
-159
-160
-161
-162</pre>
+164
+165
+166
+167</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 159</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 164</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_from_json'>from_json</span> <span class='id identifier rubyid_json'>json</span>
   
-  <span class='id identifier rubyid___from_hash_or_array__'>__from_hash_or_array__</span><span class='lparen'>(</span><span class='const'>JSON</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='id identifier rubyid_json'>json</span><span class='rparen'>)</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid___blobjectify__'>__blobjectify__</span><span class='lparen'>(</span><span class='const'>JSON</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='id identifier rubyid_json'>json</span><span class='rparen'>)</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -831,9 +856,7 @@ array will be returned</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>get a Blobject from a yaml string if the yaml string describes an array, an
-array will be returned</p>
+    <p>get a Blobject from a yaml string, if the yaml string describes an array, an array will be returned</p>
 
 
   </div>
@@ -847,17 +870,17 @@ array will be returned</p>
       <pre class="lines">
 
 
-166
-167
-168
-169</pre>
+170
+171
+172
+173</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 166</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 170</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_from_yaml'>from_yaml</span> <span class='id identifier rubyid_yaml'>yaml</span>
   
-  <span class='id identifier rubyid___from_hash_or_array__'>__from_hash_or_array__</span><span class='lparen'>(</span><span class='const'>YAML</span><span class='period'>.</span><span class='id identifier rubyid_load'>load</span><span class='lparen'>(</span><span class='id identifier rubyid_yaml'>yaml</span><span class='rparen'>)</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid___blobjectify__'>__blobjectify__</span><span class='lparen'>(</span><span class='const'>YAML</span><span class='period'>.</span><span class='id identifier rubyid_load'>load</span><span class='lparen'>(</span><span class='id identifier rubyid_yaml'>yaml</span><span class='rparen'>)</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -881,8 +904,7 @@ array will be returned</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>compares Blobjects to Blobjects or Hashes</p>
+    <p>compares Blobjects to Blobjects or Hashes for equality</p>
 
 
   </div>
@@ -896,14 +918,14 @@ array will be returned</p>
       <pre class="lines">
 
 
-114
 115
 116
 117
-118</pre>
+118
+119</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 114</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 115</span>
 
 <span class='kw'>def</span> <span class='op'>==</span> <span class='id identifier rubyid_other'>other</span>
   <span class='kw'>return</span> <span class='ivar'>@hash</span> <span class='op'>==</span> <span class='id identifier rubyid_other'>other</span><span class='period'>.</span><span class='id identifier rubyid_hash'>hash</span> <span class='kw'>if</span> <span class='id identifier rubyid_other'>other</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>&lt;=</span> <span class='const'>Blobject</span>
@@ -926,8 +948,7 @@ array will be returned</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>hash-like access to the Blobject's attributes</p>
+    <p>hash-like access to the Blobject&#39;s attributes</p>
 
 
   </div>
@@ -941,13 +962,13 @@ array will be returned</p>
       <pre class="lines">
 
 
-121
 122
 123
-124</pre>
+124
+125</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 121</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 122</span>
 
 <span class='kw'>def</span> <span class='op'>[]</span> <span class='id identifier rubyid_name'>name</span>
   
@@ -969,8 +990,7 @@ array will be returned</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>hash-like attribtue setter</p>
+    <p>hash-like attribute setter</p>
 
 
   </div>
@@ -984,13 +1004,13 @@ array will be returned</p>
       <pre class="lines">
 
 
-127
 128
 129
-130</pre>
+130
+131</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 127</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 128</span>
 
 <span class='kw'>def</span> <span class='op'>[]=</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span>
   
@@ -1012,9 +1032,7 @@ array will be returned</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>returns a hash which can be serialized as json. this is for use in rails
-controllers: `render json: blobject`</p>
+    <p>for rails: <code>render json: blobject</code></p>
 
 
   </div>
@@ -1028,13 +1046,13 @@ controllers: `render json: blobject`</p>
       <pre class="lines">
 
 
-141
-142
-143
-144</pre>
+147
+148
+149
+150</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 141</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 147</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_as_json'>as_json</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_hash'>hash</span><span class='period'>.</span><span class='id identifier rubyid_as_json'>as_json</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_hash'>hash</span><span class='period'>.</span><span class='id identifier rubyid_respond_to?'>respond_to?</span> <span class='symbol'>:as_json</span>
@@ -1043,6 +1061,59 @@ controllers: `render json: blobject`</p>
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="empty?-instance_method">
+  
+    - (<tt>Boolean</tt>) <strong>empty?</strong> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>indicates whether the blobject contains any data</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Boolean</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+31
+32
+33</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 31</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_empty?'>empty?</span>
+  <span class='ivar'>@hash</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -1056,8 +1127,7 @@ controllers: `render json: blobject`</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>freeze a Blobject to prevent it being modified</p>
+    <p>freeze a Blobject to prevent it being modified</p>
 
 
   </div>
@@ -1071,23 +1141,63 @@ controllers: `render json: blobject`</p>
       <pre class="lines">
 
 
-133
 134
 135
 136
 137</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 133</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 134</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_freeze'>freeze</span>
-  <span class='id identifier rubyid___visit_subtree__'>__visit_subtree__</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_node'>node</span><span class='op'>|</span> <span class='id identifier rubyid_node'>node</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span> <span class='rbrace'>}</span>
   <span class='ivar'>@hash</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span>
   <span class='kw'>super</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="freeze_r-instance_method">
+  
+    - (<tt>Object</tt>) <strong>freeze_r</strong> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>recursively freeze the Blobject include nest Blobjects in arrays</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+140
+141
+142
+143</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 140</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_freeze_r'>freeze_r</span>
+  <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='symbol'>:__freeze_r__</span><span class='comma'>,</span> <span class='kw'>self</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_freeze'>freeze</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -1101,8 +1211,7 @@ controllers: `render json: blobject`</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>access the internal hash. be careful, this is <em>not</em> a copy</p>
+    <p>access the internal hash. be careful, this is <em>not</em> a copy</p>
 
 
   </div>
@@ -1144,8 +1253,7 @@ controllers: `render json: blobject`</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>delegates to the internal Hash</p>
+    <p>delegates to the internal Hash</p>
 
 
   </div>
@@ -1213,7 +1321,6 @@ controllers: `render json: blobject`</p>
       <pre class="lines">
 
 
-101
 102
 103
 104
@@ -1223,10 +1330,11 @@ controllers: `render json: blobject`</p>
 108
 109
 110
-111</pre>
+111
+112</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 101</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 102</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_respond_to?'>respond_to?</span> <span class='id identifier rubyid_method'>method</span>
   
@@ -1255,8 +1363,7 @@ controllers: `render json: blobject`</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>creates a recursive copy of the internal hash</p>
+    <p>creates a recursive copy of the internal hash</p>
 
 
   </div>
@@ -1285,7 +1392,7 @@ controllers: `render json: blobject`</p>
 <span class='kw'>def</span> <span class='id identifier rubyid_to_hash'>to_hash</span>
   
   <span class='id identifier rubyid_h'>h</span> <span class='op'>=</span> <span class='id identifier rubyid_hash'>hash</span><span class='period'>.</span><span class='id identifier rubyid_dup'>dup</span>
-  <span class='id identifier rubyid___visit_subtree__'>__visit_subtree__</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_node'>node</span><span class='op'>|</span>
+  <span class='ivar'>@hash</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_node'>node</span><span class='op'>|</span>
     <span class='id identifier rubyid_h'>h</span><span class='lbracket'>[</span><span class='id identifier rubyid_name'>name</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_node'>node</span><span class='period'>.</span><span class='id identifier rubyid_to_hash'>to_hash</span> <span class='kw'>if</span> <span class='id identifier rubyid_node'>node</span><span class='period'>.</span><span class='id identifier rubyid_respond_to?'>respond_to?</span> <span class='symbol'>:to_hash</span>
   <span class='kw'>end</span>
   <span class='id identifier rubyid_h'>h</span>
@@ -1306,8 +1413,7 @@ controllers: `render json: blobject`</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>serialize the Blobject as a json string</p>
+    <p>serialize the Blobject as a json string</p>
 
 
   </div>
@@ -1321,12 +1427,12 @@ controllers: `render json: blobject`</p>
       <pre class="lines">
 
 
-147
-148
-149</pre>
+153
+154
+155</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 147</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 153</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_json'>to_json</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span>
   <span class='id identifier rubyid_as_json'>as_json</span><span class='period'>.</span><span class='id identifier rubyid_to_json'>to_json</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span>
@@ -1347,8 +1453,7 @@ controllers: `render json: blobject`</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    
-<p>serialize the Blobject as a yaml string</p>
+    <p>serialize the Blobject as a yaml string</p>
 
 
   </div>
@@ -1362,13 +1467,13 @@ controllers: `render json: blobject`</p>
       <pre class="lines">
 
 
-152
-153
-154
-155</pre>
+158
+159
+160
+161</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 152</span>
+      <pre class="code"><span class="info file"># File 'lib/blobject.rb', line 158</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_yaml'>to_yaml</span>
   
@@ -1384,7 +1489,7 @@ controllers: `render json: blobject`</p>
 </div>
 
     <div id="footer">
-  Generated on Thu Jun  7 00:25:32 2012 by
+  Generated on Sun Jun 17 00:20:42 2012 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.1 (ruby-1.9.3).
 </div>