rdf 0.0.6 → 0.0.7

data/lib/rdf/vocab/skos.rb

@@ -0,0 +1,36 @@
+module RDF
+  ##
+  # Simple Knowledge Organization System (SKOS) vocabulary.
+  #
+  # @see http://www.w3.org/TR/skos-reference/skos.html
+  class SKOS < Vocabulary("http://www.w3.org/2004/02/skos/core#")
+    property :altLabel
+    property :broadMatch
+    property :broader
+    property :broaderTransitive
+    property :changeNote
+    property :closeMatch
+    property :definition
+    property :editorialNote
+    property :exactMatch
+    property :example
+    property :hasTopConcept
+    property :hiddenLabel
+    property :historyNote
+    property :inScheme
+    property :mappingRelation
+    property :member
+    property :memberList
+    property :narrowMatch
+    property :narrower
+    property :narrowerTransitive
+    property :notation
+    property :note
+    property :prefLabel
+    property :related
+    property :relatedMatch
+    property :scopeNote
+    property :semanticRelation
+    property :topConceptOf
+  end
+end

data/lib/rdf/vocab/wot.rb

@@ -0,0 +1,21 @@
+module RDF
+  ##
+  # Web of Trust (WOT) vocabulary.
+  #
+  # @see http://xmlns.com/wot/0.1/
+  class WOT < Vocabulary("http://xmlns.com/wot/0.1/")
+    property :assurance
+    property :encryptedTo
+    property :encrypter
+    property :fingerprint
+    property :hasKey
+    property :hex_id
+    property :identity
+    property :length
+    property :pubkeyAddress
+    property :sigdate
+    property :signed
+    property :signer
+    property :sigtime
+  end
+end

data/lib/rdf/vocab/xhtml.rb

@@ -0,0 +1,9 @@
+module RDF
+  ##
+  # Extensible HyperText Markup Language (XHTML) vocabulary.
+  #
+  # @see http://www.w3.org/1999/xhtml/
+  class XHTML < Vocabulary("http://www.w3.org/1999/xhtml#")
+    # TODO
+  end
+end

data/lib/rdf/vocab/xsd.rb

@@ -0,0 +1,58 @@
+module RDF
+  ##
+  # XML Schema (XSD) vocabulary.
+  #
+  # @see http://www.w3.org/XML/Schema
+  # @see http://www.w3.org/TR/xmlschema-2/#built-in-datatypes
+  class XSD < Vocabulary("http://www.w3.org/2001/XMLSchema#")
+    # XML Schema built-in primitive types
+    # @see http://www.w3.org/TR/xmlschema-2/#built-in-primitive-datatypes
+    property :NOTATION
+    property :QName
+    property :anyURI
+    property :base64Binary
+    property :boolean
+    property :date
+    property :dateTime
+    property :decimal
+    property :double
+    property :duration
+    property :float
+    property :gDay
+    property :gMonth
+    property :gMonthDay
+    property :gYear
+    property :gYearMonth
+    property :hexBinary
+    property :string
+    property :time
+
+    # XML Schema built-in derived types
+    # @see http://www.w3.org/TR/xmlschema-2/#built-in-derived
+    property :ENTITIES
+    property :ENTITY
+    property :ID
+    property :IDREF
+    property :IDREFS
+    property :NCName
+    property :NMTOKEN
+    property :NMTOKENS
+    property :Name
+    property :byte
+    property :int
+    property :integer
+    property :language
+    property :long
+    property :negativeInteger
+    property :nonNegativeInteger
+    property :nonPositiveInteger
+    property :normalizedString
+    property :positiveInteger
+    property :short
+    property :token
+    property :unsignedByte
+    property :unsignedInt
+    property :unsignedLong
+    property :unsignedShort
+  end
+end

data/lib/rdf/writer.rb

@@ -2,30 +2,100 @@ module RDF
   ##
   # An RDF serializer.
   #
+  # @example Iterating over known RDF writer classes
+  #   RDF::Writer.each { |klass| puts klass.name }
+  #
+  # @example Obtaining an RDF writer class
+  #   RDF::Writer.for(:ntriples)     #=> RDF::NTriples::Writer
+  #   RDF::Writer.for("spec/data/output.nt")
+  #   RDF::Writer.for(:file_name => "spec/data/output.nt")
+  #   RDF::Writer.for(:file_extension => "nt")
+  #   RDF::Writer.for(:content_type => "text/plain")
+  #
+  # @example Instantiating an RDF writer class
+  #   RDF::Writer.for(:ntriples).new($stdout) { |writer| ... }
+  #
+  # @example Serializing RDF statements to a file
+  #   RDF::Writer.open("spec/data/output.nt") do |writer|
+  #     graph.each_statement do |statement|
+  #       writer << statement
+  #     end
+  #   end
+  #
+  # @example Serializing RDF statements to a string
+  #   RDF::Writer.for(:ntriples).buffer do |writer|
+  #     graph.each_statement do |statement|
+  #       writer << statement
+  #     end
+  #   end
+  #
   # @abstract
+  # @see RDF::Format
+  # @see RDF::Reader
   class Writer
-    autoload :NTriples, 'rdf/writer/ntriples' # @deprecated
-
-    include Enumerable
+    extend  ::Enumerable
+    include ::Enumerable
 
     ##
     # Enumerates known RDF writer classes.
     #
     # @yield  [klass]
     # @yieldparam [Class]
+    # @return [Enumerator]
     def self.each(&block)
-      !block_given? ? @@subclasses : @@subclasses.each { |klass| yield klass }
+      @@subclasses.each(&block)
+    end
+
+    ##
+    # Finds an RDF writer class based on the given criteria.
+    #
+    # @overload for(format)
+    #   Finds an RDF writer class based on a symbolic name.
+    #
+    #   @param  [Symbol] format
+    #   @return [Class]
+    #
+    # @overload for(filename)
+    #   Finds an RDF writer class based on a file name.
+    #
+    #   @param  [String] filename
+    #   @return [Class]
+    #
+    # @overload for(options = {})
+    #   Finds an RDF writer class based on various options.
+    #
+    #   @param  [Hash{Symbol => Object}] options
+    #   @option options [String, #to_s]   :file_name      (nil)
+    #   @option options [Symbol, #to_sym] :file_extension (nil)
+    #   @option options [String, #to_s]   :content_type   (nil)
+    #   @return [Class]
+    #
+    # @return [Class]
+    def self.for(options = {})
+      if format = Format.for(options)
+        format.writer
+      end
     end
 
     ##
-    # Returns the RDF writer class for the given format.
-    def self.for(format)
-      klass = case format.to_s.downcase.to_sym
-        when :ntriples then RDF::NTriples::Writer
-        else nil # FIXME
+    # Retrieves the RDF serialization format class for this writer class.
+    #
+    # @return [Class]
+    def self.format(klass = nil)
+      if klass.nil?
+        Format.each do |format|
+          if format.reader == self
+            return format
+          end
+        end
+        nil # not found
       end
     end
 
+    class << self
+      alias_method :format_class, :format
+    end
+
     def self.buffer(*args, &block)
       require 'stringio' unless defined?(StringIO)
 
@@ -36,10 +106,8 @@ module RDF
     end
 
     def self.open(filename, options = {}, &block)
-      options[:format] ||= :ntriples # FIXME
-
       File.open(filename, 'wb') do |file|
-        self.for(options[:format]).new(file, options, &block)
+        self.for(options[:format] || filename).new(file, options, &block)
       end
     end
 
@@ -131,6 +199,49 @@ module RDF
       raise NotImplementedError # override in subclasses
     end
 
+    ##
+    # @param  [Value] value
+    # @return [String]
+    def format_value(value, options = {})
+      case value
+        when String       then format_literal(value, options)
+        when RDF::Literal then format_literal(value, options)
+        when RDF::URI     then format_uri(value, options)
+        when RDF::Node    then format_node(value, options)
+        else nil
+      end
+    end
+
+    ##
+    # @param  [URI]                    value
+    # @param  [Hash{Symbol => Object}] options
+    # @return [String]
+    # @raise  [NotImplementedError] unless implemented in subclass
+    # @abstract
+    def format_uri(value, options = {})
+      raise NotImplementedError # override in subclasses
+    end
+
+    ##
+    # @param  [Node]                   value
+    # @param  [Hash{Symbol => Object}] options
+    # @return [String]
+    # @raise  [NotImplementedError] unless implemented in subclass
+    # @abstract
+    def format_node(value, options = {})
+      raise NotImplementedError # override in subclasses
+    end
+
+    ##
+    # @param  [Literal, String, #to_s] value
+    # @param  [Hash{Symbol => Object}] options
+    # @return [String]
+    # @raise  [NotImplementedError] unless implemented in subclass
+    # @abstract
+    def format_literal(value, options = {})
+      raise NotImplementedError # override in subclasses
+    end
+
     protected
 
       def puts(*args)
@@ -188,10 +299,6 @@ module RDF
         super
       end
 
-      def self.format(klass)
-        # TODO
-      end
-
   end
 
   class WriterError < IOError; end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rdf
 version: !ruby/object:Gem::Version 
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors: 
 - Arto Bendiken
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-30 00:00:00 +01:00
+date: 2010-01-09 00:00:00 +01:00
 default_executable: rdf
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -68,10 +68,15 @@ files:
 - bin/rdf-subjects
 - lib/df.rb
 - lib/rdf/cli.rb
+- lib/rdf/enumerable.rb
 - lib/rdf/format.rb
-- lib/rdf/graph.rb
-- lib/rdf/literal.rb
-- lib/rdf/node.rb
+- lib/rdf/model/graph.rb
+- lib/rdf/model/literal.rb
+- lib/rdf/model/node.rb
+- lib/rdf/model/resource.rb
+- lib/rdf/model/statement.rb
+- lib/rdf/model/uri.rb
+- lib/rdf/model/value.rb
 - lib/rdf/ntriples/format.rb
 - lib/rdf/ntriples/reader.rb
 - lib/rdf/ntriples/writer.rb
@@ -80,31 +85,25 @@ files:
 - lib/rdf/query/solution.rb
 - lib/rdf/query/variable.rb
 - lib/rdf/query.rb
-- lib/rdf/reader/ntriples.rb
 - lib/rdf/reader.rb
 - lib/rdf/repository.rb
-- lib/rdf/resource.rb
-- lib/rdf/statement.rb
-- lib/rdf/uri.rb
-- lib/rdf/value.rb
 - lib/rdf/version.rb
-- lib/rdf/vocabulary/cc.rb
-- lib/rdf/vocabulary/dc.rb
-- lib/rdf/vocabulary/doap.rb
-- lib/rdf/vocabulary/exif.rb
-- lib/rdf/vocabulary/foaf.rb
-- lib/rdf/vocabulary/http.rb
-- lib/rdf/vocabulary/owl.rb
-- lib/rdf/vocabulary/rdf.rb
-- lib/rdf/vocabulary/rdfs.rb
-- lib/rdf/vocabulary/rss.rb
-- lib/rdf/vocabulary/sioc.rb
-- lib/rdf/vocabulary/skos.rb
-- lib/rdf/vocabulary/wot.rb
-- lib/rdf/vocabulary/xhtml.rb
-- lib/rdf/vocabulary/xsd.rb
-- lib/rdf/vocabulary.rb
-- lib/rdf/writer/ntriples.rb
+- lib/rdf/vocab/cc.rb
+- lib/rdf/vocab/dc.rb
+- lib/rdf/vocab/doap.rb
+- lib/rdf/vocab/exif.rb
+- lib/rdf/vocab/foaf.rb
+- lib/rdf/vocab/http.rb
+- lib/rdf/vocab/owl.rb
+- lib/rdf/vocab/rdf.rb
+- lib/rdf/vocab/rdfs.rb
+- lib/rdf/vocab/rss.rb
+- lib/rdf/vocab/sioc.rb
+- lib/rdf/vocab/skos.rb
+- 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
 has_rdoc: false

data/lib/rdf/graph.rb

@@ -1,197 +0,0 @@
-module RDF
-  ##
-  # An RDF graph.
-  class Graph < Resource
-    include Enumerable
-
-    # @return [URI]
-    attr_accessor :uri
-
-    # @return [Array<Statement>]
-    attr_accessor :data
-
-    ##
-    # @param  [URI] uri
-    # @yield  [graph]
-    # @yieldparam [Graph]
-    def initialize(uri = nil, options = {}, &block)
-      @uri, @options = uri, options
-
-      if block_given?
-        case block.arity
-          when 1 then block.call(self)
-          else instance_eval(&block)
-        end
-      end
-    end
-
-    ##
-    # Returns `true`.
-    #
-    # @return [Boolean]
-    def graph?
-      true
-    end
-
-    ##
-    # @return [Boolean]
-    def named?()   !unnamed? end
-
-    ##
-    # @return [Boolean]
-    def unnamed?() uri.nil? end
-
-    ##
-    # @return [Integer]
-    def size() @data.size end
-
-    ##
-    # @yield [statement]
-    # @yieldparam [Array<Statement>]
-    # @return [Graph]
-    def each(&block)
-      each_statement(&block)
-    end
-
-    ##
-    # @yield  [statement]
-    # @yieldparam [Array<Statement>]
-    # @return [Graph]
-    def each_statement(&block)
-      @data.each(&block)
-      self
-    end
-
-    ##
-    # @yield  [triple]
-    # @yieldparam [Array(Value)]
-    # @return [Graph]
-    def each_triple(&block)
-      @data.each do |statement|
-        block.call(*statement.to_triple)
-      end
-      self
-    end
-
-    ##
-    # @yield  [quad]
-    # @yieldparam [Array(Value)]
-    # @return [Graph]
-    def each_quad(&block)
-      @data.each do |statement|
-        block.call(*statement.to_quad) # FIXME?
-      end
-      self
-    end
-
-    ##
-    # @yield  [context]
-    # @yieldparam [Resource]
-    # @return [Graph]
-    def each_context(&block)
-      block.call(uri) unless unnamed?
-      self
-    end
-
-    ##
-    # @yield  [subject]
-    # @yieldparam [Resource]
-    # @return [Graph]
-    def each_subject(&block)
-      @data.each do |statement|
-        block.call(statement.subject)
-      end
-      self
-    end
-
-    ##
-    # @yield  [predicate]
-    # @yieldparam [URI]
-    # @return [Graph]
-    def each_predicate(&block)
-      @data.each do |statement|
-        block.call(statement.predicate)
-      end
-      self
-    end
-
-    ##
-    # @yield  [object]
-    # @yieldparam [Value]
-    # @return [Graph]
-    def each_object(&block)
-      @data.each do |statement|
-        block.call(statement.object)
-      end
-      self
-    end
-
-    ##
-    # @return [Array<Statement>]
-    def statements(&block)
-      block_given? ? each_statement(&block) : @data
-    end
-
-    ##
-    # @return [Array<Array(Value)>]
-    def triples(&block)
-      block_given? ? each_triple(&block) : map { |statement| statement.to_triple }
-    end
-
-    ##
-    # @return [Array<Array(Value)>]
-    def quads(&block)
-      block_given? ? each_quad(&block) : map { |statement| statement.to_quad }
-    end
-
-    ##
-    # @return [Resource]
-    def context() uri end
-
-    ##
-    # @return [Array<Resource>]
-    def contexts
-      block_given? ? each_context(&block) : (named? ? [uri] : [])
-    end
-
-    ##
-    # @return [Array<Resource>]
-    def subjects
-      block_given? ? each_subject(&block) : map(&:subject)
-    end
-
-    ##
-    # @return [Array<URI>]
-    def predicates
-      block_given? ? each_predicate(&block) : map(&:predicate)
-    end
-
-    ##
-    # @return [Array<Value>]
-    def objects
-      block_given? ? each_object(&block) : map(&:object)
-    end
-
-    ##
-    # @param  [Statement, Array(Value)]
-    # @return [Graph]
-    def <<(statement)
-      @data << case statement
-        when Array     then Statement.new(*statement)
-        when Statement then statement
-        else statement
-      end
-      self
-    end
-
-    ##
-    # @return [URI]
-    def to_uri() uri end
-
-    ##
-    # @return [String]
-    def to_s
-      named? ? uri.to_s : "<>"
-    end
-  end
-end