rdf 0.2.3 → 0.3.0.pre

data/AUTHORS

@@ -1,2 +1,3 @@
 * Arto Bendiken <arto.bendiken@gmail.com>
 * Ben Lavender <blavender@gmail.com>
+* Gregg Kellogg <gregg@kellogg-assoc.com>

data/{CONTRIBUTORS → CREDITS}

@@ -1,5 +1,7 @@
+* Călin Ardelean <calinucs@gmail.com>
+* Joey Geiger <jgeiger@gmail.com>
 * Fumihiro Kato <fumi@fumi.me>
-* Gregg Kellogg <gregg@kellogg-assoc.com>
 * Hellekin O. Wolf <hellekin@cepheide.org>
 * John Fieber <jrf@ursamaris.org>
+* Keita Urashima <ursm@ursm.jp>
 * Pius Uzamere <pius@alum.mit.edu>

data/README

@@ -17,6 +17,9 @@ Features
 * Provides a clean, well-designed RDF object model and related APIs.
 * Supports parsing and serializing N-Triples out of the box, with more
   serialization format support available through add-on plugins.
+* Includes in-memory graph and repository implementations, with more storage
+  adapter support available through add-on plugins.
+* Implements basic graph pattern (BGP) query evaluation.
 * Plays nice with others: entirely contained in the `RDF` module, and does
   not modify any of Ruby's core classes or standard library.
 * Based entirely on Ruby's autoloading, meaning that you can generally make
@@ -109,6 +112,8 @@ Documentation
 * {RDF::Repository}
   * {RDF::Countable}
   * {RDF::Enumerable}
+  * {RDF::Indexable}
+  * {RDF::Inferable}
   * {RDF::Queryable}
   * {RDF::Mutable}
   * {RDF::Durable}
@@ -120,6 +125,7 @@ Documentation
 * {RDF::Query}
   * {RDF::Query::Pattern}
   * {RDF::Query::Solution}
+  * {RDF::Query::Solutions}
   * {RDF::Query::Variable}
 
 ### RDF Vocabularies
@@ -189,17 +195,20 @@ Mailing List
 Authors
 -------
 
-* [Arto Bendiken](mailto:arto.bendiken@gmail.com) - <http://ar.to/>
-* [Ben Lavender](mailto:blavender@gmail.com) - <http://bhuga.net/>
+* [Arto Bendiken](http://github.com/bendiken) - <http://ar.to/>
+* [Ben Lavender](http://github.com/bhuga) - <http://bhuga.net/>
+* [Gregg Kellogg](http://github.com/gkellogg) - <http://kellogg-assoc.com/>
 
 Contributors
 ------------
 
-* [Fumihiro Kato](mailto:fumi@fumi.me) - <http://fumi.me/>
-* [Gregg Kellogg](mailto:gregg@kellogg-assoc.com) - <http://kellogg-assoc.com/>
-* [Hellekin O. Wolf](mailto:hellekin@cepheide.org) - <http://hellekin.cepheide.org/>
-* [John Fieber](mailto:jrf@ursamaris.org) - <http://github.com/jfieber>
-* [Pius Uzamere](mailto:pius@alum.mit.edu) - <http://pius.me/>
+* [Călin Ardelean](http://github.com/clnx) - <http://github.com/clnx>
+* [Joey Geiger](http://github.com/jgeiger) - <http://github.com/jgeiger>
+* [Fumihiro Kato](http://github.com/fumi) - <http://fumi.me/>
+* [Hellekin O. Wolf](http://github.com/hellekin) - <http://hellekin.cepheide.org/>
+* [John Fieber](http://github.com/jfieber) - <http://github.com/jfieber>
+* [Keita Urashima](http://github.com/ursm) - <http://ursm.jp/>
+* [Pius Uzamere](http://github.com/pius) - <http://pius.me/>
 
 Contributing
 ------------
@@ -210,7 +219,7 @@ Contributing
   [tutorial][YARD-GS] or just look at the existing code for examples.
 * Don't touch the `.gemspec` or `VERSION` files. If you need to change them,
   do so on your private branch only.
-* Do feel free to add yourself to the `CONTRIBUTORS` file and the
+* Do feel free to add yourself to the `CREDITS` file and the
   corresponding list in the the `README`. Alphabetical order applies.
 * Don't touch the `AUTHORS` file. If your contributions are significant
   enough, be assured we will eventually add you in there.

data/VERSION

@@ -1 +1 @@
-0.2.3
+0.3.0.pre

data/etc/doap.nt

@@ -12,6 +12,11 @@
 <http://bhuga.net/#ben> <http://xmlns.com/foaf/0.1/mbox> <mailto:blavender@gmail.com> .
 <http://bhuga.net/#ben> <http://xmlns.com/foaf/0.1/mbox_sha1sum> "dbf45f4ffbd27b67aa84f02a6a31c144727d10af" .
 <http://bhuga.net/#ben> <http://xmlns.com/foaf/0.1/name> "Ben Lavender" .
+<http://kellogg-assoc.com/#me> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
+<http://kellogg-assoc.com/#me> <http://xmlns.com/foaf/0.1/homepage> <http://kellogg-assoc.com/> .
+<http://kellogg-assoc.com/#me> <http://xmlns.com/foaf/0.1/mbox> <mailto:gregg@kellogg-assoc.com> .
+<http://kellogg-assoc.com/#me> <http://xmlns.com/foaf/0.1/mbox_sha1sum> "35bc44e6d0070e5ad50ccbe0d24403c96af2b9bd" .
+<http://kellogg-assoc.com/#me> <http://xmlns.com/foaf/0.1/name> "Gregg Kellogg" .
 <http://rubygems.org/gems/rdf> <http://purl.org/dc/terms/creator> <http://ar.to/#self> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#blog> <http://ar.to/> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#blog> <http://blog.datagraph.org/> .
@@ -22,16 +27,23 @@
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#description> "RDF.rb is a pure-Ruby library for working with Resource Description Framework (RDF) data."@en .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#developer> <http://ar.to/#self> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#developer> <http://bhuga.net/#ben> .
+<http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#developer> <http://kellogg-assoc.com/#me> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#documenter> <http://ar.to/#self> .
+<http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#documenter> <http://bhuga.net/#ben> .
+<http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#documenter> <http://kellogg-assoc.com/#me> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#download-page> <http://rubyforge.org/projects/rdf/> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#helper> _:genid1 .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#helper> _:genid2 .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#helper> _:genid3 .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#helper> _:genid4 .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#helper> _:genid5 .
+<http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#helper> _:genid6 .
+<http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#helper> _:genid7 .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#homepage> <http://rdf.rubyforge.org/> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#license> <http://creativecommons.org/licenses/publicdomain/> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#maintainer> <http://ar.to/#self> .
+<http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#maintainer> <http://bhuga.net/#ben> .
+<http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#maintainer> <http://kellogg-assoc.com/#me> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#name> "RDF.rb" .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#platform> "Ruby" .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#shortdesc> "A Ruby library for working with Resource Description Framework (RDF) data."@en .
@@ -39,17 +51,23 @@
 <http://rubygems.org/gems/rdf> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://usefulinc.com/ns/doap#Project> .
 <http://rubygems.org/gems/rdf> <http://xmlns.com/foaf/0.1/maker> <http://ar.to/#self> .
 _:genid1 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
-_:genid1 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "d31fdd6af7a279a89bf09fdc9f7c44d9d08bb930" .
-_:genid1 <http://xmlns.com/foaf/0.1/name> "Fumihiro Kato" .
+_:genid1 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "274bd18402fc773ffc0606996aa1fb90b603aa29" .
+_:genid1 <http://xmlns.com/foaf/0.1/name> "C\u0103lin Ardelean" .
 _:genid2 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
-_:genid2 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "35bc44e6d0070e5ad50ccbe0d24403c96af2b9bd" .
-_:genid2 <http://xmlns.com/foaf/0.1/name> "Gregg Kellogg" .
+_:genid2 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "f412d743150d7b27b8468d56e69ca147917ea6fc" .
+_:genid2 <http://xmlns.com/foaf/0.1/name> "Joey Geiger" .
 _:genid3 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
-_:genid3 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "c69f3255ff0639543cc5edfd8116eac8df16fab8" .
-_:genid3 <http://xmlns.com/foaf/0.1/name> "Hellekin O. Wolf" .
+_:genid3 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "d31fdd6af7a279a89bf09fdc9f7c44d9d08bb930" .
+_:genid3 <http://xmlns.com/foaf/0.1/name> "Fumihiro Kato" .
 _:genid4 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
-_:genid4 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "f7653fc1ac0e82ebb32f092389bd5fc728eaae12" .
-_:genid4 <http://xmlns.com/foaf/0.1/name> "John Fieber" .
+_:genid4 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "c69f3255ff0639543cc5edfd8116eac8df16fab8" .
+_:genid4 <http://xmlns.com/foaf/0.1/name> "Hellekin O. Wolf" .
 _:genid5 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
-_:genid5 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "bedbbf2451e5beb38d59687c0460032aff92cd3c" .
-_:genid5 <http://xmlns.com/foaf/0.1/name> "Pius Uzamere" .
+_:genid5 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "f7653fc1ac0e82ebb32f092389bd5fc728eaae12" .
+_:genid5 <http://xmlns.com/foaf/0.1/name> "John Fieber" .
+_:genid6 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
+_:genid6 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "2b4247b6fd5bb4a1383378f325784318680d5ff9" .
+_:genid6 <http://xmlns.com/foaf/0.1/name> "Keita Urashima" .
+_:genid7 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
+_:genid7 <http://xmlns.com/foaf/0.1/mbox_sha1sum> "bedbbf2451e5beb38d59687c0460032aff92cd3c" .
+_:genid7 <http://xmlns.com/foaf/0.1/name> "Pius Uzamere" .

data/lib/rdf/format.rb

@@ -1,14 +1,17 @@
 module RDF
   ##
-  # An RDF serialization format.
+  # The base class for RDF serialization formats.
+  #
+  # @example Loading an RDF serialization format implementation
+  #   require 'rdf/ntriples'
   #
   # @example Iterating over known RDF serialization formats
   #   RDF::Format.each { |klass| puts klass.name }
   #
   # @example Getting a serialization format class
   #   RDF::Format.for(:ntriples)     #=> RDF::NTriples::Format
-  #   RDF::Format.for("spec/data/test.nt")
-  #   RDF::Format.for(:file_name => "spec/data/test.nt")
+  #   RDF::Format.for("etc/doap.nt")
+  #   RDF::Format.for(:file_name => "etc/doap.nt")
   #   RDF::Format.for(:file_extension => "nt")
   #   RDF::Format.for(:content_type => "text/plain")
   #
@@ -85,6 +88,11 @@ module RDF
 
         when Hash
           case
+            # Find a format based on the MIME content type
+            when mime_type = options[:content_type]
+              if content_types.has_key?(mime_type = mime_type.to_s)
+                content_types[mime_type].first
+              end
             # Find a format based on the file name
             when file_name = options[:file_name]
               self.for(:file_extension => File.extname(file_name.to_s)[1..-1])
@@ -93,11 +101,6 @@ module RDF
               if file_extensions.has_key?(file_ext = file_ext.to_sym)
                 self.for(:content_type => file_extensions[file_ext])
               end
-            # Find a format based on the MIME content type
-            when mime_type = options[:content_type]
-              if content_types.has_key?(mime_type = mime_type.to_s)
-                content_types[mime_type].first
-              end
           end
 
         when Symbol
@@ -270,49 +273,54 @@ module RDF
       end
     end
 
-    protected
+  protected
 
-      ##
-      # Defines a required Ruby library for this RDF serialization format.
-      #
-      # The given library will be required lazily, i.e. only when it is
-      # actually first needed, such as when instantiating a reader or parser
-      # instance for this format.
-      #
-      # @param  [String, #to_s] library
-      # @return [void]
-      def self.require(library)
-        (@@requires[self] ||= []) << library.to_s
-      end
-
-      ##
-      # Defines the content encoding for this RDF serialization format.
-      #
-      # @param  [#to_sym] encoding
-      # @return [void]
-      def self.content_encoding(encoding)
-        @@content_encoding[self] = encoding.to_sym
-      end
+    ##
+    # Defines a required Ruby library for this RDF serialization format.
+    #
+    # The given library will be required lazily, i.e. only when it is
+    # actually first needed, such as when instantiating a reader or parser
+    # instance for this format.
+    #
+    # @param  [String, #to_s] library
+    # @return [void]
+    def self.require(library)
+      (@@requires[self] ||= []) << library.to_s
+    end
 
-    private
+    ##
+    # Defines the content encoding for this RDF serialization format.
+    #
+    # @param  [#to_sym] encoding
+    # @return [void]
+    def self.content_encoding(encoding)
+      @@content_encoding[self] = encoding.to_sym
+    end
 
-      private_class_method :new
+  private
 
-      @@subclasses       = [] # @private
-      @@requires         = {} # @private
-      @@file_extensions  = {} # @private
-      @@content_type     = {} # @private
-      @@content_types    = {} # @private
-      @@content_encoding = {} # @private
-      @@readers          = {} # @private
-      @@writers          = {} # @private
+    private_class_method :new
 
-      def self.inherited(child) # @private
-        @@subclasses << child
-        super
-      end
+    @@requires         = {} # @private
+    @@file_extensions  = {} # @private
+    @@content_type     = {} # @private
+    @@content_types    = {} # @private
+    @@content_encoding = {} # @private
+    @@readers          = {} # @private
+    @@writers          = {} # @private
+    @@subclasses       = [] # @private
 
-  end
+    ##
+    # @private
+    # @return [void]
+    def self.inherited(child)
+      @@subclasses << child
+      super
+    end
+  end # Format
 
-  class FormatError < IOError; end
-end
+  ##
+  # The base class for RDF serialization format errors.
+  class FormatError < IOError
+  end # FormatError
+end # RDF

data/lib/rdf/mixin/countable.rb

@@ -23,9 +23,7 @@ module RDF
       each { count += 1 }
       count
     end
-
-    alias_method :size,   :count
-    alias_method :length, :count # @deprecated
+    alias_method :size, :count
 
     ##
     # @private
@@ -36,7 +34,6 @@ module RDF
       # Ensure that enumerators support the `#empty?` and `#count` methods:
       super.extend(RDF::Countable)
     end
-
     alias_method :to_enum, :enum_for
-  end
-end
+  end # Countable
+end # RDF