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

pho 0.7.3 → 0.7.4

Files changed (87) hide show

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

data/doc/rdoc/files/CHANGES.html ADDED Viewed

@@ -0,0 +1,373 @@
+<?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>File: CHANGES</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="fileHeader">
+    <h1>CHANGES</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>CHANGES
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Tue Aug 31 08:54:49 +0100 2010</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+Brief notes on significant changes and additions in each release
+</p>
+<h2>Version 0.7.4</h2>
+<ul>
+<li>Moved version control to github.
+</li>
+<li>Added store.name property
+</li>
+<li>Added remove_all methods to FieldPredicateMap and QueryProfile
+</li>
+</ul>
+<h2>Version 0.7.3</h2>
+<ul>
+<li>Fixed bug in Snapshot result parsing, now returns nil if no snapshot for
+store
+</li>
+<li>Fixed bug in SparqlHelper when handling rows with no result binding
+</li>
+</ul>
+<h2>Version 0.7.2</h2>
+<ul>
+<li>Now parses full OAI response, support for listing records between dates and
+resumption tokens
+</li>
+</ul>
+<h2>Version 0.7.1</h2>
+<ul>
+<li>Bug fix for changeset generation, escaping of &amp; in literals
+</li>
+</ul>
+<h2>Version 0.7</h2>
+<ul>
+<li>Started on OAI client
+</li>
+<li>New commandline options: add_mapping and add_weight
+</li>
+<li>Updated talis_store so that it now supports environment variables for user,
+pass, store (TALIS_USER, TALIS_PASS, TALIS_STORE)
+</li>
+<li>Added getfpmap and getqueryprofile methods to command-line application for
+retrieving either a summary or the raw data
+</li>
+<li>Updated command-line job control functions so that the Job URI is echoed to
+command-line.
+</li>
+<li>Updated RDFManager so that it will now automatically upload all .rdf, .ttl
+and .nt files in directory. An array of extension can be provided to
+configure this behaviour
+</li>
+<li>Updated command-line tool so that it will now handle uploads of turtle
+(.ttl) and ntriples (.nt) files correctly
+</li>
+<li>Updated Store class to allow mimetype of files and data to be specified
+when uploading to metabox. Useful now that the platform supports turtle
+</li>
+</ul>
+<h2>Version 0.6.1</h2>
+<ul>
+<li>Added examples/linkeddata/proxy.rb
+</li>
+<li>Fixed bug in command-line application
+</li>
+<li>Added SparqlHelper.exists method
+</li>
+</ul>
+<h2>Version 0.6</h2>
+<ul>
+<li>Refactored talis_store command extracting code into <a
+href="../classes/Pho/CommandLine.html">Pho::CommandLine</a>
+</li>
+<li>Tweaked talis_store command, so attempt to store .nt file will trigger
+conversion into RDF/XML before submitting to Platform
+</li>
+<li>Added <a href="../classes/Pho/RDF.html">Pho::RDF</a> module for general rdf
+utilities. Initially has method to convert ntriples into rdf/xml and to
+store that in the platform
+</li>
+<li>At suggestion of @chrislowis added rescue around redland dependent
+requires.
+</li>
+<li>talis_store command-line now supports &quot;upload&quot; option for storing
+individual files or directories
+</li>
+<li>Added support for directory traversal to RDFManager and FileManager classes
+</li>
+<li>Fixed bug in counting files being managed in RDFManager
+</li>
+<li>Fixed file naming bug in AbstractFileManager, when path contains file
+extension
+</li>
+<li>Added support for block to StoreEnricher.merge and StoreEnricher.infer
+</li>
+<li>Renamed ResourceEnricher to StoreEnricher
+</li>
+<li>Reimplemented ResourceEnricher.enrich method to support both a callback and
+a block
+</li>
+<li>Added StoreSparqlClient to extend default client, and rewrite describe_uri
+queries as describe service calls
+</li>
+<li>Added SparqlClient.describe_uri and SparqlHelper.describe_uri methods for
+generating different forms of Bounded Description for a resource
+</li>
+</ul>
+<h2>Version 0.5</h2>
+<p>
+NOTE: Released 0.4.1 version of the gem at this point to support earlier
+versions of Ruby.
+</p>
+<ul>
+<li>Added Enrichment module to support updating a store with results of simple
+inference (using CONSTRUCT queries), merging data from external endpoints,
+and support for parameterized lookup and enrichment of resources
+</li>
+<li>Added SparqlClient.multi_describe
+</li>
+<li>Added additional methods in SparqlHelper to support applying initial
+bindings to queries, and generating initial bindings from SELECT results
+</li>
+<li>Added <a
+href="../classes/Pho/FileManagement/FileManager.html">Pho::FileManagement::FileManager</a>
+for pushing a directory of files into the content box
+</li>
+<li>RDFCollection is now deprecated
+</li>
+<li>Added <a href="../classes/Pho/FileManagement.html">Pho::FileManagement</a>
+module and extracted code from RDFCollection to support creating similar
+util for other files
+</li>
+<li>Added SparqlHelper class to simplify a few common tasks
+</li>
+<li>Added new Sparql module and refactored store methods to use SparqlClient
+class
+</li>
+<li>Fixed bug in store.augment() method which was setting wrong headers on POST
+</li>
+<li>Added Converter class to convert between various RDF serializations and
+resource hashes. This uses the Redland API.
+</li>
+<li>Support Ruby 1.8.5 or above (to allow installation on Centos 5)
+</li>
+<li>Support for storing data in private graphs as well as metabox
+</li>
+<li>Support for submission of changesets to private graphs as well as metabox
+</li>
+<li>Multisparql options on all Store sparql methods
+</li>
+<li>Addition of ChangeSetBuilder class for constructing changesets from triple
+hashes
+</li>
+<li>Addition of ResourceHash module and SetAlgebra class for working with
+triple hashes
+</li>
+<li>Addition of Changeset, Statement classes for capturing and serializing
+Changeset data
+</li>
+<li>Fixed bugs in facet, search params
+</li>
+<li>Added submit_changeset method to Store to support submission of changeset
+data
+</li>
+</ul>
+<h2>Version 0.4</h2>
+<ul>
+<li>Added support for reading Job lifecycle data exposed in Talis Platform
+Release 21
+</li>
+<li>Added constants for 2 new analysers added in Talis Platform Release 21
+</li>
+<li>Refactored job submission code to move methods from the Store class onto
+the Jobs and Job classes instead. This brings that code in line with the
+patterns used elsewhere
+</li>
+<li>Re-implemented snapshot reading code to use RDF/XML rather than scraping
+the HTML
+</li>
+<li>Added a fledgling command-line tool for working with the platform
+&quot;talis_store&quot;
+</li>
+</ul>
+<h2>Version 0.3</h2>
+<ul>
+<li>Added support for QueryProfiles, Facets
+</li>
+<li>Added <a href="../classes/Pho/Namespaces.html">Pho::Namespaces</a> module
+for collecting together ns declarations
+</li>
+<li>Altered store.status to return basic response, and a new Status class to
+parse and encapsulate the response data
+</li>
+</ul>
+<h2>Version 0.2</h2>
+<ul>
+<li>Added support for parsing and maintenance of FieldPredicate Maps
+</li>
+</ul>
+<h2>Version 0.1</h2>
+<ul>
+<li>Implemented core contentbox, metabox and service functionality. First
+proper release
+</li>
+</ul>
+<h2>Version 0.0.1</h2>
+<ul>
+<li>Testing gem package building and release
+</li>
+</ul>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- 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/files/README.html ADDED Viewed

@@ -0,0 +1,204 @@
+<?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>File: README</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="fileHeader">
+    <h1>README</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>README
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Tue Aug 31 08:32:36 +0100 2010</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+The <a href="../classes/Pho.html">Pho</a> ruby module provides a
+lightweight Ruby client library for interacting with the Talis Platform API
+(<a
+href="http://n2.talis.com/wiki/Platform_API">n2.talis.com/wiki/Platform_API</a>).
+</p>
+<h2>Author</h2>
+<p>
+Leigh Dodds (leigh.dodds@talis.com)
+</p>
+<h2>Download</h2>
+<p>
+<a href="../classes/Pho.html">Pho</a> is packaged as a Ruby Gem and can be
+downloaded from:
+</p>
+<p>
+<a href="http://rubygems.org/gems/pho">rubygems.org/gems/pho</a>
+</p>
+<p>
+As of release 0.7.4 the source for the project is maintained in github at:
+</p>
+<p>
+<a href="http://github.com/ldodds/pho">github.com/ldodds/pho</a>
+</p>
+<p>
+Earlier versions of the source, plus the RDoc can be accessed from:
+</p>
+<p>
+<a href="http://pho.rubyforge.net">pho.rubyforge.net</a>
+</p>
+<h2>Installation</h2>
+<p>
+From the 0.5 release onwards, <a href="../classes/Pho.html">Pho</a> is
+dependent on the Ruby bindings for the Redland RDF library. Ensure you have
+the librdf0 and librdf-ruby packages installed.
+</p>
+<p>
+All other dependencies are for specific Ruby gems which should get
+automatically installed, along with the <a
+href="../classes/Pho.html">Pho</a> gem itself, by running:
+</p>
+<pre>
+  sudo gem install pho
+</pre>
+<h2>Usage</h2>
+<p>
+To use <a href="../classes/Pho.html">Pho</a> you can:
+</p>
+<pre>
+   require 'pho'
+</pre>
+<p>
+And then create an instance of the appropriate class, e.g Store:
+</p>
+<pre>
+   store = Pho::Store.new(&quot;http://api.talis.com/testing&quot;, &quot;user&quot;, &quot;pass&quot;)
+   response = store.describe(&quot;http://www.example.org&quot;)
+</pre>
+<p>
+For more detailed examples consult the documentation for the Store class
+</p>
+<h2>Control over HTTP interactions</h2>
+<p>
+<a href="../classes/Pho.html">Pho</a> is dependent on the HTTPClient module
+and all HTTP interactions are delegated to an instance of the HTTPClient
+class. In circumstances where greater control over the HTTP interaction is
+required, e.g. to configure proxy servers, etc, an existing instance of
+this class can be provided, e.g:
+</p>
+<pre>
+  client = HTTPClient.new
+  =&gt; configure client as required
+  store = Pho::Store.new(&quot;http://api.talis.com/testing&quot;, &quot;user&quot;, &quot;pass&quot;, client)
+  =&gt; pass instance of client as parameter
+  response = store.describe(&quot;http://www.example.org&quot;)
+</pre>
+<h2>License</h2>
+<p>
+Copyright 2009 Leigh Dodds
+</p>
+<p>
+Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);
+you may not use this file except in compliance with the License.
+</p>
+<p>
+You may obtain a copy of the License at
+</p>
+<p>
+<a
+href="http://www.apache.org/licenses/LICENSE-2.0">www.apache.org/licenses/LICENSE-2.0</a>
+</p>
+<p>
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an &quot;AS IS&quot; BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+</p>
+<p>
+See the License for the specific language governing permissions and
+limitations under the License.
+</p>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- 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/files/lib/pho/changeset_builder_rb.html ADDED Viewed

@@ -0,0 +1,108 @@
+<?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>File: changeset_builder.rb</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="fileHeader">
+    <h1>changeset_builder.rb</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>lib/pho/changeset_builder.rb
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Mon Jun 07 13:27:18 +0100 2010</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="requires-list">
+      <h3 class="section-bar">Required files</h3>
+      <div class="name-list">
+      uri&nbsp;&nbsp;
+      </div>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- 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>