pho 0.3 → 0.4

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

@@ -80,8 +80,9 @@
 
     <div id="description">
       <p>
-In the Talis Platform a &quot;snapshot&quot; is an backup of the contents
-of a <a href="Store.html">Store</a>
+In the Talis Platform a &quot;snapshot&quot; is an <a
+href="Snapshot.html#M000081">backup</a> of the contents of a <a
+href="Store.html">Store</a>
 </p>
 <p>
 A snapshot consists of a tar file that contains all data (contentbox and
@@ -89,8 +90,7 @@ metabox) in the store. The snapshot also contains the store configuration
 but this is encrypted and not intended for reuse.
 </p>
 <p>
-A snapshot can be generated (or scheduled) using the <a
-href="Store.html#M000061">Store.snapshot</a> method.
+A snapshot can be generated (or scheduled) using the Store.snapshot method.
 </p>
 
     </div>
@@ -102,10 +102,11 @@ href="Store.html#M000061">Store.snapshot</a> method.
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000073">download</a>&nbsp;&nbsp;
-      <a href="#M000071">new</a>&nbsp;&nbsp;
-      <a href="#M000070">parse</a>&nbsp;&nbsp;
-      <a href="#M000072">read_md5</a>&nbsp;&nbsp;
+      <a href="#M000081">backup</a>&nbsp;&nbsp;
+      <a href="#M000079">new</a>&nbsp;&nbsp;
+      <a href="#M000078">parse</a>&nbsp;&nbsp;
+      <a href="#M000077">read_from_store</a>&nbsp;&nbsp;
+      <a href="#M000080">read_md5</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -125,6 +126,14 @@ href="Store.html#M000061">Store.snapshot</a> method.
 
       <div class="name-list">
         <table>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">date</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc">
+Date when snapshot was taken
+
+</td>
+        </tr>
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">md5_url</td>
           <td class="context-item-value">&nbsp;[R]&nbsp;</td>
@@ -167,84 +176,191 @@ The URL from which the snapshot can be retrieved
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000071" class="method-detail">
-        <a name="M000071"></a>
+      <div id="method-M000079" class="method-detail">
+        <a name="M000079"></a>
 
         <div class="method-heading">
-          <a href="Snapshot.src/M000071.html" target="Code" class="method-signature"
-            onclick="popupCode('Snapshot.src/M000071.html');return false;">
-          <span class="method-name">new</span><span class="method-args">(url, md5_url, size, units)</span>
+          <a href="#M000079" class="method-signature">
+          <span class="method-name">new</span><span class="method-args">(url, md5_url, size, units, date)</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000079-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000079-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 76</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">url</span>, <span class="ruby-identifier">md5_url</span>, <span class="ruby-identifier">size</span>, <span class="ruby-identifier">units</span>, <span class="ruby-identifier">date</span>)
+      <span class="ruby-ivar">@url</span> = <span class="ruby-identifier">url</span>
+      <span class="ruby-ivar">@md5_url</span> = <span class="ruby-identifier">md5_url</span>
+      <span class="ruby-ivar">@size</span> = <span class="ruby-identifier">size</span>
+      <span class="ruby-ivar">@units</span> = <span class="ruby-identifier">units</span>      
+      <span class="ruby-ivar">@date</span> = <span class="ruby-identifier">date</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000070" class="method-detail">
-        <a name="M000070"></a>
+      <div id="method-M000078" class="method-detail">
+        <a name="M000078"></a>
 
         <div class="method-heading">
-          <a href="Snapshot.src/M000070.html" target="Code" class="method-signature"
-            onclick="popupCode('Snapshot.src/M000070.html');return false;">
-          <span class="method-name">parse</span><span class="method-args">(resp)</span>
+          <a href="#M000078" class="method-signature">
+          <span class="method-name">parse</span><span class="method-args">(storeuri, content)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Class method to <a href="Snapshot.html#M000070">parse</a> the HTML response
-from API, e.g. as produced by the <a
-href="Store.html#M000065">Store.get_snapshots</a> method and create a <a
-href="Snapshot.html#M000071">new</a> <a href="Snapshot.html">Snapshot</a>
+Class method to <a href="Snapshot.html#M000078">parse</a> the RDF response
+from the API, e.g. as produced by the <a
+href="Store.html#M000072">Store.get_snapshots</a> method and create a <a
+href="Snapshot.html#M000079">new</a> <a href="Snapshot.html">Snapshot</a>
 object. At the moment the Platform only supports single snapshot.
 </p>
 <p>
 If the response was an error, then an exception will be thrown
 </p>
 <pre>
- resp:: HTTP response generated by the Store.get_snapshots method
+ storeuri:: URI of the store
+ content:: response from the API
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000078-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000078-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 52</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Snapshot</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">storeuri</span>, <span class="ruby-identifier">content</span>)
+            
+      <span class="ruby-identifier">doc</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Document</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">content</span>)
+      <span class="ruby-identifier">root</span> = <span class="ruby-identifier">doc</span>.<span class="ruby-identifier">root</span>
+      
+      <span class="ruby-identifier">store</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">XPath</span>.<span class="ruby-identifier">first</span>(<span class="ruby-identifier">root</span>, <span class="ruby-node">&quot;//*[@rdf:about='#{storeuri}']&quot;</span>, <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Namespaces</span><span class="ruby-operator">::</span><span class="ruby-constant">MAPPING</span> )
+      <span class="ruby-identifier">snapshot</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">XPath</span>.<span class="ruby-identifier">first</span>(<span class="ruby-identifier">store</span>, <span class="ruby-value str">&quot;bf:snapshot&quot;</span>, <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Namespaces</span><span class="ruby-operator">::</span><span class="ruby-constant">MAPPING</span>)
+      <span class="ruby-identifier">snapshot_url</span> = <span class="ruby-identifier">snapshot</span>.<span class="ruby-identifier">attributes</span>[<span class="ruby-value str">&quot;rdf:resource&quot;</span>] 
+      <span class="ruby-identifier">snapshot_el</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">XPath</span>.<span class="ruby-identifier">first</span>(<span class="ruby-identifier">root</span>, <span class="ruby-node">&quot;//*[@rdf:about='#{snapshot_url}']&quot;</span>, <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Namespaces</span><span class="ruby-operator">::</span><span class="ruby-constant">MAPPING</span> )
+      
+      <span class="ruby-identifier">el</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">XPath</span>.<span class="ruby-identifier">first</span>(<span class="ruby-identifier">snapshot_el</span>, <span class="ruby-value str">&quot;bf:md5&quot;</span>, <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Namespaces</span><span class="ruby-operator">::</span><span class="ruby-constant">MAPPING</span>)
+      <span class="ruby-identifier">snapshot_md5_url</span> = <span class="ruby-identifier">el</span>.<span class="ruby-identifier">attributes</span>[<span class="ruby-value str">&quot;rdf:resource&quot;</span>]      
+
+      <span class="ruby-identifier">el</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">XPath</span>.<span class="ruby-identifier">first</span>(<span class="ruby-identifier">snapshot_el</span>, <span class="ruby-value str">&quot;bf:filesize&quot;</span>, <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Namespaces</span><span class="ruby-operator">::</span><span class="ruby-constant">MAPPING</span>)      
+      <span class="ruby-identifier">snapshot_size</span> = <span class="ruby-identifier">el</span>.<span class="ruby-identifier">text</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">&quot; &quot;</span>)[<span class="ruby-value">0</span>]
+      <span class="ruby-identifier">snapshot_units</span> = <span class="ruby-identifier">el</span>.<span class="ruby-identifier">text</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">&quot; &quot;</span>)[<span class="ruby-value">1</span>]
+      
+      <span class="ruby-identifier">el</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">XPath</span>.<span class="ruby-identifier">first</span>(<span class="ruby-identifier">snapshot_el</span>, <span class="ruby-value str">&quot;dc:date&quot;</span>, <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Namespaces</span><span class="ruby-operator">::</span><span class="ruby-constant">MAPPING</span>)
+      <span class="ruby-identifier">snapshot_date</span> = <span class="ruby-identifier">el</span>.<span class="ruby-identifier">text</span> 
+      
+      <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Snapshot</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">snapshot_url</span>, <span class="ruby-identifier">snapshot_md5_url</span>, <span class="ruby-identifier">snapshot_size</span>, <span class="ruby-identifier">snapshot_units</span>, <span class="ruby-identifier">snapshot_date</span>)
+      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000077" class="method-detail">
+        <a name="M000077"></a>
+
+        <div class="method-heading">
+          <a href="#M000077" class="method-signature">
+          <span class="method-name">read_from_store</span><span class="method-args">(store)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Read snapshot data from the given store
+</p>
+<table>
+<tr><td valign="top">store:</td><td>reference to a <a href="Store.html">Store</a> object
+
+</td></tr>
+</table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000077-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000077-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 34</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Snapshot</span>.<span class="ruby-identifier">read_from_store</span>(<span class="ruby-identifier">store</span>)
+      <span class="ruby-identifier">resp</span> = <span class="ruby-identifier">store</span>.<span class="ruby-identifier">get_snapshots</span>()
+      
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">resp</span>.<span class="ruby-identifier">status</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">200</span>)
+        <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Response was not successful. Status code was: #{resp.status}&quot;</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">content</span> = <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">content</span>
+      
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">parse</span>(<span class="ruby-identifier">store</span>.<span class="ruby-identifier">storeuri</span>, <span class="ruby-identifier">content</span>)  
+    <span class="ruby-keyword kw">end</span>
 </pre>
+          </div>
         </div>
       </div>
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000073" class="method-detail">
-        <a name="M000073"></a>
+      <div id="method-M000081" class="method-detail">
+        <a name="M000081"></a>
 
         <div class="method-heading">
-          <a href="Snapshot.src/M000073.html" target="Code" class="method-signature"
-            onclick="popupCode('Snapshot.src/M000073.html');return false;">
-          <span class="method-name">download</span><span class="method-args">(dir, client=HTTPClient.new())</span>
+          <a href="#M000081" class="method-signature">
+          <span class="method-name">backup</span><span class="method-args">(store, dir=Dir.tmpdir)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
 Download this snapshot to the specified directory. Will automatically
-calculate an MD5 checksum for the <a
-href="Snapshot.html#M000073">download</a> and compare it against the
+calculate an MD5 checksum for the download and compare it against the
 published value. If they don&#8216;t match then a RuntimeError will be
 raised
 </p>
 <table>
-<tr><td valign="top">dir:</td><td>directory in which snapshot will be stored
+<tr><td valign="top">store:</td><td>the store to <a href="Snapshot.html#M000081">backup</a>
 
 </td></tr>
-<tr><td valign="top">client:</td><td>specify a preconfigured client, e.g. to configure proxy servers, etc
+<tr><td valign="top">dir:</td><td>directory in which snapshot will be stored
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000081-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000081-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 96</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">backup</span>(<span class="ruby-identifier">store</span>, <span class="ruby-identifier">dir</span>=<span class="ruby-constant">Dir</span>.<span class="ruby-identifier">tmpdir</span>)
+      
+      <span class="ruby-identifier">published_md5</span> = <span class="ruby-identifier">read_md5</span>(<span class="ruby-identifier">store</span>.<span class="ruby-identifier">client</span>)
+      
+      <span class="ruby-identifier">digest</span> = <span class="ruby-constant">Digest</span><span class="ruby-operator">::</span><span class="ruby-constant">MD5</span>.<span class="ruby-identifier">new</span>()
+
+      <span class="ruby-identifier">filename</span> = <span class="ruby-ivar">@url</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">&quot;/&quot;</span>).<span class="ruby-identifier">last</span>
+      <span class="ruby-identifier">file</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>( <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>, <span class="ruby-identifier">filename</span>), <span class="ruby-value str">&quot;w&quot;</span> ) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
+
+        <span class="ruby-comment cmt">#FIXME: this is not efficient as the snapshot may be very large and this</span>
+        <span class="ruby-comment cmt">#will just read all of the data into memory</span>
+        <span class="ruby-identifier">content</span> = <span class="ruby-identifier">store</span>.<span class="ruby-identifier">client</span>.<span class="ruby-identifier">get_content</span>(<span class="ruby-ivar">@url</span>)
+        <span class="ruby-identifier">file</span>.<span class="ruby-identifier">print</span>(<span class="ruby-identifier">content</span>)
+        <span class="ruby-identifier">digest</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">content</span>
+        
+      <span class="ruby-keyword kw">end</span>
+      
+      <span class="ruby-identifier">calc_md5</span> = <span class="ruby-identifier">digest</span>.<span class="ruby-identifier">hexdigest</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">calc_md5</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">published_md5</span>)
+        <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Calculated digest of #{calc_md5} but does not match published md5 #{published_md5}&quot;</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000072" class="method-detail">
-        <a name="M000072"></a>
+      <div id="method-M000080" class="method-detail">
+        <a name="M000080"></a>
 
         <div class="method-heading">
-          <a href="Snapshot.src/M000072.html" target="Code" class="method-signature"
-            onclick="popupCode('Snapshot.src/M000072.html');return false;">
+          <a href="#M000080" class="method-signature">
           <span class="method-name">read_md5</span><span class="method-args">(client=HttpClient.new())</span>
           </a>
         </div>
@@ -253,6 +369,16 @@ raised
           <p>
 Read the published MD5 value
 </p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000080-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000080-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 86</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_md5</span>(<span class="ruby-identifier">client</span>=<span class="ruby-constant">HttpClient</span>.<span class="ruby-identifier">new</span>())
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">client</span>.<span class="ruby-identifier">get_content</span>(<span class="ruby-ivar">@md5_url</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 

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

@@ -157,13 +157,24 @@ Interval before status should be requested again.
         <a name="M000020"></a>
 
         <div class="method-heading">
-          <a href="Status.src/M000020.html" target="Code" class="method-signature"
-            onclick="popupCode('Status.src/M000020.html');return false;">
+          <a href="#M000020" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(retry_interval, status_message, access_mode)</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            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/status.rb, line 25</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">retry_interval</span>, <span class="ruby-identifier">status_message</span>, <span class="ruby-identifier">access_mode</span>)
+      <span class="ruby-ivar">@retry_interval</span> = <span class="ruby-identifier">retry_interval</span>
+      <span class="ruby-ivar">@status_message</span> = <span class="ruby-identifier">status_message</span>
+      <span class="ruby-ivar">@access_mode</span> = <span class="ruby-identifier">access_mode</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
@@ -171,8 +182,7 @@ Interval before status should be requested again.
         <a name="M000021"></a>
 
         <div class="method-heading">
-          <a href="Status.src/M000021.html" target="Code" class="method-signature"
-            onclick="popupCode('Status.src/M000021.html');return false;">
+          <a href="#M000021" class="method-signature">
           <span class="method-name">read_from_store</span><span class="method-args">(store)</span>
           </a>
         </div>
@@ -191,6 +201,29 @@ href="Status.html">Status</a> object.
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            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/status.rb, line 36</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Status</span>.<span class="ruby-identifier">read_from_store</span>(<span class="ruby-identifier">store</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-identifier">store</span>.<span class="ruby-identifier">get_status</span>()
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">response</span>.<span class="ruby-identifier">status</span> <span class="ruby-operator">!=</span> <span class="ruby-value">200</span>)
+        <span class="ruby-identifier">raise</span> <span class="ruby-value str">&quot;Cannot read store status&quot;</span>
+      <span class="ruby-keyword kw">end</span>
+      
+      <span class="ruby-identifier">u</span> = <span class="ruby-identifier">store</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/config/access-status&quot;</span>)
+      <span class="ruby-identifier">json</span> = <span class="ruby-constant">JSON</span>.<span class="ruby-identifier">parse</span>( <span class="ruby-identifier">response</span>.<span class="ruby-identifier">content</span> )
+      <span class="ruby-identifier">retry_interval</span> = <span class="ruby-identifier">json</span>[<span class="ruby-identifier">u</span>][<span class="ruby-value str">&quot;http:\/\/schemas.talis.com\/2006\/bigfoot\/configuration#retryInterval&quot;</span>][<span class="ruby-value">0</span>][<span class="ruby-value str">&quot;value&quot;</span>]
+      <span class="ruby-identifier">status_message</span> = <span class="ruby-identifier">json</span>[<span class="ruby-identifier">u</span>][<span class="ruby-value str">&quot;http:\/\/schemas.talis.com\/2006\/bigfoot\/configuration#statusMessage&quot;</span>][<span class="ruby-value">0</span>][<span class="ruby-value str">&quot;value&quot;</span>]
+      <span class="ruby-identifier">access_mode</span> = <span class="ruby-identifier">json</span>[<span class="ruby-identifier">u</span>][<span class="ruby-value str">&quot;http:\/\/schemas.talis.com\/2006\/bigfoot\/configuration#accessMode&quot;</span>][<span class="ruby-value">0</span>][<span class="ruby-value str">&quot;value&quot;</span>]
+      
+      <span class="ruby-identifier">state</span> = <span class="ruby-constant">Status</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">retry_interval</span>.<span class="ruby-identifier">to_i</span>, <span class="ruby-identifier">status_message</span>, <span class="ruby-identifier">access_mode</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">state</span>
+          
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
@@ -200,8 +233,7 @@ href="Status.html">Status</a> object.
         <a name="M000022"></a>
 
         <div class="method-heading">
-          <a href="Status.src/M000022.html" target="Code" class="method-signature"
-            onclick="popupCode('Status.src/M000022.html');return false;">
+          <a href="#M000022" class="method-signature">
           <span class="method-name">readable?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -210,6 +242,16 @@ href="Status.html">Status</a> object.
           <p>
 Is the store <a href="Status.html#M000022">readable?</a>
 </p>
+          <p><a class="source-toggle" href="#"
+            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/status.rb, line 54</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">readable?</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@access_mode</span> <span class="ruby-operator">!=</span> <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">UNAVAILABLE</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
@@ -217,8 +259,7 @@ Is the store <a href="Status.html#M000022">readable?</a>
         <a name="M000023"></a>
 
         <div class="method-heading">
-          <a href="Status.src/M000023.html" target="Code" class="method-signature"
-            onclick="popupCode('Status.src/M000023.html');return false;">
+          <a href="#M000023" class="method-signature">
           <span class="method-name">writeable?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -227,6 +268,16 @@ Is the store <a href="Status.html#M000022">readable?</a>
           <p>
 Is the store <a href="Status.html#M000023">writeable?</a>
 </p>
+          <p><a class="source-toggle" href="#"
+            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/status.rb, line 59</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">writeable?</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@access_mode</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">READ_WRITE</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 

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

@@ -109,40 +109,37 @@ See the examples directory in the distribution
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000052">augment</a>&nbsp;&nbsp;
-      <a href="#M000051">augment_uri</a>&nbsp;&nbsp;
-      <a href="#M000058">build_job_request</a>&nbsp;&nbsp;
-      <a href="#M000038">build_uri</a>&nbsp;&nbsp;
-      <a href="#M000053">configure_headers_for_conditional_get</a>&nbsp;&nbsp;
-      <a href="#M000056">delete_item</a>&nbsp;&nbsp;
-      <a href="#M000042">describe</a>&nbsp;&nbsp;
-      <a href="#M000049">facet</a>&nbsp;&nbsp;
-      <a href="#M000066">get_field_predicate_map</a>&nbsp;&nbsp;
-      <a href="#M000057">get_item</a>&nbsp;&nbsp;
-      <a href="#M000068">get_query_profile</a>&nbsp;&nbsp;
-      <a href="#M000050">get_search_params</a>&nbsp;&nbsp;
-      <a href="#M000065">get_snapshots</a>&nbsp;&nbsp;
-      <a href="#M000064">get_status</a>&nbsp;&nbsp;
-      <a href="#M000036">new</a>&nbsp;&nbsp;
-      <a href="#M000067">put_field_predicate_map</a>&nbsp;&nbsp;
-      <a href="#M000069">put_query_profile</a>&nbsp;&nbsp;
-      <a href="#M000054">record_etags</a>&nbsp;&nbsp;
-      <a href="#M000060">reindex</a>&nbsp;&nbsp;
-      <a href="#M000059">reset</a>&nbsp;&nbsp;
-      <a href="#M000062">restore</a>&nbsp;&nbsp;
-      <a href="#M000048">search</a>&nbsp;&nbsp;
-      <a href="#M000037">set_credentials</a>&nbsp;&nbsp;
-      <a href="#M000061">snapshot</a>&nbsp;&nbsp;
-      <a href="#M000047">sparql</a>&nbsp;&nbsp;
-      <a href="#M000045">sparql_ask</a>&nbsp;&nbsp;
-      <a href="#M000044">sparql_construct</a>&nbsp;&nbsp;
-      <a href="#M000043">sparql_describe</a>&nbsp;&nbsp;
-      <a href="#M000046">sparql_select</a>&nbsp;&nbsp;
-      <a href="#M000039">store_data</a>&nbsp;&nbsp;
-      <a href="#M000040">store_file</a>&nbsp;&nbsp;
-      <a href="#M000041">store_url</a>&nbsp;&nbsp;
-      <a href="#M000063">submit_job</a>&nbsp;&nbsp;
-      <a href="#M000055">upload_item</a>&nbsp;&nbsp;
+      <a href="#M000062">augment</a>&nbsp;&nbsp;
+      <a href="#M000061">augment_uri</a>&nbsp;&nbsp;
+      <a href="#M000048">build_uri</a>&nbsp;&nbsp;
+      <a href="#M000063">configure_headers_for_conditional_get</a>&nbsp;&nbsp;
+      <a href="#M000066">delete_item</a>&nbsp;&nbsp;
+      <a href="#M000052">describe</a>&nbsp;&nbsp;
+      <a href="#M000059">facet</a>&nbsp;&nbsp;
+      <a href="#M000073">get_field_predicate_map</a>&nbsp;&nbsp;
+      <a href="#M000067">get_item</a>&nbsp;&nbsp;
+      <a href="#M000068">get_job</a>&nbsp;&nbsp;
+      <a href="#M000069">get_jobs</a>&nbsp;&nbsp;
+      <a href="#M000075">get_query_profile</a>&nbsp;&nbsp;
+      <a href="#M000060">get_search_params</a>&nbsp;&nbsp;
+      <a href="#M000072">get_snapshots</a>&nbsp;&nbsp;
+      <a href="#M000071">get_status</a>&nbsp;&nbsp;
+      <a href="#M000046">new</a>&nbsp;&nbsp;
+      <a href="#M000074">put_field_predicate_map</a>&nbsp;&nbsp;
+      <a href="#M000076">put_query_profile</a>&nbsp;&nbsp;
+      <a href="#M000064">record_etags</a>&nbsp;&nbsp;
+      <a href="#M000058">search</a>&nbsp;&nbsp;
+      <a href="#M000047">set_credentials</a>&nbsp;&nbsp;
+      <a href="#M000057">sparql</a>&nbsp;&nbsp;
+      <a href="#M000055">sparql_ask</a>&nbsp;&nbsp;
+      <a href="#M000054">sparql_construct</a>&nbsp;&nbsp;
+      <a href="#M000053">sparql_describe</a>&nbsp;&nbsp;
+      <a href="#M000056">sparql_select</a>&nbsp;&nbsp;
+      <a href="#M000049">store_data</a>&nbsp;&nbsp;
+      <a href="#M000050">store_file</a>&nbsp;&nbsp;
+      <a href="#M000051">store_url</a>&nbsp;&nbsp;
+      <a href="#M000070">submit_job</a>&nbsp;&nbsp;
+      <a href="#M000065">upload_item</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -196,12 +193,11 @@ Retrieve the admin username configured in this instance
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000036" class="method-detail">
-        <a name="M000036"></a>
+      <div id="method-M000046" class="method-detail">
+        <a name="M000046"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000036.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000036.html');return false;">
+          <a href="#M000046" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(storeuri, username=nil, password=nil, client = HTTPClient.new() )</span>
           </a>
         </div>
@@ -224,17 +220,30 @@ Create an instance of the store class
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000046-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000046-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 45</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">storeuri</span>, <span class="ruby-identifier">username</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">password</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">client</span> = <span class="ruby-constant">HTTPClient</span>.<span class="ruby-identifier">new</span>() )
+      <span class="ruby-ivar">@storeuri</span> = <span class="ruby-identifier">storeuri</span>.<span class="ruby-identifier">chomp</span>(<span class="ruby-value str">&quot;/&quot;</span>)
+      <span class="ruby-ivar">@username</span> = <span class="ruby-identifier">username</span>
+      <span class="ruby-ivar">@password</span> = <span class="ruby-identifier">password</span>
+      <span class="ruby-ivar">@client</span> = <span class="ruby-identifier">client</span>
+      <span class="ruby-identifier">set_credentials</span>(<span class="ruby-identifier">username</span>, <span class="ruby-identifier">password</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">username</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">password</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000052" class="method-detail">
-        <a name="M000052"></a>
+      <div id="method-M000062" class="method-detail">
+        <a name="M000062"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000052.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000052.html');return false;">
+          <a href="#M000062" class="method-signature">
           <span class="method-name">augment</span><span class="method-args">(data)</span>
           </a>
         </div>
@@ -249,15 +258,26 @@ Platform
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000062-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000062-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 254</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">augment</span>(<span class="ruby-identifier">data</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/services/augment&quot;</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">post</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">data</span>, <span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000051" class="method-detail">
-        <a name="M000051"></a>
+      <div id="method-M000061" class="method-detail">
+        <a name="M000061"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000051.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000051.html');return false;">
+          <a href="#M000061" class="method-signature">
           <span class="method-name">augment_uri</span><span class="method-args">(uri)</span>
           </a>
         </div>
@@ -272,45 +292,26 @@ data in this store
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000061-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000061-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 245</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">augment_uri</span>(<span class="ruby-identifier">uri</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/services/augment&quot;</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, {<span class="ruby-value str">&quot;data-uri&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">uri</span>}, <span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>          
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000058" class="method-detail">
-        <a name="M000058"></a>
-
-        <div class="method-heading">
-          <a href="Store.src/M000058.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000058.html');return false;">
-          <span class="method-name">build_job_request</span><span class="method-args">(t, joburi, label)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-Construct an RDF/XML document containing a job request for submitting to
-the Platform.
-</p>
-<table>
-<tr><td valign="top">t:</td><td>a Time object, specifying the time at which the request should be carried
-out
-
-</td></tr>
-<tr><td valign="top">joburi:</td><td>the URI for the JobType that should be created
-
-</td></tr>
-<tr><td valign="top">label:</td><td>a label for this job.
-
-</td></tr>
-</table>
-        </div>
-      </div>
-
-      <div id="method-M000038" class="method-detail">
-        <a name="M000038"></a>
+      <div id="method-M000048" class="method-detail">
+        <a name="M000048"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000038.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000038.html');return false;">
+          <a href="#M000048" class="method-signature">
           <span class="method-name">build_uri</span><span class="method-args">(uri)</span>
           </a>
         </div>
@@ -324,15 +325,31 @@ Build a request uri, by concatenating it with the base uri of the store
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000048-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000048-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 63</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">build_uri</span>(<span class="ruby-identifier">uri</span>)
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">start_with?</span>(<span class="ruby-ivar">@storeuri</span>))
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">uri</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">start_with?</span>(<span class="ruby-value str">&quot;/&quot;</span>)
+        <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@storeuri</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">uri</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@storeuri</span> <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;/&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">uri</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000053" class="method-detail">
-        <a name="M000053"></a>
+      <div id="method-M000063" class="method-detail">
+        <a name="M000063"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000053.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000053.html');return false;">
+          <a href="#M000063" class="method-signature">
           <span class="method-name">configure_headers_for_conditional_get</span><span class="method-args">(u, headers, etags, if_match)</span>
           </a>
         </div>
@@ -341,15 +358,31 @@ Build a request uri, by concatenating it with the base uri of the store
           <p>
 Added appropriate http header for conditional get requests
 </p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000063-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000063-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 261</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">configure_headers_for_conditional_get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">etags</span>, <span class="ruby-identifier">if_match</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">etags</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">etags</span>.<span class="ruby-identifier">has_tag?</span>(<span class="ruby-identifier">u</span>)
+         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">if_match</span>
+           <span class="ruby-identifier">headers</span>[<span class="ruby-value str">&quot;If-Match&quot;</span>] = <span class="ruby-identifier">etags</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>)  
+         <span class="ruby-keyword kw">else</span>
+           <span class="ruby-identifier">headers</span>[<span class="ruby-value str">&quot;If-None-Match&quot;</span>] = <span class="ruby-identifier">etags</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>)
+         <span class="ruby-keyword kw">end</span>                  
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">headers</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000056" class="method-detail">
-        <a name="M000056"></a>
+      <div id="method-M000066" class="method-detail">
+        <a name="M000066"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000056.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000056.html');return false;">
+          <a href="#M000066" class="method-signature">
           <span class="method-name">delete_item</span><span class="method-args">(uri)</span>
           </a>
         </div>
@@ -366,15 +399,27 @@ Delete an item from the Contentbox in this <a href="Store.html">Store</a>
 <p>
 TODO: conditional deletes
 </p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000066-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000066-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 310</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_item</span>(<span class="ruby-identifier">uri</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">uri</span>.<span class="ruby-identifier">start_with?</span>(<span class="ruby-ivar">@storeuri</span>)
+        <span class="ruby-identifier">uri</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-identifier">uri</span>)
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">uri</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000042" class="method-detail">
-        <a name="M000042"></a>
+      <div id="method-M000052" class="method-detail">
+        <a name="M000052"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000042.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000042.html');return false;">
+          <a href="#M000052" class="method-signature">
           <span class="method-name">describe</span><span class="method-args">(uri, format=&quot;application/rdf+xml&quot;, etags=nil, if_match=false)</span>
           </a>
         </div>
@@ -386,7 +431,7 @@ be to retrieve an RDF/XML document, but other formats can be requested, as
 supported by the Talis Platform. E.g. application/json
 </p>
 <table>
-<tr><td valign="top">uri:</td><td>the URI of the resource to <a href="Store.html#M000042">describe</a>
+<tr><td valign="top">uri:</td><td>the URI of the resource to <a href="Store.html#M000052">describe</a>
 
 </td></tr>
 <tr><td valign="top">format:</td><td>the preferred response format
@@ -403,31 +448,45 @@ false to perform a Conditional GET
 </table>
 <p>
 Note that this method is different from <a
-href="Store.html#M000043">sparql_describe</a> in that it is intended to be
+href="Store.html#M000053">sparql_describe</a> in that it is intended to be
 used to generate a description of a single URI, using an separated service
 exposed by the Platform. This service is optimised for retrieval of
 descriptions for single resources and supports HTTP caching and conditional
-retrieval. The <a href="Store.html#M000043">sparql_describe</a> method
+retrieval. The <a href="Store.html#M000053">sparql_describe</a> method
 should be used to submit more complex DESCRIBE queries to the Platform,
 e.g. to generate descriptions of resources matching a particular graph
 pattern.
 </p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000052-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000052-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 128</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">describe</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>, <span class="ruby-identifier">etags</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">if_match</span>=<span class="ruby-keyword kw">false</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/meta&quot;</span>)
+      <span class="ruby-identifier">headers</span> = {<span class="ruby-value str">&quot;Accept&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">format</span>}
+      <span class="ruby-identifier">headers</span> = <span class="ruby-identifier">configure_headers_for_conditional_get</span>(<span class="ruby-node">&quot;#{u}?about=#{uri}&quot;</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">etags</span>, <span class="ruby-identifier">if_match</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, {<span class="ruby-value str">&quot;about&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">uri</span>}, <span class="ruby-identifier">headers</span> )
+      <span class="ruby-identifier">record_etags</span>(<span class="ruby-node">&quot;#{u}?about=#{uri}&quot;</span>, <span class="ruby-identifier">etags</span>, <span class="ruby-identifier">response</span>)        
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000049" class="method-detail">
-        <a name="M000049"></a>
+      <div id="method-M000059" class="method-detail">
+        <a name="M000059"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000049.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000049.html');return false;">
+          <a href="#M000059" class="method-signature">
           <span class="method-name">facet</span><span class="method-args">(query, facets, params=nil)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Perform a facetted <a href="Store.html#M000048">search</a> against the
+Perform a facetted <a href="Store.html#M000058">search</a> against the
 Metabox indexes.
 </p>
 <table>
@@ -446,7 +505,7 @@ The <em>params</em> hash can contain the following values:
 </p>
 <ul>
 <li><b>top</b>: the maximum number of results to return for each <a
-href="Store.html#M000049">facet</a>
+href="Store.html#M000059">facet</a>
 
 </li>
 <li><b>output</b>: the preferred response format, can be html or xml (the
@@ -454,15 +513,32 @@ default)
 
 </li>
 </ul>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000059-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000059-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 220</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">facet</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">facets</span>, <span class="ruby-identifier">params</span>=<span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">facets</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">facets</span>.<span class="ruby-identifier">empty?</span>
+        <span class="ruby-comment cmt">#todo</span>
+        <span class="ruby-identifier">throw</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/services/facet&quot;</span>)      
+      <span class="ruby-identifier">search_params</span> = <span class="ruby-identifier">get_search_params</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">query</span>, <span class="ruby-identifier">params</span>)
+      <span class="ruby-identifier">search_params</span>[<span class="ruby-value str">&quot;fields&quot;</span>] = <span class="ruby-identifier">facets</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot;,&quot;</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">search_params</span>, <span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>                             
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000066" class="method-detail">
-        <a name="M000066"></a>
+      <div id="method-M000073" class="method-detail">
+        <a name="M000073"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000066.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000066.html');return false;">
+          <a href="#M000073" class="method-signature">
           <span class="method-name">get_field_predicate_map</span><span class="method-args">(output=ACCEPT_JSON)</span>
           </a>
         </div>
@@ -482,15 +558,26 @@ specific stores&#8216;s configuration.
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000073-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000073-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 392</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_field_predicate_map</span>(<span class="ruby-identifier">output</span>=<span class="ruby-constant">ACCEPT_JSON</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/config/fpmaps/1&quot;</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">output</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>                  
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000057" class="method-detail">
-        <a name="M000057"></a>
+      <div id="method-M000067" class="method-detail">
+        <a name="M000067"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000057.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000057.html');return false;">
+          <a href="#M000067" class="method-signature">
           <span class="method-name">get_item</span><span class="method-args">(uri, etags=nil, if_match=false)</span>
           </a>
         </div>
@@ -512,6 +599,21 @@ the Metabox.
 <p>
 TODO: document etags, redirects
 </p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000067-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000067-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 324</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_item</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">etags</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">if_match</span>=<span class="ruby-keyword kw">false</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-identifier">uri</span>)
+      <span class="ruby-identifier">headers</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
+      <span class="ruby-identifier">headers</span> = <span class="ruby-identifier">configure_headers_for_conditional_get</span>(<span class="ruby-node">&quot;#{u}&quot;</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">etags</span>, <span class="ruby-identifier">if_match</span>)      
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">headers</span>)
+      <span class="ruby-identifier">record_etags</span>(<span class="ruby-node">&quot;#{u}&quot;</span>, <span class="ruby-identifier">etags</span>, <span class="ruby-identifier">response</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
@@ -519,8 +621,71 @@ TODO: document etags, redirects
         <a name="M000068"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000068.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000068.html');return false;">
+          <a href="#M000068" class="method-signature">
+          <span class="method-name">get_job</span><span class="method-args">(uri)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Retrieve metadata about a single job. Use <a
+href="Job.html#M000083">Job.read_from_store</a> as a convenience function
+which will return a fully-populated <a href="Job.html">Job</a> object
+</p>
+<table>
+<tr><td valign="top">uri:</td><td>the uri of the job to retrieve
+
+</td></tr>
+</table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000068-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000068-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 341</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_job</span>(<span class="ruby-identifier">uri</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-identifier">uri</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-constant">ACCEPT_RDF</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000069" class="method-detail">
+        <a name="M000069"></a>
+
+        <div class="method-heading">
+          <a href="#M000069" class="method-signature">
+          <span class="method-name">get_jobs</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Retrieve metadata about the Scheduled <a href="Jobs.html">Jobs</a>
+Collection from the store
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000069-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000069-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 348</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_jobs</span>()
+      <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/jobs&quot;</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-constant">ACCEPT_RDF</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000075" class="method-detail">
+        <a name="M000075"></a>
+
+        <div class="method-heading">
+          <a href="#M000075" class="method-signature">
           <span class="method-name">get_query_profile</span><span class="method-args">(output=ACCEPT_JSON)</span>
           </a>
         </div>
@@ -540,29 +705,55 @@ stores&#8216;s configuration.
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000075-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000075-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 413</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_query_profile</span>(<span class="ruby-identifier">output</span>=<span class="ruby-constant">ACCEPT_JSON</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/config/queryprofiles/1&quot;</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">output</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>                  
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000050" class="method-detail">
-        <a name="M000050"></a>
+      <div id="method-M000060" class="method-detail">
+        <a name="M000060"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000050.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000050.html');return false;">
+          <a href="#M000060" class="method-signature">
           <span class="method-name">get_search_params</span><span class="method-args">(u, query, params)</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000060-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000060-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 232</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_search_params</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">query</span>, <span class="ruby-identifier">params</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">params</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
+        <span class="ruby-identifier">search_params</span> = <span class="ruby-identifier">params</span>.<span class="ruby-identifier">clone</span>()
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">search_params</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>  
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">search_params</span>[<span class="ruby-value str">&quot;query&quot;</span>] = <span class="ruby-identifier">query</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">search_params</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000065" class="method-detail">
-        <a name="M000065"></a>
+      <div id="method-M000072" class="method-detail">
+        <a name="M000072"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000065.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000065.html');return false;">
+          <a href="#M000072" class="method-signature">
           <span class="method-name">get_snapshots</span><span class="method-args">()</span>
           </a>
         </div>
@@ -573,18 +764,29 @@ Retrieve the list of snapshots for this store
 </p>
 <p>
 Currently the response will contain an HTML document. Use <a
-href="Snapshot.html#M000070">Snapshot.parse</a> to turn this into a <a
+href="Snapshot.html#M000078">Snapshot.parse</a> to turn this into a <a
 href="Snapshot.html">Snapshot</a> object
 </p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000072-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000072-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 377</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_snapshots</span>()
+      <span class="ruby-identifier">u</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/snapshots&quot;</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-constant">ACCEPT_RDF</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000064" class="method-detail">
-        <a name="M000064"></a>
+      <div id="method-M000071" class="method-detail">
+        <a name="M000071"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000064.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000064.html');return false;">
+          <a href="#M000071" class="method-signature">
           <span class="method-name">get_status</span><span class="method-args">()</span>
           </a>
         </div>
@@ -593,15 +795,26 @@ href="Snapshot.html">Snapshot</a> object
           <p>
 ADMIN
 </p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000071-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000071-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 367</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_status</span>()
+      <span class="ruby-identifier">u</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/config/access-status&quot;</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-constant">ACCEPT_JSON</span> )
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000067" class="method-detail">
-        <a name="M000067"></a>
+      <div id="method-M000074" class="method-detail">
+        <a name="M000074"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000067.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000067.html');return false;">
+          <a href="#M000074" class="method-signature">
           <span class="method-name">put_field_predicate_map</span><span class="method-args">(data)</span>
           </a>
         </div>
@@ -618,15 +831,26 @@ convenience function
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000074-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000074-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 402</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_field_predicate_map</span>(<span class="ruby-identifier">data</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/config/fpmaps/1&quot;</span>)
+      <span class="ruby-identifier">headers</span> = {<span class="ruby-value str">&quot;Content-Type&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;application/rdf+xml&quot;</span>}
+      <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">put</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">data</span>, <span class="ruby-identifier">headers</span>)           
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000069" class="method-detail">
-        <a name="M000069"></a>
+      <div id="method-M000076" class="method-detail">
+        <a name="M000076"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000069.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000069.html');return false;">
+          <a href="#M000076" class="method-signature">
           <span class="method-name">put_query_profile</span><span class="method-args">(data)</span>
           </a>
         </div>
@@ -643,82 +867,51 @@ function
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000076-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000076-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 423</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_query_profile</span>(<span class="ruby-identifier">data</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/config/queryprofiles/1&quot;</span>)
+      <span class="ruby-identifier">headers</span> = {<span class="ruby-value str">&quot;Content-Type&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;application/rdf+xml&quot;</span>}
+      <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">put</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">data</span>, <span class="ruby-identifier">headers</span>)           
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000054" class="method-detail">
-        <a name="M000054"></a>
+      <div id="method-M000064" class="method-detail">
+        <a name="M000064"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000054.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000054.html');return false;">
+          <a href="#M000064" class="method-signature">
           <span class="method-name">record_etags</span><span class="method-args">(u, etags, response)</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000064-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000064-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 272</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">record_etags</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">etags</span>, <span class="ruby-identifier">response</span>)
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">etags</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">response</span>.<span class="ruby-identifier">status</span> = <span class="ruby-value">200</span>)        
+        <span class="ruby-identifier">etags</span>.<span class="ruby-identifier">add_from_response</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">response</span>)  
+      <span class="ruby-keyword kw">end</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000060" class="method-detail">
-        <a name="M000060"></a>
-
-        <div class="method-heading">
-          <a href="Store.src/M000060.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000060.html');return false;">
-          <span class="method-name">reindex</span><span class="method-args">(t=Time.now)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000059" class="method-detail">
-        <a name="M000059"></a>
-
-        <div class="method-heading">
-          <a href="Store.src/M000059.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000059.html');return false;">
-          <span class="method-name">reset</span><span class="method-args">(t=Time.now)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000062" class="method-detail">
-        <a name="M000062"></a>
-
-        <div class="method-heading">
-          <a href="Store.src/M000062.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000062.html');return false;">
-          <span class="method-name">restore</span><span class="method-args">(snapshot_url, t=Time.now)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-Restore this store from a previously generated <a
-href="Snapshot.html">Snapshot</a> The Platform can <a
-href="Store.html#M000062">restore</a> from any <a
-href="Store.html#M000061">snapshot</a> that is web-accessible
-</p>
-<table>
-<tr><td valign="top">snapshot_url:</td><td>the URL of the <a href="Store.html#M000061">snapshot</a>
-
-</td></tr>
-</table>
-        </div>
-      </div>
-
-      <div id="method-M000048" class="method-detail">
-        <a name="M000048"></a>
+      <div id="method-M000058" class="method-detail">
+        <a name="M000058"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000048.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000048.html');return false;">
+          <a href="#M000058" class="method-signature">
           <span class="method-name">search</span><span class="method-args">(query, params=nil)</span>
           </a>
         </div>
@@ -764,15 +957,28 @@ to the Platform. These parameters will only be used when an XSLT
 transformation is being applied, in which case they will be provided as
 parameters to the stylesheet.
 </p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000058-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000058-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 203</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">search</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">params</span>=<span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/items&quot;</span>)
+      <span class="ruby-identifier">search_params</span> = <span class="ruby-identifier">get_search_params</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">query</span>, <span class="ruby-identifier">params</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">search_params</span>, <span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>
+      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000037" class="method-detail">
-        <a name="M000037"></a>
+      <div id="method-M000047" class="method-detail">
+        <a name="M000047"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000037.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000037.html');return false;">
+          <a href="#M000047" class="method-signature">
           <span class="method-name">set_credentials</span><span class="method-args">(username, password)</span>
           </a>
         </div>
@@ -789,30 +995,25 @@ Set credentials that this store will use when carrying out authorization
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000047-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000047-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 57</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_credentials</span>(<span class="ruby-identifier">username</span>, <span class="ruby-identifier">password</span>)
+      <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">set_auth</span>(<span class="ruby-ivar">@storeuri</span>, <span class="ruby-identifier">username</span>, <span class="ruby-identifier">password</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000061" class="method-detail">
-        <a name="M000061"></a>
-
-        <div class="method-heading">
-          <a href="Store.src/M000061.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000061.html');return false;">
-          <span class="method-name">snapshot</span><span class="method-args">(t=Time.now)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
-      <div id="method-M000047" class="method-detail">
-        <a name="M000047"></a>
+      <div id="method-M000057" class="method-detail">
+        <a name="M000057"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000047.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000047.html');return false;">
-          <span class="method-name">sparql</span><span class="method-args">(query, format)</span>
+          <a href="#M000057" class="method-signature">
+          <span class="method-name">sparql</span><span class="method-args">(query, format=nil)</span>
           </a>
         </div>
       
@@ -824,15 +1025,31 @@ Perform a SPARQL query
  query:: the SPARQL query
  format:: the preferred response format
 </pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000057-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000057-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 177</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sparql</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/services/sparql&quot;</span>)
+      <span class="ruby-identifier">params</span> = {}
+      <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;query&quot;</span>] = <span class="ruby-identifier">query</span>
+      <span class="ruby-identifier">headers</span> = {}
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">format</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
+        <span class="ruby-identifier">headers</span>[<span class="ruby-value str">&quot;Accept&quot;</span>] = <span class="ruby-identifier">format</span>  
+      <span class="ruby-keyword kw">end</span>      
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">params</span>, <span class="ruby-identifier">headers</span>)        
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000045" class="method-detail">
-        <a name="M000045"></a>
+      <div id="method-M000055" class="method-detail">
+        <a name="M000055"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000045.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000045.html');return false;">
+          <a href="#M000055" class="method-signature">
           <span class="method-name">sparql_ask</span><span class="method-args">(query, format=&quot;application/sparql-results+xml&quot;)</span>
           </a>
         </div>
@@ -845,15 +1062,24 @@ Perform a SPARQL ASK query.
  query:: the SPARQL query
  format:: the preferred response format
 </pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000055-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000055-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 161</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sparql_ask</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/sparql-results+xml&quot;</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">sparql</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000044" class="method-detail">
-        <a name="M000044"></a>
+      <div id="method-M000054" class="method-detail">
+        <a name="M000054"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000044.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000044.html');return false;">
+          <a href="#M000054" class="method-signature">
           <span class="method-name">sparql_construct</span><span class="method-args">(query, format=&quot;application/rdf+xml&quot;)</span>
           </a>
         </div>
@@ -866,15 +1092,24 @@ Perform a SPARQL CONSTRUCT query.
  query:: the SPARQL query
  format:: the preferred response format
 </pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000054-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000054-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 153</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sparql_construct</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">sparql</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000043" class="method-detail">
-        <a name="M000043"></a>
+      <div id="method-M000053" class="method-detail">
+        <a name="M000053"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000043.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000043.html');return false;">
+          <a href="#M000053" class="method-signature">
           <span class="method-name">sparql_describe</span><span class="method-args">(query, format=&quot;application/rdf+xml&quot;)</span>
           </a>
         </div>
@@ -887,15 +1122,24 @@ Perform a SPARQL DESCRIBE query.
  query:: the SPARQL query
  format:: the preferred response format
 </pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000053-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000053-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 145</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sparql_describe</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">sparql</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000046" class="method-detail">
-        <a name="M000046"></a>
+      <div id="method-M000056" class="method-detail">
+        <a name="M000056"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000046.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000046.html');return false;">
+          <a href="#M000056" class="method-signature">
           <span class="method-name">sparql_select</span><span class="method-args">(query, format=&quot;application/sparql-results+xml&quot;)</span>
           </a>
         </div>
@@ -908,15 +1152,24 @@ Perform a SPARQL SELECT query.
  query:: the SPARQL query
  format:: the preferred response format
 </pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000056-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000056-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 169</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sparql_select</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/sparql-results+xml&quot;</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">sparql</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000039" class="method-detail">
-        <a name="M000039"></a>
+      <div id="method-M000049" class="method-detail">
+        <a name="M000049"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000039.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000039.html');return false;">
+          <a href="#M000049" class="method-signature">
           <span class="method-name">store_data</span><span class="method-args">(data)</span>
           </a>
         </div>
@@ -931,15 +1184,26 @@ store
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000049-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000049-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 80</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store_data</span>(<span class="ruby-identifier">data</span>)
+      <span class="ruby-identifier">u</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/meta&quot;</span>)
+      <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">post</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">data</span>, <span class="ruby-constant">RDF_XML</span> )
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000040" class="method-detail">
-        <a name="M000040"></a>
+      <div id="method-M000050" class="method-detail">
+        <a name="M000050"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000040.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000040.html');return false;">
+          <a href="#M000050" class="method-signature">
           <span class="method-name">store_file</span><span class="method-args">(file)</span>
           </a>
         </div>
@@ -956,15 +1220,26 @@ is submitted to the platform
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000050-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000050-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 89</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store_file</span>(<span class="ruby-identifier">file</span>)
+      <span class="ruby-identifier">data</span> = <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span>()
+      <span class="ruby-identifier">file</span>.<span class="ruby-identifier">close</span>()
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">store_data</span>(<span class="ruby-identifier">data</span>)
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000041" class="method-detail">
-        <a name="M000041"></a>
+      <div id="method-M000051" class="method-detail">
+        <a name="M000051"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000041.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000041.html');return false;">
+          <a href="#M000051" class="method-signature">
           <span class="method-name">store_url</span><span class="method-args">(u, parameters=nil)</span>
           </a>
         </div>
@@ -988,29 +1263,68 @@ URL
 
 </td></tr>
 </table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000051-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000051-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 102</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store_url</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">parameters</span>=<span class="ruby-keyword kw">nil</span>)
+      
+      <span class="ruby-identifier">headers</span> = <span class="ruby-constant">ACCEPT_RDF</span>.<span class="ruby-identifier">clone</span>()
+      <span class="ruby-identifier">dataresp</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">parameters</span>, <span class="ruby-identifier">headers</span> )
+      
+      <span class="ruby-comment cmt">#TODO make this more robust</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">dataresp</span>.<span class="ruby-identifier">status</span> <span class="ruby-operator">!=</span> <span class="ruby-value">200</span>
+          <span class="ruby-identifier">throw</span>  
+      <span class="ruby-keyword kw">end</span>
+      
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">store_data</span>(<span class="ruby-identifier">dataresp</span>.<span class="ruby-identifier">content</span>)
+      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000063" class="method-detail">
-        <a name="M000063"></a>
+      <div id="method-M000070" class="method-detail">
+        <a name="M000070"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000063.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000063.html');return false;">
-          <span class="method-name">submit_job</span><span class="method-args">(joburi, label, t=Time.now)</span>
+          <a href="#M000070" class="method-signature">
+          <span class="method-name">submit_job</span><span class="method-args">(data)</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p>
+Submit a job to the platform.
+</p>
+<table>
+<tr><td valign="top">data:</td><td>RDF/XML representing the job request. See methods on <a
+href="Jobs.html">Jobs</a> class
+
+</td></tr>
+</table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000070-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000070-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 357</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">submit_job</span>(<span class="ruby-identifier">data</span>)
+        <span class="ruby-identifier">u</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/jobs&quot;</span>)
+        <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">post</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">data</span>, <span class="ruby-constant">RDF_XML</span> )
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>          
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>
 
-      <div id="method-M000055" class="method-detail">
-        <a name="M000055"></a>
+      <div id="method-M000065" class="method-detail">
+        <a name="M000065"></a>
 
         <div class="method-heading">
-          <a href="Store.src/M000055.html" target="Code" class="method-signature"
-            onclick="popupCode('Store.src/M000055.html');return false;">
+          <a href="#M000065" class="method-signature">
           <span class="method-name">upload_item</span><span class="method-args">(f, mimetype, uri=nil)</span>
           </a>
         </div>
@@ -1037,6 +1351,28 @@ Created response with a Location header containing the URI of the newly
 stored item. If a URI is specified then a successful request will result in
 a 200 OK response.
 </p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000065-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000065-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/store.rb, line 291</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">upload_item</span>(<span class="ruby-identifier">f</span>, <span class="ruby-identifier">mimetype</span>, <span class="ruby-identifier">uri</span>=<span class="ruby-keyword kw">nil</span>)
+      <span class="ruby-identifier">data</span> = <span class="ruby-identifier">f</span>.<span class="ruby-identifier">read</span>()
+      <span class="ruby-identifier">f</span>.<span class="ruby-identifier">close</span>()
+      <span class="ruby-identifier">headers</span> = {<span class="ruby-value str">&quot;Content-Type&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">mimetype</span>}
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">uri</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
+        <span class="ruby-identifier">u</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">build_uri</span>(<span class="ruby-value str">&quot;/items&quot;</span>)        
+        <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">post</span>(<span class="ruby-identifier">u</span>, <span class="ruby-identifier">data</span>, <span class="ruby-identifier">headers</span>)
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">uri</span>.<span class="ruby-identifier">start_with?</span>(<span class="ruby-ivar">@storeuri</span>)
+          <span class="ruby-identifier">uri</span> = <span class="ruby-identifier">build_uri</span>(<span class="ruby-identifier">uri</span>)
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">response</span> = <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">put</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">data</span>, <span class="ruby-identifier">headers</span>)
+      <span class="ruby-keyword kw">end</span>      
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
         </div>
       </div>