rdf-raptor 0.1.0 → 0.2.0

data/README

@@ -6,6 +6,17 @@ This is an [RDF.rb][] plugin that adds support for parsing/serializing
 library.
 
 * <http://github.com/bendiken/rdf-raptor>
+* <http://lists.w3.org/Archives/Public/public-rdf-ruby/2010Apr/0003.html>
+
+Features
+--------
+
+* Requires the [Raptor][] library and utilities to be available.
+* Based on the [`rapper`][rapper] command-line utility bundled with Raptor.
+* Parses and serializes RDF data from/into the RDF/XML or Turtle formats.
+* Provides serialization format autodetection for RDF/XML and Turtle.
+* Compatible with any operating system supported by Raptor and Ruby.
+* Compatible with MRI 1.8.x, 1.9.x and JRuby (tested with JRuby 1.4).
 
 Examples
 --------
@@ -81,18 +92,31 @@ Documentation
 Dependencies
 ------------
 
-* [RDF.rb](http://rubygems.org/gems/rdf) (>= 0.1.3)
-* [Raptor](http://librdf.org/raptor/) (>= 1.4.21),
-  specifically the `rapper` binary
+* [RDF.rb](http://rubygems.org/gems/rdf) (>= 0.1.4)
+* [Raptor][] (>= 1.4.16), specifically the `rapper` binary
 
 Installation
 ------------
 
-The recommended installation method is via RubyGems. To install the latest
-official release, do:
+The recommended installation method is via [RubyGems](http://rubygems.org/).
+To install the latest official release of the `RDF::Raptor` gem, do:
 
     % [sudo] gem install rdf-raptor
 
+To install the required [Raptor][] command-line tools themselves, look for a
+`raptor` or `raptor-utils` package in your platform's package management
+system. Here follow installation instructions for the Mac and the most
+common Linux and BSD distributions:
+
+    % [sudo] port install raptor             # Mac OS X with MacPorts
+    % [sudo] fink install raptor-bin         # Mac OS X with Fink
+    % [sudo] aptitude install raptor-utils   # Ubuntu / Debian
+    % [sudo] yum install raptor              # Fedora / CentOS / RHEL
+    % [sudo] zypper install raptor           # openSUSE
+    % [sudo] emerge raptor                   # Gentoo Linux
+    % [sudo] pkg_add -r raptor               # FreeBSD
+    % [sudo] pkg_add raptor                  # OpenBSD / NetBSD
+
 Download
 --------
 
@@ -120,3 +144,4 @@ information, see <http://unlicense.org/> or the accompanying UNLICENSE file.
 [RDF/XML]:  http://www.w3.org/TR/REC-rdf-syntax/
 [Turtle]:   http://en.wikipedia.org/wiki/Turtle_(syntax)
 [Raptor]:   http://librdf.org/raptor/
+[rapper]:   http://librdf.org/raptor/rapper.html

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/lib/rdf/raptor.rb

@@ -37,12 +37,13 @@ module RDF
   #
   # @author [Arto Bendiken](http://ar.to/)
   module Raptor
+    ENGINE    = (ENV['RDF_RAPTOR_ENGINE'] || :cli).to_sym unless const_defined?(:ENGINE)
+    LIBRAPTOR = ENV['RDF_RAPTOR_LIBPATH'] || 'libraptor'  unless const_defined?(:LIBRAPTOR)
+    RAPPER    = ENV['RDF_RAPTOR_BINPATH'] || 'rapper'     unless const_defined?(:RAPPER)
+
     require 'rdf/raptor/version'
-    require 'rdf/raptor/format'
-    require 'rdf/raptor/reader'
-    require 'rdf/raptor/writer'
-    require 'rdf/raptor/rdfxml'
-    require 'rdf/raptor/turtle'
+    require 'rdf/raptor/cli'
+    require 'rdf/raptor/ffi' if ENGINE == :ffi
 
     ##
     # Returns `true` if the `rapper` binary is available.
@@ -64,9 +65,44 @@ module RDF
     #
     # @return [String]
     def self.version
-      if `rapper --version 2>/dev/null` =~ /^(\d+)\.(\d+)\.(\d+)/
+      if `#{RAPPER} --version 2>/dev/null` =~ /^(\d+)\.(\d+)\.(\d+)/
         [$1, $2, $3].join('.')
       end
     end
+
+    ##
+    # Format base class.
+    class Format < RDF::Format
+      ##
+      # @overload rapper_format
+      #
+      # @overload rapper_format(format)
+      #   @param  [Symbol] format
+      #
+      # @return [void]
+      def self.rapper_format(format = nil)
+        unless format
+          @rapper_format
+        else
+          @rapper_format = format
+        end
+      end
+    end
+
+    ##
+    # Reader base class.
+    class Reader < RDF::Reader
+      include RDF::Raptor::CLI::Reader if ENGINE == :cli
+      include RDF::Raptor::FFI::Reader if ENGINE == :ffi
+    end
+
+    ##
+    # Writer base class.
+    class Writer < RDF::Writer
+      include RDF::Raptor::CLI::Writer
+    end
+
+    require 'rdf/raptor/rdfxml'
+    require 'rdf/raptor/turtle'
   end # module Raptor
 end # module RDF

data/lib/rdf/raptor/cli.rb

@@ -0,0 +1,102 @@
+module RDF::Raptor
+  ##
+  # A command-line interface to Raptor's `rapper` utility.
+  module CLI
+    ##
+    # Reader implementation.
+    module Reader
+      ##
+      # @param  [IO, File, RDF::URI, String] input
+      # @param  [Hash{Symbol => Object}]     options
+      # @option (options) [String, #to_s]    :base_uri ("file:///dev/stdin")
+      # @yield  [reader]
+      # @yieldparam [RDF::Reader] reader
+      def initialize(input = $stdin, options = {}, &block)
+        raise RDF::ReaderError.new("`rapper` binary not found") unless RDF::Raptor.available?
+
+        format = self.class.format.rapper_format
+        case input
+          when RDF::URI, %r(^(file|http|https|ftp)://)
+            @command = "#{RAPPER} -q -i #{format} -o ntriples #{input}"
+            @command << " #{options[:base_uri]}" if options.has_key?(:base_uri)
+            @rapper  = IO.popen(@command, 'rb')
+          when File
+            @command = "#{RAPPER} -q -i #{format} -o ntriples #{File.expand_path(input.path)}"
+            @command << " #{options[:base_uri]}" if options.has_key?(:base_uri)
+            @rapper  = IO.popen(@command, 'rb')
+          else # IO, String
+            @command = "#{RAPPER} -q -i #{format} -o ntriples file:///dev/stdin"
+            @command << " #{options[:base_uri]}" if options.has_key?(:base_uri)
+            @rapper  = IO.popen(@command, 'rb+')
+            @rapper.write(input.respond_to?(:read) ? input.read : input.to_s)
+            @rapper.close_write
+        end
+        @reader = RDF::NTriples::Reader.new(@rapper, options, &block)
+      end
+
+      protected
+
+      ##
+      # @return [Array]
+      def read_triple
+        @reader.read_triple
+      end
+    end
+
+    ##
+    # Writer implementation.
+    module Writer
+      ##
+      # @param  [IO, File]               output
+      # @param  [Hash{Symbol => Object}] options
+      # @yield  [writer]
+      # @yieldparam [RDF::Writer] writer
+      def initialize(output = $stdout, options = {}, &block)
+        raise RDF::WriterError.new("`rapper` binary not found") unless RDF::Raptor.available?
+
+        format = self.class.format.rapper_format
+        case output
+          when File, IO
+            @command = "#{RAPPER} -q -i ntriples -o #{format} file:///dev/stdin"
+            @command << " #{options[:base_uri]}" if options.has_key?(:base_uri)
+            @rapper  = IO.popen(@command, 'rb+')
+          else
+            raise ArgumentError.new("unsupported output type: #{output.inspect}")
+        end
+        @writer = RDF::NTriples::Writer.new(@rapper, options)
+        super(output, options, &block)
+      end
+
+      protected
+
+      ##
+      # @return [void]
+      def write_prologue
+        super
+      end
+
+      ##
+      # @param  [RDF::Resource] subject
+      # @param  [RDF::URI]      predicate
+      # @param  [RDF::Value]    object
+      # @return [void]
+      def write_triple(subject, predicate, object)
+        @writer.write_triple(subject, predicate, object)
+      end
+
+      ##
+      # @return [void]
+      def write_epilogue
+        @rapper.close_write
+        begin
+          chunk_size = @options[:chunk_size] || 4096 # bytes
+          loop do
+            @output.write(@rapper.readpartial(chunk_size))
+          end
+        rescue EOFError => e
+          # we're all done
+        end
+      end
+    end
+  end
+end

data/lib/rdf/raptor/ffi.rb

@@ -0,0 +1,281 @@
+require 'ffi'
+
+module RDF::Raptor
+  ##
+  # A foreign-function interface (FFI) to `libraptor`.
+  #
+  # @see http://librdf.org/raptor/api/
+  # @see http://librdf.org/raptor/libraptor.html
+  module FFI
+    ##
+    # Reader implementation.
+    module Reader
+      ##
+      # @param  [IO, File, RDF::URI, String] input
+      # @param  [Hash{Symbol => Object}]     options
+      # @option (options) [String, #to_s]    :base_uri ("file:///dev/stdin")
+      # @yield  [reader]
+      # @yieldparam [RDF::Reader] reader
+      def initialize(input = $stdin, options = {}, &block)
+        @format = self.class.format.rapper_format
+        super
+      end
+
+      ##
+      # @yield [statement]
+      # @yieldparam [RDF::Statement] statement
+      def each_statement(&block)
+        each_triple do |triple|
+          block.call(RDF::Statement.new(*triple))
+        end
+      end
+
+      ##
+      # @yield [triple]
+      # @yieldparam [Array(RDF::Resource, RDF::URI, RDF::Value)] triple
+      def each_triple(&block)
+        @parser = Proc.new do |user_data, statement|
+          triple = V1_4::Statement.new(statement).to_triple
+          block.call(triple)
+        end
+
+        V1_4.with_world do |world|
+          V1_4.with_parser(:name => @format) do |parser|
+            V1_4.raptor_set_statement_handler(parser, nil, @parser)
+            case @input
+              when RDF::URI, %r(^(file|http|https|ftp)://)
+                begin
+                  data_url = V1_4.raptor_new_uri(@input.to_s)
+                  base_uri = @options.has_key?(:base_uri) ? V1_4.raptor_new_uri(@options[:base_uri].to_s) : nil
+                  unless (result = V1_4.raptor_parse_uri(parser, data_url, base_uri)).zero?
+                    # TODO: error handling
+                  end
+                ensure
+                  V1_4.raptor_free_uri(base_uri) if base_uri
+                  V1_4.raptor_free_uri(data_url) if data_url
+                end
+
+              when File
+                begin
+                  data_url = V1_4.raptor_new_uri("file://#{File.expand_path(@input.path)}")
+                  base_uri = @options.has_key?(:base_uri) ? V1_4.raptor_new_uri(@options[:base_uri].to_s) : nil
+                  unless (result = V1_4.raptor_parse_file(parser, data_url, base_uri)).zero?
+                    # TODO: error handling
+                  end
+                ensure
+                  V1_4.raptor_free_uri(base_uri) if base_uri
+                  V1_4.raptor_free_uri(data_url) if data_url
+                end
+
+              else # IO, String
+                base_uri = (@options[:base_uri] || 'file:///dev/stdin').to_s
+                unless (result = V1_4.raptor_start_parse(parser, base_uri)).zero?
+                  # TODO: error handling
+                end
+                # TODO: read in chunks instead of everything in one go:
+                unless (result = V1_4.raptor_parse_chunk(parser, buffer = @input.read, buffer.size, 0)).zero?
+                  # TODO: error handling
+                end
+                V1_4.raptor_parse_chunk(parser, nil, 0, 1) # EOF
+            end
+          end
+        end
+
+        @parser = nil
+      end
+
+      alias_method :each, :each_statement
+    end
+
+    ##
+    # Helper methods for FFI modules.
+    module Base
+      def define_pointer(name)
+        self.class.send(:define_method, name) { :pointer }
+      end
+    end
+
+    ##
+    # A foreign-function interface (FFI) to `libraptor` 1.4.x.
+    #
+    # @see http://librdf.org/raptor/libraptor.html
+    module V1_4
+      ##
+      # @param  [Hash{Symbol => Object}] options
+      # @option (options) [Boolean] :init (true)
+      # @yield  [world]
+      # @yieldparam [FFI::Pointer] world
+      # @return [void]
+      def self.with_world(options = {}, &block)
+        options = {:init => true}.merge(options)
+        begin
+          raptor_init if options[:init]
+          raptor_world_open(world = raptor_new_world)
+          block.call(world)
+        ensure
+          raptor_free_world(world) if world
+          raptor_finish if options[:init]
+        end
+      end
+
+      ##
+      # @param  [Hash{Symbol => Object}] options
+      # @option (options) [String, #to_s] :name (:rdfxml)
+      # @yield  [parser]
+      # @yieldparam [FFI::Pointer] parser
+      # @return [void]
+      def self.with_parser(options = {}, &block)
+        begin
+          parser = raptor_new_parser((options[:name] || :rdfxml).to_s)
+          block.call(parser)
+        ensure
+          raptor_free_parser(parser) if parser
+        end
+      end
+
+      extend Base
+      extend ::FFI::Library
+      ffi_lib LIBRAPTOR
+
+      # TODO: Ideally this would be an enum, but the JRuby FFI (as of
+      # version 1.4.0) has problems with enums as part of structs:
+      #   `Unknown field type: #<FFI::Enum> (ArgumentError)`
+      RAPTOR_IDENTIFIER_TYPE_RESOURCE  = 1
+      RAPTOR_IDENTIFIER_TYPE_ANONYMOUS = 2
+      RAPTOR_IDENTIFIER_TYPE_LITERAL   = 5
+
+      # @see http://librdf.org/raptor/api/raptor-section-triples.html
+      class Statement < ::FFI::Struct
+        layout :subject, :pointer,
+               :subject_type, :int,
+               :predicate, :pointer,
+               :predicate_type, :int,
+               :object, :pointer,
+               :object_type, :int,
+               :object_literal_datatype, :pointer,
+               :object_literal_language, :string
+
+        ##
+        # @return [RDF::Resource]
+        def subject
+          @subject ||= case self[:subject_type]
+            when RAPTOR_IDENTIFIER_TYPE_RESOURCE
+              RDF::URI.new(V1_4.raptor_uri_to_string(self[:subject]))
+            when RAPTOR_IDENTIFIER_TYPE_ANONYMOUS
+              RDF::Node.new(self[:subject].read_string)
+          end
+        end
+
+        ##
+        # @return [String]
+        def subject_as_string
+          V1_4.raptor_statement_part_as_string(
+            self[:subject],
+            self[:subject_type],
+            nil, nil)
+        end
+
+        ##
+        # @return [RDF::URI]
+        def predicate
+          @predicate ||= case self[:predicate_type]
+            when RAPTOR_IDENTIFIER_TYPE_RESOURCE
+              RDF::URI.new(V1_4.raptor_uri_to_string(self[:predicate]))
+          end
+        end
+
+        ##
+        # @return [String]
+        def predicate_as_string
+          V1_4.raptor_statement_part_as_string(
+            self[:predicate],
+            self[:predicate_type],
+            nil, nil)
+        end
+
+        ##
+        # @return [RDF::Value]
+        def object
+          @object ||= case self[:object_type]
+            when RAPTOR_IDENTIFIER_TYPE_RESOURCE
+              RDF::URI.new(V1_4.raptor_uri_to_string(self[:object]))
+            when RAPTOR_IDENTIFIER_TYPE_ANONYMOUS
+              RDF::Node.new(self[:object].read_string)
+            when RAPTOR_IDENTIFIER_TYPE_LITERAL
+              case
+                when self[:object_literal_language]
+                  RDF::Literal.new(self[:object].read_string, :language => self[:object_literal_language])
+                when self[:object_literal_datatype] && !self[:object_literal_datatype].null?
+                  RDF::Literal.new(self[:object].read_string, :datatype => V1_4.raptor_uri_to_string(self[:object_literal_datatype]))
+                else
+                  RDF::Literal.new(self[:object].read_string)
+              end
+          end
+        end
+
+        ##
+        # @return [String]
+        def object_as_string
+          V1_4.raptor_statement_part_as_string(
+            self[:object],
+            self[:object_type],
+            self[:object_literal_datatype],
+            self[:object_literal_language])
+        end
+
+        ##
+        # @return [Array(RDF::Resource, RDF::URI, RDF::Value)]
+        def to_triple
+          [subject, predicate, object]
+        end
+
+        ##
+        # @return [Array(RDF::Resource, RDF::URI, RDF::Value, nil)]
+        def to_quad
+          [subject, predicate, object, nil]
+        end
+      end
+
+      # @see http://librdf.org/raptor/api/tutorial-initialising-finishing.html
+      attach_function :raptor_init, [], :void
+      attach_function :raptor_finish, [], :void
+
+      # @see http://librdf.org/raptor/api/raptor-section-world.html
+      define_pointer  :raptor_world
+      attach_function :raptor_new_world, [], raptor_world
+      attach_function :raptor_world_open, [raptor_world], :int
+      attach_function :raptor_free_world, [raptor_world], :void
+
+      # @see http://librdf.org/raptor/api/raptor-section-uri.html
+      define_pointer  :raptor_uri
+      attach_function :raptor_new_uri, [:string], raptor_uri
+      attach_function :raptor_uri_as_string, [raptor_uri], :string
+      attach_function :raptor_uri_to_string, [raptor_uri], :string
+      attach_function :raptor_uri_print, [raptor_uri, :pointer], :void
+      attach_function :raptor_free_uri, [raptor_uri], :void
+
+      # @see http://librdf.org/raptor/api/raptor-section-triples.html
+      define_pointer  :raptor_statement
+      attach_function :raptor_statement_compare, [raptor_statement, raptor_statement], :int
+      attach_function :raptor_print_statement, [raptor_statement, :pointer], :void
+      attach_function :raptor_print_statement_as_ntriples, [:pointer, :pointer], :void
+      attach_function :raptor_statement_part_as_string, [:pointer, :int, raptor_uri, :string], :string
+
+      # @see http://librdf.org/raptor/api/raptor-section-parser.html
+      callback :raptor_statement_handler, [:pointer, raptor_statement], :void
+      define_pointer  :raptor_parser
+      attach_function :raptor_new_parser, [:string], raptor_parser
+      attach_function :raptor_set_statement_handler, [raptor_parser, :pointer, :raptor_statement_handler], :void
+      attach_function :raptor_parse_file, [raptor_parser, raptor_uri, raptor_uri], :int
+      attach_function :raptor_parse_file_stream, [raptor_parser, :pointer, :string, raptor_uri], :int
+      attach_function :raptor_parse_uri, [raptor_parser, raptor_uri, raptor_uri], :int
+      attach_function :raptor_start_parse, [raptor_parser, :string], :int
+      attach_function :raptor_parse_chunk, [raptor_parser, :string, :size_t, :int], :int
+      attach_function :raptor_get_mime_type, [raptor_parser], :string
+      attach_function :raptor_set_parser_strict, [raptor_parser, :int], :void
+      attach_function :raptor_get_need_base_uri, [raptor_parser], :int
+      attach_function :raptor_parser_get_world, [raptor_parser], raptor_world
+      attach_function :raptor_free_parser, [raptor_parser], :void
+    end
+  end
+end

data/lib/rdf/raptor/version.rb

@@ -1,7 +1,7 @@
 module RDF; module Raptor
   module VERSION
     MAJOR = 0
-    MINOR = 1
+    MINOR = 2
     TINY  = 0
     EXTRA = nil
 

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Arto Bendiken
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-02 00:00:00 +02:00
+date: 2010-04-04 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -27,8 +27,8 @@ dependencies:
         segments: 
         - 0
         - 1
-        - 0
-        version: 0.1.0
+        - 4
+        version: 0.1.4
   type: :development
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
@@ -69,8 +69,8 @@ dependencies:
         segments: 
         - 0
         - 1
-        - 3
-        version: 0.1.3
+        - 4
+        version: 0.1.4
   type: :runtime
   version_requirements: *id004
 description: RDF.rb plugin for parsing/serializing RDF/XML and Turtle data using the Raptor RDF Parser library.
@@ -86,12 +86,11 @@ files:
 - README
 - UNLICENSE
 - VERSION
-- lib/rdf/raptor/format.rb
+- lib/rdf/raptor/cli.rb
+- lib/rdf/raptor/ffi.rb
 - lib/rdf/raptor/rdfxml.rb
-- lib/rdf/raptor/reader.rb
 - lib/rdf/raptor/turtle.rb
 - lib/rdf/raptor/version.rb
-- lib/rdf/raptor/writer.rb
 - lib/rdf/raptor.rb
 has_rdoc: false
 homepage: http://rdf.rubyforge.org/
@@ -119,7 +118,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       - 0
       version: "0"
 requirements: 
-- Raptor (>= 1.4.21)
+- Raptor (>= 1.4.16)
 rubyforge_project: rdf
 rubygems_version: 1.3.6
 signing_key: 

data/lib/rdf/raptor/format.rb

@@ -1,20 +0,0 @@
-module RDF::Raptor
-  ##
-  # Format base class.
-  class Format < RDF::Format
-    ##
-    # @overload rapper_format
-    #
-    # @overload rapper_format(format)
-    #   @param  [Symbol] format
-    #
-    # @return [void]
-    def self.rapper_format(format = nil)
-      unless format
-        @rapper_format
-      else
-        @rapper_format = format
-      end
-    end
-  end
-end

data/lib/rdf/raptor/reader.rb

@@ -1,38 +0,0 @@
-module RDF::Raptor
-  ##
-  # Reader base class.
-  class Reader < RDF::Reader
-    ##
-    # @param  [IO, File, RDF::URI, String] input
-    # @param  [Hash{Symbol => Object}]     options
-    # @yield  [reader]
-    # @yieldparam [RDF::Reader] reader
-    def initialize(input = $stdin, options = {}, &block)
-      raise RDF::ReaderError.new("`rapper` binary not found") unless RDF::Raptor.available?
-
-      format = self.class.format.rapper_format
-      case input
-        when RDF::URI, %r(^(file|http|https|ftp)://)
-          @command = "rapper -q -i #{format} -o ntriples #{input}"
-          @rapper  = IO.popen(@command, 'rb')
-        when File
-          @command = "rapper -q -i #{format} -o ntriples #{File.expand_path(input.path)}"
-          @rapper  = IO.popen(@command, 'rb')
-        else # IO, String
-          @command = "rapper -q -i #{format} -o ntriples file:///dev/stdin"
-          @rapper  = IO.popen(@command, 'rb+')
-          @rapper.write(input.respond_to?(:read) ? input.read : input.to_s)
-          @rapper.close_write
-      end
-      @reader = RDF::NTriples::Reader.new(@rapper, options, &block)
-    end
-
-    protected
-
-    ##
-    # @return [Array]
-    def read_triple
-      @reader.read_triple
-    end
-  end
-end

data/lib/rdf/raptor/writer.rb

@@ -1,69 +0,0 @@
-module RDF::Raptor
-  ##
-  # Writer base class.
-  class Writer < RDF::Writer
-    ##
-    # @param  [IO, File]               output
-    # @param  [Hash{Symbol => Object}] options
-    # @yield  [writer]
-    # @yieldparam [RDF::Writer] writer
-    def initialize(output = $stdout, options = {}, &block)
-      raise RDF::WriterError.new("`rapper` binary not found") unless RDF::Raptor.available?
-
-      format = self.class.format.rapper_format
-      case output
-        when File, IO
-          @command = "rapper -q -i ntriples -o #{format} file:///dev/stdin"
-          @command << " #{options[:base_uri]}" if options.has_key?(:base_uri)
-          @rapper  = IO.popen(@command, 'rb+')
-        else
-          raise ArgumentError.new("unsupported output type: #{output.inspect}")
-      end
-      @writer = RDF::NTriples::Writer.new(@rapper, options)
-      super(output, options, &block)
-    end
-
-    protected
-
-    ##
-    # @return [void]
-    def write_prologue
-      super
-    end
-
-    ##
-    # @param  [RDF::Resource] subject
-    # @param  [RDF::URI]      predicate
-    # @param  [RDF::Value]    object
-    # @return [void]
-    def write_triple(subject, predicate, object)
-      @writer.write_triple(subject, predicate, object)
-    end
-
-    ##
-    # @return [void]
-    def write_epilogue
-      @rapper.close_write
-      begin
-        chunk_size = @options[:chunk_size] || 4096 # bytes
-        loop do
-          @output.write(@rapper.readpartial(chunk_size))
-        end
-      rescue EOFError => e
-        # we're all done
-      end
-    end
-
-    ##
-    # @todo Remove this once RDF.rb 0.1.4 is released.
-    # @private
-    def self.format(klass = nil)
-      if klass.nil?
-        Format.each do |format|
-          return format if format.writer == self
-        end
-        return nil # not found
-      end
-    end
-  end
-end