rdf 0.0.3 → 0.0.4

data/README

@@ -53,6 +53,38 @@ Documentation
 
 * <http://rdf.rubyforge.org/>
 
+### 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 Serialization
+
+* [RDF::Reader](http://rdf.rubyforge.org/RDF/Reader.html)
+* [RDF::Writer](http://rdf.rubyforge.org/RDF/Writer.html)
+
+### RDF Vocabularies
+
+* [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)
+
 Download
 --------
 

data/VERSION

@@ -1 +1 @@
-0.0.3
+0.0.4

data/bin/rdf

@@ -1,31 +1,22 @@
-#!/usr/bin/env ruby -rubygems
+#!/usr/bin/env ruby
 $:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
-require 'rdf'
+require 'rdf/cli'
 
-abort "Usage: #{File.basename($0)} command [args...]" if ARGV.empty?
-
-module RDF
-  class CLI
-    def count(*files)
-      count = 0
-      files.each do |file|
-        RDF::Reader::NTriples.open(file) do |reader|
-          reader.each do |statement|
-            count += 1
-          end
-        end
-      end
-      puts count
-    end
-
-    def query(*args)
-      # TODO
-    end
-
-    def method_missing(command, *args, &block)
-      abort "#{File.basename($0)}: unknown command `#{command}'"
-    end
+options = RDF::CLI.options do
+  self.banner = "Usage: #{RDF::CLI.basename} [options] command [args...]"
+  self.on('-d', '--debug',   'Enable debug output for troubleshooting.') do
+    $DEBUG = true
+  end
+  self.on('-v', '--verbose', 'Enable verbose output. May be given more than once.') do
+    $VERBOSE = true
+  end
+  self.on('-V', '--version', 'Display the RDF.rb version and exit.') do
+    puts RDF::VERSION; exit
   end
 end
 
-RDF::CLI.new.send(ARGV.shift, *ARGV)
+abort options.banner if ARGV.empty?
+
+unless RDF::CLI.exec_command(command = ARGV.shift, *ARGV)
+  abort "#{File.basename($0)}: unknown command `#{command}'"
+end

data/bin/rdf-count

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+require 'rdf/cli'
+
+abort "Usage: #{RDF::CLI.basename} [files...]" if ARGV.empty?
+
+count = 0
+RDF::CLI.each_statement(*ARGV) do |statement|
+  count += 1
+end
+puts count

data/bin/rdf-lengths

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+require 'rdf/cli'
+
+abort "Usage: #{RDF::CLI.basename} [files...]" if ARGV.empty?
+
+RDF::CLI.each_statement(*ARGV) do |statement|
+  puts statement.to_s.size
+end

data/bin/rdf-objects

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+require 'rdf/cli'
+
+abort "Usage: #{RDF::CLI.basename} [files...]" if ARGV.empty?
+
+RDF::CLI.each_statement(*ARGV) do |statement|
+  puts statement.object
+end

data/bin/rdf-predicates

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+require 'rdf/cli'
+
+abort "Usage: #{RDF::CLI.basename} [files...]" if ARGV.empty?
+
+RDF::CLI.each_statement(*ARGV) do |statement|
+  puts statement.predicate
+end

data/bin/rdf-subjects

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+require 'rdf/cli'
+
+abort "Usage: #{RDF::CLI.basename} [files...]" if ARGV.empty?
+
+RDF::CLI.each_statement(*ARGV) do |statement|
+  puts statement.subject
+end

data/lib/df.rb

@@ -0,0 +1 @@
+require 'rdf'

data/lib/rdf.rb

@@ -1,11 +1,21 @@
 require 'rdf/version'
 
 module RDF
-  autoload :Reader,     'rdf/reader'
+  # RDF objects
+  autoload :Graph,      'rdf/graph'
+  autoload :Literal,    'rdf/literal'
+  autoload :Node,       'rdf/node'
+  autoload :Resource,   'rdf/resource'
   autoload :Statement,  'rdf/statement'
   autoload :URI,        'rdf/uri'
-  autoload :Vocabulary, 'rdf/vocabulary'
+  autoload :Value,      'rdf/value'
+
+  # RDF serialization
+  autoload :Reader,     'rdf/reader'
+  autoload :Writer,     'rdf/writer'
 
+  # RDF vocabularies
+  autoload :Vocabulary, 'rdf/vocabulary'
   autoload :CC,         'rdf/vocabulary/cc'
   autoload :DC,         'rdf/vocabulary/dc'
   autoload :DOAP,       'rdf/vocabulary/doap'
@@ -21,14 +31,24 @@ module RDF
   autoload :XHTML,      'rdf/vocabulary/xhtml'
   autoload :XSD,        'rdf/vocabulary/xsd'
 
+  ##
+  # @return [String] uri
+  # @return [Class]
   def self.Vocabulary(uri)
     Vocabulary.create(uri)
   end
 
+  ##
+  # @return [#to_s] property
+  # @return [URI]
   def self.[](property)
     RDF::URI.parse([to_s, property.to_s].join)
   end
 
+  ##
+  # @param  [Symbol] property
+  # @return [URI]
+  # @raise  [NoMethodError]
   def self.method_missing(property, *args, &block)
     if args.empty?
       self[property]
@@ -37,6 +57,15 @@ module RDF
     end
   end
 
-  def self.to_uri() RDF::URI.parse(to_s) end
-  def self.to_s()   "http://www.w3.org/1999/02/22-rdf-syntax-ns#" end
+  ##
+  # @return [URI]
+  def self.to_uri
+    RDF::URI.parse(to_s)
+  end
+
+  ##
+  # @return [String]
+  def self.to_s # FIXME
+    "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+  end
 end

data/lib/rdf/cli.rb

@@ -0,0 +1,73 @@
+require 'rdf'
+require 'optparse'
+
+module RDF
+  class CLI
+    ##
+    # @return [String]
+    def self.basename() File.basename($0) end
+
+    ##
+    # @yield  [options]
+    # @yieldparam [OptionParser]
+    # @return [OptionParser]
+    def self.options(&block)
+      options = OptionParser.new
+
+      if block_given?
+        case block.arity
+          when 1 then block.call(options)
+          else options.instance_eval(&block)
+        end
+      end
+
+      begin
+        options.parse!
+      rescue OptionParser::InvalidOption => e
+        abort e
+      end
+
+      options
+    end
+
+    ##
+    # @param  [String] command
+    # @param  [Array<String>] args
+    # @return [Boolean]
+    def self.exec_command(command, *args)
+      if binary = RDF::CLI.find_binary(command)
+        exec(binary, *args)
+      else
+        false
+      end
+    end
+
+    ##
+    # @param  [String] command
+    # @return [String, nil]
+    def self.find_binary(command)
+      binary = File.join(File.dirname(__FILE__), '..', '..', 'bin', 'rdf-' + command)
+      File.exists?(binary) ? binary : nil
+    end
+
+    ##
+    # @param  [Array<String>] files
+    # @yield  [statement]
+    # @yieldparam [Statement]
+    # @return [nil]
+    def self.each_statement(*files, &block)
+      files.each do |file|
+        RDF::Reader::NTriples.open(file) do |reader|
+          reader.each_statement(&block)
+        end
+      end
+    end
+
+    ##
+    # @param  [String] msg
+    # @return [void]
+    def self.abort(msg)
+      Kernel.abort "#{basename}: #{msg}"
+    end
+  end
+end

data/lib/rdf/graph.rb

@@ -0,0 +1,189 @@
+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
+
+    ##
+    # @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>]
+    def triples(&block)
+      block_given? ? each_triple(&block) : map { |statement| statement.to_triple }
+    end
+
+    ##
+    # @return [Array<Array>]
+    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]
+    # @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