box-api 0.1.9 → 0.2.0

data/doc/Box/Folder.html

@@ -6,7 +6,7 @@
 <title>
   Class: Box::Folder
   
-    &mdash; Documentation by YARD 0.7.2
+    &mdash; Documentation by YARD 0.7.3
   
 </title>
 
@@ -96,16 +96,16 @@
 
 <h2>Overview</h2><div class="docstring">
   <div class="discussion">
-    <p>
-Represents a folder stored on Box. Any attributes or actions typical to a
-Box folder can be accessed through this class.
-</p>
+    
+<p>Represents a folder stored on Box. Any attributes or actions typical to a
+Box folder can be accessed through this class.</p>
 
 
   </div>
 </div>
 <div class="tags">
   
+
 </div>
 
   
@@ -147,9 +147,8 @@ Box folder can be accessed through this class.
   
 
   
-    <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>
@@ -167,6 +166,29 @@ The string representation of this item.
         <li class="public ">
   <span class="summary_signature">
     
+      <a href="#at-instance_method" title="#at (instance method)">- (Item) <strong>at</strong>(target_path) </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>Get the item at the given path.</p>
+</div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
       <a href="#create-instance_method" title="#create (instance method)">- (Folder) <strong>create</strong>(name, share = 0) </a>
     
 
@@ -180,9 +202,8 @@ The string representation of this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Create a new folder using this folder as the parent.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Create a new folder using this folder as the parent.</p>
 </div></span>
   
 </li>
@@ -204,9 +225,8 @@ Create a new folder using this folder as the parent.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Search for sub-items using criteria.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Search for sub-items using criteria.</p>
 </div></span>
   
 </li>
@@ -228,9 +248,8 @@ Search for sub-items using criteria.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Consider the item cached.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Consider the item cached.</p>
 </div></span>
   
 </li>
@@ -252,9 +271,8 @@ Consider the item cached.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Consider the tree cached.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Consider the tree cached.</p>
 </div></span>
   
 </li>
@@ -276,9 +294,8 @@ Consider the tree cached.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Get the info for this item.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Get the info for this item.</p>
 </div></span>
   
 </li>
@@ -300,9 +317,8 @@ Get the info for this item.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Get the tree for this folder.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Get the tree for this folder.</p>
 </div></span>
   
 </li>
@@ -324,9 +340,8 @@ Get the tree for this folder.
   
 
   
-    <span class="summary_desc"><div class='inline'><p>
-Upload a new file using this folder as the parent.
-</p>
+    <span class="summary_desc"><div class='inline'>
+<p>Upload a new file using this folder as the parent.</p>
 </div></span>
   
 </li>
@@ -344,7 +359,7 @@ Upload a new file using this folder as the parent.
   
   
   <h3 class="inherited">Methods inherited from <span class='object_link'><a href="Item.html" title="Box::Item (class)">Item</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="Item.html#copy-instance_method" title="Box::Item#copy (method)">#copy</a></span>, <span class='object_link'><a href="Item.html#delete-instance_method" title="Box::Item#delete (method)">#delete</a></span>, <span class='object_link'><a href="Item.html#description-instance_method" title="Box::Item#description (method)">#description</a></span>, <span class='object_link'><a href="Item.html#id-instance_method" title="Box::Item#id (method)">#id</a></span>, <span class='object_link'><a href="Item.html#initialize-instance_method" title="Box::Item#initialize (method)">#initialize</a></span>, <span class='object_link'><a href="Item.html#method_missing-instance_method" title="Box::Item#method_missing (method)">#method_missing</a></span>, <span class='object_link'><a href="Item.html#move-instance_method" title="Box::Item#move (method)">#move</a></span>, <span class='object_link'><a href="Item.html#path-instance_method" title="Box::Item#path (method)">#path</a></span>, <span class='object_link'><a href="Item.html#rename-instance_method" title="Box::Item#rename (method)">#rename</a></span>, <span class='object_link'><a href="Item.html#type-instance_method" title="Box::Item#type (method)">#type</a></span>, <span class='object_link'><a href="Item.html#types-instance_method" title="Box::Item#types (method)">#types</a></span>, <span class='object_link'><a href="Item.html#types-class_method" title="Box::Item.types (method)">types</a></span></p>
+  <p class="inherited"><span class='object_link'><a href="Item.html#copy-instance_method" title="Box::Item#copy (method)">#copy</a></span>, <span class='object_link'><a href="Item.html#delete-instance_method" title="Box::Item#delete (method)">#delete</a></span>, <span class='object_link'><a href="Item.html#id-instance_method" title="Box::Item#id (method)">#id</a></span>, <span class='object_link'><a href="Item.html#initialize-instance_method" title="Box::Item#initialize (method)">#initialize</a></span>, <span class='object_link'><a href="Item.html#method_missing-instance_method" title="Box::Item#method_missing (method)">#method_missing</a></span>, <span class='object_link'><a href="Item.html#move-instance_method" title="Box::Item#move (method)">#move</a></span>, <span class='object_link'><a href="Item.html#path-instance_method" title="Box::Item#path (method)">#path</a></span>, <span class='object_link'><a href="Item.html#rename-instance_method" title="Box::Item#rename (method)">#rename</a></span>, <span class='object_link'><a href="Item.html#respond_to%3F-instance_method" title="Box::Item#respond_to? (method)">#respond_to?</a></span>, <span class='object_link'><a href="Item.html#set_description-instance_method" title="Box::Item#set_description (method)">#set_description</a></span>, <span class='object_link'><a href="Item.html#type-instance_method" title="Box::Item#type (method)">#type</a></span>, <span class='object_link'><a href="Item.html#types-instance_method" title="Box::Item#types (method)">#types</a></span>, <span class='object_link'><a href="Item.html#types-class_method" title="Box::Item.types (method)">types</a></span></p>
 <div id="constructor_details" class="method_details_list">
   <h2>Constructor Details</h2>
   
@@ -376,15 +391,15 @@ Upload a new file using this folder as the parent.
   
 </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>
@@ -395,9 +410,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>
@@ -428,7 +442,176 @@ The string representation of this item.
     
     
       <div class="method_details first">
-  <p class="signature first" id="create-instance_method">
+  <p class="signature first" id="at-instance_method">
+  
+    - (<tt><span class='object_link'><a href="Item.html" title="Box::Item (class)">Item</a></span></tt>) <strong>at</strong>(target_path) 
+  
+
+  
+</p><div class="docstring">
+  <div class="discussion">
+    
+<p>Get the item at the given path.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+  <div class="examples">
+    <h3>Examples:</h3>
+    
+      <h4><div class='inline'>
+<p>Find a folder based on its absolute path.</p>
+</div></h4>
+      <pre class="example code"><span class='id folder'>folder</span><span class='period'>.</span><span class='id at'>at</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>/box/is/awesome</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span></pre>
+    
+      <h4><div class='inline'>
+<p>Find a file based on a relative path.</p>
+</div></h4>
+      <pre class="example code"><span class='id folder'>folder</span><span class='period'>.</span><span class='id at'>at</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>awesome/file.pdf</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span></pre>
+    
+      <h4><div class='inline'>
+<p>Find a folder using the parent.</p>
+</div></h4>
+      <pre class="example code"><span class='id folder'>folder</span><span class='period'>.</span><span class='id at'>at</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>../other/folder</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span></pre>
+    
+  </div>
+<h3>Parameters:</h3>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>The</span>
+      
+      
+        <span class='type'>(<tt>String</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>path to search for. This follows the typical unix path syntax, in that the
+root folder is '/'. Supports the dot sytax, where '.' is the current folder
+and '..' is the parent folder.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+<h3>Returns:</h3>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="Item.html" title="Box::Item (class)">Item</a></span></tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>The item that exists at this path, or nil.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+142
+143
+144
+145
+146
+147
+148
+149
+150
+151
+152
+153
+154
+155
+156
+157
+158
+159
+160
+161
+162
+163
+164
+165
+166
+167
+168
+169
+170
+171
+172
+173
+174
+175
+176
+177
+178
+179</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/box/folder.rb', line 142</span>
+
+<span class='kw'>def</span> <span class='id at'>at</span><span class='lparen'>(</span><span class='id target_path'>target_path</span><span class='rparen'>)</span>
+  <span class='comment'># start with this folder
+</span>  <span class='id current'>current</span> <span class='op'>=</span> <span class='kw'>self</span>
+
+  <span class='kw'>if</span> <span class='id target_path'>target_path</span><span class='period'>.</span><span class='id start_with?'>start_with?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>/</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
+    <span class='comment'># absolute path, find the root folder
+</span>    <span class='id current'>current</span> <span class='op'>=</span> <span class='id current'>current</span><span class='period'>.</span><span class='id parent'>parent</span> <span class='kw'>while</span> <span class='id current'>current</span><span class='period'>.</span><span class='id parent'>parent</span> <span class='op'>!=</span> <span class='kw'>nil</span>
+  <span class='kw'>end</span>
+
+  <span class='comment'># split each part of the target path
+</span>  <span class='id target_path'>target_path</span><span class='period'>.</span><span class='id split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>/</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id target_name'>target_name</span><span class='op'>|</span>
+    <span class='comment'># update current based on the target name
+</span>    <span class='id current'>current</span> <span class='op'>=</span> <span class='kw'>case</span> <span class='id target_name'>target_name</span>
+    <span class='kw'>when</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>.</span><span class='tstring_end'>&quot;</span></span>
+      <span class='comment'># no-op
+</span>      <span class='id current'>current</span>
+    <span class='kw'>when</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>..</span><span class='tstring_end'>&quot;</span></span>
+      <span class='comment'># use the parent folder
+</span>      <span class='id parent'>parent</span>
+    <span class='kw'>else</span>
+      <span class='comment'># must be a file/folder name, so make sure this is a folder
+</span>      <span class='kw'>return</span> <span class='kw'>nil</span> <span class='kw'>unless</span> <span class='id current'>current</span> <span class='kw'>and</span> <span class='id current'>current</span><span class='period'>.</span><span class='id type'>type</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>folder</span><span class='tstring_end'>'</span></span>
+
+      <span class='comment'># search for an item with that name
+</span>      <span class='id current'>current</span><span class='period'>.</span><span class='id find'>find</span><span class='lparen'>(</span><span class='symbol'>:name</span> <span class='op'>=&gt;</span> <span class='id target_name'>target_name</span><span class='comma'>,</span> <span class='symbol'>:recursive</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='rparen'>)</span><span class='period'>.</span><span class='id first'>first</span>
+    <span class='kw'>end</span>
+  <span class='kw'>end</span>
+
+  <span class='kw'>if</span> <span class='id current'>current</span>
+    <span class='comment'># ends with a slash, so it has to be a folder
+</span>    <span class='kw'>if</span> <span class='id target_path'>target_path</span><span class='period'>.</span><span class='id end_with?'>end_with?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>/</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span> <span class='kw'>and</span> <span class='id current'>current</span><span class='period'>.</span><span class='id type'>type</span> <span class='op'>!=</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>folder</span><span class='tstring_end'>'</span></span>
+      <span class='comment'># get the folder with the same name (if it exists)
+</span>      <span class='id current'>current</span> <span class='op'>=</span> <span class='id parent'>parent</span><span class='period'>.</span><span class='id find'>find</span><span class='lparen'>(</span><span class='symbol'>:type</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>folder</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='symbol'>:name</span> <span class='op'>=&gt;</span> <span class='id name'>name</span><span class='comma'>,</span> <span class='symbol'>:recursive</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='rparen'>)</span><span class='period'>.</span><span class='id first'>first</span>
+    <span class='kw'>end</span>
+  <span class='kw'>end</span>
+
+  <span class='id current'>current</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <p class="signature " id="create-instance_method">
   
     - (<tt><span class='object_link'><a href="" title="Box::Folder (class)">Folder</a></span></tt>) <strong>create</strong>(name, share = 0) 
   
@@ -436,9 +619,8 @@ The string representation of this item.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Create a new folder using this folder as the parent.
-</p>
+    
+<p>Create a new folder using this folder as the parent.</p>
 
 
   </div>
@@ -457,9 +639,8 @@ Create a new folder using this folder as the parent.
       
       
         &mdash;
-        <div class='inline'><p>
-The name of the new folder.
-</p>
+        <div class='inline'>
+<p>The name of the new folder.</p>
 </div>
       
     </li>
@@ -476,14 +657,14 @@ The name of the new folder.
       
       
         &mdash;
-        <div class='inline'><p>
-The shared status of the new folder. Defaults to not being shared.
-</p>
+        <div class='inline'>
+<p>The shared status of the new folder. Defaults to not being shared.</p>
 </div>
       
     </li>
   
 </ul>
+
 <h3>Returns:</h3>
 <ul class="return">
   
@@ -495,9 +676,8 @@ The shared status of the new folder. Defaults to not being shared.
       
       
         &mdash;
-        <div class='inline'><p>
-The new folder.
-</p>
+        <div class='inline'>
+<p>The new folder.</p>
 </div>
       
     </li>
@@ -545,28 +725,24 @@ The new folder.
     
   <div class="note notetag">
     <strong>Note:</strong> 
-    <div class='inline'><p>
-The recursive option will call <span class='object_link'><a href="#tree-instance_method" title="Box::Folder#tree (method)">#tree</a></span>, which can be slow for large
-folders.
-</p>
+    <div class='inline'>
+<p>The recursive option will call <span class='object_link'><a href="#tree-instance_method" title="Box::Folder#tree (method)">#tree</a></span>, which can be slow for large
+folders.</p>
 </div>
   </div>
 
   <div class="note notetag">
     <strong>Note:</strong> 
-    <div class='inline'><p>
-Any item method (as a symbol) can be used as criteria, which could cause
-major problems if used improperly.
-</p>
+    <div class='inline'>
+<p>Any item method (as a symbol) can be used as criteria, which could cause
+major problems if used improperly.</p>
 </div>
   </div>
 
-<p>
-Search for sub-items using criteria.
-</p>
-<p>
-TODO: Lookup YARD syntax for options hash.
-</p>
+
+<p>Search for sub-items using criteria.</p>
+
+<p>TODO: Lookup YARD syntax for options hash.</p>
 
 
   </div>
@@ -576,21 +752,18 @@ TODO: Lookup YARD syntax for options hash.
   <div class="examples">
     <h3>Examples:</h3>
     
-      <h4><div class='inline'><p>
-Find all sub-items with the name &#8216;README&#8217;
-</p>
+      <h4><div class='inline'>
+<p>Find all sub-items with the name 'README'</p>
 </div></h4>
       <pre class="example code"><span class='id folder'>folder</span><span class='period'>.</span><span class='id search'>search</span><span class='lparen'>(</span><span class='symbol'>:name</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>README</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span></pre>
     
-      <h4><div class='inline'><p>
-Recusively find a sub-item with the given path.
-</p>
+      <h4><div class='inline'>
+<p>Recusively find a sub-item with the given path.</p>
 </div></h4>
       <pre class="example code"><span class='id folder'>folder</span><span class='period'>.</span><span class='id search'>search</span><span class='lparen'>(</span><span class='symbol'>:path</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>/test/file.mp4</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='symbol'>:recursive</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='rparen'>)</span></pre>
     
-      <h4><div class='inline'><p>
-Recursively find all files with a given sha1.
-</p>
+      <h4><div class='inline'>
+<p>Recursively find all files with a given sha1.</p>
 </div></h4>
       <pre class="example code"><span class='id folder'>folder</span><span class='period'>.</span><span class='id search'>search</span><span class='lparen'>(</span><span class='symbol'>:type</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>file</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='symbol'>:sha1</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>abcdefg</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='symbol'>:recursive</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='rparen'>)</span></pre>
     
@@ -608,16 +781,16 @@ Recursively find all files with a given sha1.
       
       
         &mdash;
-        <div class='inline'><p>
-The hash of criteria to use. Each key of the criteria will be called on
+        <div class='inline'>
+<p>The hash of criteria to use. Each key of the criteria will be called on
 each sub-item and tested for equality. This lets you use any method of
-<span class='object_link'><a href="Item.html" title="Box::Item (class)">Item</a></span>, <span class='object_link'><a href="" title="Box::Folder (class)">Box::Folder</a></span>, and <span class='object_link'><a href="File.html" title="Box::File (class)">Box::File</a></span> as the criteria.
-</p>
+<span class='object_link'><a href="Item.html" title="Box::Item (class)">Item</a></span>, <span class='object_link'><a href="" title="Box::Folder (class)">Box::Folder</a></span>, and <span class='object_link'><a href="File.html" title="Box::File (class)">Box::File</a></span> as the criteria.</p>
 </div>
       
     </li>
   
 </ul>
+
 <h3>Returns:</h3>
 <ul class="return">
   
@@ -629,9 +802,8 @@ each sub-item and tested for equality. This lets you use any method of
       
       
         &mdash;
-        <div class='inline'><p>
-An array of all sub-items that matched the criteria.
-</p>
+        <div class='inline'>
+<p>An array of all sub-items that matched the criteria.</p>
 </div>
       
     </li>
@@ -678,16 +850,16 @@ An array of all sub-items that matched the criteria.
   
 </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>
@@ -698,7 +870,8 @@ item is fully fetched.
 106
 107
 108
-109</pre>
+109
+110</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/box/folder.rb', line 105</span>
@@ -706,6 +879,7 @@ item is fully fetched.
 <span class='kw'>def</span> <span class='id force_cached_info'>force_cached_info</span>
   <span class='id create_sub_items'>create_sub_items</span><span class='lparen'>(</span><span class='kw'>nil</span><span class='comma'>,</span> <span class='const'>Box</span><span class='op'>::</span><span class='const'>Folder</span><span class='rparen'>)</span>
   <span class='id create_sub_items'>create_sub_items</span><span class='lparen'>(</span><span class='kw'>nil</span><span class='comma'>,</span> <span class='const'>Box</span><span class='op'>::</span><span class='const'>File</span><span class='rparen'>)</span>
+
   <span class='kw'>super</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -722,23 +896,22 @@ item is fully fetched.
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Consider the tree cached. This prevents an additional api when we know the
-item is fully fetched.
-</p>
+    
+<p>Consider the tree 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">
 
 
-113
 114
 115
 116
@@ -748,19 +921,16 @@ item is fully fetched.
 120
 121
 122
-123
-124</pre>
+123</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/box/folder.rb', line 113</span>
+      <pre class="code"><span class="info file"># File 'lib/box/folder.rb', line 114</span>
 
 <span class='kw'>def</span> <span class='id force_cached_tree'>force_cached_tree</span>
   <span class='ivar'>@cached_tree</span> <span class='op'>=</span> <span class='kw'>true</span>
-  <span class='id force_cached_info'>force_cached_info</span>
 
-  <span class='id files'>files</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id file'>file</span><span class='op'>|</span>
-    <span class='id file'>file</span><span class='period'>.</span><span class='id force_cached_info'>force_cached_info</span>
-  <span class='kw'>end</span>
+  <span class='id create_sub_items'>create_sub_items</span><span class='lparen'>(</span><span class='kw'>nil</span><span class='comma'>,</span> <span class='const'>Box</span><span class='op'>::</span><span class='const'>Folder</span><span class='rparen'>)</span>
+  <span class='id create_sub_items'>create_sub_items</span><span class='lparen'>(</span><span class='kw'>nil</span><span class='comma'>,</span> <span class='const'>Box</span><span class='op'>::</span><span class='const'>File</span><span class='rparen'>)</span>
 
   <span class='id folders'>folders</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id folder'>folder</span><span class='op'>|</span>
     <span class='id folder'>folder</span><span class='period'>.</span><span class='id force_cached_tree'>force_cached_tree</span>
@@ -780,14 +950,12 @@ item is fully fetched.
   
 </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>
-Files and folders will only be one-level deep, and <span class='object_link'><a href="#tree-instance_method" title="Box::Folder#tree (method)">#tree</a></span> should be used
-if fetching deeper than that.
-</p>
+    
+<p>Get the info for this item. Uses a cached copy if avaliable, or else it is
+fetched from the api.</p>
+
+<p>Files and folders will only be one-level deep, and <span class='object_link'><a href="#tree-instance_method" title="Box::Folder#tree (method)">#tree</a></span> should be used
+if fetching deeper than that.</p>
 
 
   </div>
@@ -808,14 +976,14 @@ if fetching deeper than that.
       
       
         &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">
   
@@ -827,9 +995,8 @@ Does not use the cached copy if true.
       
       
         &mdash;
-        <div class='inline'><p>
-self
-</p>
+        <div class='inline'>
+<p>self</p>
 </div>
       
     </li>
@@ -879,19 +1046,17 @@ self
     
   <div class="note notetag">
     <strong>Note:</strong> 
-    <div class='inline'><p>
-Fetching the tree can take a long time for large folders. There is a
+    <div class='inline'>
+<p>Fetching the tree can take a long time for large folders. There is a
 trade-off between one <span class='object_link'><a href="#tree-instance_method" title="Box::Folder#tree (method)">#tree</a></span> call and multiple <span class='object_link'><a href="#info-instance_method" title="Box::Folder#info (method)">#info</a></span> calls, so use the
-one most relevant for your application.
-</p>
+one most relevant for your application.</p>
 </div>
   </div>
 
-<p>
-Get the tree for this folder. The tree includes all sub folders and files,
+
+<p>Get the tree for this folder. The tree includes all sub folders and files,
 including their info. Uses a cached copy if avaliable, or else it is
-fetched from the api.
-</p>
+fetched from the api.</p>
 
 
   </div>
@@ -912,14 +1077,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">
   
@@ -931,9 +1096,8 @@ Does not use the cached copy if true.
       
       
         &mdash;
-        <div class='inline'><p>
-self
-</p>
+        <div class='inline'>
+<p>self</p>
 </div>
       
     </li>
@@ -986,9 +1150,8 @@ self
   
 </p><div class="docstring">
   <div class="discussion">
-    <p>
-Upload a new file using this folder as the parent
-</p>
+    
+<p>Upload a new file using this folder as the parent</p>
 
 
   </div>
@@ -1007,14 +1170,14 @@ Upload a new file using this folder as the parent
       
       
         &mdash;
-        <div class='inline'><p>
-The path of the file on disk to upload.
-</p>
+        <div class='inline'>
+<p>The path of the file on disk to upload.</p>
 </div>
       
     </li>
   
 </ul>
+
 <h3>Returns:</h3>
 <ul class="return">
   
@@ -1026,9 +1189,8 @@ The path of the file on disk to upload.
       
       
         &mdash;
-        <div class='inline'><p>
-The new file.
-</p>
+        <div class='inline'>
+<p>The new file.</p>
 </div>
       
     </li>
@@ -1069,9 +1231,9 @@ The new file.
 </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>