rdf 0.0.5 → 0.0.6

data/README

@@ -42,7 +42,7 @@ Examples
 
 ### Reading N-Triples data
 
-    RDF::Reader::NTriples.open("spec/data/test.nt") do |reader|
+    RDF::NTriples::Reader.open("spec/data/test.nt") do |reader|
       reader.each_statement do |statement|
         puts statement.inspect
       end
@@ -55,47 +55,51 @@ Documentation
 
 ### RDF Objects
 
-* [RDF::Graph](http://rdf.rubyforge.org/RDF/Graph.html)
-* [RDF::Literal](http://rdf.rubyforge.org/RDF/Literal.html)
-* [RDF::Node](http://rdf.rubyforge.org/RDF/Node.html)
-* [RDF::Resource](http://rdf.rubyforge.org/RDF/Resource.html)
-* [RDF::Statement](http://rdf.rubyforge.org/RDF/Statement.html)
-* [RDF::URI](http://rdf.rubyforge.org/RDF/URI.html)
-* [RDF::Value](http://rdf.rubyforge.org/RDF/Value.html)
+* {RDF::Graph}
+* {RDF::Literal}
+* {RDF::Node}
+* {RDF::Resource}
+* {RDF::Statement}
+* {RDF::URI}
+* {RDF::Value}
 
 ### RDF Serialization
 
-* [RDF::Reader](http://rdf.rubyforge.org/RDF/Reader.html)
-* [RDF::Writer](http://rdf.rubyforge.org/RDF/Writer.html)
+* {RDF::Format}
+* {RDF::Reader}
+* {RDF::Writer}
 
-### RDF Vocabularies
+### RDF Serialization Formats
 
-* [RDF::CC](http://rdf.rubyforge.org/RDF/CC.html) - Creative Commons (CC)
-* [RDF::DC](http://rdf.rubyforge.org/RDF/DC.html) - Dublin Core (DC)
-* [RDF::DOAP](http://rdf.rubyforge.org/RDF/DOAP.html) - Description of a Project (DOAP)
-* [RDF::EXIF](http://rdf.rubyforge.org/RDF/EXIF.html) - Exchangeable Image File Format (EXIF)
-* [RDF::FOAF](http://rdf.rubyforge.org/RDF/FOAF.html) - Friend of a Friend (FOAF)
-* [RDF::HTTP](http://rdf.rubyforge.org/RDF/HTTP.html) - Hypertext Transfer Protocol (HTTP)
-* [RDF::OWL](http://rdf.rubyforge.org/RDF/OWL.html) - Web Ontology Language (OWL)
-* [RDF::RDFS](http://rdf.rubyforge.org/RDF/RDFS.html) - RDF Schema (RDFS)
-* [RDF::RSS](http://rdf.rubyforge.org/RDF/RSS.html) - RDF Site Summary (RSS)
-* [RDF::SIOC](http://rdf.rubyforge.org/RDF/SIOC.html) - Semantically-Interlinked Online Communities (SIOC)
-* [RDF::SKOS](http://rdf.rubyforge.org/RDF/SKOS.html) - Simple Knowledge Organization System (SKOS)
-* [RDF::WOT](http://rdf.rubyforge.org/RDF/WOT.html) - Web of Trust (WOT)
-* [RDF::XHTML](http://rdf.rubyforge.org/RDF/XHTML.html) - Extensible HyperText Markup Language (XHTML)
-* [RDF::XSD](http://rdf.rubyforge.org/RDF/XSD.html) - XML Schema (XSD)
+* {RDF::NTriples}
 
-Download
---------
+### RDF Storage
 
-To get a local working copy of the development repository, do:
+* {RDF::Repository}
 
-    % git clone git://github.com/bendiken/rdf.git
+### RDF Querying
 
-Alternatively, you can download the latest development version as a tarball
-as follows:
+* {RDF::Query}
+* {RDF::Query::Pattern}
+* {RDF::Query::Solution}
+* {RDF::Query::Variable}
 
-    % wget http://github.com/bendiken/rdf/tarball/master
+### RDF Vocabularies
+
+* {RDF::CC}    - Creative Commons (CC)
+* {RDF::DC}    - Dublin Core (DC)
+* {RDF::DOAP}  - Description of a Project (DOAP)
+* {RDF::EXIF}  - Exchangeable Image File Format (EXIF)
+* {RDF::FOAF}  - Friend of a Friend (FOAF)
+* {RDF::HTTP}  - Hypertext Transfer Protocol (HTTP)
+* {RDF::OWL}   - Web Ontology Language (OWL)
+* {RDF::RDFS}  - RDF Schema (RDFS)
+* {RDF::RSS}   - RDF Site Summary (RSS)
+* {RDF::SIOC}  - Semantically-Interlinked Online Communities (SIOC)
+* {RDF::SKOS}  - Simple Knowledge Organization System (SKOS)
+* {RDF::WOT}   - Web of Trust (WOT)
+* {RDF::XHTML} - Extensible HyperText Markup Language (XHTML)
+* {RDF::XSD}   - XML Schema (XSD)
 
 Dependencies
 ------------
@@ -110,6 +114,18 @@ official release from Gemcutter, do:
 
     % [sudo] gem install rdf
 
+Download
+--------
+
+To get a local working copy of the development repository, do:
+
+    % git clone git://github.com/bendiken/rdf.git
+
+Alternatively, you can download the latest development version as a tarball
+as follows:
+
+    % wget http://github.com/bendiken/rdf/tarball/master
+
 Resources
 ---------
 
@@ -122,6 +138,7 @@ Resources
 See also
 --------
 
+* [RDFS.rb](http://rdfs.rubyforge.org/)
 * [RDFize](http://rdfize.rubyforge.org/)
 * [RDFbus](http://rdfbus.rubyforge.org/)
 * [RDFcache](http://rdfcache.rubyforge.org/)

data/VERSION

@@ -1 +1 @@
-0.0.5
+0.0.6

data/lib/rdf.rb

@@ -11,12 +11,19 @@ module RDF
   autoload :Value,      'rdf/value'
 
   # RDF serialization
+  autoload :Format,     'rdf/format'
   autoload :Reader,     'rdf/reader'
   autoload :Writer,     'rdf/writer'
 
+  # RDF serialization formats
+  autoload :NTriples,   'rdf/ntriples'
+
   # RDF storage
   autoload :Repository, 'rdf/repository'
 
+  # RDF querying
+  autoload :Query,      'rdf/query'
+
   # RDF vocabularies
   autoload :Vocabulary, 'rdf/vocabulary'
   autoload :CC,         'rdf/vocabulary/cc'

data/lib/rdf/cli.rb

@@ -57,7 +57,7 @@ module RDF
     # @return [nil]
     def self.each_statement(*files, &block)
       files.each do |file|
-        RDF::Reader::NTriples.open(file) do |reader|
+        RDF::NTriples::Reader.open(file) do |reader|
           reader.each_statement(&block)
         end
       end

data/lib/rdf/format.rb

@@ -0,0 +1,95 @@
+module RDF
+  ##
+  # An RDF serialization format.
+  class Format
+    include Enumerable
+
+    ##
+    # Enumerates known RDF format classes.
+    #
+    # @yield  [klass]
+    # @yieldparam [Class]
+    def self.each(&block)
+      !block_given? ? @@subclasses : @@subclasses.each { |klass| yield klass } # FIXME: Enumerator
+    end
+
+    ##
+    # Returns the list of known MIME content types.
+    #
+    # @return [Hash{String => Array<Class>}]
+    def self.content_types
+      @@content_types
+    end
+
+    ##
+    # Returns the list of known file extensions.
+    #
+    # @return [Hash{Symbol => String}]
+    def self.file_extensions
+      @@file_extensions
+    end
+
+    ##
+    # @param  [Symbol] format
+    # @return [Class]
+    def self.for(format)
+      klass = case format.to_s.downcase.to_sym
+        when :ntriples then RDF::NTriples::Format
+        else nil # FIXME
+      end
+    end
+
+    ##
+    # @yield  [format]
+    # @yieldparam [Format]
+    def initialize(options = {}, &block)
+      @options = options
+
+      if block_given?
+        case block.arity
+          when 1 then block.call(self)
+          else instance_eval(&block)
+        end
+      end
+    end
+
+    protected
+
+      @@subclasses       = [] # @private
+      @@file_extensions  = {} # @private
+      @@content_types    = {} # @private
+      @@content_encoding = {} # @private
+
+      def self.inherited(child) # @private
+        @@subclasses << child
+        super
+      end
+
+      def self.require(library)
+        # TODO
+      end
+
+      def self.content_type(type, options = {})
+        @@content_types[type] ||= []
+        @@content_types[type] << self
+
+        if options[:extension]
+          extensions = [options[:extension]].flatten.map { |ext| ext.to_sym }
+          extensions.each { |ext| @@file_extensions[ext] = type }
+        end
+      end
+
+      def self.content_encoding(encoding)
+        @@content_encoding[self] = encoding.to_sym
+      end
+
+      def self.reader(klass)
+        # TODO
+      end
+
+      def self.writer(klass)
+        # TODO
+      end
+
+  end
+end

data/lib/rdf/graph.rb

@@ -25,6 +25,14 @@ module RDF
       end
     end
 
+    ##
+    # Returns `true`.
+    #
+    # @return [Boolean]
+    def graph?
+      true
+    end
+
     ##
     # @return [Boolean]
     def named?()   !unnamed? end

data/lib/rdf/literal.rb

@@ -1,6 +1,43 @@
 module RDF
   ##
   # An RDF literal.
+  #
+  # @example Creating a plain literal
+  #   value = RDF::Literal.new("Hello, world!")
+  #   value.plain?                                   #=> true
+  #
+  # @example Creating a language-tagged literal (1)
+  #   value = RDF::Literal.new("Hello!", :language => :en)
+  #   value.language?                                #=> true
+  #   value.language                                 #=> :en
+  #
+  # @example Creating a language-tagged literal (2)
+  #   RDF::Literal.new("Wazup?", :language => :"en-US")
+  #   RDF::Literal.new("Hej!",   :language => :sv)
+  #   RDF::Literal.new("¡Hola!", :language => :es)
+  #
+  # @example Creating an explicitly datatyped literal
+  #   value = RDF::Literal.new("2009-12-31", :datatype => RDF::XSD.date)
+  #   value.datatype?                                #=> true
+  #   value.datatype                                 #=> RDF::XSD.date
+  #
+  # @example Creating an implicitly datatyped literal
+  #   value = RDF::Literal.new(Date.today)
+  #   value.datatype?                                #=> true
+  #   value.datatype                                 #=> RDF::XSD.date
+  #
+  # @example Creating implicitly datatyped literals
+  #   RDF::Literal.new(false).datatype               #=> XSD.boolean
+  #   RDF::Literal.new(true).datatype                #=> XSD.boolean
+  #   RDF::Literal.new(123).datatype                 #=> XSD.int
+  #   RDF::Literal.new(9223372036854775807).datatype #=> XSD.long
+  #   RDF::Literal.new(3.1415).datatype              #=> XSD.double
+  #   RDF::Literal.new(Time.now).datatype            #=> XSD.dateTime
+  #   RDF::Literal.new(Date.new(2010)).datatype      #=> XSD.date
+  #   RDF::Literal.new(DateTime.new(2010)).datatype  #=> XSD.dateTime
+  #
+  # @see http://www.w3.org/TR/rdf-concepts/#section-Literals
+  # @see http://www.w3.org/TR/rdf-concepts/#section-Datatypes-intro
   class Literal < Value
     # @return [String] The normalized string representation of the value.
     attr_accessor :value
@@ -49,6 +86,14 @@ module RDF
       @value = @value.to_s
     end
 
+    ##
+    # Returns `true`.
+    #
+    # @return [Boolean]
+    def literal?
+      true
+    end
+
     ##
     # @return [Boolean]
     def eql?(other)
@@ -72,18 +117,38 @@ module RDF
     end
 
     ##
+    # Returns `true` if this is a plain literal.
+    #
     # @return [Boolean]
+    # @see http://www.w3.org/TR/rdf-concepts/#dfn-plain-literal
     def plain?
       language.nil? && datatype.nil?
     end
 
     ##
+    # Returns `true` if this is a language-tagged literal.
+    #
     # @return [Boolean]
-    def typed?
+    # @see http://www.w3.org/TR/rdf-concepts/#dfn-plain-literal
+    def language?
+      !language.nil?
+    end
+
+    ##
+    # Returns `true` if this is a datatyped literal.
+    #
+    # @return [Boolean]
+    # @see http://www.w3.org/TR/rdf-concepts/#dfn-typed-literal
+    def datatype?
       !datatype.nil?
     end
 
+    alias_method :typed?,     :datatype?
+    alias_method :datatyped?, :datatype?
+
     ##
+    # Returns a string representation of this literal.
+    #
     # @return [String]
     def to_s
       quoted = value # FIXME

data/lib/rdf/node.rb

@@ -1,29 +1,59 @@
 module RDF
   ##
   # An RDF blank node, also known as an unlabeled node.
+  #
+  # @example Creating a blank node with an implicit identifier
+  #   bnode = RDF::Node.new
+  #
+  # @example Creating a blank node with an UUID identifier (1)
+  #   require 'uuid'
+  #   bnode = RDF::Node.new(UUID.generate)
+  #
+  # @example Creating a blank node with an UUID identifier (2)
+  #   require 'uuidtools'
+  #   bnode = RDF::Node.new(UUIDTools::UUID.random_create)
+  #
+  # @see http://github.com/assaf/uuid
+  # @see http://uuidtools.rubyforge.org/
   class Node < Resource
     # @return [String]
     attr_accessor :id
 
     ##
-    # @param  [#to_s]
+    # @param  [#to_s] id
     def initialize(id = nil)
       @id = (id || object_id).to_s
     end
 
     ##
+    # Returns `true`.
+    #
     # @return [Boolean]
-    def anonymous?() true end
+    def node?
+      true
+    end
 
     ##
+    # Returns `true`.
+    #
     # @return [Boolean]
-    def labeled?()   !unlabeled? end
+    def anonymous?
+      true
+    end
+
+    alias_method :unlabeled?, :anonymous?
 
     ##
+    # Returns `false`.
+    #
     # @return [Boolean]
-    def unlabeled?() anonymous? end
+    def labeled?
+      !unlabeled?
+    end
 
     ##
+    # Returns a string representation of this blank node.
+    #
     # @return [String]
     def to_s
       "_:%s" % id.to_s

data/lib/rdf/ntriples.rb

@@ -0,0 +1,12 @@
+module RDF
+  ##
+  # N-Triples serialization format.
+  #
+  # @see http://www.w3.org/TR/rdf-testcases/#ntriples
+  # @see http://en.wikipedia.org/wiki/N-Triples
+  module NTriples
+    autoload :Format, 'rdf/ntriples/format'
+    autoload :Reader, 'rdf/ntriples/reader'
+    autoload :Writer, 'rdf/ntriples/writer'
+  end
+end

data/lib/rdf/ntriples/format.rb

@@ -0,0 +1,13 @@
+module RDF module NTriples
+  ##
+  # N-Triples format specification.
+  #
+  # @see http://www.w3.org/TR/rdf-testcases/#ntriples
+  class Format < RDF::Format
+    content_type     'text/plain', :extension => :nt
+    content_encoding 'ascii'
+
+    reader RDF::NTriples::Reader
+    writer RDF::NTriples::Format
+  end
+end end