rdf 0.3.8 → 0.3.9

data/README

@@ -1,5 +1,5 @@
-RDF.rb: Linked Data for Ruby
-============================
+# RDF.rb: Linked Data for Ruby
+[![Build Status](https://secure.travis-ci.org/ruby-rdf/rdf.png?branch=master)](http://travis-ci.org/ruby-rdf/rdf)
 
 This is a pure-Ruby library for working with [Resource Description Framework
 (RDF)][RDF] data.
@@ -10,8 +10,7 @@ This is a pure-Ruby library for working with [Resource Description Framework
 * <http://blog.datagraph.org/2010/04/parsing-rdf-with-ruby>
 * <http://blog.datagraph.org/2010/04/rdf-repository-howto>
 
-Features
---------
+## Features
 
 * 100% pure Ruby with minimal dependencies and no bloat.
 * 100% free and unencumbered [public domain](http://unlicense.org/) software.
@@ -30,15 +29,13 @@ Features
 * Performs auto-detection of input to select appropriate Reader class if one
   cannot be determined from file characteristics.
 
-Tutorials
----------
+## Tutorials
 
 * [Getting data from the Semantic Web using Ruby and RDF.rb](http://semanticweb.org/wiki/Getting_data_from_the_Semantic_Web_%28Ruby%29)
 * [Using RDF.rb and Spira to process RDF data from the British Ordnance Survey](http://stephenpope.co.uk/?p=85)
 * [Getting started with RDF and SPARQL using 4store and RDF.rb](http://www.jenitennison.com/blog/node/152)
 
-Command Line
-------------
+## Command Line
 When installed, RDF.rb includes a `rdf` shell script which acts as a wrapper to perform a number of different
 operations on RDF files using available readers and writers.
 
@@ -48,8 +45,7 @@ operations on RDF files using available readers and writers.
 * `objects`: Returns unique objects from parsed input.
 * `predicates`: Returns unique objects from parsed input.
 
-Examples
---------
+## Examples
 
     require 'rdf'
     include RDF
@@ -155,8 +151,7 @@ A separate [SPARQL][SPARQL doc] gem builds on basic BGP support to provide full
     foaf[:name]   #=> RDF::URI("http://xmlns.com/foaf/0.1/name")
     foaf['mbox']  #=> RDF::URI("http://xmlns.com/foaf/0.1/mbox")
 
-Documentation
--------------
+## Documentation
 
 <http://rubydoc.info/github/ruby-rdf/rdf/frames>
 
@@ -261,14 +256,12 @@ The meta-gem [LinkedData][LinkedData doc] includes many of these gems.
 * {RDF::XHTML} - Extensible HyperText Markup Language (XHTML)
 * {RDF::XSD}   - XML Schema (XSD)
 
-Dependencies
-------------
+## Dependencies
 
 * [Ruby](http://ruby-lang.org/) (>= 1.8.7) or (>= 1.8.1 with [Backports][])
 * [Addressable](http://rubygems.org/gems/addressable) (>= 2.2.0)
 
-Installation
-------------
+## Installation
 
 The recommended installation method is via [RubyGems](http://rubygems.org/).
 To install the latest official release of RDF.rb, do:
@@ -276,8 +269,7 @@ To install the latest official release of RDF.rb, do:
     % [sudo] gem install rdf             # Ruby 1.8.7+ or 1.9.x
     % [sudo] gem install backports rdf   # Ruby 1.8.1+
 
-Download
---------
+## Download
 
 To get a local working copy of the development repository, do:
 
@@ -288,8 +280,7 @@ follows:
 
     % wget http://github.com/ruby-rdf/rdf/tarball/master
 
-Resources
----------
+## Resources
 
 * <http://rubydoc.info/github/ruby-rdf/rdf/frames>
 * <http://github.com/ruby-rdf/rdf>
@@ -298,20 +289,17 @@ Resources
 * <http://raa.ruby-lang.org/project/rdf/>
 * <http://www.ohloh.net/p/rdf>
 
-Mailing List
-------------
+## Mailing List
 
 * <http://lists.w3.org/Archives/Public/public-rdf-ruby/>
 
-Authors
--------
+## Authors
 
 * [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
-------------
+## Contributors
 
 * [Călin Ardelean](http://github.com/clnx) - <http://github.com/clnx>
 * [Danny Gagne](http://github.com/danny) - <http://www.dannygagne.com/>
@@ -323,8 +311,7 @@ Contributors
 * [Keita Urashima](http://github.com/ursm) - <http://ursm.jp/>
 * [Pius Uzamere](http://github.com/pius) - <http://pius.me/>
 
-Contributing
-------------
+## 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.
@@ -340,8 +327,7 @@ Contributing
   of thumb, additions larger than about 15 lines of code), we need an
   explicit [public domain dedication][PDD] on record from you.
 
-License
--------
+## License
 
 This is free and unencumbered public domain software. For more information,
 see <http://unlicense.org/> or the accompanying {file:UNLICENSE} file.

data/VERSION

@@ -1 +1 @@
-0.3.8
+0.3.9

data/lib/rdf/model/graph.rb

@@ -36,6 +36,7 @@ module RDF
 
     ##
     # @return [RDF::Resource]
+    # @deprecated In the next release, graphs will have no name
     attr_accessor :context
 
     ##
@@ -67,11 +68,22 @@ module RDF
     end
 
     ##
-    # @param  [RDF::Resource]          context
-    # @param  [Hash{Symbol => Object}] options
+    # @overload initialize(context, options)
+    #   @param  [RDF::Resource]          context
+    #     The context only provides a context for loading relative documents
+    #   @param  [Hash{Symbol => Object}] options
+    #   @deprecated Graph context will be removed in the next release.
+    #     This is because context relates to a Named Graph in RDF 1.1
+    #     and a default graph has no context/name.
+    # @overload initialize(options)
+    #   @param  [Hash{Symbol => Object}] options
     # @yield  [graph]
     # @yieldparam [Graph]
-    def initialize(context = nil, options = {}, &block)
+    # @note Currently, context makes this a named garph;
+    # in the next release it will not
+    def initialize(*args, &block)
+      context = args.shift unless args.first.is_a?(Hash)
+      options = args.first || {}
       @context = case context
         when nil then nil
         when RDF::Resource then context
@@ -91,6 +103,7 @@ module RDF
 
     ##
     # @return [void]
+    # @note The next release, graphs will not be named
     def load!(*args)
       case
         when args.empty?
@@ -111,6 +124,7 @@ module RDF
     # Returns `true` if this is a named graph.
     #
     # @return [Boolean]
+    # @note The next release, graphs will not be named, this will return false
     def named?
       !unnamed?
     end
@@ -119,6 +133,7 @@ module RDF
     # Returns `true` if this is a unnamed graph.
     #
     # @return [Boolean]
+    # @note The next release, graphs will not be named, this will return true
     def unnamed?
       context.nil?
     end
@@ -136,6 +151,7 @@ module RDF
     # Returns all unique RDF contexts for this graph.
     #
     # @return [Enumerator<RDF::Resource>]
+    # @note The next release, graphs will not be named, this be empty
     def contexts
       (named? ? [context] : []).to_enum.extend(RDF::Countable)
     end
@@ -144,6 +160,7 @@ module RDF
     # Returns the URI representation of this graph.
     #
     # @return [RDF::URI]
+    # @note The next release, graphs will not be named, this will return nil
     def to_uri
       context
     end
@@ -169,6 +186,7 @@ module RDF
     # Returns `true` if this graph has an anonymous context, `false` otherwise.
     #
     # @return [Boolean]
+    # @note The next release, graphs will not be named, this will return true
     def anonymous?
       context.nil? ? false : context.anonymous?
     end
@@ -190,7 +208,7 @@ module RDF
     # @see    RDF::Enumerable#has_statement?
     def has_statement?(statement)
       statement = statement.dup
-      statement.context = context
+      statement.context = context # TODO: going away
       @data.has_statement?(statement)
     end
 

data/lib/rdf/model/list.rb

@@ -236,7 +236,7 @@ module RDF
       end
 
       graph.insert([new_subject, RDF.type, RDF.List])
-      graph.insert([new_subject, RDF.first, value])
+      graph.insert([new_subject, RDF.first, value.is_a?(RDF::List) ? value.subject : value])
       graph.insert([new_subject, RDF.rest, RDF.nil])
 
       self

data/lib/rdf/model/literal.rb

@@ -279,13 +279,15 @@ module RDF
     end
 
     ##
-    # Returns `true` if the value does not adhere to the defined grammar of
-    # the datatype.
+    # Validates the value using {#valid?}, raising an error if the value is
+    # invalid.
     #
-    # @return [Boolean] `true` or `false`
+    # @return [RDF::Literal] `self`
+    # @raise  [ArgumentError] if the value is invalid
     # @since  0.2.1
-    def invalid?
-      !valid?
+    def validate!
+      raise ArgumentError, "#{to_s.inspect} is not a valid <#{datatype.to_s}> literal" if invalid?
+      self
     end
 
     ##
@@ -316,19 +318,6 @@ module RDF
       end
     end
 
-    ##
-    # Validates the value using {#valid?}, raising an error if the value is
-    # invalid.
-    #
-    # @return [RDF::Literal] `self`
-    # @raise  [ArgumentError] if the value is invalid
-    # @since  0.2.1
-    def validate!
-      raise ArgumentError, "#{to_s.inspect} is not a valid <#{datatype.to_s}> literal" if invalid?
-      self
-    end
-    alias_method :validate, :validate!
-
     ##
     # Returns a copy of this literal converted into its canonical lexical
     # representation.

data/lib/rdf/model/literal/datetime.rb

@@ -24,11 +24,12 @@ module RDF; class Literal
 
     ##
     # Converts this literal into its canonical lexical representation.
+    # with date and time normalized to UTC.
     #
     # @return [RDF::Literal] `self`
     # @see    http://www.w3.org/TR/xmlschema-2/#dateTime
     def canonicalize!
-      @string = @object.new_offset(0).strftime('%Y-%m-%dT%H:%M:%S%Z').sub(/\+00:00|UTC|GMT/, 'Z') if self.valid?
+      @string = @object.new_offset(0).strftime('%Y-%m-%dT%H:%M:%SZ') if self.valid?
       self
     end
 
@@ -49,7 +50,7 @@ module RDF; class Literal
     #
     # @return [String]
     def to_s
-      @string || @object.strftime('%Y-%m-%dT%H:%M:%S%Z').sub(/\+00:00|UTC|GMT/, 'Z')
+      @string || @object.strftime('%Y-%m-%dT%H:%M:%S%:z').sub(/\+00:00|UTC|GMT/, 'Z')
     end
 
     ##

data/lib/rdf/model/literal/double.rb

@@ -47,7 +47,7 @@ module RDF; class Literal
         when @object.infinite? then @object.to_s[0...-'inity'.length].upcase
         when @object.zero?     then '0.0E0'
         else
-          i, f, e = ('%.16E' % @object.to_f).split(/[\.E]/)
+          i, f, e = ('%.15E' % @object.to_f).split(/[\.E]/)
           f.sub!(/0*$/, '')           # remove any trailing zeroes
           f = '0' if f.empty?         # ...but there must be a digit to the right of the decimal point
           e.sub!(/^\+?0+(\d)$/, '\1') # remove the optional leading '+' sign and any extra leading zeroes

data/lib/rdf/model/literal/time.rb

@@ -41,7 +41,7 @@ module RDF; class Literal
     # @return [RDF::Literal] `self`
     # @see    http://www.w3.org/TR/xmlschema-2/#time
     def canonicalize!
-      @string = @object.utc.strftime('%H:%M:%S%Z').sub(/\+00:00|UTC|GMT/, 'Z') if self.valid?
+      @string = @object.utc.strftime('%H:%M:%SZ') if self.valid?
       self
     end
 
@@ -54,15 +54,23 @@ module RDF; class Literal
     # @return [Boolean]
     # @since  0.2.1
     def valid?
-      super && object
+      super && !object.nil?
     end
 
     ##
     # Returns the value as a string.
+    # Does not normalize timezone
     #
     # @return [String]
     def to_s
-      @string || @object.strftime('%H:%M:%S%Z').sub(/\+00:00|UTC|GMT/, 'Z')
+      @string || if RUBY_VERSION >= '1.9' && RUBY_PLATFORM != 'java'
+        @object.strftime('%H:%M:%S%:z').
+        sub(/\+00:00|UTC|GMT/, 'Z')
+      else
+        # Ruby 1.8 doesn't do timezone's properly, use utc_offset
+        off = @object.utc_offset == 0 ? "Z" : ("%0.2d:00" % (@object.utc_offset/3600))
+        @object.strftime("%H:%M:%S#{off}")
+      end
     end
 
     ##

data/lib/rdf/model/statement.rb

@@ -113,7 +113,9 @@ module RDF
     ##
     # @return [Boolean]
     def valid?
-      has_subject? && has_predicate? && has_object?
+      has_subject?    && subject.valid? && 
+      has_predicate?  && predicate.valid? &&
+      has_object?     && object.valid?
     end
 
     ##

data/lib/rdf/model/uri.rb

@@ -3,6 +3,7 @@ require 'addressable/uri'
 module RDF
   ##
   # A Uniform Resource Identifier (URI).
+  # Also compatible with International Resource Identifier (IRI)
   #
   # `RDF::URI` supports all the instance methods of `Addressable::URI`.
   #
@@ -19,6 +20,8 @@ module RDF
   #   uri.to_s #=> "http://rdf.rubyforge.org/"
   #
   # @see http://en.wikipedia.org/wiki/Uniform_Resource_Identifier
+  # @see http://www.ietf.org/rfc/rfc3986.txt
+  # @see http://www.ietf.org/rfc/rfc3987.txt
   # @see http://addressable.rubyforge.org/
   class URI
     include RDF::Resource
@@ -27,7 +30,66 @@ module RDF
     # Defines the maximum number of interned URI references that can be held
     # cached in memory at any one time.
     CACHE_SIZE = -1 # unlimited by default
-
+    
+    # IRI components
+    if RUBY_VERSION >= '1.9'
+      UCSCHAR = Regexp.compile(<<-EOS.gsub(/\s+/, ''))
+        [\\u00A0-\\uD7FF]|[\\uF900-\\uFDCF]|[\\uFDF0-\\uFFEF]|
+        [\\u{10000}-\\u{1FFFD}]|[\\u{20000}-\\u{2FFFD}]|[\\u{30000}-\\u{3FFFD}]|
+        [\\u{40000}-\\u{4FFFD}]|[\\u{50000}-\\u{5FFFD}]|[\\u{60000}-\\u{6FFFD}]|
+        [\\u{70000}-\\u{7FFFD}]|[\\u{80000}-\\u{8FFFD}]|[\\u{90000}-\\u{9FFFD}]|
+        [\\u{A0000}-\\u{AFFFD}]|[\\u{B0000}-\\u{BFFFD}]|[\\u{C0000}-\\u{CFFFD}]|
+        [\\u{D0000}-\\u{DFFFD}]|[\\u{E0000}-\\u{EFFFD}]
+      EOS
+      IPRIVATE = Regexp.compile("[\\uE000-\\uF8FF]|[\\u{F0000}-\\u{FFFFD}]|[\\u100000-\\u10FFFD]")
+    end
+
+    SCHEME = Regexp.compile("[A-za-z](?:[A-Za-z0-9+-\.])*")
+    PORT = Regexp.compile("[0-9]*")
+    IP_literal = Regexp.compile("\\[[0-9A-Fa-f:\\.]*\\]")  # Simplified, no IPvFuture
+    PCT_ENCODED = Regexp.compile("%[0-9A-Fa-f]{2}")
+    GEN_DELIMS = Regexp.compile("[:/\\?\\#\\[\\]@]")
+    SUB_DELIMS = Regexp.compile("[!\\$&'\\(\\)\\*\\+,;=]")
+    RESERVED = Regexp.compile("(?:#{GEN_DELIMS}|#{SUB_DELIMS})")
+    UNRESERVED = Regexp.compile("[A-Za-z0-9]|-|\\.|_|~")
+
+    if RUBY_VERSION >= '1.9'
+      IUNRESERVED = Regexp.compile("[A-Za-z0-9]|-|\\.|_|~|#{UCSCHAR}")
+    else
+      IUNRESERVED = Regexp.compile("[A-Za-z0-9]|-|\\.|_|~")
+    end
+
+    IPCHAR = Regexp.compile("(?:#{IUNRESERVED}|#{PCT_ENCODED}|#{SUB_DELIMS}|:|@)")
+
+    if RUBY_VERSION >= '1.9'
+      IQUERY = Regexp.compile("(?:#{IPCHAR}|#{IPRIVATE}|/|\\?)*")
+    else
+      IQUERY = Regexp.compile("(?:#{IPCHAR}|/|\\?)*")
+    end
+
+    IFRAGMENT = Regexp.compile("(?:#{IPCHAR}|/|\\?)*")
+
+    ISEGMENT = Regexp.compile("(?:#{IPCHAR})*")
+    ISEGMENT_NZ = Regexp.compile("(?:#{IPCHAR})+")
+    ISEGMENT_NZ_NC = Regexp.compile("(?:(?:#{IUNRESERVED})|(?:#{PCT_ENCODED})|(?:#{SUB_DELIMS})|@)+")
+
+    IPATH_ABEMPTY = Regexp.compile("(?:/#{ISEGMENT})*")
+    IPATH_ABSOLUTE = Regexp.compile("/(?:(?:#{ISEGMENT_NZ})(/#{ISEGMENT})*)?")
+    IPATH_NOSCHEME = Regexp.compile("(?:#{ISEGMENT_NZ_NC})(?:/#{ISEGMENT})*")
+    IPATH_ROOTLESS = Regexp.compile("(?:#{ISEGMENT_NZ})(?:/#{ISEGMENT})*")
+    IPATH_EMPTY = Regexp.compile("")
+
+    IREG_NAME   = Regexp.compile("(?:(?:#{IUNRESERVED})|(?:#{PCT_ENCODED})|(?:#{SUB_DELIMS}))*")
+    IHOST = Regexp.compile("(?:#{IP_literal})|(?:#{IREG_NAME})")
+    IUSERINFO = Regexp.compile("(?:(?:#{IUNRESERVED})|(?:#{PCT_ENCODED})|(?:#{SUB_DELIMS})|:)*")
+    IAUTHORITY = Regexp.compile("(?:#{IUSERINFO}@)?#{IHOST}(?:#{PORT})?")
+    
+    IRELATIVE_PART = Regexp.compile("(?:(?://#{IAUTHORITY}(?:#{IPATH_ABEMPTY}))|(?:#{IPATH_ABSOLUTE})|(?:#{IPATH_NOSCHEME})|(?:#{IPATH_EMPTY}))")
+    IRELATIVE_REF = Regexp.compile("^#{IRELATIVE_PART}(?:\\?#{IQUERY})?(?:\\##{IFRAGMENT})?$")
+
+    IHIER_PART = Regexp.compile("(?:(?://#{IAUTHORITY}#{IPATH_ABEMPTY})|(?:#{IPATH_ABSOLUTE})|(?:#{IPATH_ROOTLESS})|(?:#{IPATH_EMPTY}))")
+    IRI = Regexp.compile("^#{SCHEME}:(?:#{IHIER_PART})(?:\\?#{IQUERY})?(?:\\##{IFRAGMENT})?$")
+    
     ##
     # @return [RDF::Util::Cache]
     # @private
@@ -142,6 +204,19 @@ module RDF
     end
     alias_method :size, :length
 
+    ##
+    # Determine if the URI is avalid according to RFC3987
+    #
+    # Note, for Ruby versions < 1.9, this always returns true.
+    #
+    # @return [Boolean] `true` or `false`
+    # @since 0.3.9
+    def valid?
+      # As Addressable::URI does not perform adequate validation, validate
+      # relative to RFC3987
+      to_s.match(RDF::URI::IRI) || to_s.match(RDF::URI::IRELATIVE_REF) || false
+    end
+
     ##
     # Validates this URI, raising an error if it is invalid.
     #
@@ -149,10 +224,9 @@ module RDF
     # @raise  [ArgumentError] if the URI is invalid
     # @since  0.3.0
     def validate!
-      # TODO: raise error if the URI fails validation
+      raise ArgumentError, "#{to_s.inspect} is not a valid IRI" if invalid?
       self
     end
-    alias_method :validate, :validate!
 
     ##
     # Returns a copy of this URI converted into its canonical lexical
@@ -170,7 +244,7 @@ module RDF
     # @return [RDF::URI] `self`
     # @since  0.3.0
     def canonicalize!
-      # TODO: canonicalize this URI
+      @uri.normalize!
       self
     end
 
@@ -250,21 +324,21 @@ module RDF
         RDF::URI.intern(to_s.sub(/:+$/,'') + ':' + fragment.to_s.sub(/^:+/,''))
       else # !urn?
         case to_s[-1].chr
-          when '#'
-            case fragment.to_s[0].chr
-              when '/' then # Base ending with '#', fragment beginning with '/'.  The fragment wins, we use '/'.
-              RDF::URI.intern(to_s.sub(/#+$/,'') + '/' + fragment.to_s.sub(/^\/+/,''))
-            else
-              RDF::URI.intern(to_s.sub(/#+$/,'') + '#' + fragment.to_s.sub(/^#+/,''))
-            end
-          else # includes '/'.  Results from bases ending in '/' are the same as if there were no trailing slash.
-            case fragment.to_s[0].chr
-              when '#' then # Base ending with '/', fragment beginning with '#'.  The fragment wins, we use '#'.
-                RDF::URI.intern(to_s.sub(/\/+$/,'') + '#' + fragment.to_s.sub(/^#+/,''))
-              else
-                RDF::URI.intern(to_s.sub(/\/+$/,'') + '/' + fragment.to_s.sub(/^\/+/,''))
-              end
+        when '#'
+          case fragment.to_s[0].chr
+          when '/' then # Base ending with '#', fragment beginning with '/'.  The fragment wins, we use '/'.
+            RDF::URI.intern(to_s.sub(/#+$/,'') + '/' + fragment.to_s.sub(/^\/+/,''))
+          else
+            RDF::URI.intern(to_s.sub(/#+$/,'') + '#' + fragment.to_s.sub(/^#+/,''))
           end
+        else # includes '/'.  Results from bases ending in '/' are the same as if there were no trailing slash.
+          case fragment.to_s[0].chr
+          when '#' then # Base ending with '/', fragment beginning with '#'.  The fragment wins, we use '#'.
+            RDF::URI.intern(to_s.sub(/\/+$/,'') + '#' + fragment.to_s.sub(/^#+/,''))
+          else
+            RDF::URI.intern(to_s.sub(/\/+$/,'') + '/' + fragment.to_s.sub(/^\/+/,''))
+          end
+        end
       end
     end
 

data/lib/rdf/model/value.rb

@@ -93,6 +93,34 @@ module RDF
       false
     end
 
+    ##
+    # Returns `true` if the value has a valid representation
+    #
+    # @return [Boolean] `true` or `false`
+    # @since  0.3.9
+    def valid?
+      true
+    end
+
+    ##
+    # Returns `true` if value is not valid
+    #
+    # @return [Boolean] `true` or `false`
+    # @since  0.2.1
+    def invalid?
+      !valid?
+    end
+
+    ##
+    # Default validate! implementation, overridden in concrete classes
+    # @return [RDF::Literal] `self`
+    # @raise  [ArgumentError] if the value is invalid
+    # @since  0.3.9
+    def validate!
+      raise ArgumentError if invalid?
+    end
+    alias_method :validate, :validate!
+
     ##
     # Returns an `RDF::Value` representation of `self`.
     #

data/lib/rdf/ntriples/reader.rb

@@ -124,7 +124,7 @@ module RDF::NTriples
     # @see    http://blog.grayproductions.net/articles/understanding_m17n
     # @see    http://yehudakatz.com/2010/05/17/encodings-unabridged/
     def self.unescape(string)
-      string.force_encoding(Encoding::ASCII_8BIT) if string.respond_to?(:force_encoding)
+      string = string.dup.force_encoding(Encoding::ASCII_8BIT) if string.respond_to?(:force_encoding)
 
       # Decode \t|\n|\r|\"|\\ character escapes:
       ESCAPE_CHARS.each { |escape| string.gsub!(escape.inspect[1...-1], escape) }

data/lib/rdf/ntriples/writer.rb

@@ -80,8 +80,7 @@ module RDF::NTriples
             buffer.string
           end
       end
-      ret.force_encoding(encoding) if ret.respond_to?(:force_encoding) && encoding
-      ret
+      ret.respond_to?(:force_encoding) && encoding ? ret.dup.force_encoding(encoding) : ret
     end
 
     ##

data/lib/rdf/writer.rb

@@ -136,7 +136,10 @@ module RDF
     # @yieldparam  [RDF::Writer] writer
     # @yieldreturn [void]
     # @return [String]
+    # @raise [ArgumentError] if no block is provided
     def self.buffer(*args, &block)
+      raise ArgumentError, "block expected" unless block_given?
+
       StringIO.open do |buffer|
         self.new(buffer, *args) { |writer| block.call(writer) }
         buffer.string

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rdf
 version: !ruby/object:Gem::Version
-  version: 0.3.8
+  version: 0.3.9
   prerelease: 
 platform: ruby
 authors:
@@ -11,72 +11,72 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-26 00:00:00.000000000 Z
+date: 2012-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: addressable
-  requirement: !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: 2.2.6
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
     none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: 2.2.6
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
     none: false
+  name: addressable
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: 0.7.5
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
     none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: 0.7.5
-- !ruby/object:Gem::Dependency
-  name: rdf-spec
-  requirement: !ruby/object:Gem::Requirement
     none: false
+  name: yard
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.3.8
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
     none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.3.8
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
     none: false
+  name: rdf-spec
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: 2.8.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
     none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: 2.8.0
+    none: false
+  name: rspec
+  prerelease: false
+  type: :development
 description: RDF.rb is a pure-Ruby library for working with Resource Description Framework
   (RDF) data.
 email: public-rdf-ruby@w3.org
@@ -93,8 +93,19 @@ files:
 - bin/rdf
 - etc/doap.nt
 - lib/df.rb
+- lib/rdf.rb
 - lib/rdf/cli.rb
 - lib/rdf/format.rb
+- lib/rdf/nquads.rb
+- lib/rdf/ntriples.rb
+- lib/rdf/query.rb
+- lib/rdf/reader.rb
+- lib/rdf/repository.rb
+- lib/rdf/transaction.rb
+- lib/rdf/util.rb
+- lib/rdf/version.rb
+- lib/rdf/vocab.rb
+- lib/rdf/writer.rb
 - lib/rdf/mixin/countable.rb
 - lib/rdf/mixin/durable.rb
 - lib/rdf/mixin/enumerable.rb
@@ -107,16 +118,6 @@ files:
 - lib/rdf/mixin/writable.rb
 - lib/rdf/model/graph.rb
 - lib/rdf/model/list.rb
-- lib/rdf/model/literal/boolean.rb
-- lib/rdf/model/literal/date.rb
-- lib/rdf/model/literal/datetime.rb
-- lib/rdf/model/literal/decimal.rb
-- lib/rdf/model/literal/double.rb
-- lib/rdf/model/literal/integer.rb
-- lib/rdf/model/literal/numeric.rb
-- lib/rdf/model/literal/time.rb
-- lib/rdf/model/literal/token.rb
-- lib/rdf/model/literal/xml.rb
 - lib/rdf/model/literal.rb
 - lib/rdf/model/node.rb
 - lib/rdf/model/resource.rb
@@ -124,25 +125,17 @@ files:
 - lib/rdf/model/term.rb
 - lib/rdf/model/uri.rb
 - lib/rdf/model/value.rb
-- lib/rdf/nquads.rb
 - lib/rdf/ntriples/format.rb
 - lib/rdf/ntriples/reader.rb
 - lib/rdf/ntriples/writer.rb
-- lib/rdf/ntriples.rb
 - lib/rdf/query/pattern.rb
 - lib/rdf/query/solution.rb
 - lib/rdf/query/solutions.rb
 - lib/rdf/query/variable.rb
-- lib/rdf/query.rb
-- lib/rdf/reader.rb
-- lib/rdf/repository.rb
-- lib/rdf/transaction.rb
 - lib/rdf/util/aliasing.rb
 - lib/rdf/util/cache.rb
 - lib/rdf/util/file.rb
 - lib/rdf/util/uuid.rb
-- lib/rdf/util.rb
-- lib/rdf/version.rb
 - lib/rdf/vocab/cc.rb
 - lib/rdf/vocab/cert.rb
 - lib/rdf/vocab/dc.rb
@@ -161,9 +154,16 @@ files:
 - lib/rdf/vocab/wot.rb
 - lib/rdf/vocab/xhtml.rb
 - lib/rdf/vocab/xsd.rb
-- lib/rdf/vocab.rb
-- lib/rdf/writer.rb
-- lib/rdf.rb
+- lib/rdf/model/literal/boolean.rb
+- lib/rdf/model/literal/date.rb
+- lib/rdf/model/literal/datetime.rb
+- lib/rdf/model/literal/decimal.rb
+- lib/rdf/model/literal/double.rb
+- lib/rdf/model/literal/integer.rb
+- lib/rdf/model/literal/numeric.rb
+- lib/rdf/model/literal/time.rb
+- lib/rdf/model/literal/token.rb
+- lib/rdf/model/literal/xml.rb
 homepage: http://ruby-rdf.github.com/rdf
 licenses:
 - Public Domain
@@ -172,17 +172,17 @@ rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: 1.8.1
-required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+  none: false
 requirements: []
 rubyforge_project: rdf
 rubygems_version: 1.8.24