rdf 0.1.10 → 0.2.0

data/CONTRIBUTORS

@@ -0,0 +1,3 @@
+* Hellekin O. Wolf <hellekin@cepheide.org>
+* John Fieber <jrf@ursamaris.org>
+* Pius Uzamere <pius@alum.mit.edu>

data/README

@@ -21,20 +21,34 @@ Features
   not modify any of Ruby's core classes or standard library.
 * Based entirely on Ruby's autoloading, meaning that you can generally make
   use of any one part of the library without needing to load up the rest.
-* Compatible with Ruby 1.8.x, Ruby 1.9.x, and JRuby (tested with JRuby 1.4).
+* Compatible with Ruby 1.8.7+, Ruby 1.9.x, and JRuby 1.4/1.5.
+* Compatible with older Ruby versions with the help of the [Backports][] gem.
 
 Examples
 --------
 
+    require 'rubygems'
     require 'rdf'
 
-### Creating an RDF statement
+### Writing RDF data using the N-Triples format
 
-    s = RDF::URI("http://rubygems.org/gems/rdf")
-    p = RDF::DC.creator
-    o = RDF::URI("http://ar.to/#self")
+    require 'rdf/ntriples'
     
-    stmt = RDF::Statement(s, p, o)
+    RDF::Writer.open("hello.nt") do |writer|
+      writer << RDF::Graph.new do |graph|
+        graph << [:hello, RDF::DC.title, "Hello, world!"]
+      end
+    end
+
+### Reading RDF data in the N-Triples format
+
+    require 'rdf/ntriples'
+    
+    RDF::Reader.open("http://rdf.rubyforge.org/doap.nt") do |reader|
+      reader.each_statement do |statement|
+        puts statement.inspect
+      end
+    end
 
 ### Using pre-defined RDF vocabularies
 
@@ -55,14 +69,6 @@ Examples
     foaf[:name]   #=> RDF::URI("http://xmlns.com/foaf/0.1/name")
     foaf['mbox']  #=> RDF::URI("http://xmlns.com/foaf/0.1/mbox")
 
-### Reading N-Triples data
-
-    RDF::Reader.open("spec/data/test.nt") do |reader|
-      reader.each_statement do |statement|
-        puts statement.inspect
-      end
-    end
-
 Documentation
 -------------
 
@@ -70,6 +76,8 @@ Documentation
 
 ### RDF Object Model
 
+<http://blog.datagraph.org/2010/03/rdf-for-ruby>
+
 * {RDF::Value}
   * {RDF::Literal}
   * {RDF::Resource}
@@ -80,6 +88,8 @@ Documentation
 
 ### RDF Serialization
 
+<http://blog.datagraph.org/2010/04/parsing-rdf-with-ruby>
+
 * {RDF::Format}
 * {RDF::Reader}
 * {RDF::Writer}
@@ -94,11 +104,14 @@ Documentation
 
 ### RDF Storage
 
+<http://blog.datagraph.org/2010/04/rdf-repository-howto>
+
 * {RDF::Repository}
+  * {RDF::Countable}
   * {RDF::Enumerable}
-  * {RDF::Durable}
-  * {RDF::Mutable}
   * {RDF::Queryable}
+  * {RDF::Mutable}
+  * {RDF::Durable}
 * [`RDF::DataObjects`](http://rdf.rubyforge.org/do/) (plugin)
 * [`RDF::Sesame`](http://rdf.rubyforge.org/sesame/) (plugin)
 
@@ -112,13 +125,17 @@ Documentation
 ### RDF Vocabularies
 
 * {RDF::CC}    - Creative Commons (CC)
+* {RDF::CERT}  - W3 Authentication Certificate (CERT)
 * {RDF::DC}    - Dublin Core (DC)
+* {RDF::DC11}  - Dublin Core 1.1 (DC11) _deprecated_
 * {RDF::DOAP}  - Description of a Project (DOAP)
 * {RDF::EXIF}  - Exchangeable Image File Format (EXIF)
 * {RDF::FOAF}  - Friend of a Friend (FOAF)
+* {RDF::GEO}   - WGS84 Geo Positioning (GEO)
 * {RDF::HTTP}  - Hypertext Transfer Protocol (HTTP)
 * {RDF::OWL}   - Web Ontology Language (OWL)
 * {RDF::RDFS}  - RDF Schema (RDFS)
+* {RDF::RSA}   - W3 RSA Keys (RSA)
 * {RDF::RSS}   - RDF Site Summary (RSS)
 * {RDF::SIOC}  - Semantically-Interlinked Online Communities (SIOC)
 * {RDF::SKOS}  - Simple Knowledge Organization System (SKOS)
@@ -129,15 +146,17 @@ Documentation
 Dependencies
 ------------
 
-* [Addressable](http://addressable.rubyforge.org/) (>= 2.1.1)
+* [Ruby](http://ruby-lang.org/) (>= 1.8.7) or (>= 1.8.1 with [Backports][])
+* [Addressable](http://rubygems.org/gems/addressable) (>= 2.1.2)
 
 Installation
 ------------
 
-The recommended installation method is via RubyGems. To install the latest
-official release from [RubyGems](http://rubygems.org/), do:
+The recommended installation method is via [RubyGems](http://rubygems.org/).
+To install the latest official release of RDF.rb, do:
 
-    % [sudo] gem install rdf
+    % [sudo] gem install rdf             # Ruby 1.8.7+ or 1.9.x
+    % [sudo] gem install backports rdf   # Ruby 1.8.1+
 
 Download
 --------
@@ -161,29 +180,44 @@ Resources
 * <http://raa.ruby-lang.org/project/rdf/>
 * <http://www.ohloh.net/p/rdf>
 
-See Also
---------
-
-* [RDF::BERT](http://rdf.rubyforge.org/bert/)
-* [RDF::Isomorphic](http://rdf.rubyforge.org/isomorphic/)
-* [RDF::Spec](http://rdf.rubyforge.org/spec/)
-* [RDFS.rb](http://rdfs.rubyforge.org/)
-* [RDFize](http://rdfize.rubyforge.org/)
-* [RDFbus](http://rdfbus.rubyforge.org/)
-* [RDFcache](http://rdfcache.rubyforge.org/)
-* [RDFgrid](http://rdfgrid.rubyforge.org/)
-* [Trinity](http://trinity.datagraph.org/)
-
 Authors
 -------
 
 * [Arto Bendiken](mailto:arto.bendiken@gmail.com) - <http://ar.to/>
 * [Ben Lavender](mailto:blavender@gmail.com) - <http://bhuga.net/>
 
+Contributors
+------------
+
+* [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/>
+
+Contributing
+------------
+
+* Do your best to adhere to the existing coding conventions and idioms.
+* Don't use hard tabs, and don't leave trailing whitespace on any line.
+* Do document every method you add using [YARD][] annotations. Read the
+  [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
+  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.
+* Do note that in order for us to merge any non-trivial changes (as a rule
+  of thumb, additions larger than about 15 lines of code), we need an
+  explicit [public domain dedication][PDD] on record from you.
+
 License
 -------
 
 RDF.rb is free and unencumbered public domain software. For more
 information, see <http://unlicense.org/> or the accompanying UNLICENSE file.
 
-[RDF]: http://www.w3.org/RDF/
+[RDF]:       http://www.w3.org/RDF/
+[YARD]:      http://yardoc.org/
+[YARD-GS]:   http://yardoc.org/docs/yard/file:docs/GettingStarted.md
+[PDD]:       http://lists.w3.org/Archives/Public/public-rdf-ruby/2010May/0013.html
+[Backports]: http://rubygems.org/gems/backports

data/VERSION

@@ -1 +1 @@
-0.1.10
+0.2.0

data/etc/doap.nt

@@ -3,23 +3,30 @@
 <http://ar.to/#self> <http://xmlns.com/foaf/0.1/homepage> <http://ar.to/> .
 <http://ar.to/#self> <http://xmlns.com/foaf/0.1/made> <http://rubygems.org/gems/rdf> .
 <http://ar.to/#self> <http://xmlns.com/foaf/0.1/mbox> <mailto:arto.bendiken@gmail.com> .
+<http://ar.to/#self> <http://xmlns.com/foaf/0.1/mbox_sha1sum> "a033f652c84a4d73b8c26d318c2395699dd2bdfb" .
+<http://ar.to/#self> <http://xmlns.com/foaf/0.1/mbox_sha1sum> "d0737cceb55eb7d740578d2db1bc0727e3ed49ce" .
 <http://ar.to/#self> <http://xmlns.com/foaf/0.1/name> "Arto Bendiken" .
 <http://bhuga.net/#ben> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
 <http://bhuga.net/#ben> <http://www.w3.org/2000/01/rdf-schema#isDefinedBy> <http://datagraph.org/bhuga/foaf> .
 <http://bhuga.net/#ben> <http://xmlns.com/foaf/0.1/homepage> <http://bhuga.net/> .
 <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://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/> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#bug-database> <http://github.com/bendiken/rdf/issues> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#category> <http://dbpedia.org/resource/Resource_Description_Framework> .
+<http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#category> <http://dbpedia.org/resource/Ruby_(programming_language)> .
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#created> "2007-10-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#documenter> <http://ar.to/#self> .
 <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#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> .
@@ -29,3 +36,12 @@
 <http://rubygems.org/gems/rdf> <http://usefulinc.com/ns/doap#vendor> <http://datagraph.org/> .
 <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> "c69f3255ff0639543cc5edfd8116eac8df16fab8" .
+_:genid1 <http://xmlns.com/foaf/0.1/name> "Hellekin O. Wolf" .
+_: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> "f7653fc1ac0e82ebb32f092389bd5fc728eaae12" .
+_:genid2 <http://xmlns.com/foaf/0.1/name> "John Fieber" .
+_: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> "bedbbf2451e5beb38d59687c0460032aff92cd3c" .
+_:genid3 <http://xmlns.com/foaf/0.1/name> "Pius Uzamere" .

data/lib/rdf.rb

@@ -1,5 +1,20 @@
-require 'enumerator'  # @since Ruby 1.8.1
+require 'enumerator'
 require 'open-uri'
+
+if RUBY_VERSION < '1.8.7'
+  # @see http://rubygems.org/gems/backports
+  begin
+    require 'backports/1.8.7'
+  rescue LoadError
+    begin
+      require 'rubygems'
+      require 'backports/1.8.7'
+    rescue LoadError
+      abort "RDF.rb requires Ruby 1.8.7 or the Backports gem (hint: `gem install backports')."
+    end
+  end
+end
+
 require 'rdf/version'
 
 module RDF
@@ -7,6 +22,7 @@ module RDF
   Enumerator = defined?(::Enumerator) ? ::Enumerator : ::Enumerable::Enumerator
 
   # RDF mixins
+  autoload :Countable,  'rdf/mixin/countable'
   autoload :Durable,    'rdf/mixin/durable'
   autoload :Enumerable, 'rdf/mixin/enumerable'
   autoload :Inferable,  'rdf/mixin/inferable'
@@ -43,21 +59,11 @@ module RDF
 
   # RDF vocabularies
   autoload :Vocabulary, 'rdf/vocab'
-  autoload :CC,         'rdf/vocab/cc'
-  autoload :DC,         'rdf/vocab/dc'
-  autoload :DC11,       'rdf/vocab/dc11'
-  autoload :DOAP,       'rdf/vocab/doap'
-  autoload :EXIF,       'rdf/vocab/exif'
-  autoload :FOAF,       'rdf/vocab/foaf'
-  autoload :HTTP,       'rdf/vocab/http'
-  autoload :OWL,        'rdf/vocab/owl'
-  autoload :RDFS,       'rdf/vocab/rdfs'
-  autoload :RSS,        'rdf/vocab/rss'
-  autoload :SIOC,       'rdf/vocab/sioc'
-  autoload :SKOS,       'rdf/vocab/skos'
-  autoload :WOT,        'rdf/vocab/wot'
-  autoload :XHTML,      'rdf/vocab/xhtml'
-  autoload :XSD,        'rdf/vocab/xsd'
+  VOCABS = Dir.glob(File.join(File.dirname(__FILE__), 'rdf', 'vocab', '*.rb')).map { |f| File.basename(f)[0...-(File.extname(f).size)].to_sym } rescue []
+  VOCABS.each { |v| autoload v.to_s.upcase.to_sym, "rdf/vocab/#{v}" unless v == :rdf }
+
+  # Utilities
+  autoload :Util,       'rdf/util'
 
   ##
   # Alias for `RDF::Resource.new`.
@@ -132,7 +138,7 @@ module RDF
   # @return [#to_s] property
   # @return [URI]
   def self.[](property)
-    RDF::URI.new([to_uri.to_s, property.to_s].join)
+    RDF::URI.intern([to_uri.to_s, property.to_s].join)
   end
 
   ##
@@ -156,7 +162,7 @@ module RDF
   ##
   # @return [URI]
   def self.to_uri
-    RDF::URI.new("http://www.w3.org/1999/02/22-rdf-syntax-ns#")
+    RDF::URI.intern("http://www.w3.org/1999/02/22-rdf-syntax-ns#")
   end
 
   class << self

data/lib/rdf/format.rb

@@ -109,7 +109,7 @@ module RDF
             else
               format = format.to_s.downcase
               @@subclasses.each do |klass|
-                if klass.name.to_s.split('::').map { |x| x.downcase }.include?(format)
+                if klass.name.to_s.split('::').map(&:downcase).include?(format)
                   return klass
                 end
               end
@@ -225,6 +225,51 @@ module RDF
       alias_method :writer_class, :writer
     end
 
+    ##
+    # Retrieves or defines MIME content types for this RDF serialization format.
+    #
+    # @overload content_type(type, options)
+    #   Retrieves or defines the MIME content type for this RDF serialization format.
+    #
+    #   Optionally also defines alias MIME content types for this RDF serialization format.
+    #
+    #   Optionally also defines a file extension, or a list of file
+    #   extensions, that should be mapped to the given MIME type and handled
+    #   by this class.
+    #
+    #   @param  [String]                 type
+    #   @param  [Hash{Symbol => Object}] options
+    #   @option options [String]         :alias   (nil)
+    #   @option options [Array<String>]  :aliases (nil)
+    #   @option options [Symbol]         :extension  (nil)
+    #   @option options [Array<Symbol>]  :extensions (nil)
+    #   @return [void]
+    #
+    # @overload content_type
+    #   Retrieves the MIME content types for this RDF serialization format.
+    #
+    #   The return is an array where the first element is the cannonical
+    #   MIME type for the format and following elements are alias MIME types.
+    #
+    #   @return [Array<String>]
+    def self.content_type(type = nil, options = {})
+      if type.nil?
+        [@@content_type[self], @@content_types.map {
+          |ct, cl| (cl.include?(self) && ct != @@content_type[self]) ?  ct : nil }].flatten.compact
+      else
+        @@content_type[self] = type
+        (@@content_types[type] ||= []) << self
+
+        if extensions = (options[:extension] || options[:extensions])
+          extensions = [extensions].flatten.map(&:to_sym)
+          extensions.each { |ext| @@file_extensions[ext] = type }
+        end
+        if aliases = (options[:alias] || options[:aliases])
+          aliases = [aliases].flatten.each { |a| (@@content_types[a] ||= []) << self }
+        end
+      end
+    end
+
     protected
 
       ##
@@ -240,27 +285,6 @@ module RDF
         (@@requires[self] ||= []) << library.to_s
       end
 
-      ##
-      # Defines MIME content types for this RDF serialization format.
-      #
-      # Optionally also defines a file extension, or a list of file
-      # extensions, that should be mapped to the given MIME type and handled
-      # by this class.
-      #
-      # @param  [String]                 type
-      # @param  [Hash{Symbol => Object}] options
-      # @option options [Symbol]         :extension  (nil)
-      # @option options [Array<Symbol>]  :extensions (nil)
-      # @return [void]
-      def self.content_type(type, options = {})
-        (@@content_types[type] ||= []) << self
-
-        if extensions = (options[:extension] || options[:extensions])
-          extensions = [extensions].flatten.map { |ext| ext.to_sym }
-          extensions.each { |ext| @@file_extensions[ext] = type }
-        end
-      end
-
       ##
       # Defines the content encoding for this RDF serialization format.
       #
@@ -277,6 +301,7 @@ module RDF
       @@subclasses       = [] # @private
       @@requires         = {} # @private
       @@file_extensions  = {} # @private
+      @@content_type     = {} # @private
       @@content_types    = {} # @private
       @@content_encoding = {} # @private
       @@readers          = {} # @private

data/lib/rdf/mixin/countable.rb

@@ -0,0 +1,42 @@
+module RDF
+  ##
+  # @since 0.2.0
+  module Countable
+    extend RDF::Util::Aliasing::LateBound
+
+    ##
+    # Returns `true` if `self` contains no RDF statements.
+    #
+    # @return [Boolean]
+    def empty?
+      empty = true
+      each { empty = false; break }
+      empty
+    end
+
+    ##
+    # Returns the number of RDF statements in `self`.
+    #
+    # @return [Integer]
+    def count
+      count = 0
+      each { count += 1 }
+      count
+    end
+
+    alias_method :size,   :count
+    alias_method :length, :count # @deprecated
+
+    ##
+    # @private
+    # @param  [Symbol, #to_sym] method
+    # @return [Enumerator]
+    # @see    Object#enum_for
+    def enum_for(method = :each, *args)
+      # Ensure that enumerators support the `#empty?` and `#count` methods:
+      super.extend(RDF::Countable)
+    end
+
+    alias_method :to_enum, :enum_for
+  end
+end