box-api 0.1.9 → 0.2.0

data/doc/Box/Item.html

@@ -6,7 +6,7 @@
 <title>
   Class: Box::Item
   
-    &mdash; Documentation by YARD 0.7.2
+    &mdash; Documentation by YARD 0.7.3
   
 </title>
 
@@ -94,18 +94,18 @@
 
 <h2>Overview</h2><div class="docstring">
   <div class="discussion">
-    <p>
-Represents a folder or file stored on Box. Any attributes or actions
+    
+<p>Represents a folder or file stored on Box. Any attributes or actions
 typical to a Box item can be accessed through this class. The <span class='object_link'><a href="" title="Box::Item (class)">Item</a></span> class
 contains only methods shared by <span class='object_link'><a href="Folder.html" title="Box::Folder (class)">Folder</a></span> and <span class='object_link'><a href="File.html" title="Box::File (class)">File</a></span>, and should not be
-instanciated directly.
-</p>
+instanciated directly.</p>
 
 
   </div>
 </div>
 <div class="tags">
   
+
 </div><div id="subclasses">
   <h2>Direct Known Subclasses</h2>
   <p class="children"><span class='object_link'><a href="File.html" title="Box::File (class)">File</a></span>, <span class='object_link'><a href="Folder.html" title="Box::Folder (class)">Folder</a></span></p>
@@ -134,9 +134,8 @@ instanciated directly.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a></span> used by this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a></span> used by this item.</p>
 </div></span>
   
 </li>
@@ -161,9 +160,8 @@ The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-The hash of info for this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>The hash of info for this item.</p>
 </div></span>
   
 </li>
@@ -188,9 +186,8 @@ The hash of info for this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-The parent of this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>The parent of this item.</p>
 </div></span>
   
 </li>
@@ -225,9 +222,8 @@ The parent of this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-The string representation of this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>The string representation of this item.</p>
 </div></span>
   
 </li>
@@ -249,9 +245,8 @@ The string representation of this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-The plural string representation of this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>The plural string representation of this item.</p>
 </div></span>
   
 </li>
@@ -282,9 +277,8 @@ The plural string representation of this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Copy this item to the destination folder.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Copy this item to the destination folder.</p>
 </div></span>
   
 </li>
@@ -306,9 +300,8 @@ Copy this item to the destination folder.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Delete this item and all sub-items.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Delete this item and all sub-items.</p>
 </div></span>
   
 </li>
@@ -317,7 +310,7 @@ Delete this item and all sub-items.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#description-instance_method" title="#description (instance method)">- (Item) <strong>description</strong>(message) </a>
+      <a href="#force_cached_info-instance_method" title="#force_cached_info (instance method)">- (Object) <strong>force_cached_info</strong> </a>
     
 
     
@@ -330,9 +323,8 @@ Delete this item and all sub-items.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Set the description of this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Consider the item cached.</p>
 </div></span>
   
 </li>
@@ -341,7 +333,7 @@ Set the description of this item.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#force_cached_info-instance_method" title="#force_cached_info (instance method)">- (Object) <strong>force_cached_info</strong> </a>
+      <a href="#id-instance_method" title="#id (instance method)">- (String) <strong>id</strong> </a>
     
 
     
@@ -354,9 +346,8 @@ Set the description of this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Consider the item cached.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>The id of this item.</p>
 </div></span>
   
 </li>
@@ -365,7 +356,7 @@ Consider the item cached.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#id-instance_method" title="#id (instance method)">- (String) <strong>id</strong> </a>
+      <a href="#info-instance_method" title="#info (instance method)">- (Item) <strong>info</strong>(refresh = false) </a>
     
 
     
@@ -378,9 +369,8 @@ Consider the item cached.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-The id of this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Get the info for this item.</p>
 </div></span>
   
 </li>
@@ -389,12 +379,14 @@ The id of this item.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#info-instance_method" title="#info (instance method)">- (Item) <strong>info</strong>(refresh = false) </a>
+      <a href="#initialize-instance_method" title="#initialize (instance method)">- (Item) <strong>initialize</strong>(api, parent, info) </a>
     
 
     
   </span>
   
+    <span class="note title constructor">constructor</span>
+  
   
   
   
@@ -402,9 +394,8 @@ The id of this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Get the info for this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Create a new item representing either a file or folder.</p>
 </div></span>
   
 </li>
@@ -413,24 +404,44 @@ Get the info for this item.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#initialize-instance_method" title="#initialize (instance method)">- (Item) <strong>initialize</strong>(api, parent, info) </a>
+      <a href="#method_missing-instance_method" title="#method_missing (instance method)">- (Object) <strong>method_missing</strong>(sym, *args, &amp;block) </a>
     
 
     
   </span>
   
-    <span class="note title constructor">constructor</span>
   
   
   
   
   
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>Provides an easy way to access this item's info.</p>
+</div></span>
   
+</li>
 
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#move-instance_method" title="#move (instance method)">- (Item) <strong>move</strong>(destination) </a>
+    
+
+    
+  </span>
   
-    <span class="summary_desc"><div class='inline'><p>
-Create a new item representing either a file or folder.
-</p>
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>Move this item to the destination folder.</p>
 </div></span>
   
 </li>
@@ -439,7 +450,7 @@ Create a new item representing either a file or folder.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#method_missing-instance_method" title="#method_missing (instance method)">- (Object) <strong>method_missing</strong>(sym, *args, &amp;block) </a>
+      <a href="#path-instance_method" title="#path (instance method)">- (String) <strong>path</strong> </a>
     
 
     
@@ -452,9 +463,8 @@ Create a new item representing either a file or folder.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Provides an easy way to access this item&#8217;s info.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>The path of this item.</p>
 </div></span>
   
 </li>
@@ -463,7 +473,7 @@ Provides an easy way to access this item&#8217;s info.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#move-instance_method" title="#move (instance method)">- (Item) <strong>move</strong>(destination) </a>
+      <a href="#rename-instance_method" title="#rename (instance method)">- (Item) <strong>rename</strong>(new_name) </a>
     
 
     
@@ -476,9 +486,8 @@ Provides an easy way to access this item&#8217;s info.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Move this item to the destination folder.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Rename this item.</p>
 </div></span>
   
 </li>
@@ -487,7 +496,7 @@ Move this item to the destination folder.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#path-instance_method" title="#path (instance method)">- (String) <strong>path</strong> </a>
+      <a href="#respond_to%3F-instance_method" title="#respond_to? (instance method)">- (Boolean) <strong>respond_to?</strong>(sym) </a>
     
 
     
@@ -500,9 +509,8 @@ Move this item to the destination folder.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-The path of this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Handles some cases in method_missing, but won't always be accurate.</p>
 </div></span>
   
 </li>
@@ -511,7 +519,7 @@ The path of this item.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#rename-instance_method" title="#rename (instance method)">- (Item) <strong>rename</strong>(new_name) </a>
+      <a href="#set_description-instance_method" title="#set_description (instance method)">- (Item) <strong>set_description</strong>(message) </a>
     
 
     
@@ -524,9 +532,8 @@ The path of this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Rename this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Set the description of this item.</p>
 </div></span>
   
 </li>
@@ -548,9 +555,8 @@ Rename this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-The string representation of this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>The string representation of this item.</p>
 </div></span>
   
 </li>
@@ -572,9 +578,8 @@ The string representation of this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-The plural string representation of this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>The plural string representation of this item.</p>
 </div></span>
   
 </li>
@@ -595,9 +600,8 @@ The plural string representation of this item.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Create a new item representing either a file or folder.
-</p>
+    
+<p>Create a new item representing either a file or folder.</p>
 
 
   </div>
@@ -616,9 +620,8 @@ Create a new item representing either a file or folder.
       
       
         &mdash;
-        <div class='inline'><p>
-The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a></span> instance used to generate requests.
-</p>
+        <div class='inline'>
+<p>The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a></span> instance used to generate requests.</p>
 </div>
       
     </li>
@@ -633,9 +636,8 @@ The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a
       
       
         &mdash;
-        <div class='inline'><p>
-The <span class='object_link'><a href="Folder.html" title="Box::Folder (class)">Folder</a></span> parent of this item.
-</p>
+        <div class='inline'>
+<p>The <span class='object_link'><a href="Folder.html" title="Box::Folder (class)">Folder</a></span> parent of this item.</p>
 </div>
       
     </li>
@@ -650,31 +652,31 @@ The <span class='object_link'><a href="Folder.html" title="Box::Folder (class)">
       
       
         &mdash;
-        <div class='inline'><p>
-The hash of initial info for this item.
-</p>
+        <div class='inline'>
+<p>The hash of initial info for this item.</p>
 </div>
       
     </li>
   
 </ul>
 
+
 </div><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
 
 
-22
-23
 24
 25
 26
 27
-28</pre>
+28
+29
+30</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 22</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 24</span>
 
 <span class='kw'>def</span> <span class='id initialize'>initialize</span><span class='lparen'>(</span><span class='id api'>api</span><span class='comma'>,</span> <span class='id parent'>parent</span><span class='comma'>,</span> <span class='id info'>info</span><span class='rparen'>)</span>
   <span class='ivar'>@api</span> <span class='op'>=</span> <span class='id api'>api</span>
@@ -705,9 +707,8 @@ The hash of initial info for this item.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Provides an easy way to access this item&#8217;s info.
-</p>
+    
+<p>Provides an easy way to access this item's info.</p>
 
 
   </div>
@@ -722,14 +723,13 @@ Provides an easy way to access this item&#8217;s info.
     
   </div>
 
+
 </div><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
 
 
-137
-138
 139
 140
 141
@@ -745,21 +745,41 @@ Provides an easy way to access this item&#8217;s info.
 151
 152
 153
-154</pre>
+154
+155
+156
+157
+158
+159
+160
+161
+162
+163
+164
+165</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 137</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 139</span>
 
 <span class='kw'>def</span> <span class='id method_missing'>method_missing</span><span class='lparen'>(</span><span class='id sym'>sym</span><span class='comma'>,</span> <span class='op'>*</span><span class='id args'>args</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id block'>block</span><span class='rparen'>)</span>
   <span class='comment'># TODO: Why not symbols?
 </span>  <span class='comment'># convert to a string
 </span>  <span class='id str'>str</span> <span class='op'>=</span> <span class='id sym'>sym</span><span class='period'>.</span><span class='id to_s'>to_s</span>
 
+  <span class='comment'># determine whether to refresh the cache
+</span>  <span class='id refresh'>refresh</span> <span class='op'>=</span> <span class='id args'>args</span> <span class='op'>?</span> <span class='id args'>args</span><span class='period'>.</span><span class='id first'>first</span> <span class='op'>:</span> <span class='kw'>false</span>
+
   <span class='comment'># return the value if it already exists
-</span>  <span class='kw'>return</span> <span class='ivar'>@data</span><span class='lbracket'>[</span><span class='id str'>str</span><span class='rbracket'>]</span> <span class='kw'>if</span> <span class='ivar'>@data</span><span class='period'>.</span><span class='id key?'>key?</span><span class='lparen'>(</span><span class='id str'>str</span><span class='rparen'>)</span>
+</span>  <span class='kw'>return</span> <span class='ivar'>@data</span><span class='lbracket'>[</span><span class='id str'>str</span><span class='rbracket'>]</span> <span class='kw'>if</span> <span class='kw'>not</span> <span class='id refresh'>refresh</span> <span class='kw'>and</span> <span class='ivar'>@data</span><span class='period'>.</span><span class='id key?'>key?</span><span class='lparen'>(</span><span class='id str'>str</span><span class='rparen'>)</span>
 
   <span class='comment'># value didn't exist, so try to update the info
-</span>  <span class='kw'>self</span><span class='period'>.</span><span class='id info'>info</span>
+</span>  <span class='comment'># TODO: Figure out a good way to work with multiple sources.
+</span>  <span class='kw'>case</span> <span class='id str'>str</span>
+  <span class='kw'>when</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>comments</span><span class='tstring_end'>'</span></span>
+    <span class='kw'>self</span><span class='period'>.</span><span class='id get_comments'>get_comments</span>
+  <span class='kw'>when</span>
+    <span class='kw'>self</span><span class='period'>.</span><span class='id info'>info</span><span class='lparen'>(</span><span class='id refresh'>refresh</span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
 
   <span class='comment'># try returning the value again
 </span>  <span class='kw'>return</span> <span class='ivar'>@data</span><span class='lbracket'>[</span><span class='id str'>str</span><span class='rbracket'>]</span> <span class='kw'>if</span> <span class='ivar'>@data</span><span class='period'>.</span><span class='id key?'>key?</span><span class='lparen'>(</span><span class='id str'>str</span><span class='rparen'>)</span>
@@ -790,15 +810,15 @@ Provides an easy way to access this item&#8217;s info.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a></span> used by this item.
-</p>
+    
+<p>The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a></span> used by this item.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -809,9 +829,8 @@ The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a
       
       
         &mdash;
-        <div class='inline'><p>
-The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a></span> used by this item.
-</p>
+        <div class='inline'>
+<p>The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a></span> used by this item.</p>
 </div>
       
     </li>
@@ -824,12 +843,12 @@ The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a
       <pre class="lines">
 
 
-12
-13
-14</pre>
+14
+15
+16</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 12</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 14</span>
 
 <span class='kw'>def</span> <span class='id api'>api</span>
   <span class='ivar'>@api</span>
@@ -851,15 +870,15 @@ The <span class='object_link'><a href="Api.html" title="Box::Api (class)">Api</a
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-The hash of info for this item.
-</p>
+    
+<p>The hash of info for this item.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -870,9 +889,8 @@ The hash of info for this item.
       
       
         &mdash;
-        <div class='inline'><p>
-The hash of info for this item.
-</p>
+        <div class='inline'>
+<p>The hash of info for this item.</p>
 </div>
       
     </li>
@@ -885,12 +903,12 @@ The hash of info for this item.
       <pre class="lines">
 
 
-9
-10
-11</pre>
+11
+12
+13</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 9</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 11</span>
 
 <span class='kw'>def</span> <span class='id data'>data</span>
   <span class='ivar'>@data</span>
@@ -912,15 +930,15 @@ The hash of info for this item.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-The parent of this item.
-</p>
+    
+<p>The parent of this item.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -931,9 +949,8 @@ The parent of this item.
       
       
         &mdash;
-        <div class='inline'><p>
-The parent of this item.
-</p>
+        <div class='inline'>
+<p>The parent of this item.</p>
 </div>
       
     </li>
@@ -946,12 +963,12 @@ The parent of this item.
       <pre class="lines">
 
 
-15
-16
-17</pre>
+17
+18
+19</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 15</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 17</span>
 
 <span class='kw'>def</span> <span class='id parent'>parent</span>
   <span class='ivar'>@parent</span>
@@ -977,15 +994,15 @@ The parent of this item.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-The string representation of this item.
-</p>
+    
+<p>The string representation of this item.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -996,9 +1013,8 @@ The string representation of this item.
       
       
         &mdash;
-        <div class='inline'><p>
-The string representation of this item.
-</p>
+        <div class='inline'>
+<p>The string representation of this item.</p>
 </div>
       
     </li>
@@ -1011,10 +1027,10 @@ The string representation of this item.
       <pre class="lines">
 
 
-31</pre>
+33</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 31</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 33</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id type'>type</span><span class='semicolon'>;</span> <span class='id raise'>raise</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Overwrite this method</span><span class='tstring_end'>&quot;</span></span><span class='semicolon'>;</span> <span class='kw'>end</span></pre>
     </td>
@@ -1031,15 +1047,15 @@ The string representation of this item.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-The plural string representation of this item.
-</p>
+    
+<p>The plural string representation of this item.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -1050,9 +1066,8 @@ The plural string representation of this item.
       
       
         &mdash;
-        <div class='inline'><p>
-The plural string representation of this item.
-</p>
+        <div class='inline'>
+<p>The plural string representation of this item.</p>
 </div>
       
     </li>
@@ -1065,10 +1080,10 @@ The plural string representation of this item.
       <pre class="lines">
 
 
-34</pre>
+36</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 34</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 36</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id types'>types</span><span class='semicolon'>;</span> <span class='id type'>type</span> <span class='op'>+</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>s</span><span class='tstring_end'>'</span></span><span class='semicolon'>;</span> <span class='kw'>end</span></pre>
     </td>
@@ -1094,15 +1109,13 @@ The plural string representation of this item.
     
   <div class="note notetag">
     <strong>Note:</strong> 
-    <div class='inline'><p>
-Copying folders is not currently supported.
-</p>
+    <div class='inline'>
+<p>Copying folders is not currently supported.</p>
 </div>
   </div>
 
-<p>
-Copy this item to the destination folder.
-</p>
+
+<p>Copy this item to the destination folder.</p>
 
 
   </div>
@@ -1121,14 +1134,14 @@ Copy this item to the destination folder.
       
       
         &mdash;
-        <div class='inline'><p>
-The parent folder to copy the item to.
-</p>
+        <div class='inline'>
+<p>The parent folder to copy the item to.</p>
 </div>
       
     </li>
   
 </ul>
+
 <h3>Returns:</h3>
 <ul class="return">
   
@@ -1140,9 +1153,8 @@ The parent folder to copy the item to.
       
       
         &mdash;
-        <div class='inline'><p>
-The new copy of this item.
-</p>
+        <div class='inline'>
+<p>The new copy of this item.</p>
 </div>
       
     </li>
@@ -1155,16 +1167,16 @@ The new copy of this item.
       <pre class="lines">
 
 
-85
-86
 87
 88
 89
 90
-91</pre>
+91
+92
+93</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 85</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 87</span>
 
 <span class='kw'>def</span> <span class='id copy'>copy</span><span class='lparen'>(</span><span class='id destination'>destination</span><span class='rparen'>)</span>
   <span class='ivar'>@api</span><span class='period'>.</span><span class='id copy'>copy</span><span class='lparen'>(</span><span class='id type'>type</span><span class='comma'>,</span> <span class='id id'>id</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='period'>.</span><span class='id id'>id</span><span class='rparen'>)</span>
@@ -1187,18 +1199,17 @@ The new copy of this item.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Delete this item and all sub-items.
-</p>
-<p>
-TODO: Return nil instead
-</p>
+    
+<p>Delete this item and all sub-items.</p>
+
+<p>TODO: Return nil instead</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -1209,9 +1220,8 @@ TODO: Return nil instead
       
       
         &mdash;
-        <div class='inline'><p>
-self
-</p>
+        <div class='inline'>
+<p>self</p>
 </div>
       
     </li>
@@ -1224,17 +1234,17 @@ self
       <pre class="lines">
 
 
-109
-110
 111
 112
 113
 114
 115
-116</pre>
+116
+117
+118</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 109</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 111</span>
 
 <span class='kw'>def</span> <span class='id delete'>delete</span>
   <span class='ivar'>@api</span><span class='period'>.</span><span class='id delete'>delete</span><span class='lparen'>(</span><span class='id type'>type</span><span class='comma'>,</span> <span class='id id'>id</span><span class='rparen'>)</span>
@@ -1247,89 +1257,6 @@ self
     </td>
   </tr>
 </table>
-</div>
-    
-      <div class="method_details ">
-  <p class="signature " id="description-instance_method">
-  
-    - (<tt><span class='object_link'><a href="" title="Box::Item (class)">Item</a></span></tt>) <strong>description</strong>(message) 
-  
-
-  
-</p><div class="docstring">
-  <div class="discussion">
-    <p>
-Set the description of this item.
-</p>
-
-
-  </div>
-</div>
-<div class="tags">
-  <h3>Parameters:</h3>
-<ul class="param">
-  
-    <li>
-      
-        <span class='name'>message</span>
-      
-      
-        <span class='type'>(<tt>String</tt>)</span>
-      
-      
-      
-        &mdash;
-        <div class='inline'><p>
-The description message to use.
-</p>
-</div>
-      
-    </li>
-  
-</ul>
-<h3>Returns:</h3>
-<ul class="return">
-  
-    <li>
-      
-      
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Box::Item (class)">Item</a></span></tt>)</span>
-      
-      
-      
-        &mdash;
-        <div class='inline'><p>
-self
-</p>
-</div>
-      
-    </li>
-  
-</ul>
-
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-
-
-122
-123
-124
-125
-126</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 122</span>
-
-<span class='kw'>def</span> <span class='id description'>description</span><span class='lparen'>(</span><span class='id message'>message</span><span class='rparen'>)</span>
-  <span class='ivar'>@api</span><span class='period'>.</span><span class='id set_description'>set_description</span><span class='lparen'>(</span><span class='id type'>type</span><span class='comma'>,</span> <span class='id id'>id</span><span class='comma'>,</span> <span class='id message'>message</span><span class='rparen'>)</span>
-
-  <span class='kw'>self</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
 </div>
     
       <div class="method_details ">
@@ -1341,28 +1268,28 @@ self
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Consider the item cached. This prevents an additional api when we know the
-item is fully fetched.
-</p>
+    
+<p>Consider the item cached. This prevents an additional api when we know the
+item is fully fetched.</p>
 
 
   </div>
 </div>
 <div class="tags">
   
+
 </div><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
 
 
-158
-159
-160</pre>
+174
+175
+176</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 158</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 174</span>
 
 <span class='kw'>def</span> <span class='id force_cached_info'>force_cached_info</span>
   <span class='ivar'>@cached_info</span> <span class='op'>=</span> <span class='kw'>true</span>
@@ -1381,15 +1308,15 @@ item is fully fetched.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-The id of this item.
-</p>
+    
+<p>The id of this item.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -1400,9 +1327,8 @@ The id of this item.
       
       
         &mdash;
-        <div class='inline'><p>
-The id of this item.
-</p>
+        <div class='inline'>
+<p>The id of this item.</p>
 </div>
       
     </li>
@@ -1415,13 +1341,13 @@ The id of this item.
       <pre class="lines">
 
 
-45
-46
 47
-48</pre>
+48
+49
+50</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 45</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 47</span>
 
 <span class='kw'>def</span> <span class='id id'>id</span>
   <span class='comment'># overloads Object#id
@@ -1441,10 +1367,9 @@ The id of this item.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Get the info for this item. Uses a cached copy if avaliable, or else it is
-fetched from the api.
-</p>
+    
+<p>Get the info for this item. Uses a cached copy if avaliable, or else it is
+fetched from the api.</p>
 
 
   </div>
@@ -1465,14 +1390,14 @@ fetched from the api.
       
       
         &mdash;
-        <div class='inline'><p>
-Does not use the cached copy if true.
-</p>
+        <div class='inline'>
+<p>Does not use the cached copy if true.</p>
 </div>
       
     </li>
   
 </ul>
+
 <h3>Returns:</h3>
 <ul class="return">
   
@@ -1484,9 +1409,8 @@ Does not use the cached copy if true.
       
       
         &mdash;
-        <div class='inline'><p>
-self
-</p>
+        <div class='inline'>
+<p>self</p>
 </div>
       
     </li>
@@ -1499,17 +1423,17 @@ self
       <pre class="lines">
 
 
-55
-56
 57
 58
 59
 60
 61
-62</pre>
+62
+63
+64</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 55</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 57</span>
 
 <span class='kw'>def</span> <span class='id info'>info</span><span class='lparen'>(</span><span class='id refresh'>refresh</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>self</span> <span class='kw'>if</span> <span class='ivar'>@cached_info</span> <span class='kw'>and</span> <span class='kw'>not</span> <span class='id refresh'>refresh</span>
@@ -1533,9 +1457,8 @@ self
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Move this item to the destination folder.
-</p>
+    
+<p>Move this item to the destination folder.</p>
 
 
   </div>
@@ -1554,14 +1477,14 @@ Move this item to the destination folder.
       
       
         &mdash;
-        <div class='inline'><p>
-The new parent folder to use.
-</p>
+        <div class='inline'>
+<p>The new parent folder to use.</p>
 </div>
       
     </li>
   
 </ul>
+
 <h3>Returns:</h3>
 <ul class="return">
   
@@ -1573,9 +1496,8 @@ The new parent folder to use.
       
       
         &mdash;
-        <div class='inline'><p>
-self
-</p>
+        <div class='inline'>
+<p>self</p>
 </div>
       
     </li>
@@ -1588,8 +1510,6 @@ self
       <pre class="lines">
 
 
-68
-69
 70
 71
 72
@@ -1597,10 +1517,12 @@ self
 74
 75
 76
-77</pre>
+77
+78
+79</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 68</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 70</span>
 
 <span class='kw'>def</span> <span class='id move'>move</span><span class='lparen'>(</span><span class='id destination'>destination</span><span class='rparen'>)</span>
   <span class='ivar'>@api</span><span class='period'>.</span><span class='id move'>move</span><span class='lparen'>(</span><span class='id type'>type</span><span class='comma'>,</span> <span class='id id'>id</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='period'>.</span><span class='id id'>id</span><span class='rparen'>)</span>
@@ -1626,15 +1548,15 @@ self
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-The path of this item. This starts with a &#8217;/&#8217;.
-</p>
+    
+<p>The path of this item. This starts with a '/', unless it is root.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -1645,9 +1567,8 @@ The path of this item. This starts with a &#8217;/&#8217;.
       
       
         &mdash;
-        <div class='inline'><p>
-The path of this item. This starts with a &#8217;/&#8217;.
-</p>
+        <div class='inline'>
+<p>The path of this item. This starts with a '/', unless it is root.</p>
 </div>
       
     </li>
@@ -1660,12 +1581,12 @@ The path of this item. This starts with a &#8217;/&#8217;.
       <pre class="lines">
 
 
-129
-130
-131</pre>
+131
+132
+133</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 129</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 131</span>
 
 <span class='kw'>def</span> <span class='id path'>path</span>
   <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span> <span class='id parent'>parent</span><span class='period'>.</span><span class='id path'>path</span> <span class='op'>+</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>/</span><span class='tstring_end'>'</span></span> <span class='kw'>if</span> <span class='id parent'>parent</span> <span class='rbrace'>}</span><span class='embexpr_beg'>#{</span> <span class='id name'>name</span> <span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
@@ -1684,9 +1605,8 @@ The path of this item. This starts with a &#8217;/&#8217;.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Rename this item.
-</p>
+    
+<p>Rename this item.</p>
 
 
   </div>
@@ -1705,14 +1625,14 @@ Rename this item.
       
       
         &mdash;
-        <div class='inline'><p>
-The new name for the item.
-</p>
+        <div class='inline'>
+<p>The new name for the item.</p>
 </div>
       
     </li>
   
 </ul>
+
 <h3>Returns:</h3>
 <ul class="return">
   
@@ -1724,9 +1644,8 @@ The new name for the item.
       
       
         &mdash;
-        <div class='inline'><p>
-self
-</p>
+        <div class='inline'>
+<p>self</p>
 </div>
       
     </li>
@@ -1739,16 +1658,16 @@ self
       <pre class="lines">
 
 
-97
-98
 99
 100
 101
 102
-103</pre>
+103
+104
+105</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 97</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 99</span>
 
 <span class='kw'>def</span> <span class='id rename'>rename</span><span class='lparen'>(</span><span class='id new_name'>new_name</span><span class='rparen'>)</span>
   <span class='ivar'>@api</span><span class='period'>.</span><span class='id rename'>rename</span><span class='lparen'>(</span><span class='id type'>type</span><span class='comma'>,</span> <span class='id id'>id</span><span class='comma'>,</span> <span class='id new_name'>new_name</span><span class='rparen'>)</span>
@@ -1760,6 +1679,139 @@ self
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <p class="signature " id="respond_to?-instance_method">
+  
+    - (<tt>Boolean</tt>) <strong>respond_to?</strong>(sym) 
+  
+
+  
+</p><div class="docstring">
+  <div class="discussion">
+    
+<p>Handles some cases in method_missing, but won't always be accurate.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<h3>Returns:</h3>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Boolean</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+168
+169
+170</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 168</span>
+
+<span class='kw'>def</span> <span class='id respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='id sym'>sym</span><span class='rparen'>)</span>
+  <span class='ivar'>@data</span><span class='period'>.</span><span class='id key?'>key?</span><span class='lparen'>(</span><span class='id sym'>sym</span><span class='period'>.</span><span class='id to_s'>to_s</span><span class='rparen'>)</span> <span class='kw'>or</span> <span class='kw'>super</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <p class="signature " id="set_description-instance_method">
+  
+    - (<tt><span class='object_link'><a href="" title="Box::Item (class)">Item</a></span></tt>) <strong>set_description</strong>(message) 
+  
+
+  
+</p><div class="docstring">
+  <div class="discussion">
+    
+<p>Set the description of this item.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <h3>Parameters:</h3>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>message</span>
+      
+      
+        <span class='type'>(<tt>String</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>The description message to use.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+<h3>Returns:</h3>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="" title="Box::Item (class)">Item</a></span></tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>self</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+124
+125
+126
+127
+128</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 124</span>
+
+<span class='kw'>def</span> <span class='id set_description'>set_description</span><span class='lparen'>(</span><span class='id message'>message</span><span class='rparen'>)</span>
+  <span class='ivar'>@api</span><span class='period'>.</span><span class='id set_description'>set_description</span><span class='lparen'>(</span><span class='id type'>type</span><span class='comma'>,</span> <span class='id id'>id</span><span class='comma'>,</span> <span class='id message'>message</span><span class='rparen'>)</span>
+
+  <span class='kw'>self</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -1771,15 +1823,15 @@ self
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-The string representation of this item.
-</p>
+    
+<p>The string representation of this item.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -1790,9 +1842,8 @@ The string representation of this item.
       
       
         &mdash;
-        <div class='inline'><p>
-The string representation of this item.
-</p>
+        <div class='inline'>
+<p>The string representation of this item.</p>
 </div>
       
     </li>
@@ -1805,10 +1856,10 @@ The string representation of this item.
       <pre class="lines">
 
 
-39</pre>
+41</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 39</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 41</span>
 
 <span class='kw'>def</span> <span class='id type'>type</span><span class='semicolon'>;</span> <span class='kw'>self</span><span class='period'>.</span><span class='id class'>class</span><span class='period'>.</span><span class='id type'>type</span><span class='semicolon'>;</span> <span class='kw'>end</span></pre>
     </td>
@@ -1825,15 +1876,15 @@ The string representation of this item.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-The plural string representation of this item.
-</p>
+    
+<p>The plural string representation of this item.</p>
 
 
   </div>
 </div>
 <div class="tags">
-  <h3>Returns:</h3>
+  
+<h3>Returns:</h3>
 <ul class="return">
   
     <li>
@@ -1844,9 +1895,8 @@ The plural string representation of this item.
       
       
         &mdash;
-        <div class='inline'><p>
-The plural string representation of this item.
-</p>
+        <div class='inline'>
+<p>The plural string representation of this item.</p>
 </div>
       
     </li>
@@ -1859,10 +1909,10 @@ The plural string representation of this item.
       <pre class="lines">
 
 
-42</pre>
+44</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 42</span>
+      <pre class="code"><span class="info file"># File 'lib/box/item.rb', line 44</span>
 
 <span class='kw'>def</span> <span class='id types'>types</span><span class='semicolon'>;</span> <span class='kw'>self</span><span class='period'>.</span><span class='id class'>class</span><span class='period'>.</span><span class='id types'>types</span><span class='semicolon'>;</span> <span class='kw'>end</span></pre>
     </td>
@@ -1875,9 +1925,9 @@ The plural string representation of this item.
 </div>
     
     <div id="footer">
-  Generated on Mon Aug  8 13:05:22 2011 by 
+  Generated on Tue Nov  8 15:32:23 2011 by 
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.7.2 (ruby-1.9.2).
+  0.7.3 (ruby-1.9.3).
 </div>
 
   </body>