rdf-raptor 2.2.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: e4024c120a6e8446c7005d1fe0dd26ff2324217a
-  data.tar.gz: eb27b27c8569b47fcb9f8a9cf2ceddb043f3cae3
+SHA256:
+  metadata.gz: dbcabda9177f086bc3b3ace9ccf55b554bef4697a3dd162d97ab626fde5da8a0
+  data.tar.gz: 27077358ddb590b9d7a8bd1b03374d0865bce291bdf056f079d168f259b50fb8
 SHA512:
-  metadata.gz: 066e90c8325d4a366203eb172a340a2427b95ccddb8faafd369356d3b0436fe4e9b99db42236fd3aae06cd2769a74d5e21fb2dcefce97c043a7dbaa10bdf6db1
-  data.tar.gz: 219ef70aac776f72b92dbb560b8dedca56baa71193208a228c12ce312d18417c701aa55ccccf425069c827651ee720a3b8508d97d14827b6f437cc1ee3252e89
+  metadata.gz: 77adec7f207278ffabc61a176f8f987cf8f23eb17f0591d37ed9fb9c2952ed5a8a5a7e7609d8d400099ca9c738a51644cb6e38eddb1690203cd83336f21716ca
+  data.tar.gz: 8ffd16a4a230445c5985a0a1dfa0410dc2f11a1697c24d0d4e51a9565b00adcc320be61939896d9a5c83c956c46946249659add57c28b7a05c6819d302362471

data/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# How to contribute
+
+Community contributions are essential for keeping Ruby RDF great. We want to keep it as easy as possible to contribute changes that get things working in your environment. There are a few guidelines that we need contributors to follow so that we can have a chance of keeping on top of things.
+
+## Development
+
+This repository uses [Git Flow](https://github.com/nvie/gitflow) to manage development and release activity. All submissions _must_ be on a feature branch based on the _develop_ branch to ease staging and integration.
+
+* create or respond to an issue on the [Github Repository](http://github.com/ruby-rdf/rdf-raptor/issues)
+* Fork and clone the repo:
+  `git clone git@github.com:your-username/rdf-raptor.git`
+* Install bundle:
+  `bundle install`
+* Create tests in RSpec and make sure you achieve at least 90% code coverage for the feature your adding or behavior being modified.
+* Push to your fork and [submit a pull request][pr].
+
+## Do's and Dont's
+* Do your best to adhere to the existing coding conventions and idioms.
+* Don't use hard tabs, and don't leave trailing whitespace on any line.
+  Before committing, run `git diff --check` to make sure of this.
+* Do document every method you add using [YARD][] annotations. Read the
+  [tutorial][YARD-GS] or just look at the existing code for examples.
+* Don't touch the `.gemspec` or `VERSION` files. If you need to change them,
+  do so on your private branch only.
+* Do feel free to add yourself to the `CREDITS` file and the
+  corresponding list in the the `README`. Alphabetical order applies.
+* Don't touch the `AUTHORS` file. If your contributions are significant
+  enough, be assured we will eventually add you in there.
+* Do note that in order for us to merge any non-trivial changes (as a rule
+  of thumb, additions larger than about 15 lines of code), we need an
+  explicit [public domain dedication][PDD] on record from you.
+
+[YARD]:    http://yardoc.org/
+[YARD-GS]: http://rubydoc.info/docs/yard/file/docs/GettingStarted.md
+[PDD]:     http://lists.w3.org/Archives/Public/public-rdf-ruby/2010May/0013.html
+[pr]:      https://github.com/ruby-rdf/rdf-raptor/compare/

data/README.md

@@ -0,0 +1,222 @@
+Raptor RDF Extension for RDF.rb
+===================================
+
+This is an [RDF.rb][] extension that adds support for parsing/serializing [NTriples][],
+[RDF/XML][], [Turtle][], [RDFa][], and [Graphviz][] data using the [Raptor RDF Parser][Raptor]
+library.
+
+* <https://github.com/ruby-rdf/rdf-raptor>
+* <http://blog.datagraph.org/2010/04/parsing-rdf-with-ruby>
+
+[![Gem Version](https://badge.fury.io/rb/rdf-raptor.png)](http://badge.fury.io/rb/rdf-raptor)
+[![Build Status](https://travis-ci.org/ruby-rdf/rdf-raptor.png?branch=master)](http://travis-ci.org/ruby-rdf/rdf-raptor)
+
+Features
+--------
+
+* Uses the fast [Raptor][] C library.
+* Parses and serializes RDF data from/into the NTriples, RDF/XML, and Turtle formats.
+* Extracts RDF statements from XHTML+RDFa documents.
+* Serializes RDF statements into Graphviz format.
+* Provides serialization format autodetection for RDF/XML, Turtle and RDFa.
+* Compatible with any operating system supported by Raptor and Ruby.
+* Compatible with MRI >= 2.4, JRuby and Rubinius.
+
+Examples
+--------
+
+    require 'rdf/raptor'
+
+### Ensuring Raptor is installed and obtaining the version number
+
+    RDF::Raptor.available?         #=> true
+    RDF::Raptor.version            #=> "2.0.8"
+
+### Parsing RDF statements from an NTriples file
+
+    RDF::Reader.open("http://datagraph.org/jhacker/foaf.nt") do |reader|
+      reader.each_statement do |statement|
+        puts statement.inspect
+      end
+    end
+
+### Parsing RDF statements from an RDF/XML file
+
+    RDF::Reader.open("http://datagraph.org/jhacker/foaf.rdf") do |reader|
+      reader.each_statement do |statement|
+        puts statement.inspect
+      end
+    end
+
+### Parsing RDF statements from a Turtle file
+
+    RDF::Reader.open("http://datagraph.org/jhacker/foaf.ttl") do |reader|
+      reader.each_statement do |statement|
+        puts statement.inspect
+      end
+    end
+
+### Extracting RDF statements from an HTML+RDFa document
+
+    RDF::Reader.open(url = "http://bblfish.net/", format: :rdfa, base_uri: url) do |reader|
+      reader.each_statement do |statement|
+        puts statement.inspect
+      end
+    end
+
+### Serializing RDF statements into an RDF/XML file
+
+    data = RDF::Repository.load("http://datagraph.org/jhacker/foaf.nt")
+    
+    RDF::Writer.open("output.rdf") do |writer|
+      data.each_statement do |statement|
+        writer << statement
+      end
+    end
+
+### Serializing RDF statements into a Turtle file
+
+    data = RDF::Repository.load("http://datagraph.org/jhacker/foaf.nt")
+    
+    RDF::Writer.open("output.ttl") do |writer|
+      data.each_statement do |statement|
+        writer << statement
+      end
+    end
+
+### Obtaining the NTriples format specification class
+
+    RDF::Format.for(:ntriples)      #=> RDF::Raptor::NTriples::Format
+    RDF::Format.for("input.nt")
+    RDF::Format.for(file_name:      "input.nt")
+    RDF::Format.for(file_extension: "nt")
+    RDF::Format.for(content_type:   "application/n-triples")
+
+### Obtaining the RDF/XML format specification class
+
+    RDF::Format.for(:rdfxml)       #=> RDF::Raptor::RDFXML::Format
+    RDF::Format.for("input.rdf")
+    RDF::Format.for(file_name:      "input.rdf")
+    RDF::Format.for(file_extension: "rdf")
+    RDF::Format.for(content_type:   "application/rdf+xml")
+
+### Obtaining the Turtle format specification class
+
+    RDF::Format.for(:turtle)       #=> RDF::Raptor::Turtle::Format
+    RDF::Format.for("input.ttl")
+    RDF::Format.for(file_name:      "input.ttl")
+    RDF::Format.for(file_extension: "ttl")
+    RDF::Format.for(content_type:   "text/turtle")
+
+### Obtaining the RDFa format specification class
+
+    RDF::Format.for(:rdfa)         #=> RDF::Raptor::RDFa::Format
+    RDF::Format.for("input.html")
+    RDF::Format.for(file_name:      "input.html")
+    RDF::Format.for(file_extension: "html")
+    RDF::Format.for(content_type:   "application/xhtml+xml")
+
+### Obtaining the Graphviz format specification class
+
+    RDF::Format.for(:graphviz)     #=> RDF::Raptor::Graphviz::Format
+    RDF::Format.for("output.dot")
+    RDF::Format.for(file_name:      "output.dot")
+    RDF::Format.for(file_extension: "")
+    RDF::Format.for(content_type:   "text/vnd.graphviz")
+
+Documentation
+-------------
+
+<http://www.rubydoc.info/github/ruby-rdf/rdf-raptor/>
+
+* {RDF::Raptor}
+  * {RDF::Raptor::NTriples}
+  * {RDF::Raptor::Turtle}
+  * {RDF::Raptor::RDFXML}
+  * {RDF::Raptor::RDFa}
+  * {RDF::Raptor::Graphviz}
+
+Dependencies
+------------
+
+* [RDF.rb](http://rubygems.org/gems/rdf) (~> 3.1)
+* [FFI](http://rubygems.org/gems/ffi) (~> 1.11)
+* [Raptor][] (>= 2.0), the `libraptor` library or the `rapper` binary
+
+Installation
+------------
+
+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. For your convenience, 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
+    % brew install raptor                    # Mac OS X with Homebrew
+    % [sudo] aptitude install raptor-utils   # Ubuntu / Debian with aptitude
+    % [sudo] apt-get install libraptor2-0    # Ubuntu / Debian with apt-get
+    % [sudo] yum install raptor2             # Fedora / CentOS / RHEL
+    % [sudo] zypper install raptor           # openSUSE
+    % [sudo] emerge raptor                   # Gentoo Linux
+    % [sudo] pacman -S raptor                # Arch Linux
+    % [sudo] pkg_add -r raptor               # FreeBSD
+    % [sudo] pkg_add raptor                  # OpenBSD / NetBSD
+
+If the `libraptor2` library is in the standard library search path, and
+the `rapper` command is in the standard command search path, all should
+be well and work fine out of the box. However, if either is in a
+non-standard location, be sure to set the `RDF_RAPTOR_LIBPATH` and/or
+`RDF_RAPTOR_BINPATH` environment variables appropriately before
+requiring `rdf/raptor`.
+
+Download
+--------
+
+To get a local working copy of the development repository, do:
+
+    % git clone git@github.com:ruby-rdf/rdf-raptor.git
+
+Alternatively, download the latest development version as a tarball as
+follows:
+
+    % wget https://github.com/ruby-rdf/rdf-raptor/tarball/master
+
+Mailing List
+------------
+
+* <http://lists.w3.org/Archives/Public/public-rdf-ruby/>
+
+Authors
+-------
+
+* [Arto Bendiken](https://github.com/bendiken) - <http://ar.to/>
+* [John Fieber](https://github.com/jfieber) - <http://github.com/jfieber>
+
+Contributors
+------------
+
+* [Ben Lavender](https://github.com/bhuga) - <http://bhuga.net/>
+* [David Butler](https://github.com/dwbutler) - <http://github.com/dwbutler>
+* [Gregg Kellogg](https://github.com/gkellogg) - <http://greggkellogg.net/>
+
+License
+-------
+
+This is free and unencumbered public domain software. For more information,
+see <http://unlicense.org/> or the accompanying [UNLICENSE][] file.
+
+[RDF.rb]:   https://ruby-rdf.github.io/rdf
+[NTriples]: https://en.wikipedia.org/wiki/N-Triples
+[RDF/XML]:  http://www.w3.org/TR/REC-rdf-syntax/
+[Turtle]:   https://en.wikipedia.org/wiki/Turtle_(syntax)
+[RDFa]:     http://rdfa.info/
+[Graphviz]: http://www.graphviz.org/
+[Raptor]:   http://librdf.org/raptor/
+[rapper]:   http://librdf.org/raptor/rapper.html
+[UNLICENSE]:https://github.com/ruby-rdf/rdf-raptor/blob/master/UNLICENSE

data/VERSION

@@ -1 +1 @@
-2.2.0
+3.1.0

data/lib/rdf/raptor/cli.rb

@@ -27,30 +27,30 @@ module RDF::Raptor
       # Initializes the CLI reader instance.
       #
       # @param  [IO, File, RDF::URI, String] input
+      # @param [String, #to_s] :base_uri ("file:///dev/stdin")
       # @param  [Hash{Symbol => Object}] options
       #   any additional options (see `RDF::Reader#initialize`)
-      # @option options [String, #to_s] :base_uri ("file:///dev/stdin")
       # @yield  [reader] `self`
       # @yieldparam  [RDF::Reader] reader
       # @yieldreturn [void] ignored
-      def initialize(input = $stdin, options = {}, &block)
+      def initialize(input = $stdin, base_uri: nil, **options, &block)
         raise RDF::ReaderError, "`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)
+            @command << " '#{base_uri}'" if options.has_key?(:base_uri)
             @rapper  = IO.popen(@command, 'rb')
 
           when File, Tempfile
             @command = "#{RAPPER} -q -i #{format} -o ntriples '#{File.expand_path(input.path)}'"
-            @command << " '#{options[:base_uri]}'" if options.has_key?(:base_uri)
+            @command << " '#{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)
+            @command << " '#{base_uri}'" if options.has_key?(:base_uri)
             @rapper  = IO.popen(@command, 'rb+')
             pid = fork do
               # process to feed `rapper`
@@ -135,20 +135,20 @@ module RDF::Raptor
       # @yield  [writer] `self`
       # @yieldparam  [RDF::Writer] writer
       # @yieldreturn [void]
-      def initialize(output = $stdout, options = {}, &block)
+      def initialize(output = $stdout, base_uri: nil, **options, &block)
         raise RDF::WriterError, "`rapper` binary not found" unless RDF::Raptor.available?
 
         format = self.class.format.rapper_format
         case output
           when File, IO, StringIO, Tempfile
             @command = "#{RAPPER} -q -i turtle -o #{format} file:///dev/stdin"
-            @command << " '#{options[:base_uri]}'" if options.has_key?(:base_uri)
+            @command << " '#{base_uri}'" if options.has_key?(:base_uri)
             @rapper  = IO.popen(@command, 'rb+')
           else
             raise ArgumentError, "unsupported output type: #{output.inspect}"
         end
-        @writer = RDF::NTriples::Writer.new(@rapper, options)
-        super(output, options, &block)
+        @writer = RDF::NTriples::Writer.new(@rapper, **options)
+        super(output, base_uri: base_uri, **options, &block)
       end
 
     protected

data/lib/rdf/raptor/ffi.rb

@@ -40,7 +40,7 @@ module RDF::Raptor
       # @yield  [reader] `self`
       # @yieldparam  [RDF::Reader] reader
       # @yieldreturn [void] ignored
-      def initialize(input = $stdin, options = {}, &block)
+      def initialize(input = $stdin, **options, &block)
         @format = self.class.format.rapper_format
         @parser = V2::Parser.new(@format)
         @parser.error_handler = ERROR_HANDLER
@@ -75,7 +75,7 @@ module RDF::Raptor
       # @yieldparam  [RDF::Statement] statement
       # @yieldreturn [void] ignored
       # @see   RDF::Reader#each_statement
-      def each_statement(options = {}, &block)
+      def each_statement(**options, &block)
         if block_given?
           if options[:raw]
             # this is up to an order of magnitude faster...
@@ -92,7 +92,7 @@ module RDF::Raptor
             raise RDF::ReaderError, "Errors found during processing"
           end
         end
-        enum_for(:each_statement, options)
+        enum_for(:each_statement, **options)
       end
       alias_method :each, :each_statement
 
@@ -121,7 +121,7 @@ module RDF::Raptor
       # @yieldreturn [void] ignored
       # @return [void]
       def parse(input, &block)
-        @parser.parse(input, @options, &block)
+        @parser.parse(input, **@options, &block)
       end
 
       GENID = /^genid\d+$/
@@ -156,12 +156,12 @@ module RDF::Raptor
       # @yield  [writer] `self`
       # @yieldparam  [RDF::Writer] writer
       # @yieldreturn [void] ignored
-      def initialize(output = $stdout, options = {}, &block)
+      def initialize(output = $stdout, **options, &block)
         @format = self.class.format.rapper_format
         @serializer = V2::Serializer.new(@format)
         @serializer.error_handler   = ERROR_HANDLER
         @serializer.warning_handler = WARNING_HANDLER
-        @serializer.start_to(output, options)
+        @serializer.start_to(output, **options)
         super
       end
 

data/lib/rdf/raptor/ffi/v1/iostream.rb

@@ -18,7 +18,7 @@ module RDF::Raptor::FFI::V1
     # @overload initialize(file)
     #   @param  [File, Tempfile] file
     #
-    def initialize(ptr_or_obj, options = {})
+    def initialize(ptr_or_obj, **options)
       ptr = case ptr_or_obj
         when FFI::Pointer
           ptr_or_obj

data/lib/rdf/raptor/ffi/v1/parser.rb

@@ -75,16 +75,16 @@ module RDF::Raptor::FFI::V1
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse(input, options = {}, &block)
+    def parse(input, **options, &block)
       case input
         when RDF::URI, %r(^(file|https|http|ftp)://)
-          parse_url(input, options, &block)
+          parse_url(input, **options, &block)
         when File, Tempfile
-          parse_file(input, options, &block)
+          parse_file(input, **options, &block)
         when IO, StringIO
-          parse_stream(input, options, &block)
+          parse_stream(input, **options, &block)
         when String
-          parse_buffer(input, options, &block)
+          parse_buffer(input, **options, &block)
         else
           raise ArgumentError, "don't know how to parse #{input.inspect}"
       end
@@ -101,11 +101,11 @@ module RDF::Raptor::FFI::V1
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse_url(url, options = {}, &block)
+    def parse_url(url, base_uri: nil, **options, &block)
       self.statement_handler = block if block_given?
 
       data_url = V1::URI.new((url.respond_to?(:to_uri) ? url.to_uri : url).to_s)
-      base_uri = options[:base_uri].to_s.empty? ? nil : V1::URI.new(options[:base_uri].to_s)
+      base_uri = base_uri.to_s.empty? ? nil : V1::URI.new(base_uri.to_s)
 
       result = V1.raptor_parse_uri(self, data_url, base_uri)
       # TODO: error handling if result.nonzero?
@@ -123,11 +123,11 @@ module RDF::Raptor::FFI::V1
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse_file(file, options = {}, &block)
+    def parse_file(file, base_uri: nil, **options, &block)
       self.statement_handler = block if block_given?
 
       data_url = V1::URI.new("file://#{File.expand_path(file.path)}")
-      base_uri = options[:base_uri].to_s.empty? ? nil : V1::URI.new(options[:base_uri].to_s)
+      base_uri = base_uri.to_s.empty? ? nil : V1::URI.new(base_uri.to_s)
 
       result = V1.raptor_parse_file(self, data_url, base_uri)
       # TODO: error handling if result.nonzero?
@@ -144,11 +144,11 @@ module RDF::Raptor::FFI::V1
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse_stream(stream, options = {}, &block)
+    def parse_stream(stream, base_uri: nil, **options, &block)
       self.statement_handler = block if block_given?
 
       begin
-        parse_start!((options[:base_uri] || BASE_URI).to_s)
+        parse_start!((base_uri || BASE_URI).to_s)
         loop do
           parse_chunk(stream.sysread(BUFFER_SIZE))
         end
@@ -168,10 +168,10 @@ module RDF::Raptor::FFI::V1
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse_buffer(buffer, options = {}, &block)
+    def parse_buffer(buffer, base_uri: nil, **options, &block)
       self.statement_handler = block if block_given?
 
-      parse_start!((options[:base_uri] || BASE_URI).to_s)
+      parse_start!((base_uri || BASE_URI).to_s)
       parse_chunk(buffer.to_str)
       parse_end!
     end

data/lib/rdf/raptor/ffi/v1/serializer.rb

@@ -57,9 +57,9 @@ module RDF::Raptor::FFI::V1
     # @option options [String, #to_s] :base_uri (nil)
     #   the base URI to use when resolving relative URIs
     # @return [void]
-    def start_to(output, options = {})
+    def start_to(output, **options)
       if output.respond_to?(:write)
-        start_to_stream(output, options)
+        start_to_stream(output, **options)
        else
         raise ArgumentError, "don't know how to serialize to #{output.inspect}"
       end
@@ -70,9 +70,9 @@ module RDF::Raptor::FFI::V1
     # @param  [Hash{Symbol => Object}] options
     #   any additional options for serializing (see {#start_to})
     # @return [void]
-    def start_to_stream(stream, options = {})
+    def start_to_stream(stream, **options)
       iostream = V1::IOStream.new(V1::IOStreamHandler.new(stream), free_iostream: false)
-      start_to_iostream(iostream, options)
+      start_to_iostream(iostream, **options)
     end
 
     ##
@@ -80,7 +80,7 @@ module RDF::Raptor::FFI::V1
     # @param  [Hash{Symbol => Object}] options
     #   any additional options for serializing (see {#start_to})
     # @return [void]
-    def start_to_iostream(iostream, options = {})
+    def start_to_iostream(iostream, **options)
       @iostream = iostream # prevents premature GC
       @base_uri = options[:base_uri].to_s.empty? ? nil : V1::URI.new(options[:base_uri].to_s)
       if V1.raptor_serialize_start_to_iostream(self, @base_uri, @iostream).nonzero?

data/lib/rdf/raptor/ffi/v2/iostream.rb

@@ -23,7 +23,7 @@ module RDF::Raptor::FFI::V2
     # @overload initialize(file)
     #   @param  [File, Tempfile] file
     #
-    def initialize(ptr_or_obj, options = {})
+    def initialize(ptr_or_obj, **options)
       ptr = case ptr_or_obj
         when FFI::Pointer
           ptr_or_obj

data/lib/rdf/raptor/ffi/v2/parser.rb

@@ -82,16 +82,16 @@ module RDF::Raptor::FFI::V2
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse(input, options = {}, &block)
+    def parse(input, **options, &block)
       case input
         when RDF::URI, URI, %r(^(file|https|http|ftp)://)
-          parse_url(input, options, &block)
+          parse_url(input, **options, &block)
         when File, Tempfile
-          parse_file(input, options, &block)
+          parse_file(input, **options, &block)
         when IO, StringIO
-          parse_stream(input, options, &block)
+          parse_stream(input, **options, &block)
         when String
-          parse_buffer(input, options, &block)
+          parse_buffer(input, **options, &block)
         else
           raise ArgumentError, "don't know how to parse #{input.inspect}"
       end
@@ -108,7 +108,7 @@ module RDF::Raptor::FFI::V2
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse_url(url, options = {}, &block)
+    def parse_url(url, **options, &block)
       self.statement_handler = block if block_given?
 
       data_url = V2::URI.new((url.respond_to?(:to_uri) ? url.to_uri : url).to_s)
@@ -130,7 +130,7 @@ module RDF::Raptor::FFI::V2
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse_file(file, options = {}, &block)
+    def parse_file(file, **options, &block)
       self.statement_handler = block if block_given?
 
       data_url = V2::URI.new("file://#{File.expand_path(file.path)}")
@@ -151,7 +151,7 @@ module RDF::Raptor::FFI::V2
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse_stream(stream, options = {}, &block)
+    def parse_stream(stream, **options, &block)
       self.statement_handler = block if block_given?
 
       begin
@@ -175,7 +175,7 @@ module RDF::Raptor::FFI::V2
     # @yieldparam  [FFI::Pointer] statement
     # @yieldreturn [void] ignored
     # @return [void]
-    def parse_buffer(buffer, options = {}, &block)
+    def parse_buffer(buffer, **options, &block)
       self.statement_handler = block if block_given?
 
       parse_start!((options[:base_uri] || BASE_URI).to_s)

data/lib/rdf/raptor/ffi/v2/serializer.rb

@@ -69,9 +69,9 @@ module RDF::Raptor::FFI::V2
     # @option options [String, #to_s] :base_uri (nil)
     #   the base URI to use when resolving relative URIs
     # @return [void]
-    def start_to(output, options = {})
+    def start_to(output, **options)
       if output.respond_to?(:write)
-        start_to_stream(output, options)
+        start_to_stream(output, **options)
        else
         raise ArgumentError, "don't know how to serialize to #{output.inspect}"
       end
@@ -82,9 +82,9 @@ module RDF::Raptor::FFI::V2
     # @param  [Hash{Symbol => Object}] options
     #   any additional options for serializing (see {#start_to})
     # @return [void]
-    def start_to_stream(stream, options = {})
+    def start_to_stream(stream, **options)
       iostream = V2::IOStream.new(V2::IOStreamHandler.new(stream), free_iostream: self[:free_iostream_on_end])
-      start_to_iostream(iostream, options)
+      start_to_iostream(iostream, **options)
     end
 
     ##
@@ -92,9 +92,9 @@ module RDF::Raptor::FFI::V2
     # @param  [Hash{Symbol => Object}] options
     #   any additional options for serializing (see {#start_to})
     # @return [void]
-    def start_to_iostream(iostream, options = {})
+    def start_to_iostream(iostream, base_uri: nil, **options)
       @iostream = iostream # prevents premature GC
-      @base_uri = options[:base_uri].to_s.empty? ? nil : V2::URI.new(options[:base_uri].to_s)
+      @base_uri = base_uri.to_s.empty? ? nil : V2::URI.new(base_uri.to_s)
       if V2.raptor_serializer_start_to_iostream(self, @base_uri, @iostream).nonzero?
         raise RDF::WriterError, "raptor_serialize_start_to_iostream() failed"
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rdf-raptor
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Arto Bendiken
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-14 00:00:00.000000000 Z
+date: 2019-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -17,110 +17,98 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.10
+        version: '1.11'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.10
+        version: '1.11'
 - !ruby/object:Gem::Dependency
   name: rdf
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '2.2'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '2.2'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: 0.9.20
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: 0.9.20
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '3.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '3.9'
 - !ruby/object:Gem::Dependency
   name: rspec-its
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rdf-spec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '2.2'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '3.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '2.2'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 description: RDF.rb plugin for parsing/serializing NTriples, RDF/XML, Turtle and RDFa
   data using the Raptor RDF Parser library.
 email: public-rdf-ruby@w3.org
@@ -129,8 +117,9 @@ extensions: []
 extra_rdoc_files: []
 files:
 - AUTHORS
+- CONTRIBUTING.md
 - CREDITS
-- README
+- README.md
 - UNLICENSE
 - VERSION
 - etc/doap.ttl
@@ -175,7 +164,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.2.2
+      version: '2.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -183,8 +172,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - libraptor2 (>= 2.0)
-rubyforge_project: 
-rubygems_version: 2.6.14
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: Raptor RDF Parser plugin for RDF.rb.

data/README

@@ -1 +0,0 @@
-./README.md