rdf 0.0.4 → 0.0.5

data/README

@@ -97,7 +97,7 @@ as follows:
 
     % wget http://github.com/bendiken/rdf/tarball/master
 
-Requirements
+Dependencies
 ------------
 
 * [Addressable](http://addressable.rubyforge.org/) (>= 2.1.1)
@@ -117,7 +117,14 @@ Resources
 * <http://github.com/bendiken/rdf>
 * <http://gemcutter.org/gems/rdf>
 * <http://rubyforge.org/projects/rdf/>
-* <http://raa.ruby-lang.org/project/rdf>
+* <http://raa.ruby-lang.org/project/rdf/>
+
+See also
+--------
+
+* [RDFize](http://rdfize.rubyforge.org/)
+* [RDFbus](http://rdfbus.rubyforge.org/)
+* [RDFcache](http://rdfcache.rubyforge.org/)
 
 Author
 ------

data/VERSION

@@ -1 +1 @@
-0.0.4
+0.0.5

data/lib/rdf.rb

@@ -14,6 +14,9 @@ module RDF
   autoload :Reader,     'rdf/reader'
   autoload :Writer,     'rdf/writer'
 
+  # RDF storage
+  autoload :Repository, 'rdf/repository'
+
   # RDF vocabularies
   autoload :Vocabulary, 'rdf/vocabulary'
   autoload :CC,         'rdf/vocabulary/cc'
@@ -38,6 +41,12 @@ module RDF
     Vocabulary.create(uri)
   end
 
+  ##
+  # @return [URI]
+  def self.type
+    self[:type]
+  end
+
   ##
   # @return [#to_s] property
   # @return [URI]

data/lib/rdf/graph.rb

@@ -56,7 +56,7 @@ module RDF
 
     ##
     # @yield  [triple]
-    # @yieldparam [Array<Value>]
+    # @yieldparam [Array(Value)]
     # @return [Graph]
     def each_triple(&block)
       @data.each do |statement|
@@ -67,7 +67,7 @@ module RDF
 
     ##
     # @yield  [quad]
-    # @yieldparam [Array<Value>]
+    # @yieldparam [Array(Value)]
     # @return [Graph]
     def each_quad(&block)
       @data.each do |statement|
@@ -125,13 +125,13 @@ module RDF
     end
 
     ##
-    # @return [Array<Array>]
+    # @return [Array<Array(Value)>]
     def triples(&block)
       block_given? ? each_triple(&block) : map { |statement| statement.to_triple }
     end
 
     ##
-    # @return [Array<Array>]
+    # @return [Array<Array(Value)>]
     def quads(&block)
       block_given? ? each_quad(&block) : map { |statement| statement.to_quad }
     end
@@ -165,7 +165,7 @@ module RDF
     end
 
     ##
-    # @param  [Statement, Array]
+    # @param  [Statement, Array(Value)]
     # @return [Graph]
     def <<(statement)
       @data << case statement

data/lib/rdf/reader.rb

@@ -23,13 +23,13 @@ module RDF
     end
 
     ##
-    # @return [{String => Symbol}]
+    # @return [Hash{String => Symbol}]
     def self.content_types
       @@content_types
     end
 
     ##
-    # @return [{Symbol => String}]
+    # @return [Hash{Symbol => String}]
     def self.file_extensions
       @@file_extensions
     end
@@ -89,7 +89,7 @@ module RDF
 
     ##
     # @yield  [triple]
-    # @yieldparam [Array]
+    # @yieldparam [Array(Value)]
     # @return [Reader]
     def each_triple(&block)
       begin

data/lib/rdf/repository.rb

@@ -0,0 +1,242 @@
+module RDF
+  ##
+  # An RDF repository.
+  class Repository
+    include Enumerable
+
+    # @return [URI]
+    attr_reader :uri
+
+    # @return [String]
+    attr_reader :title
+
+    ##
+    # Loads an N-Triples file as a transient in-memory repository.
+    #
+    # @param  [String] filename
+    # @yield  [repository]
+    # @yieldparam [Repository]
+    # @return [void]
+    def self.load(filename, options = {}, &block)
+      self.new(options) do |repository|
+        repository.load(filename, options)
+
+        if block_given?
+          case block.arity
+            when 1 then block.call(repository)
+            else repository.instance_eval(&block)
+          end
+        end
+      end
+    end
+
+    ##
+    # @yield  [repository]
+    # @yieldparam [Repository]
+    def initialize(options = {}, &block)
+      @uri   = options.delete(:uri)
+      @title = options.delete(:title)
+      @data, @options = [], options
+
+      if block_given?
+        case block.arity
+          when 1 then block.call(self)
+          else instance_eval(&block)
+        end
+      end
+    end
+
+    ##
+    # Returns `true` if the repository is transient.
+    #
+    # @return [Boolean]
+    # @see    #persistent?
+    def transient?
+      !persistent?
+    end
+
+    ##
+    # Returns `true` if the repository is persistent.
+    #
+    # @return [Boolean]
+    # @see    #transient?
+    # @abstract
+    def persistent?
+      false # NOTE: override this in any persistent subclasses
+    end
+
+    ##
+    # Returns `true` if the repository is readable.
+    #
+    # @return [Boolean]
+    def readable?
+      true
+    end
+
+    ##
+    # Returns `true` if the repository is mutable.
+    #
+    # @return [Boolean]
+    # @see    #immutable?
+    # @see    #immutable!
+    def mutable?
+      !immutable?
+    end
+
+    alias_method :writable?, :mutable?
+
+    ##
+    # Returns `true` if the repository is immutable.
+    #
+    # @return [Boolean]
+    # @see    #mutable?
+    # @see    #immutable!
+    def immutable?
+      @options[:mutable] == false
+    end
+
+    ##
+    # Makes the repository contents immutable.
+    #
+    # @return [void]
+    # @see    #mutable?
+    # @see    #immutable?
+    def immutable!
+      @options[:mutable] = true
+    end
+
+    ##
+    # Returns `true` if the repository contains no RDF statements.
+    #
+    # @return [Boolean]
+    def empty?
+      @data.empty?
+    end
+
+    ##
+    # Returns the number of RDF statements in the repository.
+    #
+    # @return [Integer] 
+    def size
+      @data.size
+    end
+
+    alias_method :count, :size
+
+    ##
+    # Returns `true` if the repository contains the given RDF statement.
+    #
+    # @param  [Statement] statement
+    # @return [Boolean]
+    def has_statement?(statement)
+      @data.include?(statement)
+    end
+
+    alias_method :include?, :has_statement?
+
+    ##
+    # Enumerates each RDF statement in the repository.
+    #
+    # @yield [statement]
+    # @yieldparam [Statement]
+    # @return [Repository]
+    def each_statement(&block)
+      @data.each(&block)
+      self
+    end
+
+    alias_method :each, :each_statement
+
+    ##
+    # Queries the repository for RDF statements matching the given pattern.
+    #
+    # @param  [Statement, Array(Value)] pattern
+    # @yield  [statement]
+    # @yieldparam [Statement]
+    # @return [Array<Statement>, nil]
+    def query(pattern, &block)
+      raise TypeError.new("repository is not readable") unless readable?
+      case pattern
+        when Array
+          query(Statement.new(*pattern), &block)
+        when Statement
+          if block_given?
+            # TODO: yield any found statements
+            nil
+          else
+            find_all { |statement| pattern === statement }
+          end
+      end
+    end
+
+    ##
+    # Loads RDF statements from the given N-Triples file into the repository.
+    #
+    # @param  [String]  filename
+    # @return [Integer] the number of inserted RDF statements
+    def load(filename, options = {})
+      raise TypeError.new("repository is immutable") if immutable?
+      count = 0
+      Reader.open(filename, options) do |reader|
+        reader.each_statement do |statement|
+          insert_statement(statement)
+          count += 1
+        end
+      end
+      count
+    end
+
+    ##
+    # Inserts an RDF statement to the repository.
+    #
+    # @param  [Statement, Array(Value), #to_a] statement
+    # @return [Repository]
+    def <<(statement)
+      raise TypeError.new("repository is immutable") if immutable?
+      case statement
+        when Statement then insert_statement(statement)
+        else insert_statement(Statement.new(*statement.to_a))
+      end
+      self
+    end
+
+    ##
+    # Inserts RDF statements into the repository.
+    #
+    # @param  [Array<Statement>] statements
+    # @raise  [TypeError] if the repository is immutable
+    # @return [Repository]
+    def insert(*statements)
+      raise TypeError.new("repository is immutable") if immutable?
+      statements.each do |statement|
+        insert_statement(statement)
+      end
+      self
+    end
+
+    ##
+    # Deletes RDF statements from the repository.
+    #
+    # @param  [Array<Statement>] statements
+    # @raise  [TypeError] if the repository is immutable
+    # @return [Repository]
+    def delete(*statements)
+      raise TypeError.new("repository is immutable") if immutable?
+      statements.each do |statement|
+        delete_statement(statement)
+      end
+      self
+    end
+
+    protected
+
+      def insert_statement(statement)
+        @data.push(statement) unless @data.include?(statement)
+      end
+
+      def delete_statement(statement)
+        @data.delete(statement)
+      end
+
+  end
+end

data/lib/rdf/statement.rb

@@ -23,37 +23,58 @@ module RDF
     # @param  [Value]    o
     # @option options [Resource] :context (nil)
     def initialize(s = nil, p = nil, o = nil, options = {})
+      @id = options[:id] if options.has_key?(:id)
       @context = options[:context] || options[:graph]
       @subject, @predicate, @object = s, p, o
     end
 
     ##
     # @return [Boolean]
-    def asserted?()  !quoted? end
+    def asserted?
+      !quoted?
+    end
+
+    ##
+    # @return [Boolean]
+    def quoted?
+      false
+    end
 
     ##
     # @return [Boolean]
-    def quoted?()    false end
+    def inferred?
+      false
+    end
 
     ##
     # @return [Boolean]
-    def has_graph?()     has_context? end
+    def has_graph?
+      has_context?
+    end
 
     ##
     # @return [Boolean]
-    def has_context?()   !!context end
+    def has_context?
+      !!context
+    end
 
     ##
     # @return [Boolean]
-    def has_subject?()   !!subject end
+    def has_subject?
+      !!subject
+    end
 
     ##
     # @return [Boolean]
-    def has_predicate?() !!predicate end
+    def has_predicate?
+      !!predicate
+    end
 
     ##
     # @return [Boolean]
-    def has_object?()    !!object end
+    def has_object?
+      !!object
+    end
 
     ##
     # @param  [Statement] other
@@ -100,24 +121,19 @@ module RDF
     end
 
     ##
-    # @return [Array]
-    def to_triple
-      [subject, predicate, object]
-    end
-
-    ##
-    # @return [Array]
+    # @return [Array(Value)]
     def to_quad
       [subject, predicate, object, context]
     end
 
     ##
-    # @return [Array]
-    def to_a()   to_triple end
+    # @return [Array(Value)]
+    def to_triple
+      [subject, predicate, object]
+    end
 
-    ##
-    # @return [Array]
-    def to_ary() to_triple end
+    alias_method :to_a,   :to_triple
+    alias_method :to_ary, :to_triple
 
     ##
     # @return [Hash]

data/lib/rdf/version.rb

@@ -2,7 +2,7 @@ module RDF
   module VERSION
     MAJOR = 0
     MINOR = 0
-    TINY  = 4
+    TINY  = 5
     EXTRA = nil
 
     STRING = [MAJOR, MINOR, TINY].join('.')

data/lib/rdf/writer.rb

@@ -132,7 +132,7 @@ module RDF
     end
 
     ##
-    # @param  [Array<Array>] triples
+    # @param  [Array<Array(Value)>] triples
     def write_triples(*triples)
       triples.each { |triple| write_triple(*triple) }
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rdf
 version: !ruby/object:Gem::Version 
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors: 
 - Arto Bendiken
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-23 00:00:00 +01:00
+date: 2009-12-27 00:00:00 +01:00
 default_executable: rdf
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -37,6 +37,10 @@ email: arto.bendiken@gmail.com
 executables: 
 - rdf
 - rdf-count
+- rdf-lengths
+- rdf-objects
+- rdf-predicates
+- rdf-subjects
 extensions: []
 
 extra_rdoc_files: []
@@ -44,7 +48,6 @@ extra_rdoc_files: []
 files: 
 - AUTHORS
 - README
-- Rakefile
 - UNLICENSE
 - VERSION
 - bin/rdf
@@ -60,6 +63,7 @@ files:
 - lib/rdf/node.rb
 - lib/rdf/reader/ntriples.rb
 - lib/rdf/reader.rb
+- lib/rdf/repository.rb
 - lib/rdf/resource.rb
 - lib/rdf/statement.rb
 - lib/rdf/uri.rb

data/Rakefile

@@ -1,8 +0,0 @@
-#!/usr/bin/env ruby
-$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), 'lib')))
-require 'rubygems'
-begin
-  require 'rakefile' # http://github.com/bendiken/rakefile
-rescue LoadError => e
-end
-require 'rdf'