pho 0.5 → 0.6

data/CHANGES

@@ -1,5 +1,22 @@
 Brief notes on significant changes and additions in each release
 
+== Version 0.6
+
+* Refactored talis_store command extracting code into Pho::CommandLine
+* Tweaked talis_store command, so attempt to store .nt file will trigger conversion into RDF/XML before submitting to Platform
+* Added Pho::RDF module for general rdf utilities. Initially has method to convert ntriples into rdf/xml and to store that in the platform
+* At suggestion of @chrislowis added rescue around redland dependent requires.
+* talis_store command-line now supports "upload" option for storing individual files or directories
+* Added support for directory traversal to RDFManager and FileManager classes
+* Fixed bug in counting files being managed in RDFManager
+* Fixed file naming bug in AbstractFileManager, when path contains file extension
+* Added support for block to StoreEnricher.merge and StoreEnricher.infer
+* Renamed ResourceEnricher to StoreEnricher
+* Reimplemented ResourceEnricher.enrich method to support both a callback and a block
+* Added StoreSparqlClient to extend default client, and rewrite describe_uri queries as describe service calls 
+* Added SparqlClient.describe_uri and SparqlHelper.describe_uri methods for generating different forms 
+  of Bounded Description for a resource
+
 == Version 0.5
 
 NOTE: Released 0.4.1 version of the gem at this point to support earlier versions of 

data/Rakefile

@@ -5,7 +5,7 @@ require 'rake/testtask'
 require 'rake/clean'
 
 NAME = "pho"
-VER = "0.5"
+VER = "0.6"
 
 RDOC_OPTS = ['--quiet', '--title', 'Pho (Talis Platform Client) Reference', '--main', 'README']
 
@@ -51,17 +51,25 @@ Rake::RDocTask.new do |rdoc|
     
 end
 
+desc "Publish rdoc output to rubyforge"
+task "publish-docs" => ["rdoc"] do 
+  rubyforge_path = "/var/www/gforge-projects/#{NAME}/" 
+  sh "scp -r doc/* " + 
+    "#{ENV["RUBYFORGE_USER"]}@rubyforge.org:#{rubyforge_path}", 
+    :verbose => true 
+end 
 
 Rake::TestTask.new do |test|
   test.test_files = FileList['tests/tc_*.rb']
 end
 
+desc "Install from a locally built copy of the gem"
 task :install do
   sh %{rake package}
   sh %{sudo gem install pkg/#{NAME}-#{VER}}
 end
 
-
+desc "Uninstall the gem"
 task :uninstall => [:clean] do
   sh %{sudo gem uninstall #{NAME}}
 end

data/bin/talis_store

@@ -75,7 +75,7 @@ MODE
     Show read-write status of the store
     
   store
-    Upload some RDF data to the Platform. Can either specify a local file, or a URL
+    Upload some RDF data to the metabox in a Platform store. Can either specify a local file, or a URL
     When a url is specified, then the data is retrieved and then submitted to the Platform
     Can also be used to store an entire directory of RDF/XML using the --dir option.
        
@@ -84,7 +84,19 @@ MODE
       #{ PROGRAM } store -u user -p pass -s my-dev1 -f /tmp/data.rdf
       #{ PROGRAM } store -u user -p pass -s my-dev1 -r http://www.example.net/data/somedata.rdf
       #{ PROGRAM } store -u user -p pass -s my-dev1 -d ~/data
-           
+
+  upload
+    Upload some files to the contentbox in a Platform store. Can either specify a local file, or 
+    an entire directory of files using the --dir option. Directories can be traversed using the 
+    --traverse option.
+       
+    example :
+  
+      #{ PROGRAM } upload -u user -p pass -s my-dev1 -f /tmp/file.txt
+      #{ PROGRAM } upload -u user -p pass -s my-dev1 -d ~/files
+      #{ PROGRAM } upload -u user -p pass -s my-dev1 --traverse -d ~/files
+      #{ PROGRAM } upload -u user -p pass -s my-dev1 --traverse -d ~/files --base assets
+               
 OPTIONS
 
   --help            , -h
@@ -101,7 +113,10 @@ OPTIONS
     specify a file name, e.g. data to upload
   --dir
     specify a directory, e.g. containing data to upload or location to place data.
-        
+  --traverse
+    recursively store files or RDF
+  --base
+    base path for uploading files to content box      
 EOL
 
 mode = ARGV.shift
@@ -113,7 +128,9 @@ opts = GetoptLong::new(
          [ "--store"           , "-s" , GetoptLong::REQUIRED_ARGUMENT ],
          [ "--url"             , "-r" , GetoptLong::REQUIRED_ARGUMENT ],
          [ "--file"            , "-f" , GetoptLong::REQUIRED_ARGUMENT ],
-         [ "--dir"             , "-d" , GetoptLong::REQUIRED_ARGUMENT ]                           
+         [ "--dir"             , "-d" , GetoptLong::REQUIRED_ARGUMENT ],
+         [ "--traverse"        , "-t" , GetoptLong::NO_ARGUMENT ],
+         [ "--base"            , "-b" , GetoptLong::REQUIRED_ARGUMENT ]                                                                               
        ).enum_for.inject({}) { |h, (k, v)| h.update k.delete('-') => v }
 
 mode = "help" if opts["--help"]
@@ -141,115 +158,43 @@ else
   end
   
   store = Pho::Store.new(storename, opts["username"], opts["password"])
+  cmds = Pho::CommandLine.new(store, opts)
   
   #begin
     
     case mode
       when "status"
-         status = Pho::Status.read_from_store(store)
-         puts "Store Status:\nReadable: #{status.readable?}\nWritable: #{status.writeable?}" 
+         cmds.status()
       when "backup"
-         puts "Submitting Snapshot Job"
-         resp = Pho::Jobs.submit_snapshot(store, "Reindex", Time.now)
-         puts "Monitoring Job"
-         job = Pho::Jobs.wait_for_submitted(resp, store) do |job, message, time|
-           puts "#{time} #{message}"
-         end 
-         puts "Job Completed"         
-         snapshot = Pho::Snapshot.read_from_store(store)
-         puts "Retrieving #{snapshot.url}"
-         dir = opts["dir"] || Dir.tmpdir
-         snapshot.backup(store, dir)
-         puts "Download complete. MD5 OK."
+         cmds.backup()         
       when "snapshot"
-         puts "Submitting Snapshot Job"
-         resp = Pho::Jobs.submit_snapshot(store, "Reindex", Time.now)
-         puts "Monitoring Job"
-         job = Pho::Jobs.wait_for_submitted(resp, store) do |job, message, time|
-           puts "#{time} #{message}"
-         end 
-        puts "Snapshot Completed"                   
+         cmds.snapshot()                   
       when "reindex"
-         puts "Submitting Reindex Job"
-         resp = Pho::Jobs.submit_reindex(store, "Reindex", Time.now)
-         if resp.status == 201
-           puts "Monitoring Reindex Job: #{resp.header["Location"].first}"
-         end
-         job = Pho::Jobs.wait_for_submitted(resp, store) do |job, message, time|
-           puts "#{time} #{message}"
-         end 
-         puts "Reindex Completed"
+         cmds.reindex()
       when "reset"
-        puts "Resetting Store"
-        resp = Pho::Jobs.submit_reset(store, "Reset", Time.now)
-        puts "Monitoring Reset Job:"
-        job = Pho::Jobs.wait_for_submitted(resp, store) do |job, message, time|
-          puts "#{time} #{message}"
-        end 
-        puts "Reset Completed"
+         cmds.reset()
       when "restore"
-        url = opts["url"]     
-        if url == nil
-          puts "Restore from latest snapshot"
-          snapshot = Pho::Snapshot.read_from_store(store)
-          url = snapshot.url
-        end
-        puts "Restoring from #{url}"    
-        resp = Pho::Jobs.submit_restore(store, url, "Reset", Time.now)
-        job = Pho::Jobs.wait_for_submitted(resp, store) do |job, message, time|
-          puts "#{time} #{message}"
-        end 
-        puts "Restore Completed"
+         cmds.restore()
       when "store"
-        resp = nil
-        if opts["url"]
-          puts "Storing remote data: #{opts["url"]}"
-          resp = store.store_url( opts["url"] ) 
-        elsif opts["file"]
-          puts "Storing local file: #{opts["file"]}"
-          resp = store.store_file( File.new( opts["file"] ) )
-        elsif opts["dir"]
-          puts "Storing contents of directory: #{opts["dir"]}"
-          collection = Pho::RDFCollection.new(store, opts["dir"])         
-          collection.store()          
-          puts collection.summary()
-        else     
+        if opts["file"] == nil && opts["dir"] == nil && opts["url"] == nil
           abort USAGE
-        end 
-      
-        if resp != nil 
-          if resp.status == 204
-            puts "Complete"
-          else
-            puts "Error: #{resp.status} #{resp.reason}"
-            puts resp.content
-          end         
         end
-      
+        cmds.store()         
+      when "upload"
+        if opts["file"] == nil && opts["dir"] == nil && opts["url"] == nil
+          abort USAGE
+        end
+        cmds.upload()                
       when "describe"
         if opts["url"] == nil
           abort USAGE
         end 
-        resp = store.describe( opts["url"] )
-        if resp.status == 200
-          puts resp.content
-        else
-          puts "Error: #{resp.status} #{resp.reason}"
-          puts resp.content
-        end
+        cmds.describe()
       when "sparql"
         if opts["file"] == nil
           abort USAGE
         end 
-        query = File.new( opts["file"] ).read()
-        resp = store.sparql(query)
-        if resp.status == 200
-          puts resp.content
-        else
-          puts "Error: #{resp.status} #{resp.reason}"
-          puts resp.content          
-        end
-                            
+        cmds.sparql()                            
       else
          abort USAGE
     end  

data/doc/rdoc/classes/Pho.html

@@ -62,6 +62,10 @@
                 <a href="../files/lib/pho/changeset_builder_rb.html">
                 lib/pho/changeset_builder.rb
                 </a>
+        <br />
+                <a href="../files/lib/pho/rdf_rb.html">
+                lib/pho/rdf.rb
+                </a>
         <br />
                 <a href="../files/lib/pho/file_manager_rb.html">
                 lib/pho/file_manager.rb
@@ -74,6 +78,10 @@
                 <a href="../files/lib/pho/enrichment_rb.html">
                 lib/pho/enrichment.rb
                 </a>
+        <br />
+                <a href="../files/lib/pho/command_line_rb.html">
+                lib/pho/command_line.rb
+                </a>
         <br />
                 <a href="../files/lib/pho/status_rb.html">
                 lib/pho/status.rb
@@ -164,10 +172,12 @@ TODO put together proper test suite for this
       Module <a href="Pho/Enrichment.html" class="link">Pho::Enrichment</a><br />
 Module <a href="Pho/Facet.html" class="link">Pho::Facet</a><br />
 Module <a href="Pho/FileManagement.html" class="link">Pho::FileManagement</a><br />
+Module <a href="Pho/RDF.html" class="link">Pho::RDF</a><br />
 Module <a href="Pho/ResourceHash.html" class="link">Pho::ResourceHash</a><br />
 Module <a href="Pho/Sparql.html" class="link">Pho::Sparql</a><br />
 Module <a href="Pho/Update.html" class="link">Pho::Update</a><br />
 Class <a href="Pho/Analyzers.html" class="link">Pho::Analyzers</a><br />
+Class <a href="Pho/CommandLine.html" class="link">Pho::CommandLine</a><br />
 Class <a href="Pho/DatatypeProperty.html" class="link">Pho::DatatypeProperty</a><br />
 Class <a href="Pho/Etags.html" class="link">Pho::Etags</a><br />
 Class <a href="Pho/FieldPredicateMap.html" class="link">Pho::FieldPredicateMap</a><br />
@@ -181,6 +191,7 @@ Class <a href="Pho/RDFCollection.html" class="link">Pho::RDFCollection</a><br />
 Class <a href="Pho/Snapshot.html" class="link">Pho::Snapshot</a><br />
 Class <a href="Pho/Status.html" class="link">Pho::Status</a><br />
 Class <a href="Pho/Store.html" class="link">Pho::Store</a><br />
+Class <a href="Pho/StoreSparqlClient.html" class="link">Pho::StoreSparqlClient</a><br />
 
     </div>
 

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

@@ -0,0 +1,508 @@
+<?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::CommandLine</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::CommandLine</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../files/lib/pho/command_line_rb.html">
+                lib/pho/command_line.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>
+Class that implements the command-line behaviour
+</p>
+
+    </div>
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000109">backup</a>&nbsp;&nbsp;
+      <a href="#M000114">describe</a>&nbsp;&nbsp;
+      <a href="#M000107">new</a>&nbsp;&nbsp;
+      <a href="#M000111">reindex</a>&nbsp;&nbsp;
+      <a href="#M000112">reset</a>&nbsp;&nbsp;
+      <a href="#M000113">restore</a>&nbsp;&nbsp;
+      <a href="#M000110">snapshot</a>&nbsp;&nbsp;
+      <a href="#M000115">sparql</a>&nbsp;&nbsp;
+      <a href="#M000108">status</a>&nbsp;&nbsp;
+      <a href="#M000116">store</a>&nbsp;&nbsp;
+      <a href="#M000117">upload</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+
+
+
+
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+
+      <div id="method-M000107" class="method-detail">
+        <a name="M000107"></a>
+
+        <div class="method-heading">
+          <a href="#M000107" class="method-signature">
+          <span class="method-name">new</span><span class="method-args">(store, opts)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000107-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000107-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 6</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">store</span>, <span class="ruby-identifier">opts</span>)
+       <span class="ruby-ivar">@store</span> = <span class="ruby-identifier">store</span>      
+       <span class="ruby-ivar">@opts</span> = <span class="ruby-identifier">opts</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <h3 class="section-bar">Public Instance methods</h3>
+
+      <div id="method-M000109" class="method-detail">
+        <a name="M000109"></a>
+
+        <div class="method-heading">
+          <a href="#M000109" class="method-signature">
+          <span class="method-name">backup</span><span class="method-args">()</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">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 16</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">backup</span>()
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Submitting Snapshot Job&quot;</span>
+      <span class="ruby-identifier">resp</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">submit_snapshot</span>(<span class="ruby-ivar">@store</span>, <span class="ruby-value str">&quot;Reindex&quot;</span>, <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>)
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Monitoring Job&quot;</span>
+      <span class="ruby-identifier">job</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">wait_for_submitted</span>(<span class="ruby-identifier">resp</span>, <span class="ruby-ivar">@store</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">job</span>, <span class="ruby-identifier">message</span>, <span class="ruby-identifier">time</span><span class="ruby-operator">|</span>
+         <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;#{time} #{message}&quot;</span>
+      <span class="ruby-keyword kw">end</span> 
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Job Completed&quot;</span>         
+      <span class="ruby-identifier">snapshot</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Snapshot</span>.<span class="ruby-identifier">read_from_store</span>(<span class="ruby-ivar">@store</span>)
+      <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Retrieving #{snapshot.url}&quot;</span>
+      <span class="ruby-identifier">dir</span> = <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;dir&quot;</span>] <span class="ruby-operator">||</span> <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">tmpdir</span>
+      <span class="ruby-identifier">snapshot</span>.<span class="ruby-identifier">backup</span>(<span class="ruby-ivar">@store</span>, <span class="ruby-identifier">dir</span>)
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Download complete. MD5 OK.&quot;</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000114" class="method-detail">
+        <a name="M000114"></a>
+
+        <div class="method-heading">
+          <a href="#M000114" class="method-signature">
+          <span class="method-name">describe</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000114-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000114-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 78</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">describe</span>()
+      <span class="ruby-identifier">resp</span> = <span class="ruby-ivar">@store</span>.<span class="ruby-identifier">describe</span>( <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;url&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">puts</span> <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">content</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Error: #{resp.status} #{resp.reason}&quot;</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">content</span>
+      <span class="ruby-keyword kw">end</span>    
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000111" class="method-detail">
+        <a name="M000111"></a>
+
+        <div class="method-heading">
+          <a href="#M000111" class="method-signature">
+          <span class="method-name">reindex</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000111-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000111-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 41</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reindex</span>()
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Submitting Reindex Job&quot;</span>
+      <span class="ruby-identifier">resp</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">submit_reindex</span>(<span class="ruby-ivar">@store</span>, <span class="ruby-value str">&quot;Reindex&quot;</span>, <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</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">201</span>
+          <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Monitoring Reindex Job: #{resp.header[&quot;Location&quot;].first}&quot;</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">job</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">wait_for_submitted</span>(<span class="ruby-identifier">resp</span>, <span class="ruby-ivar">@store</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">job</span>, <span class="ruby-identifier">message</span>, <span class="ruby-identifier">time</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;#{time} #{message}&quot;</span>
+      <span class="ruby-keyword kw">end</span> 
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Reindex Completed&quot;</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000112" class="method-detail">
+        <a name="M000112"></a>
+
+        <div class="method-heading">
+          <a href="#M000112" class="method-signature">
+          <span class="method-name">reset</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000112-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000112-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 53</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reset</span>()
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Resetting Store&quot;</span>
+      <span class="ruby-identifier">resp</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">submit_reset</span>(<span class="ruby-ivar">@store</span>, <span class="ruby-value str">&quot;Reset&quot;</span>, <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>)
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Monitoring Reset Job:&quot;</span>
+      <span class="ruby-identifier">job</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">wait_for_submitted</span>(<span class="ruby-identifier">resp</span>, <span class="ruby-ivar">@store</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">job</span>, <span class="ruby-identifier">message</span>, <span class="ruby-identifier">time</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;#{time} #{message}&quot;</span>
+      <span class="ruby-keyword kw">end</span> 
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Reset Completed&quot;</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000113" class="method-detail">
+        <a name="M000113"></a>
+
+        <div class="method-heading">
+          <a href="#M000113" class="method-signature">
+          <span class="method-name">restore</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000113-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000113-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 63</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">restore</span>()
+      <span class="ruby-identifier">url</span> = <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;url&quot;</span>]     
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">url</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Restore from latest snapshot&quot;</span>
+        <span class="ruby-identifier">snapshot</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Snapshot</span>.<span class="ruby-identifier">read_from_store</span>(<span class="ruby-ivar">@store</span>)
+        <span class="ruby-identifier">url</span> = <span class="ruby-identifier">snapshot</span>.<span class="ruby-identifier">url</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Restoring from #{url}&quot;</span>    
+      <span class="ruby-identifier">resp</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">submit_restore</span>(<span class="ruby-ivar">@store</span>, <span class="ruby-identifier">url</span>, <span class="ruby-value str">&quot;Reset&quot;</span>, <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>)
+      <span class="ruby-identifier">job</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">wait_for_submitted</span>(<span class="ruby-identifier">resp</span>, <span class="ruby-ivar">@store</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">job</span>, <span class="ruby-identifier">message</span>, <span class="ruby-identifier">time</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;#{time} #{message}&quot;</span>
+      <span class="ruby-keyword kw">end</span> 
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Restore Completed&quot;</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000110" class="method-detail">
+        <a name="M000110"></a>
+
+        <div class="method-heading">
+          <a href="#M000110" class="method-signature">
+          <span class="method-name">snapshot</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000110-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000110-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 31</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">snapshot</span>()
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Submitting Snapshot Job&quot;</span>
+      <span class="ruby-identifier">resp</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">submit_snapshot</span>(<span class="ruby-ivar">@store</span>, <span class="ruby-value str">&quot;Reindex&quot;</span>, <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>)
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Monitoring Job&quot;</span>
+      <span class="ruby-identifier">job</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Jobs</span>.<span class="ruby-identifier">wait_for_submitted</span>(<span class="ruby-identifier">resp</span>, <span class="ruby-ivar">@store</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">job</span>, <span class="ruby-identifier">message</span>, <span class="ruby-identifier">time</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;#{time} #{message}&quot;</span>
+      <span class="ruby-keyword kw">end</span> 
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Snapshot Completed&quot;</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000115" class="method-detail">
+        <a name="M000115"></a>
+
+        <div class="method-heading">
+          <a href="#M000115" class="method-signature">
+          <span class="method-name">sparql</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000115-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000115-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 88</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sparql</span>()
+      <span class="ruby-identifier">query</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">new</span>( <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;file&quot;</span>] ).<span class="ruby-identifier">read</span>()
+      <span class="ruby-identifier">resp</span> = <span class="ruby-ivar">@store</span>.<span class="ruby-identifier">sparql</span>(<span class="ruby-identifier">query</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">puts</span> <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">content</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Error: #{resp.status} #{resp.reason}&quot;</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">content</span>          
+      <span class="ruby-keyword kw">end</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000108" class="method-detail">
+        <a name="M000108"></a>
+
+        <div class="method-heading">
+          <a href="#M000108" class="method-signature">
+          <span class="method-name">status</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000108-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000108-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 11</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">status</span>()
+      <span class="ruby-identifier">status</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Status</span>.<span class="ruby-identifier">read_from_store</span>(<span class="ruby-ivar">@store</span>)
+      <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Store Status:\nReadable: #{status.readable?}\nWritable: #{status.writeable?}&quot;</span>      
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000116" class="method-detail">
+        <a name="M000116"></a>
+
+        <div class="method-heading">
+          <a href="#M000116" class="method-signature">
+          <span class="method-name">store</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000116-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000116-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 99</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store</span>()
+      <span class="ruby-identifier">resp</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;url&quot;</span>]
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Storing remote data: #{@opts[&quot;url&quot;]}&quot;</span>
+        <span class="ruby-identifier">resp</span> = <span class="ruby-ivar">@store</span>.<span class="ruby-identifier">store_url</span>( <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;url&quot;</span>] ) 
+      <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;file&quot;</span>]
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Storing local file: #{@opts[&quot;file&quot;]}&quot;</span>
+        <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">new</span>( <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;file&quot;</span>] )
+        <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-identifier">f</span>) <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;.nt&quot;</span>
+          <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">RDF</span><span class="ruby-operator">::</span><span class="ruby-constant">Parser</span>.<span class="ruby-identifier">store_ntriples</span>(<span class="ruby-identifier">f</span>, <span class="ruby-ivar">@store</span>)
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-identifier">resp</span> = <span class="ruby-ivar">@store</span>.<span class="ruby-identifier">store_file</span>( <span class="ruby-identifier">f</span> )  
+        <span class="ruby-keyword kw">end</span>          
+      <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;dir&quot;</span>]
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Storing contents of directory: #{@opts[&quot;dir&quot;]}&quot;</span>
+        <span class="ruby-identifier">collection</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">RDFCollection</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@store</span>, <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;dir&quot;</span>])         
+        <span class="ruby-identifier">collection</span>.<span class="ruby-identifier">store</span>()          
+        <span class="ruby-identifier">puts</span> <span class="ruby-identifier">collection</span>.<span class="ruby-identifier">summary</span>()
+      <span class="ruby-keyword kw">else</span>     
+        <span class="ruby-comment cmt">#noop</span>
+      <span class="ruby-keyword kw">end</span> 
+    
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">resp</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</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">204</span>
+          <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Complete&quot;</span>
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Error: #{resp.status} #{resp.reason}&quot;</span>
+          <span class="ruby-identifier">puts</span> <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">content</span>
+        <span class="ruby-keyword kw">end</span>         
+      <span class="ruby-keyword kw">end</span>         
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000117" class="method-detail">
+        <a name="M000117"></a>
+
+        <div class="method-heading">
+          <a href="#M000117" class="method-signature">
+          <span class="method-name">upload</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000117-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000117-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/command_line.rb, line 131</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">upload</span>()
+      <span class="ruby-identifier">resp</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;file&quot;</span>]
+        <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">new</span>( <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;file&quot;</span>] )
+        <span class="ruby-identifier">uri</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>( <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;file&quot;</span>] )
+        <span class="ruby-identifier">uri</span> = <span class="ruby-node">&quot;#{opts[&quot;base&quot;]}/#{uri}&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;base&quot;</span>]            
+        <span class="ruby-identifier">mime</span> = <span class="ruby-constant">MIME</span><span class="ruby-operator">::</span><span class="ruby-constant">Types</span>.<span class="ruby-identifier">type_for</span>( <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;file&quot;</span>] )[<span class="ruby-value">0</span>].<span class="ruby-identifier">to_s</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Uploading file: #{ @opts[&quot;file&quot;] } to /items/#{ uri } as #{mime}&quot;</span>
+        <span class="ruby-identifier">resp</span> = <span class="ruby-ivar">@store</span>.<span class="ruby-identifier">upload_item</span>( <span class="ruby-identifier">f</span> , <span class="ruby-identifier">mime</span> , <span class="ruby-identifier">uri</span> )
+      <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;dir&quot;</span>]
+        <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Uploading contents of directory: #{@opts[&quot;dir&quot;]}&quot;</span>
+        <span class="ruby-identifier">collection</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">FileManagement</span><span class="ruby-operator">::</span><span class="ruby-constant">FileManager</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@store</span>, <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;dir&quot;</span>], <span class="ruby-ivar">@opts</span>[<span class="ruby-value str">&quot;base&quot;</span>])
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">opts</span>[<span class="ruby-value str">&quot;traverse&quot;</span>]
+          <span class="ruby-identifier">collection</span>.<span class="ruby-identifier">store</span>(<span class="ruby-identifier">:traverse</span>)          
+          <span class="ruby-identifier">puts</span> <span class="ruby-identifier">collection</span>.<span class="ruby-identifier">summary</span>(<span class="ruby-identifier">:traverse</span>)
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-identifier">collection</span>.<span class="ruby-identifier">store</span>()          
+          <span class="ruby-identifier">puts</span> <span class="ruby-identifier">collection</span>.<span class="ruby-identifier">summary</span>()            
+        <span class="ruby-keyword kw">end</span>         
+      <span class="ruby-keyword kw">else</span>     
+        <span class="ruby-comment cmt">#noop</span>
+      <span class="ruby-keyword kw">end</span> 
+    
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">resp</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</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">204</span>
+          <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Complete&quot;</span>
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Error: #{resp.status} #{resp.reason}&quot;</span>
+          <span class="ruby-identifier">puts</span> <span class="ruby-identifier">resp</span>.<span class="ruby-identifier">content</span>
+        <span class="ruby-keyword kw">end</span>         
+      <span class="ruby-keyword kw">end</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>