pho 0.7.8 → 0.7.9

data/doc/rdoc/classes/Pho/FieldWeighting.html

@@ -93,8 +93,8 @@ href="QueryProfile.html">QueryProfile</a>
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000202">new</a>&nbsp;&nbsp;
-      <a href="#M000203">to_rdf</a>&nbsp;&nbsp;
+      <a href="#M000212">new</a>&nbsp;&nbsp;
+      <a href="#M000213">to_rdf</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -148,19 +148,19 @@ The weighting applied to the field
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000202" class="method-detail">
-        <a name="M000202"></a>
+      <div id="method-M000212" class="method-detail">
+        <a name="M000212"></a>
 
         <div class="method-heading">
-          <a href="#M000202" class="method-signature">
+          <a href="#M000212" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(uri, name, weight)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000202-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000202-source">
+            onclick="toggleCode('M000212-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000212-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/query_profile.rb, line 15</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">name</span>, <span class="ruby-identifier">weight</span>)
@@ -175,11 +175,11 @@ The weighting applied to the field
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000203" class="method-detail">
-        <a name="M000203"></a>
+      <div id="method-M000213" class="method-detail">
+        <a name="M000213"></a>
 
         <div class="method-heading">
-          <a href="#M000203" class="method-signature">
+          <a href="#M000213" class="method-signature">
           <span class="method-name">to_rdf</span><span class="method-args">(ns=true)</span>
           </a>
         </div>
@@ -195,8 +195,8 @@ rdf:Description, optionally including namespaces
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000203-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000203-source">
+            onclick="toggleCode('M000213-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000213-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/query_profile.rb, line 23</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_rdf</span>(<span class="ruby-identifier">ns</span>=<span class="ruby-keyword kw">true</span>)

data/doc/rdoc/classes/Pho/FileManagement.html

@@ -66,6 +66,10 @@
                 <a href="../../files/lib/pho/rdf_collection_rb.html">
                 lib/pho/rdf_collection.rb
                 </a>
+        <br />
+                <a href="../../files/lib/pho/upload_rb.html">
+                lib/pho/upload.rb
+                </a>
         <br />
             </td>
         </tr>
@@ -80,6 +84,14 @@
 
   <div id="contextContent">
 
+    <div id="description">
+      <p>
+This module provides support for managing local directories of files and
+mirroring them into either the metabox or contentbox of a Talis Platform
+store
+</p>
+
+    </div>
 
 
    </div>
@@ -96,8 +108,12 @@
       <h3 class="section-bar">Classes and Modules</h3>
 
       Class <a href="FileManagement/AbstractFileManager.html" class="link">Pho::FileManagement::AbstractFileManager</a><br />
+Class <a href="FileManagement/BNodeRewritingHandler.html" class="link">Pho::FileManagement::BNodeRewritingHandler</a><br />
 Class <a href="FileManagement/FileManager.html" class="link">Pho::FileManagement::FileManager</a><br />
+Class <a href="FileManagement/FileSplitter.html" class="link">Pho::FileManagement::FileSplitter</a><br />
 Class <a href="FileManagement/RDFManager.html" class="link">Pho::FileManagement::RDFManager</a><br />
+Class <a href="FileManagement/StatementHandler.html" class="link">Pho::FileManagement::StatementHandler</a><br />
+Class <a href="FileManagement/Util.html" class="link">Pho::FileManagement::Util</a><br />
 
     </div>
 

data/doc/rdoc/classes/Pho/FileManagement/AbstractFileManager.html

@@ -78,6 +78,41 @@
 
   <div id="contextContent">
 
+    <div id="description">
+      <p>
+Base class for the management of collections of files
+</p>
+<p>
+A collection is considered to be a directory (and sub-directory) of files.
+Depending on the type of collection manager used (e.g. +<a
+href="FileManager.html">Pho::FileManagement::FileManager</a>+ or +<a
+href="RDFManager.html">Pho::FileManagement::RDFManager</a>+) these may be
+collections of any kind of file, or just RDF serialisations.
+</p>
+<p>
+The basic mechanism has support for:
+</p>
+<pre>
+ * tracking whether a file has been successfully loaded into a store (or not)
+ * identifying all new files, just those that have been successfully stored, or failed
+ * identifying files that have been changed locally since last stored
+ * storage of any of these classes of files either by uploading into the contentbox or
+   storing in the metabox
+ * resumable uploads
+ * retrying uploads
+ * traversal across a directory structure to manage a complete set of files
+</pre>
+<p>
+Files are tracked locally by keeping some hidden files in the same
+directory system as the files being tracked. These are currently all
+managed in a hidden directory (&quot;.pho&quot;) that is automatically
+created. To access error messages from uploads look for the corresponding
+&quot;fail file&quot; for the relevant file. E.g. /foo/file.txt will be
+tracked in /foo/.pho, and will have either an OK file
+(/foo/.pho/file.txt.ok) or a fail file (/foo/.pho/file.txt.fail).
+</p>
+
+    </div>
 
 
    </div>
@@ -86,21 +121,22 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000016">changed?</a>&nbsp;&nbsp;
-      <a href="#M000018">changed_files</a>&nbsp;&nbsp;
-      <a href="#M000020">failures</a>&nbsp;&nbsp;
-      <a href="#M000023">get_fail_file_for</a>&nbsp;&nbsp;
-      <a href="#M000024">get_ok_file_for</a>&nbsp;&nbsp;
-      <a href="#M000010">new</a>&nbsp;&nbsp;
-      <a href="#M000019">new_files</a>&nbsp;&nbsp;
-      <a href="#M000014">reset</a>&nbsp;&nbsp;
-      <a href="#M000012">retry_failures</a>&nbsp;&nbsp;
-      <a href="#M000011">store</a>&nbsp;&nbsp;
-      <a href="#M000013">store_changes</a>&nbsp;&nbsp;
-      <a href="#M000015">stored?</a>&nbsp;&nbsp;
-      <a href="#M000017">stored_files</a>&nbsp;&nbsp;
-      <a href="#M000021">successes</a>&nbsp;&nbsp;
-      <a href="#M000022">summary</a>&nbsp;&nbsp;
+      <a href="#M000019">changed?</a>&nbsp;&nbsp;
+      <a href="#M000021">changed_files</a>&nbsp;&nbsp;
+      <a href="#M000028">create_tracking_dir</a>&nbsp;&nbsp;
+      <a href="#M000023">failures</a>&nbsp;&nbsp;
+      <a href="#M000026">get_fail_file_for</a>&nbsp;&nbsp;
+      <a href="#M000027">get_ok_file_for</a>&nbsp;&nbsp;
+      <a href="#M000013">new</a>&nbsp;&nbsp;
+      <a href="#M000022">new_files</a>&nbsp;&nbsp;
+      <a href="#M000017">reset</a>&nbsp;&nbsp;
+      <a href="#M000015">retry_failures</a>&nbsp;&nbsp;
+      <a href="#M000014">store</a>&nbsp;&nbsp;
+      <a href="#M000016">store_changes</a>&nbsp;&nbsp;
+      <a href="#M000018">stored?</a>&nbsp;&nbsp;
+      <a href="#M000020">stored_files</a>&nbsp;&nbsp;
+      <a href="#M000024">successes</a>&nbsp;&nbsp;
+      <a href="#M000025">summary</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -163,21 +199,21 @@
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000010" class="method-detail">
-        <a name="M000010"></a>
+      <div id="method-M000013" class="method-detail">
+        <a name="M000013"></a>
 
         <div class="method-heading">
-          <a href="#M000010" class="method-signature">
+          <a href="#M000013" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(store, dir, ok_suffix=OK, fail_suffix=FAIL)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000010-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000010-source">
+            onclick="toggleCode('M000013-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000013-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 14</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 38</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">store</span>, <span class="ruby-identifier">dir</span>, <span class="ruby-identifier">ok_suffix</span>=<span class="ruby-constant">OK</span>, <span class="ruby-identifier">fail_suffix</span>=<span class="ruby-constant">FAIL</span>)
         <span class="ruby-ivar">@store</span> = <span class="ruby-identifier">store</span>
         <span class="ruby-ivar">@dir</span> = <span class="ruby-identifier">dir</span>
@@ -191,11 +227,11 @@
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000016" class="method-detail">
-        <a name="M000016"></a>
+      <div id="method-M000019" class="method-detail">
+        <a name="M000019"></a>
 
         <div class="method-heading">
-          <a href="#M000016" class="method-signature">
+          <a href="#M000019" class="method-signature">
           <span class="method-name">changed?</span><span class="method-args">(file)</span>
           </a>
         </div>
@@ -207,10 +243,10 @@ Allows files that have been updated in a collection to be easily identified
 New files (i.e untracked) are always considered to be changed
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000016-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000016-source">
+            onclick="toggleCode('M000019-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000019-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 82</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 106</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">changed?</span>(<span class="ruby-identifier">file</span>)
         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">stored?</span>(<span class="ruby-identifier">file</span>)
           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
@@ -231,21 +267,21 @@ New files (i.e untracked) are always considered to be changed
         </div>
       </div>
 
-      <div id="method-M000018" class="method-detail">
-        <a name="M000018"></a>
+      <div id="method-M000021" class="method-detail">
+        <a name="M000021"></a>
 
         <div class="method-heading">
-          <a href="#M000018" class="method-signature">
+          <a href="#M000021" class="method-signature">
           <span class="method-name">changed_files</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000018-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000018-source">
+            onclick="toggleCode('M000021-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000021-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 106</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 130</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">changed_files</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">changed</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>
         <span class="ruby-identifier">list</span>(<span class="ruby-identifier">recursive</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
@@ -258,24 +294,48 @@ New files (i.e untracked) are always considered to be changed
         </div>
       </div>
 
-      <div id="method-M000020" class="method-detail">
-        <a name="M000020"></a>
+      <div id="method-M000028" class="method-detail">
+        <a name="M000028"></a>
 
         <div class="method-heading">
-          <a href="#M000020" class="method-signature">
+          <a href="#M000028" class="method-signature">
+          <span class="method-name">create_tracking_dir</span><span class="method-args">(filename)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000028-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000028-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 190</span>
+      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">create_tracking_dir</span>(<span class="ruby-identifier">filename</span>)
+        <span class="ruby-identifier">path</span> = <span class="ruby-identifier">filename</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">&quot;/&quot;</span>)[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">-2</span>].<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot;/&quot;</span>)  
+        <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">mkdir</span>(<span class="ruby-node">&quot;#{path}/#{TRACKING_DIR}&quot;</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-node">&quot;#{path}/#{TRACKING_DIR}&quot;</span>)
+      <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000023" class="method-detail">
+        <a name="M000023"></a>
+
+        <div class="method-heading">
+          <a href="#M000023" class="method-signature">
           <span class="method-name">failures</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-List <a href="AbstractFileManager.html#M000020">failures</a>
+List <a href="AbstractFileManager.html#M000023">failures</a>
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000020-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000020-source">
+            onclick="toggleCode('M000023-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000023-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 124</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 148</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">failures</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">fails</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>
         <span class="ruby-identifier">list</span>(<span class="ruby-identifier">recursive</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
@@ -288,21 +348,21 @@ List <a href="AbstractFileManager.html#M000020">failures</a>
         </div>
       </div>
 
-      <div id="method-M000023" class="method-detail">
-        <a name="M000023"></a>
+      <div id="method-M000026" class="method-detail">
+        <a name="M000026"></a>
 
         <div class="method-heading">
-          <a href="#M000023" class="method-signature">
+          <a href="#M000026" class="method-signature">
           <span class="method-name">get_fail_file_for</span><span class="method-args">(filename)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000023-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000023-source">
+            onclick="toggleCode('M000026-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000026-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 152</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 176</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_fail_file_for</span>(<span class="ruby-identifier">filename</span>)
         <span class="ruby-identifier">relative_path</span> = <span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-ivar">@dir</span>, <span class="ruby-value str">&quot;&quot;</span>)
         <span class="ruby-identifier">base</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">filename</span>)
@@ -314,21 +374,21 @@ List <a href="AbstractFileManager.html#M000020">failures</a>
         </div>
       </div>
 
-      <div id="method-M000024" class="method-detail">
-        <a name="M000024"></a>
+      <div id="method-M000027" class="method-detail">
+        <a name="M000027"></a>
 
         <div class="method-heading">
-          <a href="#M000024" class="method-signature">
+          <a href="#M000027" class="method-signature">
           <span class="method-name">get_ok_file_for</span><span class="method-args">(filename)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000024-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000024-source">
+            onclick="toggleCode('M000027-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000027-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 159</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 183</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_ok_file_for</span>(<span class="ruby-identifier">filename</span>)
         <span class="ruby-identifier">relative_path</span> = <span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-ivar">@dir</span>, <span class="ruby-value str">&quot;&quot;</span>)
         <span class="ruby-identifier">base</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">filename</span>)
@@ -340,25 +400,25 @@ List <a href="AbstractFileManager.html#M000020">failures</a>
         </div>
       </div>
 
-      <div id="method-M000019" class="method-detail">
-        <a name="M000019"></a>
+      <div id="method-M000022" class="method-detail">
+        <a name="M000022"></a>
 
         <div class="method-heading">
-          <a href="#M000019" class="method-signature">
+          <a href="#M000022" class="method-signature">
           <span class="method-name">new_files</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-List any <a href="AbstractFileManager.html#M000010">new</a> files in the
+List any <a href="AbstractFileManager.html#M000013">new</a> files in the
 directory
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000019-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000019-source">
+            onclick="toggleCode('M000022-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000022-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 115</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 139</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">new_files</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">newfiles</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>
         <span class="ruby-identifier">list</span>(<span class="ruby-identifier">recursive</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
@@ -371,11 +431,11 @@ directory
         </div>
       </div>
 
-      <div id="method-M000014" class="method-detail">
-        <a name="M000014"></a>
+      <div id="method-M000017" class="method-detail">
+        <a name="M000017"></a>
 
         <div class="method-heading">
-          <a href="#M000014" class="method-signature">
+          <a href="#M000017" class="method-signature">
           <span class="method-name">reset</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
@@ -385,10 +445,10 @@ directory
 Reset the directory to clear out any previous statuses
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000014-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000014-source">
+            onclick="toggleCode('M000017-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000017-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 55</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 79</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reset</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">recursive</span>
           <span class="ruby-identifier">pattern</span> = <span class="ruby-node">&quot;**/#{TRACKING_DIR}/*&quot;</span>
@@ -407,11 +467,11 @@ Reset the directory to clear out any previous statuses
         </div>
       </div>
 
-      <div id="method-M000012" class="method-detail">
-        <a name="M000012"></a>
+      <div id="method-M000015" class="method-detail">
+        <a name="M000015"></a>
 
         <div class="method-heading">
-          <a href="#M000012" class="method-signature">
+          <a href="#M000015" class="method-signature">
           <span class="method-name">retry_failures</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
@@ -421,10 +481,10 @@ Reset the directory to clear out any previous statuses
 Retry anything known to have failed
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000012-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000012-source">
+            onclick="toggleCode('M000015-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000015-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 31</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 55</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">retry_failures</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">retries</span> = <span class="ruby-identifier">failures</span>(<span class="ruby-identifier">recursive</span>)
         <span class="ruby-identifier">retries</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">filename</span><span class="ruby-operator">|</span>
@@ -439,11 +499,11 @@ Retry anything known to have failed
         </div>
       </div>
 
-      <div id="method-M000011" class="method-detail">
-        <a name="M000011"></a>
+      <div id="method-M000014" class="method-detail">
+        <a name="M000014"></a>
 
         <div class="method-heading">
-          <a href="#M000011" class="method-signature">
+          <a href="#M000014" class="method-signature">
           <span class="method-name">store</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
@@ -454,10 +514,10 @@ Retry anything known to have failed
 directory
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000011-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000011-source">
+            onclick="toggleCode('M000014-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000014-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 22</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 46</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">files_to_store</span> = <span class="ruby-identifier">new_files</span>(<span class="ruby-identifier">recursive</span>)
         <span class="ruby-identifier">files_to_store</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">filename</span><span class="ruby-operator">|</span>
@@ -470,21 +530,21 @@ directory
         </div>
       </div>
 
-      <div id="method-M000013" class="method-detail">
-        <a name="M000013"></a>
+      <div id="method-M000016" class="method-detail">
+        <a name="M000016"></a>
 
         <div class="method-heading">
-          <a href="#M000013" class="method-signature">
+          <a href="#M000016" class="method-signature">
           <span class="method-name">store_changes</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000013-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000013-source">
+            onclick="toggleCode('M000016-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000016-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 41</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 65</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store_changes</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">changes</span> = <span class="ruby-identifier">changed_files</span>(<span class="ruby-identifier">recursive</span>)
         <span class="ruby-identifier">changes</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">filename</span><span class="ruby-operator">|</span>
@@ -502,11 +562,11 @@ directory
         </div>
       </div>
 
-      <div id="method-M000015" class="method-detail">
-        <a name="M000015"></a>
+      <div id="method-M000018" class="method-detail">
+        <a name="M000018"></a>
 
         <div class="method-heading">
-          <a href="#M000015" class="method-signature">
+          <a href="#M000018" class="method-signature">
           <span class="method-name">stored?</span><span class="method-args">(file)</span>
           </a>
         </div>
@@ -516,10 +576,10 @@ directory
 returns true if there is a fail or ok file, false otherwise
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000015-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000015-source">
+            onclick="toggleCode('M000018-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000018-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 70</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 94</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stored?</span>(<span class="ruby-identifier">file</span>)
         <span class="ruby-identifier">ok_file</span> = <span class="ruby-identifier">get_ok_file_for</span>(<span class="ruby-identifier">file</span>)
         <span class="ruby-identifier">fail_file</span> = <span class="ruby-identifier">get_fail_file_for</span>(<span class="ruby-identifier">file</span>)        
@@ -533,21 +593,21 @@ returns true if there is a fail or ok file, false otherwise
         </div>
       </div>
 
-      <div id="method-M000017" class="method-detail">
-        <a name="M000017"></a>
+      <div id="method-M000020" class="method-detail">
+        <a name="M000020"></a>
 
         <div class="method-heading">
-          <a href="#M000017" class="method-signature">
+          <a href="#M000020" class="method-signature">
           <span class="method-name">stored_files</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000017-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000017-source">
+            onclick="toggleCode('M000020-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000020-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 98</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 122</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stored_files</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">stored</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>
         <span class="ruby-identifier">list</span>(<span class="ruby-identifier">recursive</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
@@ -560,24 +620,24 @@ returns true if there is a fail or ok file, false otherwise
         </div>
       </div>
 
-      <div id="method-M000021" class="method-detail">
-        <a name="M000021"></a>
+      <div id="method-M000024" class="method-detail">
+        <a name="M000024"></a>
 
         <div class="method-heading">
-          <a href="#M000021" class="method-signature">
+          <a href="#M000024" class="method-signature">
           <span class="method-name">successes</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-List <a href="AbstractFileManager.html#M000021">successes</a>
+List <a href="AbstractFileManager.html#M000024">successes</a>
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000021-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000021-source">
+            onclick="toggleCode('M000024-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000024-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 133</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 157</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">successes</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">successes</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>
         <span class="ruby-identifier">list</span>(<span class="ruby-identifier">recursive</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
@@ -590,11 +650,11 @@ List <a href="AbstractFileManager.html#M000021">successes</a>
         </div>
       </div>
 
-      <div id="method-M000022" class="method-detail">
-        <a name="M000022"></a>
+      <div id="method-M000025" class="method-detail">
+        <a name="M000025"></a>
 
         <div class="method-heading">
-          <a href="#M000022" class="method-signature">
+          <a href="#M000025" class="method-signature">
           <span class="method-name">summary</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
@@ -605,10 +665,10 @@ Summarize the state of the collection to the provided IO object Creates a
 simple report
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000022-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000022-source">
+            onclick="toggleCode('M000025-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000025-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 143</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 167</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">summary</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
          <span class="ruby-identifier">failures</span> = <span class="ruby-identifier">failures</span>(<span class="ruby-identifier">recursive</span>)
          <span class="ruby-identifier">successes</span> = <span class="ruby-identifier">successes</span>(<span class="ruby-identifier">recursive</span>)