rdf 0.1.3 → 0.1.4

data/README

@@ -7,6 +7,18 @@ This is a pure-Ruby library for working with [Resource Description Framework
 * <http://github.com/bendiken/rdf>
 * <http://blog.datagraph.org/2010/03/rdf-for-ruby>
 
+Features
+--------
+
+* 100% pure Ruby with minimal dependencies and no bloat whatsoever.
+* 100% free and unencumbered [public domain](http://unlicense.org/) software.
+* 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.
+* Plays nice with others: entirely contained in the `RDF` module, and does
+  not modify any of Ruby's core classes or standard library.
+* Compatible with Ruby 1.8.x, Ruby 1.9.x, and JRuby (tested with JRuby 1.4).
+
 Examples
 --------
 
@@ -26,6 +38,7 @@ Examples
     
     DC.title      #=> RDF::URI("http://purl.org/dc/terms/title")
     FOAF.knows    #=> RDF::URI("http://xmlns.com/foaf/0.1/knows")
+    RDF.type      #=> RDF::URI("http://www.w3.org/1999/02/22-rdf-syntax-ns#type")
     RDFS.seeAlso  #=> RDF::URI("http://www.w3.org/2000/01/rdf-schema#seeAlso")
     RSS.title     #=> RDF::URI("http://purl.org/rss/1.0/title")
     OWL.sameAs    #=> RDF::URI("http://www.w3.org/2002/07/owl#sameAs")
@@ -49,17 +62,17 @@ Examples
 Documentation
 -------------
 
-* <http://rdf.rubyforge.org/>
+<http://rdf.rubyforge.org/>
 
 ### RDF Object Model
 
-* {RDF::Graph}
-* {RDF::Literal}
-* {RDF::Node}
-* {RDF::Resource}
-* {RDF::Statement}
-* {RDF::URI}
 * {RDF::Value}
+  * {RDF::Literal}
+  * {RDF::Resource}
+    * {RDF::Node}
+    * {RDF::URI}
+    * {RDF::Graph}
+  * {RDF::Statement}
 
 ### RDF Serialization
 
@@ -70,13 +83,20 @@ Documentation
 ### RDF Serialization Formats
 
 * {RDF::NTriples}
-* [RDF::JSON](http://rdf.rubyforge.org/json/) (plugin)
-* [RDF::Trix](http://rdf.rubyforge.org/trix/) (plugin)
+* [`RDF::JSON`](http://rdf.rubyforge.org/json/) (plugin)
+* [`RDF::Trix`](http://rdf.rubyforge.org/trix/) (plugin)
+* [`RDF::Raptor::RDFXML`](http://rdf.rubyforge.org/raptor/) (plugin)
+* [`RDF::Raptor::Turtle`](http://rdf.rubyforge.org/raptor/) (plugin)
 
 ### RDF Storage
 
 * {RDF::Repository}
-* [RDF::Sesame](http://rdf.rubyforge.org/sesame/) (plugin)
+  * {RDF::Enumerable}
+  * {RDF::Durable}
+  * {RDF::Mutable}
+  * {RDF::Queryable}
+* [`RDF::DataObjects`](http://rdf.rubyforge.org/do/) (plugin)
+* [`RDF::Sesame`](http://rdf.rubyforge.org/sesame/) (plugin)
 
 ### RDF Querying
 
@@ -140,11 +160,14 @@ Resources
 See Also
 --------
 
-* [DataMapper RDF.rb Adapter](http://dm-rdf.rubyforge.org/)
+* [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

data/VERSION

@@ -1 +1 @@
-0.1.3
+0.1.4

data/lib/rdf/model/node.rb

@@ -36,7 +36,7 @@ module RDF
     ##
     # @param  [#to_s] id
     def initialize(id = nil)
-      @id = (id || object_id).to_s
+      @id = (id || "g#{object_id}").to_s
     end
 
     ##

data/lib/rdf/ntriples.rb

@@ -41,5 +41,25 @@ module RDF
     require 'rdf/ntriples/format'
     autoload :Reader, 'rdf/ntriples/reader'
     autoload :Writer, 'rdf/ntriples/writer'
+
+    ##
+    # Reconstructs an RDF value from its serialized N-Triples
+    # representation.
+    #
+    # @param  [String] data
+    # @return [RDF::Value]
+    def self.unserialize(data)
+      Reader.unserialize(data)
+    end
+
+    ##
+    # Returns the serialized N-Triples representation of the given RDF
+    # value.
+    #
+    # @param  [RDF::Value] value
+    # @return [String]
+    def self.serialize(value)
+      Writer.serialize(value)
+    end
   end
 end

data/lib/rdf/ntriples/reader.rb

@@ -35,7 +35,10 @@ module RDF::NTriples
     # @param  [String] data
     # @return [RDF::Value]
     def self.unserialize(data)
-      self.new(data).read_value
+      case data
+        when nil then nil
+        else self.new(data).read_value
+      end
     end
 
     ##

data/lib/rdf/ntriples/writer.rb

@@ -36,6 +36,7 @@ module RDF::NTriples
     def self.serialize(value)
       writer = self.new
       case value
+        when nil then nil
         when RDF::Statement
           writer.format_statement(value) + "\n"
         else

data/lib/rdf/reader.rb

@@ -104,12 +104,12 @@ module RDF
     # @yieldparam [Reader]
     # @raise  [FormatError] if no reader available for the specified format
     def self.open(filename, options = {}, &block)
-      Kernel.open(filename, 'rb') do |file|
-        if reader = self.for(options[:format] || filename)
+      if reader = self.for(options[:format] || filename)
+        Kernel.open(filename, 'rb') do |file|
           reader.new(file, options, &block)
-        else
-          raise FormatError.new("unknown RDF format: #{options[:format] || filename}")
         end
+      else
+        raise FormatError.new("unknown RDF format: #{options[:format] || filename}")
       end
     end
 

data/lib/rdf/spec.rb

@@ -0,0 +1,49 @@
+require 'rdf'
+
+module RDF
+  ##
+  # **`RDF::Spec`** provides RSpec extensions for RDF.rb.
+  #
+  # @example Requiring the `RDF::Spec` module
+  #   require 'rdf/spec'
+  #
+  # @example Including the matchers in `spec/spec_helper.rb`
+  #   require 'rdf/spec'
+  #   
+  #   Spec::Runner.configure do |config|
+  #     config.include(RDF::Spec::Matchers)
+  #   end
+  #
+  # @example Using the shared examples for `RDF::Enumerable`
+  #   require 'rdf/spec/enumerable'
+  #   
+  #   describe RDF::Enumerable do
+  #     before :each do
+  #       @statements = RDF::NTriples::Reader.new(File.open("etc/doap.nt")).to_a
+  #       @enumerable = @statements.dup.extend(RDF::Enumerable)
+  #     end
+  #     
+  #     it_should_behave_like RDF_Enumerable
+  #   end
+  #
+  # @example Using the shared examples for `RDF::Repository`
+  #   require 'rdf/spec/repository'
+  #   
+  #   describe RDF::Repository do
+  #     before :each do
+  #       @repository = RDF::Repository.new
+  #     end
+  #     
+  #     it_should_behave_like RDF_Repository
+  #   end
+  #
+  # @see http://rdf.rubyforge.org/
+  # @see http://rspec.info/
+  #
+  # @author [Arto Bendiken](http://ar.to/)
+  # @author [Ben Lavender](http://bhuga.net/)
+  module Spec
+    autoload :Matchers, 'rdf/spec/matchers'
+    autoload :VERSION,  'rdf/spec/version'
+  end # module Spec
+end # module RDF

data/lib/rdf/version.rb

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

data/lib/rdf/writer.rb

@@ -84,7 +84,7 @@ module RDF
     def self.format(klass = nil)
       if klass.nil?
         Format.each do |format|
-          if format.reader == self
+          if format.writer == self
             return format
           end
         end
@@ -129,6 +129,11 @@ module RDF
       end
     end
 
+    ##
+    # @param  [IO, File]               output
+    # @param  [Hash{Symbol => Object}] options
+    # @yield  [writer]
+    # @yieldparam [RDF::Writer] writer
     def initialize(output = $stdout, options = {}, &block)
       @output, @options = output, options
       @nodes, @node_id = {}, 0
@@ -141,14 +146,17 @@ module RDF
     end
 
     ##
+    # @return [void]
     # @abstract
     def write_prologue() end
 
     ##
+    # @return [void]
     # @abstract
     def write_epilogue() end
 
     ##
+    # @return [void]
     # @abstract
     def write_comment(text) end
 
@@ -174,10 +182,13 @@ module RDF
 
     ##
     # @param  [Graph] graph
+    # @return [void]
     def write_graph(graph)
       write_triples(*graph.triples)
     end
 
+    ##
+    # @return [void]
     def write_resource(subject) # FIXME
       edge_nodes = []
       subject.each do |predicate, objects|
@@ -191,18 +202,21 @@ module RDF
 
     ##
     # @param  [Array<Statement>] statements
+    # @return [void]
     def write_statements(*statements)
       statements.flatten.each { |stmt| write_statement(stmt) }
     end
 
     ##
     # @param  [Statement] statement
+    # @return [void]
     def write_statement(statement)
       write_triple(*statement.to_a)
     end
 
     ##
     # @param  [Array<Array(Value)>] triples
+    # @return [void]
     def write_triples(*triples)
       triples.each { |triple| write_triple(*triple) }
     end
@@ -211,6 +225,7 @@ module RDF
     # @param  [Resource] subject
     # @param  [URI]      predicate
     # @param  [Value]    object
+    # @return [void]
     # @raise  [NotImplementedError] unless implemented in subclass
     # @abstract
     def write_triple(subject, predicate, object)

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 3
-  version: 0.1.3
+  - 4
+  version: 0.1.4
 platform: ruby
 authors: 
 - Arto Bendiken
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-30 00:00:00 +02:00
+date: 2010-04-03 00:00:00 +02:00
 default_executable: rdf
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -28,8 +28,8 @@ dependencies:
         segments: 
         - 0
         - 1
-        - 0
-        version: 0.1.0
+        - 4
+        version: 0.1.4
   type: :development
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
@@ -117,6 +117,7 @@ files:
 - lib/rdf/query.rb
 - lib/rdf/reader.rb
 - lib/rdf/repository.rb
+- lib/rdf/spec.rb
 - lib/rdf/version.rb
 - lib/rdf/vocab/cc.rb
 - lib/rdf/vocab/dc.rb