rdf 0.0.8 → 0.0.9

data/README

@@ -4,6 +4,8 @@ RDF.rb: RDF API for Ruby
 This is a pure-Ruby library for working with Resource Description Framework
 (RDF) data.
 
+* <http://github.com/bendiken/rdf>
+
 ### About the Resource Description Framework (RDF)
 
 * <http://www.w3.org/RDF/>
@@ -144,6 +146,7 @@ See Also
 * [RDFize](http://rdfize.rubyforge.org/)
 * [RDFbus](http://rdfbus.rubyforge.org/)
 * [RDFcache](http://rdfcache.rubyforge.org/)
+* [Trinity](http://trinity.datagraph.org/)
 
 Author
 ------

data/VERSION

@@ -1 +1 @@
-0.0.8
+0.0.9

data/lib/rdf.rb

@@ -4,6 +4,7 @@ module RDF
   # RDF mixins
   autoload :Durable,    'rdf/mixin/durable'
   autoload :Enumerable, 'rdf/mixin/enumerable'
+  autoload :Inferable,  'rdf/mixin/inferable'
   autoload :Mutable,    'rdf/mixin/mutable'
   autoload :Queryable,  'rdf/mixin/queryable'
   autoload :Readable,   'rdf/mixin/readable'
@@ -21,7 +22,9 @@ module RDF
   # RDF serialization
   autoload :Format,     'rdf/format'
   autoload :Reader,     'rdf/reader'
+  autoload :ReaderError,'rdf/reader'
   autoload :Writer,     'rdf/writer'
+  autoload :WriterError,'rdf/writer'
 
   # RDF serialization formats
   autoload :NTriples,   'rdf/ntriples'
@@ -66,7 +69,7 @@ module RDF
   # @return [#to_s] property
   # @return [URI]
   def self.[](property)
-    RDF::URI.parse([to_s, property.to_s].join)
+    RDF::URI.new([to_uri.to_s, property.to_s].join)
   end
 
   ##
@@ -83,13 +86,18 @@ module RDF
 
   ##
   # @return [URI]
-  def self.to_uri
-    RDF::URI.parse(to_s)
+  def self.to_rdf
+    to_uri
   end
 
   ##
-  # @return [String]
-  def self.to_s # FIXME
-    "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+  # @return [URI]
+  def self.to_uri
+    RDF::URI.new("http://www.w3.org/1999/02/22-rdf-syntax-ns#")
+  end
+
+  class << self
+    # For compatibility with `RDF::Vocabulary.__name__`:
+    alias_method :__name__, :name
   end
 end

data/lib/rdf/mixin/inferable.rb

@@ -0,0 +1,6 @@
+module RDF
+  ##
+  module Inferable
+    # TODO
+  end
+end

data/lib/rdf/mixin/queryable.rb

@@ -29,7 +29,7 @@ module RDF
           if block_given?
             find_all { |statement| pattern === statement }.each(&block)
           else
-            find_all { |statement| pattern === statement }
+            find_all { |statement| pattern === statement }.extend(RDF::Enumerable, RDF::Queryable)
           end
         else
           raise ArgumentError.new("expected RDF::Query or RDF::Pattern, got #{pattern.inspect}")

data/lib/rdf/model/statement.rb

@@ -126,6 +126,15 @@ module RDF
       !!object
     end
 
+    ##
+    # Returns `true` if the subject or object of this statement is a blank
+    # node.
+    #
+    # @return [Boolean]
+    def has_blank_nodes?
+      (has_object? && object.node?) || (has_subject? && subject.node?)
+    end
+
     ##
     # @param  [Statement] other
     # @return [Boolean]

data/lib/rdf/model/uri.rb

@@ -4,9 +4,14 @@ module RDF
   ##
   # A Uniform Resource Identifier (URI).
   #
-  # @example Creating a URI reference
+  # `RDF::URI` supports all the instance methods of `Addressable::URI`.
+  #
+  # @example Creating a URI reference (1)
   #   uri = RDF::URI.new("http://rdf.rubyforge.org/")
   #
+  # @example Creating a URI reference (2)
+  #   uri = RDF::URI.new(:scheme => 'http', :host => 'rdf.rubyforge.org', :path => '/')
+  #
   # @example Getting the string representation of a URI
   #   uri.to_s #=> "http://rdf.rubyforge.org/"
   #
@@ -14,6 +19,11 @@ module RDF
   # @see http://addressable.rubyforge.org/
   class URI < Node
     ##
+    # Creates a new `RDF::URI` instance based on the given `uri` string.
+    #
+    # This is just an alias for {RDF::URI.new} for compatibity with
+    # {Addressable::URI].
+    #
     # @param  [String] uri
     # @return [URI]
     def self.parse(uri)
@@ -21,10 +31,10 @@ module RDF
     end
 
     ##
-    # @overload uri(uri)
+    # @overload URI.new(uri)
     #   @param  [URI, String, #to_s]    uri
     #
-    # @overload uri(options = {})
+    # @overload URI.new(options = {})
     #   @param  [Hash{Symbol => Object} options
     def initialize(uri_or_options)
       case uri_or_options
@@ -54,6 +64,82 @@ module RDF
     end
 
     ##
+    # Returns `true` if this URI's path component is equal to `/`.
+    #
+    # @return [Boolean]
+    def root?
+      self.path == '/' || self.path.empty?
+    end
+
+    ##
+    # Returns a copy of this URI with the path component set to `/`.
+    #
+    # @return [URI]
+    def root
+      if root?
+        self
+      else
+        uri = self.dup
+        uri.path = '/'
+        uri
+      end
+    end
+
+    ##
+    # Returns `true` if this URI's path component isn't equal to `/`.
+    #
+    # @return [Boolean]
+    def has_parent?
+      !root?
+    end
+
+    ##
+    # Returns a copy of this URI with the path component ascended to the
+    # parent directory, if any.
+    #
+    # @return [URI]
+    def parent
+      case
+        when root? then nil
+        else
+          require 'pathname' unless defined?(Pathname)
+          if path = Pathname.new(self.path).parent
+            uri = self.dup
+            uri.path = path.to_s
+            uri.path << '/' unless uri.root?
+            uri
+          end
+      end
+    end
+
+    ##
+    # Returns a qualified name (QName) for this URI, if possible.
+    #
+    # @return [Array(Symbol, Symbol)]
+    def qname
+      Vocabulary.each do |vocab|
+        if to_s.index(vocab.to_uri.to_s) == 0
+          vocab_name = vocab.__name__.split('::').last.downcase
+          local_name = to_s[vocab.to_uri.to_s.size..-1]
+          unless vocab_name.empty? || local_name.empty?
+            return [vocab_name.to_sym, local_name.to_sym]
+          end
+        end
+      end
+      nil # no QName found
+    end
+
+    ##
+    # Returns a duplicate copy of `self`.
+    #
+    # @return [URI]
+    def dup
+      self.class.new(@uri.dup)
+    end
+
+    ##
+    # Checks whether this URI is equal to `other`.
+    #
     # @param  [URI] other
     # @return [Boolean]
     def eql?(other)
@@ -61,6 +147,8 @@ module RDF
     end
 
     ##
+    # Checks whether this URI is equal to `other`.
+    #
     # @param  [Object] other
     # @return [Boolean]
     def ==(other)
@@ -73,29 +161,51 @@ module RDF
     end
 
     ##
+    # Returns `self`.
+    #
     # @return [URI]
     def to_uri
       self
     end
 
     ##
+    # Returns a string representation of this URI.
+    #
     # @return [String]
     def to_s
       @uri.to_s
     end
 
-    protected
+    ##
+    # Returns a hash code for this URI.
+    #
+    # @return [Fixnum]
+    def hash
+      @uri.hash
+    end
 
-      def respond_to?(symbol) #:nodoc:
-        @uri.respond_to?(symbol) || super
-      end
+    ##
+    # Returns `true` if this URI instance supports the `symbol` method.
+    #
+    # @param  [Symbol, String, #to_s] symbol
+    # @return [Boolean]
+    def respond_to?(symbol)
+      @uri.respond_to?(symbol) || super
+    end
 
-      def method_missing(symbol, *args, &block) #:nodoc:
-        if @uri.respond_to?(symbol)
-          @uri.send(symbol, *args, &block)
-        else
-          super
-        end
+    ##
+    # @param  [Symbol, String, #to_s] symbol
+    # @param  [Array<Object>]         args
+    # @yield
+    # @private
+    def method_missing(symbol, *args, &block)
+      if @uri.respond_to?(symbol)
+        @uri.send(symbol, *args, &block)
+      else
+        super
       end
+    end
+
+    protected :method_missing
   end
 end

data/lib/rdf/model/value.rb

@@ -29,9 +29,6 @@ module RDF
   class Value
     include Comparable
 
-    # Prevent the instantiation of this class.
-    private_class_method :new
-
     ##
     # Returns `true` if this value is a graph.
     #
@@ -125,8 +122,11 @@ module RDF
 
     private
 
-      def self.inherited(child) #:nodoc:
-        # Enable the instantiation of any subclasses.
+      # Prevent the instantiation of this class:
+      private_class_method :new
+
+      def self.inherited(child) # @private
+        # Enable the instantiation of any subclasses:
         child.send(:public_class_method, :new)
         super
       end

data/lib/rdf/repository.rb

@@ -59,15 +59,17 @@ module RDF
     attr_reader :title
 
     ##
-    # Loads an RDF file as a transient in-memory repository.
+    # Loads one or more RDF files into a new transient in-memory repository.
     #
-    # @param  [String] filename
+    # @param  [String, Array<String>] filenames
     # @yield  [repository]
     # @yieldparam [Repository]
     # @return [void]
-    def self.load(filename, options = {}, &block)
+    def self.load(filenames, options = {}, &block)
       self.new(options) do |repository|
-        repository.load(filename, options)
+        [filenames].flatten.each do |filename|
+          repository.load(filename, options)
+        end
 
         if block_given?
           case block.arity

data/lib/rdf/version.rb

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

data/lib/rdf/vocab.rb

@@ -39,6 +39,28 @@ module RDF
   # @see http://www.w3.org/TR/curie/
   # @see http://en.wikipedia.org/wiki/QName
   class Vocabulary
+    extend ::Enumerable
+
+    ##
+    # Enumerates known RDF vocabulary classes.
+    #
+    # @yield  [klass]
+    # @yieldparam [Class] klass
+    # @return [Enumerator]
+    def self.each(&block)
+      if self.equal?(Vocabulary)
+        # This is needed since all vocabulary classes are defined using
+        # Ruby's autoloading facility, meaning that `@@subclasses` will
+        # be empty until each subclass has been touched or require'd.
+        %w(cc dc doap exif foaf http owl rdfs rss sioc skos wot xhtml xsd).each do |prefix|
+          require "rdf/vocab/#{prefix}"
+        end
+        @@subclasses.each(&block)
+      else
+        # TODO: should enumerate vocabulary-specific defined properties.
+      end
+    end
+
     ##
     # Defines a vocabulary term called `property`.
     #
@@ -86,6 +108,12 @@ module RDF
       end
     end
 
+    class << self
+      # Preserve the class name so that it can be obtained even for
+      # vocabularies that define a `name` property:
+      alias_method :__name__, :name
+    end
+
     # Undefine all superfluous instance methods:
     undef_method *(instance_methods - %w(__id__ __send__ __class__ __eval__ instance_eval inspect class))
 
@@ -139,11 +167,13 @@ module RDF
       end
 
       def self.inherited(subclass) # @private
+        @@subclasses << subclass
         unless @@uri.nil?
           subclass.send(:private_class_method, :new)
           @@uris[subclass] = @@uri
           @@uri = nil
         end
+        super
       end
 
       def self.method_missing(property, *args, &block)
@@ -164,8 +194,9 @@ module RDF
 
     private
 
-      @@uris = {}  # @private
-      @@uri  = nil # @private
+      @@subclasses = [::RDF] # @private
+      @@uris       = {}      # @private
+      @@uri        = nil     # @private
 
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rdf
 version: !ruby/object:Gem::Version 
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors: 
 - Arto Bendiken
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-10 00:00:00 +01:00
+date: 2010-02-01 00:00:00 +01:00
 default_executable: rdf
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -63,6 +63,7 @@ files:
 - lib/rdf/format.rb
 - lib/rdf/mixin/durable.rb
 - lib/rdf/mixin/enumerable.rb
+- lib/rdf/mixin/inferable.rb
 - lib/rdf/mixin/mutable.rb
 - lib/rdf/mixin/queryable.rb
 - lib/rdf/mixin/readable.rb