lightrdf 0.1.5 → 0.1.6

data/History.txt

@@ -1,3 +1,7 @@
+=== 0.1.6 2011-01-21
+
+* Added Sesame functionality
+
 === 0.1.5 2010-11-16
 
 * Corrected problem when using Open3 and rapper

data/Manifest

@@ -7,6 +7,7 @@ lib/lightrdf.rb
 lib/lightrdf/graph.rb
 lib/lightrdf/node.rb
 lib/lightrdf/parser.rb
+lib/lightrdf/repository.rb
 lib/lightrdf/quri.rb
 test/test_helper.rb
 test/test_lightrdf.rb

data/README.rdoc

@@ -4,7 +4,7 @@
 
 == DESCRIPTION:
 
-LightRDF is a gem that makes managing RDF data and graphs easily with a Ruby interface.
+LightRDF is a gem that makes managing RDF data and graphs easy, with a Ruby interface.
 
 == INSTALL:
 
@@ -15,6 +15,8 @@ for outputting different RDF serialization formats.
 
 Additionally, PNG output of RDF graphs requires Graphviz (in Debian systems: sudo aptitude install graphviz).
 
+Also, if you want to use the repository and Sesame functionality, Sesame must be installed. You can find furhter instructions at http://openrdf.org
+
 == RDF NODES:
 
 RDF nodes can be created using the Node method:
@@ -137,6 +139,40 @@ graphs and serialized using the parse and serialize methods:
   graph = RDF::Parser.parse(:rdf, open('http://planetrdf.com/guide/rss.rdf').read) # Builds a graph
   graph.serialize(:ntriples) # Outputs a string with triples
 
+== RDF REPOSITORY
+
+LightRDF can use a Sesame repository to save the RDF data.
+The Sesame options are configured when creating the repository
+  
+  repository = RDF::Repository.new :host=>"http://localhost", :port=>8080, :repository=>"memory"
+
+If any of the values is missing, the values above will be used by default.
+
+You have three ways of comunicating with Sesame:
+- You can ask Sesame for the list of all the contexts in the repository:
+  
+  repository = RDF::Repository.new
+  repository.contexts
+  
+- You can ask Sesame for all the data in several contexts, using the data method, which returns an RDF Graph:
+
+  repository = RDF::Repository.new
+  repository = repository.data "test:context1", "test:context2"
+  repository = repository.data "test:context3"
+  
+- You can ask Sesame for including data in a certain context, using the data= method, passing an RDF Graph as a parameter.
+
+  repository = RDF::Repository.new
+  context = "test:context4"
+  repository.data = graph, context # Associate graph to "test:context4"
+  repository.data = graph # In this case, data has no associated context
+  
+== CONTRIBUTORS:
+
+* José Ignacio Fernández
+
+* Alberto Mardomingo
+
 == LICENSE:
 
 (The MIT License)

data/Rakefile

@@ -11,7 +11,7 @@ Echoe.new('lightrdf', RDF::VERSION) do |p|
   p.email          = "joseignacio.fernandez@gmail.com"
   p.install_message = '**Remember to install raptor RDF tools and (optionally for RDF PNG output) Graphviz**'
   p.ignore_pattern = ["pkg/*"]
-  p.development_dependencies = [['activesupport','>= 2.0.2']]
+  p.dependencies   = [['activesupport','>= 2.0.2'], ['rest-client', '>=1.6.1'], ['nokogiri', '>= 1.4.1']]
 end
 
 Rake::RDocTask.new(:rdoc) do |rdoc|

data/lib/lightrdf/parser.rb

@@ -36,9 +36,10 @@ module RDF
       when :rdf
         serialize(:rdfxml)
       else
-        tmpfile = File.join(Dir.tmpdir, "rapper#{$$}#{Thread.current.object_id}")
-        File.open(tmpfile, 'w') { |f| f.write(serialize(:ntriples)) }
-        %x[rapper -q -i ntriples -o #{format} #{tmpfile}]
+        stdin, stdout, stderr = Open3.popen3("rapper -q -i ntriples -o #{format} /dev/stdin")
+        stdin.puts serialize(:ntriples)
+        stdin.close
+        stdout.read
       end
     end
 

data/lib/lightrdf/repository.rb

@@ -0,0 +1,85 @@
+module RDF
+  class Repository
+    include MonitorMixin
+    include Parser  
+  
+    def initialize options={}
+      super()
+      
+      # Assigns the default value to the options.
+      @options = {:host=>"http://localhost", :port=>8080, :repository=>"memory", :format=>:ntriples}.merge(options)
+    end
+    
+    # Extracts the data in sesame from the indicated repositories
+    def data *contexts
+      synchronize do
+        params = ("?" + contexts.map{|context| "context=%3C#{CGI::escape(context)}%3E"}*"&&" if contexts.empty?)
+
+        # Prepares the URL to request the data
+        url = "#{repository_statements_url(@options[:repository])}?#{params}"
+
+        # Asks for the data
+        ntriples = RestClient.get url, :content_type=>content_type
+
+        # Builds the graph
+        Parser.parse :rdf, ntriples
+      end
+	 	end
+
+	  # Gets the list of the sesame contexts
+    def contexts
+      synchronize do
+        # The URL to get the context list from sesame
+        url = "#{repository_url(@options[:repository])}/contexts"
+
+        # Asks for the context list and parses it
+        Nokogiri::XML( RestClient.get(url, :content_type=>'application/sparql-results+xml') ).search(:uri).map(&:text)
+      end
+    end
+
+    # Adds data to sesame without removing the previous data
+    def data= *args
+      synchronize do
+        # Retrieve arguments
+        graph, context = if args.first.is_a?(Array)
+            [args.first.first, args.first.last]
+          else
+            [args.first, ""]
+          end
+        
+        # Prepares the dir to connect with the repository
+        url = "#{repository_statements_url(@options[:repository])}?context=%3C#{CGI::escape(context)}%3E"
+        data = graph.serialize :ntriples
+
+        # Adds the data to Sesame
+        RestClient.post url, data, :content_type=>content_type
+      end
+    end
+
+    protected
+
+    # Selects the type of data to send to sesame
+    def content_type
+      case @options[:format].to_sym
+        when :rdfxml   then 'application/rdf+xml'
+        when :ntriples then 'text/plain'
+        when :turtle   then 'application/x-turtle'
+        when :n3       then 'text/rdf+n3'
+        when :trix     then 'application/trix'
+        when :trig     then 'application/x-trig'
+      end
+    end
+    
+    def repositories_url
+      "#{@options[:host]}:#{@options[:port]}/openrdf-sesame/repositories"
+    end
+    
+    def repository_url repository
+      "#{repositories_url}/#{repository}"
+    end
+    
+    def repository_statements_url repository
+      "#{repository_url(repository)}/statements"
+    end
+  end
+end

data/lib/lightrdf.rb

@@ -2,7 +2,7 @@ $:.unshift(File.dirname(__FILE__)) unless
   $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 module RDF
-  VERSION = '0.1.5'
+  VERSION = '0.1.6'
 end
 
 require 'rubygems'
@@ -11,8 +11,13 @@ require 'uri'
 require 'open3'
 require 'open-uri'
 require 'tmpdir'
+require 'rest-client'
+require 'yaml'
+require 'monitor'
+require 'nokogiri'
 
 require "lightrdf/quri"
 require "lightrdf/parser"
 require "lightrdf/graph"
 require "lightrdf/node"
+require "lightrdf/repository"

data/lightrdf.gemspec

@@ -2,17 +2,17 @@
 
 Gem::Specification.new do |s|
   s.name = %q{lightrdf}
-  s.version = "0.1.5"
+  s.version = "0.1.6"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jose Ignacio"]
-  s.date = %q{2010-11-16}
+  s.date = %q{2011-01-21}
   s.default_executable = %q{yarfp}
   s.description = %q{RDF library}
   s.email = %q{joseignacio.fernandez@gmail.com}
   s.executables = ["yarfp"]
-  s.extra_rdoc_files = ["README.rdoc", "bin/yarfp", "lib/lightrdf.rb", "lib/lightrdf/graph.rb", "lib/lightrdf/node.rb", "lib/lightrdf/parser.rb", "lib/lightrdf/quri.rb"]
-  s.files = ["History.txt", "Manifest", "README.rdoc", "Rakefile", "bin/yarfp", "lib/lightrdf.rb", "lib/lightrdf/graph.rb", "lib/lightrdf/node.rb", "lib/lightrdf/parser.rb", "lib/lightrdf/quri.rb", "test/test_helper.rb", "test/test_lightrdf.rb", "lightrdf.gemspec"]
+  s.extra_rdoc_files = ["README.rdoc", "bin/yarfp", "lib/lightrdf.rb", "lib/lightrdf/graph.rb", "lib/lightrdf/node.rb", "lib/lightrdf/parser.rb", "lib/lightrdf/repository.rb", "lib/lightrdf/quri.rb"]
+  s.files = ["History.txt", "Manifest", "README.rdoc", "Rakefile", "bin/yarfp", "lib/lightrdf.rb", "lib/lightrdf/graph.rb", "lib/lightrdf/node.rb", "lib/lightrdf/parser.rb", "lib/lightrdf/repository.rb", "lib/lightrdf/quri.rb", "test/test_helper.rb", "test/test_lightrdf.rb", "lightrdf.gemspec"]
   s.homepage = %q{http://github.com/josei/lighrdf}
   s.post_install_message = %q{**Remember to install raptor RDF tools and (optionally for RDF PNG output) Graphviz**}
   s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Lightrdf", "--main", "README.rdoc"]
@@ -27,11 +27,17 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<activesupport>, [">= 2.0.2"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.0.2"])
+      s.add_runtime_dependency(%q<rest-client>, [">= 1.6.1"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 1.4.1"])
     else
       s.add_dependency(%q<activesupport>, [">= 2.0.2"])
+      s.add_dependency(%q<rest-client>, [">= 1.6.1"])
+      s.add_dependency(%q<nokogiri>, [">= 1.4.1"])
     end
   else
     s.add_dependency(%q<activesupport>, [">= 2.0.2"])
+    s.add_dependency(%q<rest-client>, [">= 1.6.1"])
+    s.add_dependency(%q<nokogiri>, [">= 1.4.1"])
   end
 end

data/test/test_lightrdf.rb

@@ -4,7 +4,7 @@ class TestLightRDF < Test::Unit::TestCase
 
   def setup
     Namespace :ex,   'http://www.example.com/ontology#'
-    Namespace :foaf, 'http://xmlns.com/foaf/0.1/'
+    Namespace :foaf, 'http://xmlns.com/foaf/0.1/'
   end
   
   def test_equality
@@ -122,4 +122,29 @@ foaf: http://xmlns.com/foaf/0.1/
 
     assert 2, g.to_ntriples.split("\n").size
   end
+
+  def test_repository
+    repository = RDF::Repository.new
+    triple = [Node("http://testuri.org"), Node('rdf:type'), Node('rdf:Class')]
+    graph = RDF::Graph.new [triple]
+    context = "http://test_repository.org"
+    repository.data = graph, context
+    
+    # Check if the added data is there
+    assert_equal graph, repository.data(context)
+    
+    # Check if the triple is there when not filtering by context
+    assert repository.data.triples.include?(triple)
+  end
+  
+  def test_repository_contexts
+    repository = RDF::Repository.new
+    graph = RDF::Graph.new [[Node("http://testuri.org"), Node('rdf:type'), Node('rdf:Class')]]
+    context = "http://test_repository_contexts.org"
+    repository.data = graph, context
+    contexts = repository.contexts
+
+    # Check if the added context is there
+    assert contexts.include?("http://test_repository_contexts.org")
+  end
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 5
-  version: 0.1.5
+  - 6
+  version: 0.1.6
 platform: ruby
 authors: 
 - Jose Ignacio
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-16 00:00:00 +01:00
+date: 2011-01-21 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -29,8 +29,36 @@ dependencies:
         - 0
         - 2
         version: 2.0.2
-  type: :development
+  type: :runtime
   version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 6
+        - 1
+        version: 1.6.1
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 4
+        - 1
+        version: 1.4.1
+  type: :runtime
+  version_requirements: *id003
 description: RDF library
 email: joseignacio.fernandez@gmail.com
 executables: 
@@ -44,6 +72,7 @@ extra_rdoc_files:
 - lib/lightrdf/graph.rb
 - lib/lightrdf/node.rb
 - lib/lightrdf/parser.rb
+- lib/lightrdf/repository.rb
 - lib/lightrdf/quri.rb
 files: 
 - History.txt
@@ -55,6 +84,7 @@ files:
 - lib/lightrdf/graph.rb
 - lib/lightrdf/node.rb
 - lib/lightrdf/parser.rb
+- lib/lightrdf/repository.rb
 - lib/lightrdf/quri.rb
 - test/test_helper.rb
 - test/test_lightrdf.rb