rdf 0.1.0 → 0.1.1

data/README

@@ -1,15 +1,11 @@
-RDF.rb: RDF API for Ruby
-========================
+RDF.rb: RDF for Ruby
+====================
 
-This is a pure-Ruby library for working with Resource Description Framework
-(RDF) data.
+This is a pure-Ruby library for working with [Resource Description Framework
+(RDF)][RDF] data.
 
 * <http://github.com/bendiken/rdf>
-
-### About the Resource Description Framework (RDF)
-
-* <http://www.w3.org/RDF/>
-* <http://en.wikipedia.org/wiki/Resource_Description_Framework>
+* <http://blog.datagraph.org/2010/03/rdf-for-ruby>
 
 Examples
 --------
@@ -162,3 +158,5 @@ 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/

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/etc/doap.nt

@@ -1,13 +1,19 @@
 <http://ar.to/#self> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://xmlns.com/foaf/0.1/Person> .
+<http://ar.to/#self> <http://www.w3.org/2000/01/rdf-schema#isDefinedBy> <http://datagraph.org/bendiken/foaf> .
+<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/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/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#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> .
@@ -20,5 +26,6 @@
 <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 .
+<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> .

data/lib/rdf/ntriples/format.rb

@@ -2,6 +2,13 @@ module RDF::NTriples
   ##
   # N-Triples format specification.
   #
+  # @example Obtaining an RDF/NTriples format class
+  #   RDF::Format.for(:ntriples)     #=> RDF::NTriples::Format
+  #   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")
+  #
   # @see http://www.w3.org/TR/rdf-testcases/#ntriples
   class Format < RDF::Format
     content_type     'text/plain', :extension => :nt

data/lib/rdf/ntriples/reader.rb

@@ -2,8 +2,23 @@ module RDF::NTriples
   ##
   # N-Triples parser.
   #
-  # @example Reading N-Triples data
-  #   RDF::NTriples::Reader.open("spec/data/test.nt") do |reader|
+  # @example Obtaining an RDF/NTriples reader class
+  #   RDF::Reader.for(:ntriples)     #=> RDF::NTriples::Reader
+  #   RDF::Reader.for("etc/doap.nt")
+  #   RDF::Reader.for(:file_name      => "etc/doap.nt")
+  #   RDF::Reader.for(:file_extension => "nt")
+  #   RDF::Reader.for(:content_type   => "text/plain")
+  #
+  # @example Parsing RDF statements from an NTriples file
+  #   RDF::NTriples::Reader.open("etc/doap.nt") do |reader|
+  #     reader.each_statement do |statement|
+  #       puts statement.inspect
+  #     end
+  #   end
+  #
+  # @example Parsing RDF statements from an NTriples string
+  #   data = StringIO.new(File.read("etc/doap.nt"))
+  #   RDF::NTriples::Reader.new(data) do |reader|
   #     reader.each_statement do |statement|
   #       puts statement.inspect
   #     end

data/lib/rdf/ntriples/writer.rb

@@ -2,6 +2,27 @@ module RDF::NTriples
   ##
   # N-Triples serializer.
   #
+  # @example Obtaining an NTriples writer class
+  #   RDF::Writer.for(:ntriples)     #=> RDF::NTriples::Writer
+  #   RDF::Writer.for("etc/test.nt")
+  #   RDF::Writer.for(:file_name      => "etc/test.nt")
+  #   RDF::Writer.for(:file_extension => "nt")
+  #   RDF::Writer.for(:content_type   => "text/plain")
+  #
+  # @example Serializing RDF statements into an NTriples file
+  #   RDF::NTriples::Writer.open("etc/test.nt") do |writer|
+  #     graph.each_statement do |statement|
+  #       writer << statement
+  #     end
+  #   end
+  #
+  # @example Serializing RDF statements into an NTriples string
+  #   RDF::NTriples::Writer.buffer do |writer|
+  #     graph.each_statement do |statement|
+  #       writer << statement
+  #     end
+  #   end
+  #
   # @see http://www.w3.org/TR/rdf-testcases/#ntriples
   class Writer < RDF::Writer
     format RDF::NTriples::Format
@@ -12,7 +33,7 @@ module RDF::NTriples
     # @param  [String] text
     # @return [void]
     def write_comment(text)
-      puts "# #{text}"
+      puts "# #{text.chomp}" # TODO: correctly output multi-line comments
     end
 
     ##
@@ -23,44 +44,64 @@ module RDF::NTriples
     # @param  [RDF::Value]    object
     # @return [void]
     def write_triple(subject, predicate, object)
-      puts "%s %s %s ." % [subject, predicate, object].map { |value| format_value(value) }
+      puts format_triple(subject, predicate, object)
+    end
+
+    ##
+    # Returns the N-Triples representation of a statement.
+    #
+    # @param  [RDF::Statement] statement
+    # @return [String]
+    def format_statement(statement)
+      format_triple(*statement.to_triple)
+    end
+
+    ##
+    # Returns the N-Triples representation of a triple.
+    #
+    # @param  [RDF::Resource] subject
+    # @param  [RDF::URI]      predicate
+    # @param  [RDF::Value]    object
+    # @return [String]
+    def format_triple(subject, predicate, object)
+      "%s %s %s ." % [subject, predicate, object].map { |value| format_value(value) }
     end
 
     ##
     # Returns the N-Triples representation of a blank node.
     #
-    # @param  [RDF::Node] value
+    # @param  [RDF::Node] node
     # @param  [Hash{Symbol => Object}] options
     # @return [String]
-    def format_node(value, options = {})
+    def format_node(node, options = {})
       "_:%s" % node.id
     end
 
     ##
     # Returns the N-Triples representation of a URI reference.
     #
-    # @param  [RDF::URI] value
+    # @param  [RDF::URI] literal
     # @param  [Hash{Symbol => Object}] options
     # @return [String]
-    def format_uri(value, options = {})
-      "<%s>" % uri_for(value)
+    def format_uri(uri, options = {})
+      "<%s>" % uri_for(uri)
     end
 
     ##
     # Returns the N-Triples representation of a literal.
     #
-    # @param  [RDF::Literal, String, #to_s] value
+    # @param  [RDF::Literal, String, #to_s] literal
     # @param  [Hash{Symbol => Object}] options
     # @return [String]
-    def format_literal(value, options = {})
-      case value
+    def format_literal(literal, options = {})
+      case literal
         when RDF::Literal
-          text = quoted(escaped(value.value))
-          text << "@#{value.language}" if value.language
-          text << "^^<#{uri_for(value.datatype)}>" if value.datatype
+          text = quoted(escaped(literal.value))
+          text << "@#{literal.language}" if literal.has_language?
+          text << "^^<#{uri_for(literal.datatype)}>" if literal.has_datatype?
           text
         else
-          quoted(escaped(value.to_s))
+          quoted(escaped(literal.to_s))
       end
     end
   end

data/lib/rdf/version.rb

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

metadata

@@ -1,7 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: rdf
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
 platform: ruby
 authors: 
 - Arto Bendiken
@@ -10,49 +15,65 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-10 00:00:00 +01:00
+date: 2010-03-14 00:00:00 +01:00
 default_executable: rdf
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rdf-spec
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.0.9
-    version: 
+        segments: 
+        - 0
+        - 1
+        - 0
+        version: 0.1.0
+  type: :development
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: rspec
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.2.9
-    version: 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id002
 - !ruby/object:Gem::Dependency 
   name: yard
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 5
+        - 3
         version: 0.5.3
-    version: 
+  type: :development
+  version_requirements: *id003
 - !ruby/object:Gem::Dependency 
   name: addressable
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 1
+        - 1
         version: 2.1.1
-    version: 
+  type: :runtime
+  version_requirements: *id004
 description: RDF.rb is a pure-Ruby library for working with Resource Description Framework (RDF) data.
 email: arto.bendiken@gmail.com
 executables: 
@@ -128,18 +149,22 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 8
+      - 2
       version: 1.8.2
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: rdf
-rubygems_version: 1.3.5
+rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
 summary: A Ruby library for working with Resource Description Framework (RDF) data.