rdf-raptor 1.99.0 → 3.2.0

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

@@ -3,7 +3,7 @@ module RDF::Raptor::FFI::V2
   # This class provides the functionality of turning syntaxes into RDF
   # triples - RDF parsing.
   #
-  # @see http://librdf.org/raptor/api/raptor2-section-parser.html
+  # @see https://librdf.org/raptor/api/raptor2-section-parser.html
   class Parser < ::FFI::ManagedStruct
     include RDF::Raptor::FFI
     layout :world, :pointer # the actual layout is private
@@ -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

@@ -3,10 +3,12 @@ module RDF::Raptor::FFI::V2
   # This class provides the functionality of turning RDF triples into
   # syntaxes - RDF serializing.
   #
-  # @see http://librdf.org/raptor/api-1.4/raptor-section-serializer.html
+  # @see https://librdf.org/raptor/api-1.4/raptor-section-serializer.html
   class Serializer < ::FFI::ManagedStruct
     include RDF::Raptor::FFI
 
+    attr_reader :iostream
+
     # Note this layout is private
     layout  :world, :pointer,
             :locator, :pointer,
@@ -49,14 +51,14 @@ module RDF::Raptor::FFI::V2
     # @param  [Proc] handler
     # @return [void]
     def error_handler=(handler)
-      V2.raptor_serializer_set_error_handler(self, self, handler)
+      V2.raptor_serializer_set_error_handler(self, self, handler) if V2.respond_to?(:raptor_serializer_set_error_handler)
     end
 
     ##
     # @param  [Proc] handler
     # @return [void]
     def warning_handler=(handler)
-      V2.raptor_serializer_set_warning_handler(self, self, handler)
+      V2.raptor_serializer_set_warning_handler(self, self, handler) if V2.respond_to?(:raptor_serializer_set_warning_handler)
     end
 
     ##
@@ -67,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
@@ -80,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
 
     ##
@@ -90,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

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

@@ -1,6 +1,6 @@
 module RDF::Raptor::FFI::V2
   ##
-  # @see http://librdf.org/raptor/api-1.4/raptor-section-triples.html
+  # @see https://librdf.org/raptor/api-1.4/raptor-section-triples.html
   class Statement < ::FFI::Struct
     include RDF::Raptor::FFI
     layout  :world, :pointer,

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

@@ -1,6 +1,6 @@
 module RDF::Raptor::FFI::V2
   ##
-  # @see http://librdf.org/raptor/api-1.4/raptor-section-triples.html
+  # @see https://librdf.org/raptor/api-1.4/raptor-section-triples.html
   class Term < ::FFI::Struct
     include RDF::Raptor::FFI
     

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

@@ -4,7 +4,7 @@ module RDF::Raptor::FFI::V2
   # passing URI references. The default internal implementation uses `char*`
   # strings for URIs, manipulating them and constructing them.
   #
-  # @see http://librdf.org/raptor/api-1.4/raptor-section-uri.html
+  # @see https://librdf.org/raptor/api-1.4/raptor-section-uri.html
   class URI < ::FFI::ManagedStruct
     include RDF::Raptor::FFI
     include RDF::Resource

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

@@ -2,7 +2,7 @@ module RDF::Raptor::FFI
   ##
   # A foreign-function interface (FFI) to `libraptor` 2.x.
   #
-  # @see http://librdf.org/raptor/libraptor.html
+  # @see https://librdf.org/raptor/libraptor.html
   module V2
     autoload :IOStream,        'rdf/raptor/ffi/v2/iostream'
     autoload :IOStreamHandler, 'rdf/raptor/ffi/v2/iostream_handler'
@@ -25,22 +25,23 @@ module RDF::Raptor::FFI
     RAPTOR_TERM_TYPE_LITERAL  = 2
     RAPTOR_TERM_TYPE_BLANK    = 4
 
-    # @see http://librdf.org/raptor/api/tutorial-initialising-finishing.html
+    # @see https://librdf.org/raptor/api/tutorial-initialising-finishing.html
     typedef :pointer, :raptor_world
     typedef :int, :raptor_version
+    typedef :pointer, :raptor_iostream
     attach_function :raptor_new_world_internal, [:raptor_version], :raptor_world
     attach_function :raptor_free_world, [], :void
     attach_function :raptor_alloc_memory, [:size_t], :pointer
     attach_function :raptor_calloc_memory, [:size_t, :size_t], :pointer
     attach_function :raptor_free_memory, [:pointer], :void
 
-    # @see http://librdf.org/raptor/api-1.4/raptor-section-locator.html
+    # @see https://librdf.org/raptor/api-1.4/raptor-section-locator.html
     typedef :pointer, :raptor_locator
     attach_function :raptor_locator_line, [:raptor_locator], :int
     attach_function :raptor_locator_column, [:raptor_locator], :int
     attach_function :raptor_locator_byte, [:raptor_locator], :int
 
-    # @see http://librdf.org/raptor/api/raptor2-section-general.html
+    # @see https://librdf.org/raptor/api/raptor2-section-general.html
     attach_variable :raptor_version_string, :string
     attach_variable :raptor_version_major, :int
     attach_variable :raptor_version_minor, :int
@@ -48,7 +49,7 @@ module RDF::Raptor::FFI
     attach_variable :raptor_version_decimal, :int
     callback        :raptor_message_handler, [:pointer, :raptor_locator, :string], :void
 
-    # @see http://librdf.org/raptor/api-1.4/raptor-section-uri.html
+    # @see https://librdf.org/raptor/api-1.4/raptor-section-uri.html
     typedef :pointer, :raptor_uri
     attach_function :raptor_new_uri, [:raptor_world, :string], :raptor_uri
     attach_function :raptor_uri_copy, [:raptor_uri], :raptor_uri
@@ -58,7 +59,7 @@ module RDF::Raptor::FFI
     attach_function :raptor_uri_print, [:raptor_uri, :pointer], :void
     attach_function :raptor_free_uri, [:raptor_uri], :void
 
-    # @see http://librdf.org/raptor/api/raptor2-section-triples.html
+    # @see https://librdf.org/raptor/api/raptor2-section-triples.html
     typedef :int,     :raptor_identifier_type
     typedef :pointer, :raptor_identifier
     typedef :pointer, :raptor_statement
@@ -77,12 +78,13 @@ module RDF::Raptor::FFI
     attach_function :raptor_new_term_from_literal, [:raptor_world, :literal, :datatype, :language], :raptor_term
     attach_function :raptor_new_term_from_blank, [:raptor_world, :blank], :raptor_term
     attach_function :raptor_free_term, [:raptor_term], :void
+    attach_function :raptor_term_ntriples_write, [:raptor_term, :raptor_iostream], :int
 
-    # @see http://librdf.org/raptor/api/raptor2-section-xml-namespace.html
+    # @see https://librdf.org/raptor/api/raptor2-section-xml-namespace.html
     typedef :pointer, :raptor_namespace
     attach_function :raptor_free_namespace, [:raptor_namespace], :void
 
-    # @see http://librdf.org/raptor/api/raptor2-section-parser.html
+    # @see https://librdf.org/raptor/api/raptor2-section-parser.html
     callback :raptor_statement_handler, [:pointer, :raptor_statement], :void
     callback :raptor_namespace_handler, [:pointer, :raptor_namespace], :void
     typedef :pointer, :raptor_parser
@@ -105,8 +107,7 @@ module RDF::Raptor::FFI
     attach_function :raptor_parser_parse_abort, [], :void
     attach_function :raptor_free_parser, [:raptor_parser], :void
 
-    # @see http://librdf.org/raptor/api/raptor2-section-iostream.html
-    typedef :pointer, :raptor_iostream
+    # @see https://librdf.org/raptor/api/raptor2-section-iostream.html
     attach_function :raptor_new_iostream_from_handler, [:raptor_world, :pointer, :pointer], :raptor_iostream
     attach_function :raptor_new_iostream_to_filename, [:raptor_world, :string], :raptor_iostream
     attach_function :raptor_new_iostream_to_sink, [:raptor_world], :raptor_iostream
@@ -119,7 +120,7 @@ module RDF::Raptor::FFI
     callback        :raptor_iostream_read_bytes_func, [:pointer, :pointer, :size_t, :size_t], :int
     callback        :raptor_iostream_read_eof_func, [:pointer], :int
 
-    # @see http://librdf.org/raptor/api/raptor2-section-serializer.html
+    # @see https://librdf.org/raptor/api/raptor2-section-serializer.html
     typedef :pointer, :raptor_serializer
     typedef :string, :prefix
     attach_function :raptor_new_serializer, [:raptor_world, :string], :raptor_serializer

data/lib/rdf/raptor/ffi.rb

@@ -1,5 +1,5 @@
 require 'tempfile'
-require 'ffi' # @see http://rubygems.org/gems/ffi
+require 'ffi' # @see https://rubygems.org/gems/ffi
 
 module RDF::Raptor
   ##
@@ -28,6 +28,8 @@ module RDF::Raptor
     ##
     # FFI reader implementation.
     class Reader < RDF::Reader
+      include RDF::Util::Logger
+
       ##
       # Initializes the FFI reader instance.
       #
@@ -38,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
@@ -54,12 +56,12 @@ module RDF::Raptor
 
       ERROR_HANDLER = Proc.new do |user_data, locator, message|
         line = V2.raptor_locator_line(locator)
-        raise RDF::ReaderError, line > -1 ? "Line #{line}: #{message}" : message
+        log_error(message, lineno: line)
       end
 
       WARNING_HANDLER = Proc.new do |user_data, locator, message|
-        # line = V2.raptor_locator_line(locator)
-        # $stderr.puts line > -1 ? "Line #{line}: #{message}" : message
+        line = V2.raptor_locator_line(locator)
+        log_warn(message, lineno: line)
       end
 
       ##
@@ -73,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...
@@ -85,8 +87,12 @@ module RDF::Raptor
               block.call(V2::Statement.new(statement, self).to_rdf)
             end
           end
+
+          if validate? && log_statistics[:error]
+            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
 
@@ -97,8 +103,8 @@ module RDF::Raptor
       # @see   RDF::Reader#each_triple
       def each_triple(&block)
         if block_given?
-          parse(@input) do |parser, statement|
-            block.call(V2::Statement.new(statement, self).to_triple)
+          each_statement do |statement|
+            block.call(*statement.to_triple)
           end
         end
         enum_for(:each_triple)
@@ -115,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+$/
@@ -139,6 +145,8 @@ module RDF::Raptor
     ##
     # FFI writer implementation.
     class Writer < RDF::Writer
+      include RDF::Util::Logger
+
       ##
       # Initializes the FFI writer instance.
       #
@@ -148,21 +156,21 @@ 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.error_handler   = ERROR_HANDLER
+        @serializer.warning_handler = WARNING_HANDLER
+        @serializer.start_to(output, **options)
         super
       end
 
       ERROR_HANDLER = Proc.new do |user_data, locator, message|
-        raise RDF::WriterError, message
+        log_error(message)
       end
 
       WARNING_HANDLER = Proc.new do |user_data, locator, message|
-        # $stderr.puts "warning"
+        log_warn(message)
       end
 
       ##
@@ -171,6 +179,23 @@ module RDF::Raptor
       # @return [V2::Serializer]
       attr_reader :serializer
 
+      def self.serialize(value)
+        output = StringIO.new
+        writer = new(output)
+        case value
+        when nil then nil
+        when FalseClass then value.to_s
+        when RDF::Statement
+          writer.write_triple(statement.subject, statement.predicate, statement.object)
+        when RDF::Term
+          writer.write_term(value)
+        else
+          raise ArgumentError, "expected an RDF::Statement or RDF::Term, but got #{value.inspect}"
+        end
+
+        output.to_s
+      end
+
       ##
       # @param  [RDF::Resource] subject
       # @param  [RDF::URI]      predicate
@@ -181,6 +206,10 @@ module RDF::Raptor
         @serializer.serialize_triple(subject, predicate, object)
       end
 
+      def write_term(value)
+        raise NotImplementedError
+      end
+
       ##
       # @return [void]
       # @see    RDF::Writer#write_prologue

data/lib/rdf/raptor/graphviz.rb

@@ -23,7 +23,7 @@ module RDF::Raptor
     #   RDF::Format.for(file_extension: "dot")
     #   RDF::Format.for(content_type:   "text/vnd.graphviz")
     #
-    # @see http://www.iana.org/assignments/media-types/text/vnd.graphviz
+    # @see https://www.iana.org/assignments/media-types/text/vnd.graphviz
     class Format < RDF::Format
       extend RDF::Raptor::Format
       
@@ -32,7 +32,6 @@ module RDF::Raptor
       rapper_format    :dot
 
       writer { RDF::Raptor::Graphviz::Writer }
-      reader { RDF::Raptor::Graphviz::Reader }
     end # Format
 
     ##
@@ -55,13 +54,5 @@ module RDF::Raptor
     class Writer < RDF::Raptor::Writer
       format RDF::Raptor::Graphviz::Format
     end # Writer
-    
-    ##
-    # Raptor does not implement a Graphviz reader, but we need one in
-    # order for the Format to pass specs. This class should always
-    # raise a NoMethodError to indicate it shouldn't be used.
-    #
-    class Reader
-    end
   end # Graphviz
 end # RDF::Raptor

data/lib/rdf/raptor/ntriples.rb

@@ -19,7 +19,7 @@ module RDF::Raptor
   #     end
   #   end
   #
-  # @see http://www.w3.org/TR/rdf-testcases/#ntriples
+  # @see https://www.w3.org/TR/rdf-testcases/#ntriples
   module NTriples
     ##
     # N-Triples format specification.
@@ -86,7 +86,12 @@ module RDF::Raptor
     #   end
     #
     class Writer < RDF::Raptor::Writer
+      include RDF::Raptor::FFI
       format RDF::Raptor::NTriples::Format
+
+      def write_term(value)
+        V2.raptor_term_ntriples_write(value, @serializer.iostream)
+      end
     end # Writer
   end # NTriples
 end # RDF::Raptor

data/lib/rdf/raptor/rdfa.rb

@@ -12,7 +12,7 @@ module RDF::Raptor
   #     end
   #   end
   #
-  # @see http://rdfa.info/
+  # @see https://rdfa.info/
   module RDFa
     ##
     # RDFa format specification.
@@ -27,11 +27,32 @@ module RDF::Raptor
     class Format < RDF::Format
       extend RDF::Raptor::Format
       
-      content_type     'application/xhtml+xml', aliases: ['text/html'], extension: :html
+      content_type     'text/html',
+        aliases: %w(application/xhtml+xml image/svg+xml),
+        extensions: [:html, :xhtml, :svg]
       content_encoding 'utf-8'
       rapper_format    :rdfa
 
       reader { RDF::Raptor::RDFa::Reader }
+
+      ##
+      # Sample detection to see if it matches RDFa (not RDF/XML or Microdata)
+      #
+      # Use a text sample to detect the format of an input file. Sub-classes implement
+      # a matcher sufficient to detect probably format matches, including disambiguating
+      # between other similar formats.
+      #
+      # @param [String] sample Beginning several bytes (~ 1K) of input.
+      # @return [Boolean]
+      def self.detect(sample)
+        (sample.match(/<[^>]*(about|resource|prefix|typeof|property|vocab)\s*="[^>]*>/m) ||
+         sample.match(/<[^>]*DOCTYPE\s+html[^>]*>.*xmlns:/im)
+        ) && !sample.match(/<(\w+:)?(RDF)/)
+      end
+
+      def self.symbols
+        [:rdfa, :lite, :html, :xhtml, :svg]
+      end
     end # Format
 
     ##

data/lib/rdf/raptor/rdfxml.rb

@@ -19,7 +19,7 @@ module RDF::Raptor
   #     end
   #   end
   #
-  # @see http://www.w3.org/TR/REC-rdf-syntax/
+  # @see https://www.w3.org/TR/REC-rdf-syntax/
   module RDFXML
     ##
     # RDF/XML format specification.
@@ -45,6 +45,10 @@ module RDF::Raptor
         # Raptor guess is not fully supported
         sample.match(/<(\w+:)?(RDF)/)
       end
+
+      def self.symbols
+        [:rdfxml, :rdf]
+      end
     end # Format
 
     ##

data/lib/rdf/raptor/turtle.rb

@@ -19,7 +19,7 @@ module RDF::Raptor
   #     end
   #   end
   #
-  # @see http://www.w3.org/TeamSubmission/turtle/
+  # @see https://www.w3.org/TeamSubmission/turtle/
   module Turtle
     ##
     # Turtle format specification.
@@ -40,6 +40,37 @@ module RDF::Raptor
 
       reader { RDF::Raptor::Turtle::Reader }
       writer { RDF::Raptor::Turtle::Writer }
+
+      ##
+      # Sample detection to see if it matches Turtle (or N-Triples)
+      #
+      # Use a text sample to detect the format of an input file. Sub-classes implement
+      # a matcher sufficient to detect probably format matches, including disambiguating
+      # between other similar formats.
+      #
+      # @param [String] sample Beginning several bytes (~ 1K) of input.
+      # @return [Boolean]
+      def self.detect(sample)
+        !!sample.match(%r(
+          (?:@(base|prefix)) |                                            # Turtle keywords
+          ["']{3} |                                                       # STRING_LITERAL_LONG_SINGLE_QUOTE/2
+          "[^"]*"^^ | "[^"]*"@ |                                          # Typed/Language literals
+          (?:
+            (?:\s*(?:(?:<[^>]*>) | (?:\w*:\w+) | (?:"[^"]*"))\s*[,;]) ||
+            (?:\s*(?:(?:<[^>]*>) | (?:\w*:\w+) | (?:"[^"]*"))){3}
+          )
+        )mx) && !(
+          sample.match(%r([{}])) ||                                       # TriG
+          sample.match(%r(@keywords|=>|\{)) ||                            # N3
+          sample.match(%r(<(?:\/|html|rdf))i) ||                          # HTML, RDF/XML
+          sample.match(%r(^(?:\s*<[^>]*>){4}.*\.\s*$)) ||                 # N-Quads
+          sample.match(%r("@(context|subject|iri)"))                      # JSON-LD
+        )
+      end
+
+      def self.symbols
+        [:turtle, :ttl]
+      end
     end # Format
 
     ##

data/lib/rdf/raptor/version.rb

@@ -14,6 +14,6 @@ module RDF; module Raptor
 
     ##
     # @return [Array(Integer, Integer, Integer)]
-    def self.to_a() [MAJOR, MINOR, TINY] end
+    def self.to_a() STRING.split(".") end
   end
 end; end

data/lib/rdf/raptor.rb

@@ -1,4 +1,4 @@
-require 'rdf' # @see http://rubygems.org/gems/rdf
+require 'rdf' # @see https://rubygems.org/gems/rdf
 require 'rdf/raptor/format'
 
 module RDF
@@ -72,12 +72,12 @@ module RDF
   # `RDF_RAPTOR_BINPATH` environment variables appropriately before
   # requiring `rdf/raptor`.
   #
-  # @see http://rdf.rubyforge.org/
-  # @see http://librdf.org/raptor/
-  # @see http://wiki.github.com/ffi/ffi/
+  # @see https://www.rubydoc.info/github/ruby-rdf/rdf/
+  # @see https://librdf.org/raptor/
+  # @see https://wiki.github.com/ffi/ffi/
   #
-  # @author [Arto Bendiken](http://github.com/bendiken)
-  # @author [John Fieber](http://github.com/jfieber)
+  # @author [Arto Bendiken](https://github.com/artob)
+  # @author [John Fieber](https://github.com/jfieber)
   module Raptor
     LIBRAPTOR = ENV['RDF_RAPTOR_LIBPATH'] || ['libraptor2', 'libraptor2.so.0']  unless const_defined?(:LIBRAPTOR)
     RAPPER    = ENV['RDF_RAPTOR_BINPATH'] || 'rapper'     unless const_defined?(:RAPPER)