pho 0.5 → 0.6

data/doc/rdoc/classes/Pho/Sparql/SparqlHelper.html

@@ -93,16 +93,17 @@ manipulating the results
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000011">apply_initial_bindings</a>&nbsp;&nbsp;
-      <a href="#M000015">ask</a>&nbsp;&nbsp;
-      <a href="#M000018">construct_to_resource_hash</a>&nbsp;&nbsp;
-      <a href="#M000019">describe_to_resource_hash</a>&nbsp;&nbsp;
-      <a href="#M000020">multi_describe</a>&nbsp;&nbsp;
-      <a href="#M000012">result_to_query_binding</a>&nbsp;&nbsp;
-      <a href="#M000013">results_to_query_bindings</a>&nbsp;&nbsp;
-      <a href="#M000014">select</a>&nbsp;&nbsp;
-      <a href="#M000017">select_single_value</a>&nbsp;&nbsp;
-      <a href="#M000016">select_values</a>&nbsp;&nbsp;
+      <a href="#M000012">apply_initial_bindings</a>&nbsp;&nbsp;
+      <a href="#M000016">ask</a>&nbsp;&nbsp;
+      <a href="#M000019">construct_to_resource_hash</a>&nbsp;&nbsp;
+      <a href="#M000020">describe_to_resource_hash</a>&nbsp;&nbsp;
+      <a href="#M000022">describe_uri</a>&nbsp;&nbsp;
+      <a href="#M000021">multi_describe</a>&nbsp;&nbsp;
+      <a href="#M000013">result_to_query_binding</a>&nbsp;&nbsp;
+      <a href="#M000014">results_to_query_bindings</a>&nbsp;&nbsp;
+      <a href="#M000015">select</a>&nbsp;&nbsp;
+      <a href="#M000018">select_single_value</a>&nbsp;&nbsp;
+      <a href="#M000017">select_values</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -137,11 +138,11 @@ manipulating the results
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000011" class="method-detail">
-        <a name="M000011"></a>
+      <div id="method-M000012" class="method-detail">
+        <a name="M000012"></a>
 
         <div class="method-heading">
-          <a href="#M000011" class="method-signature">
+          <a href="#M000012" class="method-signature">
           <span class="method-name">apply_initial_bindings</span><span class="method-args">(query, bindings={})</span>
           </a>
         </div>
@@ -159,15 +160,19 @@ literals according to Turtle syntax.
 Any keys in the hash that are not in the query are ignored. Any variables
 not found in the hash remain unbound.
 </p>
-<pre>
-  query:: the query whose initial bindings are to be set
-  values:: hash of query name to value
-</pre>
+<table>
+<tr><td valign="top">query:</td><td>the query whose initial bindings are to be set
+
+</td></tr>
+<tr><td valign="top">values:</td><td>hash of query name to value
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000011-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000011-source">
+            onclick="toggleCode('M000012-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000012-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 159</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 260</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">apply_initial_bindings</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">bindings</span>={})
             <span class="ruby-identifier">copy</span> = <span class="ruby-identifier">query</span>.<span class="ruby-identifier">clone</span>()
             <span class="ruby-identifier">copy</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-constant">VARIABLE_MATCHER</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">pattern</span><span class="ruby-operator">|</span>
@@ -185,11 +190,11 @@ not found in the hash remain unbound.
         </div>
       </div>
 
-      <div id="method-M000015" class="method-detail">
-        <a name="M000015"></a>
+      <div id="method-M000016" class="method-detail">
+        <a name="M000016"></a>
 
         <div class="method-heading">
-          <a href="#M000015" class="method-signature">
+          <a href="#M000016" class="method-signature">
           <span class="method-name">ask</span><span class="method-args">(query, sparql_client)</span>
           </a>
         </div>
@@ -203,15 +208,19 @@ response
 Will request the results using the SPARQL JSON results format, parse the
 resulting JSON results, and extract the true/false response.
 </p>
-<pre>
- query:: the SPARQL SELECT query
- sparql_client:: a configured SparqlClient object
-</pre>
+<table>
+<tr><td valign="top">query:</td><td>the SPARQL SELECT query
+
+</td></tr>
+<tr><td valign="top">sparql_client:</td><td>a configured <a href="SparqlClient.html">SparqlClient</a> object
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000015-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000015-source">
+            onclick="toggleCode('M000016-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000016-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 242</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 343</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">ask</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">sparql_client</span>)
           <span class="ruby-identifier">json</span> = <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">select</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">sparql_client</span>)
           <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">json</span>[<span class="ruby-value str">&quot;boolean&quot;</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;true&quot;</span>
@@ -221,11 +230,11 @@ resulting JSON results, and extract the true/false response.
         </div>
       </div>
 
-      <div id="method-M000018" class="method-detail">
-        <a name="M000018"></a>
+      <div id="method-M000019" class="method-detail">
+        <a name="M000019"></a>
 
         <div class="method-heading">
-          <a href="#M000018" class="method-signature">
+          <a href="#M000019" class="method-signature">
           <span class="method-name">construct_to_resource_hash</span><span class="method-args">(query, sparql_client)</span>
           </a>
         </div>
@@ -239,15 +248,19 @@ results in JSON
 Will request the results as application/json (with the expectation that it
 returns RDF_JSON), and parses the resulting JSON document.
 </p>
-<pre>
- query:: the SPARQL SELECT query
- sparql_client:: a configured SparqlClient object
-</pre>
+<table>
+<tr><td valign="top">query:</td><td>the SPARQL SELECT query
+
+</td></tr>
+<tr><td valign="top">sparql_client:</td><td>a configured <a href="SparqlClient.html">SparqlClient</a> object
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000018-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000018-source">
+            onclick="toggleCode('M000019-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000019-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 290</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 391</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">construct_to_resource_hash</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">sparql_client</span>)
           <span class="ruby-comment cmt">#TODO: test whether endpoint supports json, and if not, switch to parsing XML</span>
           <span class="ruby-identifier">resp</span> = <span class="ruby-identifier">sparql_client</span>.<span class="ruby-identifier">construct</span>(<span class="ruby-identifier">query</span>, <span class="ruby-value str">&quot;application/json&quot;</span>)
@@ -261,11 +274,11 @@ returns RDF_JSON), and parses the resulting JSON document.
         </div>
       </div>
 
-      <div id="method-M000019" class="method-detail">
-        <a name="M000019"></a>
+      <div id="method-M000020" class="method-detail">
+        <a name="M000020"></a>
 
         <div class="method-heading">
-          <a href="#M000019" class="method-signature">
+          <a href="#M000020" class="method-signature">
           <span class="method-name">describe_to_resource_hash</span><span class="method-args">(query, sparql_client)</span>
           </a>
         </div>
@@ -279,15 +292,19 @@ in JSON
 Will request the results as application/json (with the expectation that it
 returns RDF_JSON), and parses the resulting JSON document.
 </p>
-<pre>
- query:: the SPARQL SELECT query
- sparql_client:: a configured SparqlClient object
-</pre>
+<table>
+<tr><td valign="top">query:</td><td>the SPARQL SELECT query
+
+</td></tr>
+<tr><td valign="top">sparql_client:</td><td>a configured <a href="SparqlClient.html">SparqlClient</a> object
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000019-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000019-source">
+            onclick="toggleCode('M000020-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000020-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 306</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 407</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">describe_to_resource_hash</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">sparql_client</span>)
           <span class="ruby-comment cmt">#TODO: test whether endpoint supports json, and if not, switch to parsing XML</span>
           <span class="ruby-identifier">resp</span> = <span class="ruby-identifier">sparql_client</span>.<span class="ruby-identifier">describe</span>(<span class="ruby-identifier">query</span>, <span class="ruby-value str">&quot;application/json&quot;</span>)
@@ -301,28 +318,75 @@ returns RDF_JSON), and parses the resulting JSON document.
         </div>
       </div>
 
-      <div id="method-M000020" class="method-detail">
-        <a name="M000020"></a>
+      <div id="method-M000022" class="method-detail">
+        <a name="M000022"></a>
 
         <div class="method-heading">
-          <a href="#M000020" class="method-signature">
-          <span class="method-name">multi_describe</span><span class="method-args">(uris, sparql_client)</span>
+          <a href="#M000022" class="method-signature">
+          <span class="method-name">describe_uri</span><span class="method-args">(uri, sparql_client, type=:cbd)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-DESCRIBE multiple resources in a single SPARQL request
+Describe a single URI using one of several forms of Bounded Description See
+<a href="SparqlClient.html#M000006">SparqlClient.describe_uri</a>
 </p>
+<table>
+<tr><td valign="top">uri:</td><td>resource to describe
+
+</td></tr>
+<tr><td valign="top">sparql_client:</td><td>configured SPARQL client
+
+</td></tr>
+<tr><td valign="top">type:</td><td>form of bounded description to generate
+
+</td></tr>
+</table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000022-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000022-source">
 <pre>
- uris:: an array of URIs
- sparql_client:: a configured SparqlClient objec
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 435</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">describe_uri</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">sparql_client</span>, <span class="ruby-identifier">type</span>=<span class="ruby-identifier">:cbd</span>)
+          <span class="ruby-comment cmt">#TODO: test whether endpoint supports json, and if not, switch to parsing XML</span>
+          <span class="ruby-identifier">resp</span> = <span class="ruby-identifier">sparql_client</span>.<span class="ruby-identifier">describe_uri</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-value str">&quot;application/json&quot;</span>, <span class="ruby-identifier">type</span>)
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">resp</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-node">&quot;Error performing sparql query: #{resp.status} #{resp.reason}\n#{resp.content}&quot;</span>
+          <span class="ruby-keyword kw">end</span>
+          <span class="ruby-keyword kw">return</span> <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">ResourceHash</span><span class="ruby-operator">::</span><span class="ruby-constant">Converter</span>.<span class="ruby-identifier">parse_json</span>( <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">content</span> )                              
+        <span class="ruby-keyword kw">end</span>
 </pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000021" class="method-detail">
+        <a name="M000021"></a>
+
+        <div class="method-heading">
+          <a href="#M000021" class="method-signature">
+          <span class="method-name">multi_describe</span><span class="method-args">(uris, sparql_client)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+DESCRIBE multiple resources in a single SPARQL request
+</p>
+<table>
+<tr><td valign="top">uris:</td><td>an array of URIs
+
+</td></tr>
+<tr><td valign="top">sparql_client:</td><td>a configured <a href="SparqlClient.html">SparqlClient</a> objec
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000020-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000020-source">
+            onclick="toggleCode('M000021-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000021-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 319</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 420</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">multi_describe</span>(<span class="ruby-identifier">uris</span>, <span class="ruby-identifier">sparql_client</span>)
           <span class="ruby-comment cmt">#TODO: test whether endpoint supports json, and if not, switch to parsing XML</span>
           <span class="ruby-identifier">resp</span> = <span class="ruby-identifier">sparql_client</span>.<span class="ruby-identifier">multi_describe</span>(<span class="ruby-identifier">uris</span>, <span class="ruby-value str">&quot;application/json&quot;</span>)
@@ -336,11 +400,11 @@ DESCRIBE multiple resources in a single SPARQL request
         </div>
       </div>
 
-      <div id="method-M000012" class="method-detail">
-        <a name="M000012"></a>
+      <div id="method-M000013" class="method-detail">
+        <a name="M000013"></a>
 
         <div class="method-heading">
-          <a href="#M000012" class="method-signature">
+          <a href="#M000013" class="method-signature">
           <span class="method-name">result_to_query_binding</span><span class="method-args">(result)</span>
           </a>
         </div>
@@ -348,7 +412,7 @@ DESCRIBE multiple resources in a single SPARQL request
         <div class="method-description">
           <p>
 Convert a SPARQL query result binding into a hash suitable for passing to
-the <a href="SparqlHelper.html#M000011">apply_initial_bindings</a> method.
+the <a href="SparqlHelper.html#M000012">apply_initial_bindings</a> method.
 </p>
 <p>
 The result param is assumed to be a Ruby hash that reflects the structure
@@ -358,17 +422,20 @@ result binding.
 </p>
 <p>
 The method is intended to be used to support cases where an initial <a
-href="SparqlHelper.html#M000014">select</a> query is performed to extract
+href="SparqlHelper.html#M000015">select</a> query is performed to extract
 some variables that can later be plugged into a subsequent query
 </p>
-<pre>
- result:: hash conforming to structure of a &lt;tt&gt;binding&lt;/tt&gt; in the SPARQL JSON format
-</pre>
+<table>
+<tr><td valign="top">result:</td><td>hash conforming to structure of a <tt>binding</tt> in the SPARQL JSON
+format
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000012-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000012-source">
+            onclick="toggleCode('M000013-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000013-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 184</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 285</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">result_to_query_binding</span>(<span class="ruby-identifier">result</span>)
           <span class="ruby-identifier">hash</span> = {}
           <span class="ruby-identifier">result</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
@@ -389,11 +456,11 @@ some variables that can later be plugged into a subsequent query
         </div>
       </div>
 
-      <div id="method-M000013" class="method-detail">
-        <a name="M000013"></a>
+      <div id="method-M000014" class="method-detail">
+        <a name="M000014"></a>
 
         <div class="method-heading">
-          <a href="#M000013" class="method-signature">
+          <a href="#M000014" class="method-signature">
           <span class="method-name">results_to_query_bindings</span><span class="method-args">(results)</span>
           </a>
         </div>
@@ -402,23 +469,25 @@ some variables that can later be plugged into a subsequent query
           <p>
 Convert Ruby hash structured according to SPARQL JSON format into an array
 of hashes by calling <a
-href="SparqlHelper.html#M000012">result_to_query_binding</a> on each
+href="SparqlHelper.html#M000013">result_to_query_binding</a> on each
 binding into the results.
 </p>
 <p>
-E.g:
+E.g: <tt>results = <a
+href="SparqlHelper.html#M000015">Pho::Sparql::SparqlHelper.select</a>(query,
+sparql_client)</tt> <tt>bindings = <a
+href="SparqlHelper.html#M000014">Pho::Sparql::SparqlHelper.results_to_query_bindings(results)</a></tt>
 </p>
-<pre>
- &lt;tt&gt;results = Pho::Sparql::SparqlHelper.select(query, sparql_client)&lt;/tt&gt;
- &lt;tt&gt;bindings = Pho::Sparql::SparqlHelper.results_to_query_bindings(results)&lt;/tt&gt;
+<table>
+<tr><td valign="top">results:</td><td>hash conforming to SPARQL SELECT structure
 
-  results:: hash conforming to SPARQL SELECT structure
-</pre>
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000013-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000013-source">
+            onclick="toggleCode('M000014-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000014-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 209</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 310</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">results_to_query_bindings</span>(<span class="ruby-identifier">results</span>)
           <span class="ruby-identifier">bindings</span> = []
           
@@ -432,11 +501,11 @@ E.g:
         </div>
       </div>
 
-      <div id="method-M000014" class="method-detail">
-        <a name="M000014"></a>
+      <div id="method-M000015" class="method-detail">
+        <a name="M000015"></a>
 
         <div class="method-heading">
-          <a href="#M000014" class="method-signature">
+          <a href="#M000015" class="method-signature">
           <span class="method-name">select</span><span class="method-args">(query, sparql_client)</span>
           </a>
         </div>
@@ -450,15 +519,19 @@ The result will therefore be a simple ruby hash of the results
 <p>
 An error will be raised if the response is HTTP OK.
 </p>
-<pre>
- query:: the SPARQL SELECT query
- sparql_client:: a configured SparqlClient object
-</pre>
+<table>
+<tr><td valign="top">query:</td><td>the SPARQL SELECT query
+
+</td></tr>
+<tr><td valign="top">sparql_client:</td><td>a configured <a href="SparqlClient.html">SparqlClient</a> object
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000014-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000014-source">
+            onclick="toggleCode('M000015-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000015-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 226</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 327</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">select</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">sparql_client</span>)
           <span class="ruby-comment cmt">#TODO: test whether endpoint supports json, and if not, switch to parsing XML</span>
           <span class="ruby-identifier">resp</span> = <span class="ruby-identifier">sparql_client</span>.<span class="ruby-identifier">select</span>(<span class="ruby-identifier">query</span>, <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Sparql</span><span class="ruby-operator">::</span><span class="ruby-constant">SPARQL_RESULTS_JSON</span>)
@@ -472,11 +545,11 @@ An error will be raised if the response is HTTP OK.
         </div>
       </div>
 
-      <div id="method-M000017" class="method-detail">
-        <a name="M000017"></a>
+      <div id="method-M000018" class="method-detail">
+        <a name="M000018"></a>
 
         <div class="method-heading">
-          <a href="#M000017" class="method-signature">
+          <a href="#M000018" class="method-signature">
           <span class="method-name">select_single_value</span><span class="method-args">(query, sparql_client)</span>
           </a>
         </div>
@@ -494,15 +567,19 @@ a single value (i.e single variable, with single binding)
 Note this will lose any type information, only the value of the binding is
 returned
 </p>
-<pre>
- query:: the SPARQL SELECT query
- sparql_client:: a configured SparqlClient object
-</pre>
+<table>
+<tr><td valign="top">query:</td><td>the SPARQL SELECT query
+
+</td></tr>
+<tr><td valign="top">sparql_client:</td><td>a configured <a href="SparqlClient.html">SparqlClient</a> object
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000017-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000017-source">
+            onclick="toggleCode('M000018-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000018-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 277</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 378</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">select_single_value</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">sparql_client</span>)
           <span class="ruby-identifier">results</span> = <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">select</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">sparql_client</span>)
           <span class="ruby-identifier">v</span> = <span class="ruby-identifier">results</span>[<span class="ruby-value str">&quot;head&quot;</span>][<span class="ruby-value str">&quot;vars&quot;</span>][<span class="ruby-value">0</span>];
@@ -513,11 +590,11 @@ returned
         </div>
       </div>
 
-      <div id="method-M000016" class="method-detail">
-        <a name="M000016"></a>
+      <div id="method-M000017" class="method-detail">
+        <a name="M000017"></a>
 
         <div class="method-heading">
-          <a href="#M000016" class="method-signature">
+          <a href="#M000017" class="method-signature">
           <span class="method-name">select_values</span><span class="method-args">(query, sparql_client)</span>
           </a>
         </div>
@@ -537,15 +614,19 @@ an array
 Note this will lose any type information, only the value of the bindings
 are returned
 </p>
-<pre>
- query:: the SPARQL SELECT query
- sparql_client:: a configured SparqlClient object
-</pre>
+<table>
+<tr><td valign="top">query:</td><td>the SPARQL SELECT query
+
+</td></tr>
+<tr><td valign="top">sparql_client:</td><td>a configured <a href="SparqlClient.html">SparqlClient</a> object
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000016-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000016-source">
+            onclick="toggleCode('M000017-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000017-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 257</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 358</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">select_values</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">sparql_client</span>)
            <span class="ruby-identifier">results</span> = <span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">select</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">sparql_client</span>)
            <span class="ruby-identifier">v</span> = <span class="ruby-identifier">results</span>[<span class="ruby-value str">&quot;head&quot;</span>][<span class="ruby-value str">&quot;vars&quot;</span>][<span class="ruby-value">0</span>];