rdf-4store 0.0.1

data/AUTHORS

@@ -0,0 +1 @@
+Fumihiro Kato <fumi@fumi.me>

data/README

@@ -0,0 +1,43 @@
+# 4store Storage Adapter for RDF.rb
+
+This is an [RDF.rb][] storage adapter that allows you to use the [4store][] RDF Database.
+
+See <http://blog.datagraph.org/2010/04/rdf-repository-howto> for an overview.
+
+## Status
+
+This is still in alpha status, don't use in production environment.
+
+## Requirements
+
+This plugin depends on the unsafe mode of 4s-httpd. 
+
+    $ 4s-backend demo
+    $ 4s-httpd -U -s -1 demo
+
+## Resources
+
+ * <http://rdf.rubyforge.org> - RDF.rb's home page
+ * <http://rdf.rubyforge.org/RDF/Repository.html> - RDF.rb's Repository documentation
+ * <http://4store.org> - 4store's home page
+ * <http://github.com/fumi/rdf-4store>
+
+### Support
+
+Please post questions or feedback to the [W3C-ruby-rdf mailing list][].
+
+### Author
+
+ * Fumihiro Kato <fumi@fumi.me> | <http://github.com/fumi> | <http://fumi.me>
+
+### 'License'
+
+This is free and unemcumbered software released into the public domain.  For
+more information, see the accompanying UNLICENSE file.
+
+If you're unfamiliar with public domain, that means it's perfectly fine to
+start with this skeleton and code away, later relicensing as you see fit.
+
+[RDF.rb]: http://rdf.rubyforge.org/
+[4store]: http://4store.org/
+[W3C-ruby-rdf mailing list]:        http://lists.w3.org/Archives/Public/public-rdf-ruby/

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <http://unlicense.org/>

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/rdf/4store.rb

@@ -0,0 +1,9 @@
+require 'rdf'
+
+module RDF
+  module FourStore
+    autoload :Repository, 'rdf/four_store/repository'
+    autoload :VERSION, 'rdf/four_store/version'
+  end
+end
+

data/lib/rdf/four_store/repository.rb

@@ -0,0 +1,296 @@
+require 'net/http'
+require 'uri'
+require 'open-uri'
+require 'enumerator'
+require 'rdf'
+require 'sparql/client'
+require 'nokogiri'
+
+module RDF::FourStore
+
+  ##
+  # RDF::Repository backend for 4store
+  #
+  # @see http://4store.org
+  # @see 
+  class Repository < ::SPARQL::Client::Repository
+
+    attr_reader :endpointURI, :dataURI, :updateURI, :statusURI, :sizeURI
+
+    DEFAULT_CONTEXT = "local:".freeze
+
+    ##
+    # Constructor of RDF::FourStore::Repository
+    #
+    # @param [String] uri
+    # @param [Hash] options
+    # @return [RDF::FourStore::Repository]
+    # @example
+    #    RDF::FourStore::Respository.new('http://localhost:8080')
+    #
+    def initialize(uri_or_options = {})
+      case uri_or_options
+      when String
+        @options = {}
+        @uri = uri_or_options.to_s
+      when Hash
+        @options = uri_or_options.dup
+        @uri = @options.delete([:uri])
+      else
+        raise ArgumentError, "expected String or Hash, but got #{uri_or_options.inspect}"
+      end
+      @uri.sub!(/\/$/, '')
+      @endpointURI = @uri + "/sparql/"
+      @dataURI = @uri + "/data/"
+      @updateURI = @uri + "/update/"
+      @statusURI = @uri + "/status/"
+      @sizeURI = @statusURI + "size/"
+
+      super(@endpointURI, options)
+    end
+
+    ##
+    # Loads RDF statements from the given file or URL into `self`.
+    #
+    # @see RDF::Mutable#load
+    # @param  [String, #to_s]          filename
+    # @param  [Hash{Symbol => Object}] options
+    # @return [void]
+    def load(filename, options = {})
+      return super(filename, options) if /^https?:\/\//.match(filename)
+
+      uri = nil
+
+      if options[:context]
+        uri = @dataURI + options[:context]
+      else
+        uri = @dataURI + 'file://' + File.expand_path(filename)
+      end
+
+      uri = URI.parse(uri)
+      content = open(filename).read
+      begin
+        req = Net::HTTP::Put.new(uri.path)
+        Net::HTTP.start(uri.host, uri.port) do |http|
+          http.request(req, content)
+        end
+      rescue Errno::ECONNREFUSED, Errno::ECONNRESET, TimeoutError
+        retry
+      end
+    end
+
+    alias_method :load!, :load
+
+    ##
+    # Returns the number of statements in this repository.
+    # @see RDF::Repository#count
+    # @return [Integer]
+    def count
+      c = 0
+      doc = Nokogiri::HTML(open(@sizeURI))
+      doc.search('tr').each do |tr|
+        td = tr.search('td')
+        c = td[0].content if td[0]
+      end
+      c.to_i # the last one is the total number
+    end
+    alias_method :size, :count
+    alias_method :length, :count
+
+    ##
+    # Enumerates each RDF statement in this repository.
+    #
+    # @yield  [statement]
+    # @yieldparam [RDF::Statement] statement
+    # @return [Enumerator]
+    # @see    RDF::Repository#each
+    # @see    SPARQL::Client::Rpository#each
+    def each(&block)
+      unless block_given?
+        RDF::Enumerator.new(self, :each)
+      else
+        # TODO: check why @client.construct does not work here.
+        statements = @client.query("CONSTRUCT { ?s ?p ?o } WHERE { ?s ?p ?o }")
+        statements.each_statement(&block) if statements
+      end
+    end
+
+    ##
+    # @private
+    # @see RDF::Enumerable#has_triple?
+    def has_triple?(triple)
+      has_statement?(RDF::Statement.from(triple))
+    end
+
+    ##
+    # @private
+    # @see RDF::Enumerable#has_quad?
+    def has_quad?(quad)
+      has_statement?(RDF::Statement.new(quad[0], quad[1], quad[2], :context => quad[3]))
+    end
+
+    ##
+    # @private
+    # @see RDF::Enumerable#has_statement?
+    def has_statement?(statement)
+      context = statement.context
+      dump = dump_statement(statement)
+      if context
+        @client.query("ASK { GRAPH <#{context}> { #{dump} } } ")
+      else
+        @client.query("ASK { #{dump} } ")
+      end
+    end
+
+    ##
+    # @see RDF::Mutable#insert_statement
+    # @private
+    def insert_statement(statement)
+      #TODO: save the given RDF::Statement.  Don't save duplicates.
+      #
+      #unless has_statement?(statement)
+        dump = dump_statement(statement)
+        post_data(dump, statement.context)
+      #end
+    end
+
+    ##
+    # @see RDF::Mutable#delete_statement
+    # @private
+    def delete_statement(statement)
+      if has_statement?(statement)
+        context = statement.context || DEFAULT_CONTEXT
+        dump = dump_statement(statement)
+        q = "DELETE DATA { GRAPH <#{context}> { #{dump} } }"
+        post_update(q, context)
+      end
+    end
+
+    ##
+    # @private
+    # @see RDF::Mutable#clear
+    def clear_statements
+      q = "SELECT ?g WHERE { GRAPH ?g { ?s ?p ?o . } FILTER (?g != <#{DEFAULT_CONTEXT}>) }"
+      @client.query(q).each do |solution|
+        post_update("CLEAR GRAPH <#{solution[:g]}>") 
+      end
+      post_update("CLEAR GRAPH <#{DEFAULT_CONTEXT}>") 
+    end
+
+    ##
+    # Queries `self` for RDF statements matching the given `pattern`.
+    #
+    # @param  [Query, Statement, Array(Value), Hash] pattern
+    # @yield  [statement]
+    # @yieldparam [Statement]
+    # @return [Enumerable<Statement>]
+    def query(pattern, &block)
+      case pattern
+      when RDF::Statement
+        h = {
+          :subject => pattern.subject || :s,
+          :predicate => pattern.predicate || :p,
+          :object => pattern.object || :o,
+          :context => pattern.context || nil
+        }
+        super(RDF::Query::Pattern.new(h), &block)
+      when Array
+        h = {
+          :subject => pattern[0] || :s,
+          :predicate => pattern[1] || :p,
+          :object => pattern[2]  || :o,
+          :context => pattern[3]  || nil
+        }
+        super(RDF::Query::Pattern.new(h), &block)
+      when Hash
+        pattern[:subject] ||= :s
+        pattern[:predicate] ||= :p
+        pattern[:object] ||= :o
+        super(RDF::Query::Pattern.new(pattern), &block)
+      else
+        super(pattern, &block)
+      end
+    end
+
+    def query_pattern(pattern, &block)
+      context = pattern.context || DEFAULT_CONTEXT
+      str = pattern.to_s
+      q = "CONSTRUCT { #{str} } WHERE { GRAPH <#{context}> { #{str} } } "
+      result = @client.query(q)
+      if result
+        if block_given?
+          result.each_statement(&block)
+        else
+          result
+        end
+      end
+    end
+
+    def dump_statement(statement)
+      dump_statements([statement])
+    end
+    
+    def dump_statements(statements)
+      graph = RDF::Graph.new
+      graph.insert_statements(statements)
+      RDF::Writer.for(:ntriples).dump(graph)
+    end
+ 
+    def post_data(content, context = nil)
+      context ||= DEFAULT_CONTEXT
+      uri = URI.parse(@dataURI)
+
+      req = Net::HTTP::Post.new(uri.path)
+      req.form_data = {
+        'data' => content,
+        'graph' => context,
+        'mime-type' => 'application/x-turtle'
+      }
+
+      Net::HTTP.start(uri.host, uri.port) do |http|
+        http.request(req)
+      end
+    end
+
+    def post_update(content, context = nil)
+      context ||= DEFAULT_CONTEXT
+      uri = URI.parse(@updateURI)
+
+      req = Net::HTTP::Post.new(uri.path)
+      req.form_data = {
+        'update' => content,
+        'graph' => context,
+        'content-type' => 'triples',
+      }
+
+      Net::HTTP.start(uri.host, uri.port) do |http|
+        http.request(req)
+      end
+    end
+
+    ## 
+    # @private
+    # @see RDF::Writable#writable?
+    # @return [Boolean]
+    def writable?
+      true
+    end
+
+    ## 
+    # @private
+    # @see RDF::Durable#durable?
+    # @return [Boolean]
+    def durable?
+      true
+    end
+    
+    ## 
+    # @private
+    # @see RDF::Countable#empty?
+    # @return [Boolean]
+    def empty?
+      count.zero?
+    end
+
+  end
+end

data/lib/rdf/four_store/version.rb

@@ -0,0 +1,23 @@
+module RDF::FourStore
+  module VERSION
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+    EXTRA = nil
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+    STRING << ".#{EXTRA}" if EXTRA
+
+    ##
+    # @return [String]
+    def self.to_s() STRING end
+
+    ##
+    # @return [String]
+    def self.to_str() STRING end
+
+    ##
+    # @return [Array(Integer, Integer, Integer)]
+    def self.to_a() [MAJOR, MINOR, TINY] end
+  end
+end

metadata

@@ -0,0 +1,154 @@
+--- !ruby/object:Gem::Specification 
+name: rdf-4store
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Fumihiro Kato
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-15 00:00:00 +09:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rdf-spec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 0
+        - 2
+        - 0
+        version: 0.2.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rdf
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 2
+        - 2
+        version: 0.2.2
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 1
+        - 4
+        - 1
+        version: 1.4.1
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: sparql-client
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 0
+        - 0
+        - 4
+        version: 0.0.4
+  type: :runtime
+  version_requirements: *id005
+description: RDF.rb plugin providing 4store storage adapter.
+email: fumi@fumi.me
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- AUTHORS
+- README
+- UNLICENSE
+- VERSION
+- lib/rdf/4store.rb
+- lib/rdf/four_store/repository.rb
+- lib/rdf/four_store/version.rb
+has_rdoc: true
+homepage: http://github.com/fumi/rdf-4store
+licenses: 
+- Public Domain
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 57
+      segments: 
+      - 1
+      - 8
+      - 7
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: 
+- 4store 1.0.3 or greater
+rubyforge_project: rdf
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: 4store adapter for RDF.rb.
+test_files: []
+