RubyGems - pho - Versions diffs - 0.7.2 → 0.7.3 - Mend

pho 0.7.2 → 0.7.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (82) hide show

data/CHANGES +5 -0
data/Rakefile +1 -1
data/lib/pho/snapshot.rb +6 -1
data/lib/pho/sparql.rb +4 -1
data/tests/tc_snapshots.rb +14 -1
data/tests/tc_sparql_helper.rb +23 -0
metadata +60 -160
data/doc/rdoc/classes/Pho/Analyzers.html +0 -310
data/doc/rdoc/classes/Pho/CommandLine.html +0 -770
data/doc/rdoc/classes/Pho/DatatypeProperty.html +0 -241
data/doc/rdoc/classes/Pho/Enrichment/StoreEnricher.html +0 -410
data/doc/rdoc/classes/Pho/Enrichment.html +0 -119
data/doc/rdoc/classes/Pho/Etags.html +0 -310
data/doc/rdoc/classes/Pho/Facet/Results.html +0 -299
data/doc/rdoc/classes/Pho/Facet/Term.html +0 -177
data/doc/rdoc/classes/Pho/Facet.html +0 -119
data/doc/rdoc/classes/Pho/FieldPredicateMap.html +0 -668
data/doc/rdoc/classes/Pho/FieldWeighting.html +0 -230
data/doc/rdoc/classes/Pho/FileManagement/AbstractFileManager.html +0 -478
data/doc/rdoc/classes/Pho/FileManagement/FileManager.html +0 -264
data/doc/rdoc/classes/Pho/FileManagement/RDFManager.html +0 -259
data/doc/rdoc/classes/Pho/FileManagement.html +0 -121
data/doc/rdoc/classes/Pho/Job.html +0 -627
data/doc/rdoc/classes/Pho/JobUpdate.html +0 -141
data/doc/rdoc/classes/Pho/Jobs.html +0 -538
data/doc/rdoc/classes/Pho/Namespaces.html +0 -164
data/doc/rdoc/classes/Pho/OAI/Record.html +0 -165
data/doc/rdoc/classes/Pho/OAI/Records.html +0 -331
data/doc/rdoc/classes/Pho/OAI.html +0 -118
data/doc/rdoc/classes/Pho/QueryProfile.html +0 -497
data/doc/rdoc/classes/Pho/RDF/Parser.html +0 -279
data/doc/rdoc/classes/Pho/RDF.html +0 -120
data/doc/rdoc/classes/Pho/RDFCollection.html +0 -119
data/doc/rdoc/classes/Pho/ResourceHash/Converter.html +0 -325
data/doc/rdoc/classes/Pho/ResourceHash/SetAlgebra.html +0 -241
data/doc/rdoc/classes/Pho/ResourceHash.html +0 -123
data/doc/rdoc/classes/Pho/Snapshot.html +0 -397
data/doc/rdoc/classes/Pho/Sparql/SparqlClient.html +0 -594
data/doc/rdoc/classes/Pho/Sparql/SparqlHelper.html +0 -692
data/doc/rdoc/classes/Pho/Sparql.html +0 -187
data/doc/rdoc/classes/Pho/Status.html +0 -296
data/doc/rdoc/classes/Pho/Store.html +0 -1560
data/doc/rdoc/classes/Pho/StoreSparqlClient.html +0 -183
data/doc/rdoc/classes/Pho/Update/Changeset.html +0 -521
data/doc/rdoc/classes/Pho/Update/ChangesetBuilder.html +0 -330
data/doc/rdoc/classes/Pho/Update/ChangesetHelper.html +0 -159
data/doc/rdoc/classes/Pho/Update/Changesets.html +0 -205
data/doc/rdoc/classes/Pho/Update/LiteralStatement.html +0 -257
data/doc/rdoc/classes/Pho/Update/ResourceStatement.html +0 -237
data/doc/rdoc/classes/Pho/Update/Statement.html +0 -303
data/doc/rdoc/classes/Pho/Update.html +0 -128
data/doc/rdoc/classes/Pho.html +0 -283
data/doc/rdoc/classes/String.html +0 -146
data/doc/rdoc/created.rid +0 -1
data/doc/rdoc/files/CHANGES.html +0 -351
data/doc/rdoc/files/README.html +0 -191
data/doc/rdoc/files/lib/pho/changeset_builder_rb.html +0 -108
data/doc/rdoc/files/lib/pho/changeset_rb.html +0 -108
data/doc/rdoc/files/lib/pho/command_line_rb.html +0 -101
data/doc/rdoc/files/lib/pho/converter_rb.html +0 -108
data/doc/rdoc/files/lib/pho/enrichment_rb.html +0 -101
data/doc/rdoc/files/lib/pho/etags_rb.html +0 -108
data/doc/rdoc/files/lib/pho/facet_rb.html +0 -101
data/doc/rdoc/files/lib/pho/field_predicate_map_rb.html +0 -101
data/doc/rdoc/files/lib/pho/file_management_rb.html +0 -101
data/doc/rdoc/files/lib/pho/file_manager_rb.html +0 -108
data/doc/rdoc/files/lib/pho/job_rb.html +0 -101
data/doc/rdoc/files/lib/pho/oai_rb.html +0 -101
data/doc/rdoc/files/lib/pho/query_profile_rb.html +0 -101
data/doc/rdoc/files/lib/pho/rdf_collection_rb.html +0 -101
data/doc/rdoc/files/lib/pho/rdf_rb.html +0 -108
data/doc/rdoc/files/lib/pho/resource_hash_rb.html +0 -101
data/doc/rdoc/files/lib/pho/snapshot_rb.html +0 -109
data/doc/rdoc/files/lib/pho/sparql_rb.html +0 -101
data/doc/rdoc/files/lib/pho/status_rb.html +0 -101
data/doc/rdoc/files/lib/pho/store_rb.html +0 -108
data/doc/rdoc/files/lib/pho_rb.html +0 -133
data/doc/rdoc/fr_class_index.html +0 -72
data/doc/rdoc/fr_file_index.html +0 -49
data/doc/rdoc/fr_method_index.html +0 -237
data/doc/rdoc/index.html +0 -24
data/doc/rdoc/rdoc-style.css +0 -208

data/doc/rdoc/classes/Pho/DatatypeProperty.html DELETED Viewed

@@ -1,241 +0,0 @@
-<?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::DatatypeProperty</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::DatatypeProperty</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../files/lib/pho/field_predicate_map_rb.html">
-                lib/pho/field_predicate_map.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>
-Captures information about a mapped datatype from a Field Predicate Map
-</p>
-    </div>
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000151">new</a>&nbsp;&nbsp;
-      <a href="#M000152">to_rdf</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">analyzer</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc">
-URI of the analyzer associated with this property
-</td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">name</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc">
-Short name for the property
-</td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">property_uri</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc">
-<a href="RDF.html">RDF</a> predicate URI for the mapped property
-</td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">uri</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc">
-URI for this mapping
-</td>
-        </tr>
-        </table>
-      </div>
-    </div>
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000151" class="method-detail">
-        <a name="M000151"></a>
-        <div class="method-heading">
-          <a href="#M000151" class="method-signature">
-          <span class="method-name">new</span><span class="method-args">(uri, property_uri, name, analyzer=nil)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000151-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000151-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/pho/field_predicate_map.rb, line 64</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">property_uri</span>, <span class="ruby-identifier">name</span>, <span class="ruby-identifier">analyzer</span>=<span class="ruby-keyword kw">nil</span>)
-        <span class="ruby-ivar">@uri</span> = <span class="ruby-identifier">uri</span>
-        <span class="ruby-ivar">@property_uri</span> = <span class="ruby-identifier">property_uri</span>
-        <span class="ruby-ivar">@name</span> = <span class="ruby-identifier">name</span>
-        <span class="ruby-ivar">@analyzer</span> = <span class="ruby-identifier">analyzer</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000152" class="method-detail">
-        <a name="M000152"></a>
-        <div class="method-heading">
-          <a href="#M000152" class="method-signature">
-          <span class="method-name">to_rdf</span><span class="method-args">(ns=true)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Convert this object into an <a href="RDF.html">RDF</a> representation.
-Generates a simple rdf:Description, optionally including namespaces
-</p>
-<table>
-<tr><td valign="top">ns:</td><td>include namespace declarations
-</td></tr>
-</table>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000152-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000152-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/pho/field_predicate_map.rb, line 73</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_rdf</span>(<span class="ruby-identifier">ns</span>=<span class="ruby-keyword kw">true</span>)
-      <span class="ruby-identifier">rdf</span> = <span class="ruby-value str">&quot;&lt;rdf:Description &quot;</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ns</span>
-        <span class="ruby-identifier">rdf</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot; xmlns:rdf=\&quot;http://www.w3.org/1999/02/22-rdf-syntax-ns#\&quot; xmlns:frm=\&quot;#{Pho::Namespaces::FRAME}\&quot; xmlns:bf=\&quot;#{Pho::Namespaces::CONFIG}\&quot; &quot;</span>
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">rdf</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot; rdf:about=\&quot;#{@uri}\&quot;&gt;&quot;</span>
-      <span class="ruby-identifier">rdf</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot; &lt;frm:property rdf:resource=\&quot;#{@property_uri}\&quot;/&gt;&quot;</span>
-      <span class="ruby-identifier">rdf</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot; &lt;frm:name&gt;#{@name}&lt;/frm:name&gt;&quot;</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@analyzer</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-        <span class="ruby-identifier">rdf</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot; &lt;bf:analyzer rdf:resource=\&quot;#{@analyzer}\&quot; /&gt;&quot;</span>
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">rdf</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;&lt;/rdf:Description&gt;&quot;</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">rdf</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>

data/doc/rdoc/classes/Pho/Enrichment/StoreEnricher.html DELETED Viewed

@@ -1,410 +0,0 @@
-<?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::Enrichment::StoreEnricher</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::Enrichment::StoreEnricher</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../../files/lib/pho/enrichment_rb.html">
-                lib/pho/enrichment.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>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000081">enrich</a>&nbsp;&nbsp;
-      <a href="#M000079">infer</a>&nbsp;&nbsp;
-      <a href="#M000080">merge</a>&nbsp;&nbsp;
-      <a href="#M000078">new</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">sparql_client</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">store</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        </table>
-      </div>
-    </div>
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000079" class="method-detail">
-        <a name="M000079"></a>
-        <div class="method-heading">
-          <a href="#M000079" class="method-signature">
-          <span class="method-name">infer</span><span class="method-args">(store, query, &amp;block)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Enrich a store against itself
-</p>
-<p>
-For the common case where a store needs to be enriched against itself by
-inferring <a href="StoreEnricher.html#M000078">new</a> data from old using
-a CONSTRUCT query
-</p>
-<table>
-<tr><td valign="top">store:</td><td>the store to be updated
-</td></tr>
-<tr><td valign="top">query:</td><td>the SPARQL CONSTRUCT query to be used to <a
-href="StoreEnricher.html#M000079">infer</a> the <a
-href="StoreEnricher.html#M000078">new</a> data
-</td></tr>
-</table>
-          <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/enrichment.rb, line 28</span>
-      <span class="ruby-keyword kw">def</span> <span class="ruby-constant">StoreEnricher</span>.<span class="ruby-identifier">infer</span>(<span class="ruby-identifier">store</span>, <span class="ruby-identifier">query</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-        <span class="ruby-identifier">enricher</span> = <span class="ruby-constant">StoreEnricher</span>.<span class="ruby-identifier">new</span>( <span class="ruby-identifier">store</span>, <span class="ruby-identifier">store</span>.<span class="ruby-identifier">sparql_client</span>() )
-        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">enricher</span>.<span class="ruby-identifier">merge</span>( <span class="ruby-identifier">query</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span> )
-      <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000078" class="method-detail">
-        <a name="M000078"></a>
-        <div class="method-heading">
-          <a href="#M000078" class="method-signature">
-          <span class="method-name">new</span><span class="method-args">(store, sparql_client)</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Constructor
-</p>
-<table>
-<tr><td valign="top">store:</td><td>the store containing resource(s) to <a
-href="StoreEnricher.html#M000081">enrich</a>
-</td></tr>
-<tr><td valign="top">sparql_client:</td><td>SparqlClient object to be used as client for retrieving enrichments
-</td></tr>
-</table>
-          <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/enrichment.rb, line 16</span>
-      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">store</span>, <span class="ruby-identifier">sparql_client</span>)
-          <span class="ruby-ivar">@store</span> = <span class="ruby-identifier">store</span>
-          <span class="ruby-ivar">@sparql_client</span> = <span class="ruby-identifier">sparql_client</span>
-      <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000081" class="method-detail">
-        <a name="M000081"></a>
-        <div class="method-heading">
-          <a href="#M000081" class="method-signature">
-          <span class="method-name">enrich</span><span class="method-args">(locator_query, enrichment_query, callback=nil) {|:query, query_response| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Enrich a store with data extracted from a SPARQL endpoint.
-</p>
-<p>
-The locator_query is used to find resources in the Platform <a
-href="../Store.html">Store</a> that should be enriched. The query should be
-a SPARQL SELECT query that returns the data to be used to parameterize the
-enrichment_query.
-</p>
-<p>
-For each query result, the enrichment_query will be submitted to the
-configured SPARQL endpoint, after first interpolating the string, providing
-the query result bindings as parameters. (See
-SparqlHelper.apply_initial_bindings and
-SparqlHelper.results_to_query_bindings
-</p>
-<p>
-If successful, the result of each enrichment query will then be pushed back
-into the Platform <a href="../Store.html">Store</a> by posting the results
-of the query to the metabox. <a href="../Enrichment.html">Enrichment</a>
-queries should therefore be CONSTRUCT or DESCRIBE queries. The SPARQL
-protocol request will be sent with an Accept header of application/rdf+xml
-</p>
-<p>
-The method supports a callback object that can be provided as an optional
-parameter to the query. If provided then then object should respond to
-either or both of the following methods:
-</p>
-<pre>
-  pre_process(rdf_xml)
-  post_process(resp, rdf_xml)
-</pre>
-<p>
-The first of these is invoked after each enrichment query has been executed
-on the configured SPARQL endpoint. It is intended to support additional
-filtering or annotation. If the <tt>pre_process</tt> method returns nil,
-then no data will be written to the store, otherwise the return value is
-substituted instead of the original value.
-</p>
-<p>
-The second callback method, <tt>post_process</tt> is called after data has
-been written to the store and provides access to the response from the
-store, and the <a href="../RDF.html">RDF</a>/XML data that had been
-attempted to be stored. As the request may have been un-successful, code
-should check the status on the HTTPMessage parameter.
-</p>
-<pre>
-  class MyCallback
-     def pre_process(rdf)
-       if !should_store?(rdf)
-         return nil
-       end
-       return rdf
-     end
-     def post_process(resp, rdf)
-       puts &quot;Store returned #{resp.status} when storing: #{rdf}&quot;
-     end
-  end
-  callback = MyCallback.new()
-  enricher.enrich(&quot;SELECT ?item WHERE { ?item a ex:Class } LIMIT 10&quot;, &quot;DESCRIBE ?item&quot;, callback)
-</pre>
-<p>
-The callback support is primarily intended to support filtering and
-notification of activities. For simple logging purposes, the method also
-supports a block parameter. This is invoked after each enrichment query,
-and each store response. The block can receive two values: the first is a
-symbol (either +:query+ or +:store+) indicating the source of the response,
-and the response object itself. E.g:
-</p>
-<pre>
-  enricher.enrich(&quot;SELECT ?item WHERE { ?item a ex:Class } LIMIT 10&quot;, &quot;DESCRIBE ?item&quot;) do |source, resp|
-    if source == :query
-      puts &quot;Enrichment query returned #{resp.status}&quot;
-    else
-      puts &quot;Store returned #{resp.status} when storing data&quot;
-    end
-  end
-</pre>
-<table>
-<tr><td valign="top">locator_query:</td><td>query to locate resources to be enriched
-</td></tr>
-<tr><td valign="top">enrichment_query:</td><td>query to be used to <a href="StoreEnricher.html#M000081">enrich</a> the
-resource
-</td></tr>
-<tr><td valign="top">callback:</td><td>optional callback object
-</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/enrichment.rb, line 108</span>
-      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">enrich</span>(<span class="ruby-identifier">locator_query</span>, <span class="ruby-identifier">enrichment_query</span>, <span class="ruby-identifier">callback</span>=<span class="ruby-keyword kw">nil</span>)
-          <span class="ruby-identifier">results</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">SparqlHelper</span>.<span class="ruby-identifier">select</span>(<span class="ruby-identifier">locator_query</span>, <span class="ruby-ivar">@store</span>.<span class="ruby-identifier">sparql_client</span>() )
-          <span class="ruby-identifier">bindings</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">SparqlHelper</span>.<span class="ruby-identifier">results_to_query_bindings</span>(<span class="ruby-identifier">results</span>)
-          <span class="ruby-identifier">bindings</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">binding</span><span class="ruby-operator">|</span>
-            <span class="ruby-identifier">bound_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">SparqlHelper</span>.<span class="ruby-identifier">apply_initial_bindings</span>(<span class="ruby-identifier">enrichment_query</span>, <span class="ruby-identifier">binding</span>)
-            <span class="ruby-comment cmt">#TODO counting numbers of requests and responses?</span>
-            <span class="ruby-identifier">query_response</span> = <span class="ruby-ivar">@sparql_client</span>.<span class="ruby-identifier">query</span>(<span class="ruby-identifier">bound_query</span>, <span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
-            <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-              <span class="ruby-keyword kw">yield</span> <span class="ruby-operator">:</span><span class="ruby-identifier">query</span>, <span class="ruby-identifier">query_response</span>
-            <span class="ruby-keyword kw">end</span>
-            <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">query_response</span>.<span class="ruby-identifier">status</span> <span class="ruby-operator">==</span> <span class="ruby-value">200</span>
-              <span class="ruby-identifier">result</span> = <span class="ruby-identifier">query_response</span>.<span class="ruby-identifier">content</span>
-              <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">callback</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">callback</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:pre_process</span>)
-                <span class="ruby-identifier">result</span> = <span class="ruby-identifier">callback</span>.<span class="ruby-identifier">pre_process</span>(<span class="ruby-identifier">result</span>)
-              <span class="ruby-keyword kw">end</span>
-              <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">result</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
-                <span class="ruby-identifier">store_response</span> = <span class="ruby-ivar">@store</span>.<span class="ruby-identifier">store_data</span>( <span class="ruby-identifier">result</span> )
-                <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">callback</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">callback</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:post_process</span>)
-                  <span class="ruby-identifier">callback</span>.<span class="ruby-identifier">post_process</span>(<span class="ruby-identifier">store_response</span>, <span class="ruby-identifier">result</span>)
-                <span class="ruby-keyword kw">end</span>
-                <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-                  <span class="ruby-keyword kw">yield</span> <span class="ruby-operator">:</span><span class="ruby-identifier">store</span>, <span class="ruby-identifier">store_response</span>
-                <span class="ruby-keyword kw">end</span>
-              <span class="ruby-keyword kw">end</span>
-            <span class="ruby-keyword kw">end</span>
-          <span class="ruby-comment cmt">#end each binding</span>
-          <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-      <div id="method-M000080" class="method-detail">
-        <a name="M000080"></a>
-        <div class="method-heading">
-          <a href="#M000080" class="method-signature">
-          <span class="method-name">merge</span><span class="method-args">(query) {|resp, data| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Execute the provided query against the configured SPARQL endpoint and store
-the results in the Platform <a href="../Store.html">Store</a>
-</p>
-<table>
-<tr><td valign="top">query:</td><td>the SPARQL CONSTRUCT or DESCRIBE query to execute
-</td></tr>
-</table>
-          <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/enrichment.rb, line 37</span>
-      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">merge</span>(<span class="ruby-identifier">query</span>)
-        <span class="ruby-identifier">resp</span> = <span class="ruby-ivar">@sparql_client</span>.<span class="ruby-identifier">query</span>( <span class="ruby-identifier">query</span>, <span class="ruby-value str">&quot;application/rdf+xml&quot;</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;Unable to execute query. Response: #{resp.status} #{resp.reason} #{resp.content}&quot;</span>
-        <span class="ruby-keyword kw">end</span>
-        <span class="ruby-identifier">data</span> = <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">content</span>
-        <span class="ruby-identifier">resp</span> = <span class="ruby-ivar">@store</span>.<span class="ruby-identifier">store_data</span>( <span class="ruby-identifier">data</span> )
-        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-          <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">resp</span>, <span class="ruby-identifier">data</span>
-        <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">resp</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>