pho 0.4.1 → 0.5

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

@@ -81,7 +81,7 @@
     <div id="description">
       <p>
 In the Talis Platform a &quot;snapshot&quot; is an <a
-href="Snapshot.html#M000111">backup</a> of the contents of a <a
+href="Snapshot.html#M000159">backup</a> of the contents of a <a
 href="Store.html">Store</a>
 </p>
 <p>
@@ -102,11 +102,11 @@ A snapshot can be generated (or scheduled) using the Store.snapshot method.
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000111">backup</a>&nbsp;&nbsp;
-      <a href="#M000109">new</a>&nbsp;&nbsp;
-      <a href="#M000108">parse</a>&nbsp;&nbsp;
-      <a href="#M000107">read_from_store</a>&nbsp;&nbsp;
-      <a href="#M000110">read_md5</a>&nbsp;&nbsp;
+      <a href="#M000159">backup</a>&nbsp;&nbsp;
+      <a href="#M000157">new</a>&nbsp;&nbsp;
+      <a href="#M000156">parse</a>&nbsp;&nbsp;
+      <a href="#M000155">read_from_store</a>&nbsp;&nbsp;
+      <a href="#M000158">read_md5</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -176,19 +176,19 @@ The URL from which the snapshot can be retrieved
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000109" class="method-detail">
-        <a name="M000109"></a>
+      <div id="method-M000157" class="method-detail">
+        <a name="M000157"></a>
 
         <div class="method-heading">
-          <a href="#M000109" class="method-signature">
+          <a href="#M000157" 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('M000109-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000109-source">
+            onclick="toggleCode('M000157-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000157-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>)
@@ -203,21 +203,21 @@ The URL from which the snapshot can be retrieved
         </div>
       </div>
 
-      <div id="method-M000108" class="method-detail">
-        <a name="M000108"></a>
+      <div id="method-M000156" class="method-detail">
+        <a name="M000156"></a>
 
         <div class="method-heading">
-          <a href="#M000108" class="method-signature">
+          <a href="#M000156" 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#M000108">parse</a> the RDF response
+Class method to <a href="Snapshot.html#M000156">parse</a> the RDF response
 from the API, e.g. as produced by the <a
-href="Store.html#M000102">Store.get_snapshots</a> method and create a <a
-href="Snapshot.html#M000109">new</a> <a href="Snapshot.html">Snapshot</a>
+href="Store.html#M000150">Store.get_snapshots</a> method and create a <a
+href="Snapshot.html#M000157">new</a> <a href="Snapshot.html">Snapshot</a>
 object. At the moment the Platform only supports single snapshot.
 </p>
 <p>
@@ -228,8 +228,8 @@ If the response was an error, then an exception will be thrown
  content:: response from the API
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000108-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000108-source">
+            onclick="toggleCode('M000156-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000156-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>)
@@ -260,11 +260,11 @@ If the response was an error, then an exception will be thrown
         </div>
       </div>
 
-      <div id="method-M000107" class="method-detail">
-        <a name="M000107"></a>
+      <div id="method-M000155" class="method-detail">
+        <a name="M000155"></a>
 
         <div class="method-heading">
-          <a href="#M000107" class="method-signature">
+          <a href="#M000155" class="method-signature">
           <span class="method-name">read_from_store</span><span class="method-args">(store)</span>
           </a>
         </div>
@@ -279,8 +279,8 @@ Read snapshot data from the given store
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000107-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000107-source">
+            onclick="toggleCode('M000155-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000155-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>)
@@ -300,11 +300,11 @@ Read snapshot data from the given store
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000111" class="method-detail">
-        <a name="M000111"></a>
+      <div id="method-M000159" class="method-detail">
+        <a name="M000159"></a>
 
         <div class="method-heading">
-          <a href="#M000111" class="method-signature">
+          <a href="#M000159" class="method-signature">
           <span class="method-name">backup</span><span class="method-args">(store, dir=Dir.tmpdir)</span>
           </a>
         </div>
@@ -317,7 +317,7 @@ published value. If they don&#8216;t match then a RuntimeError will be
 raised
 </p>
 <table>
-<tr><td valign="top">store:</td><td>the store to <a href="Snapshot.html#M000111">backup</a>
+<tr><td valign="top">store:</td><td>the store to <a href="Snapshot.html#M000159">backup</a>
 
 </td></tr>
 <tr><td valign="top">dir:</td><td>directory in which snapshot will be stored
@@ -325,8 +325,8 @@ raised
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000111-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000111-source">
+            onclick="toggleCode('M000159-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000159-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>)
@@ -356,11 +356,11 @@ raised
         </div>
       </div>
 
-      <div id="method-M000110" class="method-detail">
-        <a name="M000110"></a>
+      <div id="method-M000158" class="method-detail">
+        <a name="M000158"></a>
 
         <div class="method-heading">
-          <a href="#M000110" class="method-signature">
+          <a href="#M000158" class="method-signature">
           <span class="method-name">read_md5</span><span class="method-args">(client=HttpClient.new())</span>
           </a>
         </div>
@@ -370,8 +370,8 @@ raised
 Read the published MD5 value
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000110-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000110-source">
+            onclick="toggleCode('M000158-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000158-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>())

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

@@ -0,0 +1,137 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Module: Pho::Sparql</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Module</strong></td>
+          <td class="class-name-in-header">Pho::Sparql</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../files/lib/pho/sparql_rb.html">
+                lib/pho/sparql.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+    <div id="description">
+      <p>
+Module providing a SPARQL client library, support for parsing SPARQL query
+responses into Ruby objects and other useful behaviour
+</p>
+
+    </div>
+
+
+   </div>
+
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+
+      Class <a href="Sparql/SparqlClient.html" class="link">Pho::Sparql::SparqlClient</a><br />
+Class <a href="Sparql/SparqlHelper.html" class="link">Pho::Sparql::SparqlHelper</a><br />
+
+    </div>
+
+    <div id="constants-list">
+      <h3 class="section-bar">Constants</h3>
+
+      <div class="name-list">
+        <table summary="Constants">
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">SPARQL_RESULTS_XML</td>
+          <td>=</td>
+          <td class="context-item-value">&quot;application/sparql-results+xml&quot;</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">SPARQL_RESULTS_JSON</td>
+          <td>=</td>
+          <td class="context-item-value">&quot;application/sparql-results+json&quot;</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+
+
+
+      
+
+
+    <!-- if method_list -->
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>

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

@@ -0,0 +1,515 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Class: Pho::Sparql::SparqlClient</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Class</strong></td>
+          <td class="class-name-in-header">Pho::Sparql::SparqlClient</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../../files/lib/pho/sparql_rb.html">
+                lib/pho/sparql.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                Object
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+    <div id="description">
+      <p>
+A simple SPARQL client that handles the basic HTTP traffic
+</p>
+
+    </div>
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000003">add_default_graph</a>&nbsp;&nbsp;
+      <a href="#M000004">add_named_graph</a>&nbsp;&nbsp;
+      <a href="#M000009">ask</a>&nbsp;&nbsp;
+      <a href="#M000008">construct</a>&nbsp;&nbsp;
+      <a href="#M000006">describe</a>&nbsp;&nbsp;
+      <a href="#M000007">multi_describe</a>&nbsp;&nbsp;
+      <a href="#M000002">new</a>&nbsp;&nbsp;
+      <a href="#M000005">query</a>&nbsp;&nbsp;
+      <a href="#M000010">select</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+
+
+
+
+    <div id="attribute-list">
+      <h3 class="section-bar">Attributes</h3>
+
+      <div class="name-list">
+        <table>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">client</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc">
+HTTPClient object
+
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">endpoint</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc">
+URI of the endpoint
+
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">graphs</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">named_graphs</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">output_parameter_name</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc">
+Name of output parameter to use to control response format. If set then
+this parameter is added to the <a
+href="SparqlClient.html#M000005">query</a> string, rather than using
+Content Negotiation
+
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">supports_rdf_json</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc">
+Configures whether the remote endpoint supports the RDF-in-JSON
+specification for serializing RDF graphs as JSON. Will default to false.
+
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">supports_sparql_json</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc">
+Configures whether the remote endpoint supports SPARQL JSON Results format
+Will default to true.
+
+</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+
+      <div id="method-M000002" class="method-detail">
+        <a name="M000002"></a>
+
+        <div class="method-heading">
+          <a href="#M000002" class="method-signature">
+          <span class="method-name">new</span><span class="method-args">(endpoint, client=HTTPClient.new() )</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Initialize a client for a specific endpoint
+</p>
+<pre>
+ endpoint:: uri of the SPARQL endpoint
+ client:: optionally, a reference to an existing HTTPClient object instance
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000002-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 34</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">endpoint</span>, <span class="ruby-identifier">client</span>=<span class="ruby-constant">HTTPClient</span>.<span class="ruby-identifier">new</span>() )
+         <span class="ruby-ivar">@endpoint</span> = <span class="ruby-identifier">endpoint</span>
+         <span class="ruby-ivar">@graphs</span> = <span class="ruby-keyword kw">nil</span>
+         <span class="ruby-ivar">@named_graphs</span> = <span class="ruby-keyword kw">nil</span>
+         <span class="ruby-ivar">@client</span> = <span class="ruby-identifier">client</span>
+         <span class="ruby-ivar">@output_parameter_name</span> = <span class="ruby-keyword kw">nil</span>
+         <span class="ruby-ivar">@supports_rdf_json</span> = <span class="ruby-keyword kw">false</span>
+         <span class="ruby-ivar">@supports_sparql_json</span> = <span class="ruby-keyword kw">true</span>
+        <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <h3 class="section-bar">Public Instance methods</h3>
+
+      <div id="method-M000003" class="method-detail">
+        <a name="M000003"></a>
+
+        <div class="method-heading">
+          <a href="#M000003" class="method-signature">
+          <span class="method-name">add_default_graph</span><span class="method-args">(graph_uri)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Add a default graph. This will be added as a default graph in the request
+protocol
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000003-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000003-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 45</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_default_graph</span>(<span class="ruby-identifier">graph_uri</span>)
+          <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@graphs</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
+             <span class="ruby-ivar">@graphs</span> = []
+          <span class="ruby-keyword kw">end</span>  
+          <span class="ruby-ivar">@graphs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">graph_uri</span>
+        <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000004" class="method-detail">
+        <a name="M000004"></a>
+
+        <div class="method-heading">
+          <a href="#M000004" class="method-signature">
+          <span class="method-name">add_named_graph</span><span class="method-args">(graph_uri)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Add a named graph. This will be added as a named graph in the request
+protocol
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000004-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 53</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_named_graph</span>(<span class="ruby-identifier">graph_uri</span>)
+          <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@named_graphs</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
+            <span class="ruby-ivar">@named_graphs</span> = []
+          <span class="ruby-keyword kw">end</span>  
+          <span class="ruby-ivar">@named_graphs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">graph_uri</span>
+        <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000009" class="method-detail">
+        <a name="M000009"></a>
+
+        <div class="method-heading">
+          <a href="#M000009" class="method-signature">
+          <span class="method-name">ask</span><span class="method-args">(query, format=Pho::Sparql::SPARQL_RESULTS_XML)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Perform a SPARQL ASK <a href="SparqlClient.html#M000005">query</a>.
+</p>
+<pre>
+ query:: the SPARQL query
+ format:: the preferred response format
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000009-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000009-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 130</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ask</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</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_XML</span>)
+          <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</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-M000008" class="method-detail">
+        <a name="M000008"></a>
+
+        <div class="method-heading">
+          <a href="#M000008" class="method-signature">
+          <span class="method-name">construct</span><span class="method-args">(query, format=&quot;application/rdf+xml&quot;)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Perform a SPARQL CONSTRUCT <a href="SparqlClient.html#M000005">query</a>.
+</p>
+<pre>
+ query:: the SPARQL query
+ format:: the preferred response format
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000008-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000008-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 122</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">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">query</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-M000006" class="method-detail">
+        <a name="M000006"></a>
+
+        <div class="method-heading">
+          <a href="#M000006" class="method-signature">
+          <span class="method-name">describe</span><span class="method-args">(query, format=&quot;application/rdf+xml&quot;)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Perform a SPARQL DESCRIBE <a href="SparqlClient.html#M000005">query</a>.
+</p>
+<pre>
+ query:: the SPARQL query
+ format:: the preferred response format
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000006-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 101</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">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">query</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-M000007" class="method-detail">
+        <a name="M000007"></a>
+
+        <div class="method-heading">
+          <a href="#M000007" class="method-signature">
+          <span class="method-name">multi_describe</span><span class="method-args">(uris, format=&quot;application/rdf+xml&quot;)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+DESCRIBE multiple resources in a single <a
+href="SparqlClient.html#M000005">query</a>. The provided array should
+contain the uris that are to be described
+</p>
+<p>
+This will generate a <a href="SparqlClient.html#M000005">query</a> like:
+</p>
+<pre>
+ DESCRIBE &lt;http://www.example.org&gt; &lt;http://www.example.com&gt; ...
+
+ uris:: list of the uris to be described
+ format:: the preferred response format. Default is RDF/XML
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000007-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 113</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">multi_describe</span>(<span class="ruby-identifier">uris</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
+          <span class="ruby-identifier">query</span> = <span class="ruby-value str">&quot;DESCRIBE &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">uris</span>.<span class="ruby-identifier">map</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">u</span><span class="ruby-operator">|</span> <span class="ruby-node">&quot;&lt;#{u}&gt;&quot;</span> }.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot; &quot;</span>)
+          <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</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-M000005" class="method-detail">
+        <a name="M000005"></a>
+
+        <div class="method-heading">
+          <a href="#M000005" class="method-signature">
+          <span class="method-name">query</span><span class="method-args">(sparql, format=nil, graphs=nil, named_graphs=nil)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Perform a sparql <a href="SparqlClient.html#M000005">query</a>
+</p>
+<pre>
+ sparql:: a valid SPARQL query
+ format:: specific a request format. Usually a media-type, but may be a name for a type, if not using Conneg
+ graphs:: an array of default graphs
+ named_graphs:: an array of named graphs
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000005-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 66</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">sparql</span>, <span class="ruby-identifier">format</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">graphs</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">named_graphs</span>=<span class="ruby-keyword kw">nil</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">sparql</span>
+          
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">graphs</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
+            <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;default-graph-uri&quot;</span>] = <span class="ruby-identifier">graphs</span>
+          <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@graphs</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
+            <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;default-graph-uri&quot;</span>] = <span class="ruby-ivar">@graphs</span>
+          <span class="ruby-keyword kw">end</span>          
+
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">named_graphs</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
+            <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;named-graph-uri&quot;</span>] = <span class="ruby-identifier">named_graphs</span>
+          <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@named_graphs</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
+            <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;named-graph-uri&quot;</span>] = <span class="ruby-ivar">@named_graphs</span>
+          <span class="ruby-keyword kw">end</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-keyword kw">if</span> <span class="ruby-ivar">@output_parameter_name</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
+              <span class="ruby-identifier">params</span>[<span class="ruby-ivar">@output_parameter_name</span>] = <span class="ruby-identifier">format</span>
+            <span class="ruby-keyword kw">else</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-keyword kw">end</span>
+          
+          <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>( <span class="ruby-ivar">@endpoint</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-M000010" class="method-detail">
+        <a name="M000010"></a>
+
+        <div class="method-heading">
+          <a href="#M000010" class="method-signature">
+          <span class="method-name">select</span><span class="method-args">(query, format=Pho::Sparql::SPARQL_RESULTS_XML)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Perform a SPARQL SELECT <a href="SparqlClient.html#M000005">query</a>.
+</p>
+<pre>
+ query:: the SPARQL query
+ format:: the preferred response format
+</pre>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000010-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000010-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 138</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</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_XML</span>)
+          <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</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>
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>