rdf 3.1.11 → 3.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb4903dd836362f2ba5883f4af56b2276d879e60c0be2b740fcfd946c2b9bc29
-  data.tar.gz: e0abcd40f798fa08955649dda90a53f10e775d74d95f4fbbb7680cb8223594a8
+  metadata.gz: deb163eb0095fba5da13f3f9a03a8543cb244e4525a495f2585d49c98e72fffc
+  data.tar.gz: e146b2eeaf881c53cf4291362698440febbb6f45fb793c3369fc374a8909c97d
 SHA512:
-  metadata.gz: fa91bd5cc0daa34b2055bf0504dd05a67ad433320d316247eee7ecc7e34c4b26a60be3dd944f2b480a3282b6f1175b4af03a740a6697d5a1848e14279093d025
-  data.tar.gz: b30eea12865c58960d3ee942ff89e6e0cfb1b5bc3d1cc66187356709c389450c03e1d397715c4a807902deacfd10916a1db7c054f03ed289253986b42fefc0e3
+  metadata.gz: 568557c3d23702f3fb8f842d8b64a19f116403c1d21a1da6164b6ce83a8d8297556ac5d74e508916d9be6ff215de777d553591760db9ab79479d161e89a3d6a8
+  data.tar.gz: 7d90c6165c87710add8ed7b9359fdd38b617b1efac9c928885b88c78769d0b0a7a1898418b6a9c3d2d6e97a9eb7de61ae48047b9053e430eeb053b3ee5a75968

data/README.md

@@ -398,16 +398,16 @@ from BNode identity (i.e., they each entail the other)
 
 ## Dependencies
 
-* [Ruby](https://ruby-lang.org/) (>= 2.2)
+* [Ruby](https://ruby-lang.org/) (>= 2.6)
 * [LinkHeader][] (>= 0.0.8)
-* Soft dependency on [RestClient][] (>= 1.7)
+* Soft dependency on [RestClient][] (>= 2.1)
 
 ## Installation
 
 The recommended installation method is via [RubyGems](https://rubygems.org/).
 To install the latest official release of RDF.rb, do:
 
-    % [sudo] gem install rdf             # Ruby 2+
+    % [sudo] gem install rdf             # Ruby 2.6+
 
 ## Download
 

data/VERSION

@@ -1 +1 @@
-3.1.11
+3.2.1

data/lib/rdf/cli.rb

@@ -256,8 +256,7 @@ module RDF
         lambda: ->(argv, opts) do
           writer_class = RDF::Writer.for(opts[:output_format]) || RDF::NTriples::Writer
           out = opts[:output]
-          opts = opts.merge(prefixes: {})
-          writer_opts = opts.merge(standard_prefixes: true)
+          writer_opts = {prefixes: {}, standard_prefixes: true}.merge(opts)
           writer_class.new(out, **writer_opts) do |writer|
             writer << repository
           end
@@ -536,6 +535,8 @@ module RDF
         count = 0
         self.parse(args, **options) do |reader|
           reader.each_statement {|st| @repository << st}
+          # Remember prefixes from reading
+          options[:prefixes] ||= reader.prefixes
         end
         secs = Time.new - start
         options[:logger].info "Parsed #{repository.count} statements with #{@readers.join(', ')} in #{secs} seconds @ #{count/secs} statements/second."

data/lib/rdf/mixin/enumerable.rb

@@ -136,8 +136,13 @@ module RDF
     #
     #   @param  [RDF::Statement] statement
     #   @return [Boolean]
-    def statement?(statement = nil)
-      statement && !enum_statement.find { |s| s.eql?(statement) }.nil?
+    def statement?(*args)
+      case args.length
+      when 0 then false
+      when 1
+        args.first && !enum_statement.find { |s| s.eql?(args.first) }.nil?        
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
     alias_method :has_statement?, :statement?
     alias_method :include?, :statement?
@@ -541,8 +546,12 @@ module RDF
     #   @param  [RDF::Resource] value
     #   @return [Boolean]
     #   @since 2.0
-    def term?(value = nil)
-      value && enum_term.include?(value)
+    def term?(*args)
+      case args.length
+      when 0 then super
+      when 1 then args.first && enum_term.include?(args.first)
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
     alias_method :has_term?, :term?
 

data/lib/rdf/model/graph.rb

@@ -138,11 +138,22 @@ module RDF
     end
 
     ##
-    # Returns `true` to indicate that this is a graph.
+    # @overload graph?
+    #   Returns `true` to indicate that this is a graph.
     #
-    # @return [Boolean]
-    def graph?
-      true
+    #   @return [Boolean]
+    # @overload graph?(name)
+    #   Returns `true` if `self` contains the given RDF graph_name.
+    #
+    #   @param  [RDF::Resource, false] graph_name
+    #     Use value `false` to query for the default graph_name
+    #   @return [Boolean]
+    def graph?(*args)
+      case args.length
+      when 0 then true
+      when 1 then graph_name == args.first
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
 
     ##
@@ -227,11 +238,15 @@ module RDF
     #   @param  [Statement] statement
     #   @return [Boolean]
     #   @see    RDF::Enumerable#statement?
-    def statement?(statement = nil)
-      return false if statement.nil?
-      statement = statement.dup
-      statement.graph_name = graph_name
-      @data.statement?(statement)
+    def statement?(*args)
+      case args.length
+      when 0 then false
+      when 1
+        statement = args.first.dup
+        statement.graph_name = graph_name
+        @data.statement?(statement)
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
     alias_method :has_statement?, :statement?
 

data/lib/rdf/model/literal/double.rb

@@ -43,6 +43,7 @@ module RDF; class Literal
       # Can't use simple %f transformation due to special requirements from
       # N3 tests in representation
       @string = case
+        when @object.nil?      then 'NaN'
         when @object.nan?      then 'NaN'
         when @object.infinite? then @object.to_s[0...-'inity'.length].upcase
         when @object.zero?     then '0.0E0'

data/lib/rdf/model/literal/numeric.rb

@@ -11,6 +11,9 @@ module RDF; class Literal
     # @return [Integer] `-1`, `0`, or `1`
     # @since  0.3.0
     def <=>(other)
+      # If lexically invalid, use regular literal testing
+      return super unless self.valid? && (!other.respond_to?(:valid?) || other.valid?)
+
       case other
         when ::Numeric
           to_d <=> other
@@ -30,11 +33,10 @@ module RDF; class Literal
     # @since  0.3.0
     def ==(other)
       # If lexically invalid, use regular literal testing
-      return super unless self.valid?
+      return super unless self.valid? && (!other.respond_to?(:valid?) || other.valid?)
 
       case other
       when Literal::Numeric
-        return super unless other.valid?
         (cmp = (self <=> other)) ? cmp.zero? : false
       when RDF::URI, RDF::Node
         # Interpreting SPARQL data-r2/expr-equal/eq-2-2, numeric can't be compared with other types

data/lib/rdf/model/literal.rb

@@ -166,12 +166,12 @@ module RDF
       @object   = value.freeze
       @string   = lexical if lexical
       @string   = value if !defined?(@string) && value.is_a?(String)
-      @string   = @string.encode(Encoding::UTF_8).freeze if @string
-      @object   = @string if @string && @object.is_a?(String)
+      @string   = @string.encode(Encoding::UTF_8).freeze if instance_variable_defined?(:@string)
+      @object   = @string if instance_variable_defined?(:@string) && @object.is_a?(String)
       @language = language.to_s.downcase.to_sym if language
       @datatype = RDF::URI(datatype).freeze if datatype
       @datatype ||= self.class.const_get(:DATATYPE) if self.class.const_defined?(:DATATYPE)
-      @datatype ||= @language ? RDF.langString : RDF::URI("http://www.w3.org/2001/XMLSchema#string")
+      @datatype ||= instance_variable_defined?(:@language) && @language ? RDF.langString : RDF::URI("http://www.w3.org/2001/XMLSchema#string")
     end
 
     ##
@@ -179,7 +179,7 @@ module RDF
     #
     # @return [String]
     def value
-      @string || to_s
+      instance_variable_defined?(:@string) && @string || to_s
     end
 
     ##
@@ -308,6 +308,37 @@ module RDF
     end
     alias_method :===, :==
 
+    ##
+    # Compares `self` to `other` for sorting purposes (with type check).
+    #
+    # @param  [Object]  other
+    # @return [Integer] `-1`, `0`, or `1`
+    def <=>(other)
+      case other
+      when Literal
+        case
+        when self.eql?(other)
+          0
+        when self.language? && other.language?
+          # Literals with languages can compare if languages are identical
+          self.to_s <=> other.to_s
+        when self.simple? && other.simple?
+          self.to_s <=> other.to_s
+        when !self.valid?
+          type_error("#{self.inspect} is invalid") || 0
+        when !other.valid?
+          type_error("#{other.inspect} is invalid") || 0
+        when self.comperable_datatype2?(other)
+          self.object <=> other.object
+        else
+          type_error("#{self.inspect} and #{other.inspect} are not comperable") || 0
+        end
+      when String
+        self.simple? && self.value <=> other
+      else 1
+      end
+    end
+
     ##
     # Returns `true` if this is a plain literal. A plain literal
     # may have a language, but may not have a datatype. For
@@ -399,6 +430,26 @@ module RDF
       end
     end
 
+    ##
+    # Returns `true` if the literals are comperable.
+    #
+    # Used for <=> operator.
+    #
+    # @return [Boolean]
+    def comperable_datatype2?(other)
+      case self
+      when RDF::Literal::Numeric, RDF::Literal::Boolean
+        case other
+        when RDF::Literal::Numeric, RDF::Literal::Boolean
+          true
+        else
+          false
+        end
+      else
+        self.datatype == other.datatype
+      end
+    end
+
     ##
     # Converts this literal into its canonical lexical representation.
     #

data/lib/rdf/model/statement.rb

@@ -136,23 +136,45 @@ module RDF
     end
 
     ##
-    # Returns `true` to indicate that this value is a statement.
+    # @overload statement?
+    #   Returns `true` if `self` is a {RDF::Statement}.
     #
-    # @return [Boolean]
-    def statement?
-      true
+    #   @return [Boolean]
+    # @overload statement?(statement)
+    #   Returns `true` if `self` contains the given {RDF::Statement}.
+    #
+    #   @param  [RDF::Statement] statement
+    #   @return [Boolean]
+    def statement?(*args)
+      case args.length
+      when 0 then true
+      when 1 then self == args.first || subject.statement?(*args) || object.statement?(*args)
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
 
     ##
-    # Returns `true` if any element of the statement is not a
+    # @overload variable?
+    #   Returns `true` if any element of the statement is not a
     # URI, Node or Literal.
     #
-    # @return [Boolean]
-    def variable?
-      !(subject?    && subject.constant? &&
-        predicate?  && predicate.constant? &&
-        object?     && object.constant? &&
-        (graph?     ? graph_name.constant? : true))
+    #   @return [Boolean]
+    # @overload variable?(variables)
+    #   Returns `true` if this statement contains any of the variables.
+    #
+    #   @param  [Array<Symbol, #to_sym>] variables
+    #   @return [Boolean]
+    def variable?(*args)
+      case args.length
+      when 0
+        !(subject?    && subject.constant? &&
+          predicate?  && predicate.constant? &&
+          object?     && object.constant? &&
+          (graph?     ? graph_name.constant? : true))
+      when 1
+        to_quad.any? {|t| t.respond_to?(:variable?) && t.variable?(*args)}
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
 
     ##
@@ -215,9 +237,22 @@ module RDF
     end
 
     ##
-    # @return [Boolean]
-    def graph?
-      !!graph_name
+    # @overload graph?
+    #   Returns `true` if the statement has a graph name.
+    #
+    #   @return [Boolean]
+    # @overload graph?(name)
+    #   Returns `true` if `self` contains the given RDF graph_name.
+    #
+    #   @param  [RDF::Resource, false] graph_name
+    #     Use value `false` to query for the default graph_name
+    #   @return [Boolean]
+    def graph?(*args)
+      case args.length
+      when 0 then !!graph_name
+      when 1 then graph_name == args.first
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
     alias_method :name?, :graph?
     alias_method :has_graph?, :graph?
@@ -266,7 +301,7 @@ module RDF
     # @see RDF::Literal#==
     # @see RDF::Query::Variable#==
     def eql?(other)
-      other.is_a?(Statement) && self == other && (self.graph_name || false) == (other.graph_name || false)
+      other.is_a?(Statement) && self.to_a.eql?(other.to_a) && (self.graph_name || false) == (other.graph_name || false)
     end
 
     ##

data/lib/rdf/model/term.rb

@@ -57,11 +57,21 @@ module RDF
     end
 
     ##
-    # Returns `true` if `self` is a {RDF::Term}.
+    # @overload term?
+    #   Returns `true` if `self` is a {RDF::Term}.
     #
-    # @return [Boolean]
-    def term?
-      true
+    #   @return [Boolean]
+    # @overload term?(name)
+    #   Returns `true` if `self` contains the given RDF subject term.
+    #
+    #   @param  [RDF::Resource] value
+    #   @return [Boolean]
+    def term?(*args)
+      case args.length
+      when 0 then true
+      when 1 then false
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
 
     ##

data/lib/rdf/model/uri.rb

@@ -621,16 +621,22 @@ module RDF
     end
 
     ##
-    # Returns a qualified name (QName) for this URI based on available vocabularies, if possible.
+    # Returns a qualified name (QName) as a tuple of `[prefix, suffix]` for this URI based on available vocabularies, if possible.
     #
     # @example
     #   RDF::URI('http://www.w3.org/2000/01/rdf-schema#').qname       #=> [:rdfs, nil]
     #   RDF::URI('http://www.w3.org/2000/01/rdf-schema#label').qname  #=> [:rdfs, :label]
     #   RDF::RDFS.label.qname                                         #=> [:rdfs, :label]
     #
+    # @param [Hash{Symbol => String}] prefixes
+    #   Explicit set of prefixes to look for matches, defaults to loaded vocabularies.
     # @return [Array(Symbol, Symbol)] or `nil` if no QName found
-    def qname
-      if self.to_s =~ %r([:/#]([^:/#]*)$)
+    def qname(prefixes: nil)
+      if prefixes
+        prefixes.each do |prefix, uri|
+          return [prefix, self.to_s[uri.length..-1].to_sym] if self.start_with?(uri)
+        end
+      elsif self.to_s =~ %r([:/#]([^:/#]*)$)
         local_name = $1
         vocab_uri  = local_name.empty? ? self.to_s : self.to_s[0...-(local_name.length)]
         Vocabulary.each do |vocab|
@@ -655,9 +661,11 @@ module RDF
     ##
     # Returns a string version of the QName or the full IRI
     #
+    # @param [Hash{Symbol => String}] prefixes
+    #   Explicit set of prefixes to look for matches, defaults to loaded vocabularies.
     # @return [String] or `nil`
-    def pname
-      (q = self.qname) ? q.join(":") : to_s
+    def pname(prefixes: nil)
+      (q = self.qname(prefixes: prefixes)) ? q.join(":") : to_s
     end
 
     ##

data/lib/rdf/model/value.rb

@@ -29,19 +29,38 @@ module RDF
   # @see RDF::Statement
   module Value
     ##
-    # Returns `true` if `self` is a {RDF::Graph}.
+    # @overload graph?
+    #   Returns `true` if `self` is a {RDF::Graph}.
     #
-    # @return [Boolean]
-    def graph?
-      false
+    #   @return [Boolean]
+    # @overload graph?(name)
+    #   Returns `true` if `self` contains the given RDF graph_name.
+    #
+    #   @param  [RDF::Resource, false] graph_name
+    #     Use value `false` to query for the default graph_name
+    #   @return [Boolean]
+    def graph?(*args)
+      case args.length
+      when 0, 1 then false
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
 
     ##
-    # Is this a {RDF::Statement}?
+    # @overload statement?
+    #   Returns `true` if `self` is a {RDF::Statement}.
     #
-    # @return [Boolean]
-    def statement?
-      false
+    #   @return [Boolean]
+    # @overload statement?(statement)
+    #   Returns `true` if `self` contains the given {RDF::Statement}.
+    #
+    #   @param  [RDF::Statement] statement
+    #   @return [Boolean]
+    def statement?(*args)
+      case args.length
+      when 0, 1 then false
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
 
     ##
@@ -53,11 +72,20 @@ module RDF
     end
 
     ##
-    # Is this a {RDF::Term}?
+    # @overload term?
+    #   Returns `true` if `self` is a {RDF::Term}.
     #
-    # @return [Boolean]
-    def term?
-      false
+    #   @return [Boolean]
+    # @overload term?(name)
+    #   Returns `true` if `self` contains the given RDF subject term.
+    #
+    #   @param  [RDF::Resource] value
+    #   @return [Boolean]
+    def term?(*args)
+      case args.length
+      when 0, 1 then false
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
 
     ##
@@ -103,12 +131,21 @@ module RDF
     end
 
     ##
-    # Is this a {RDF::Query::Variable}, or does it contain a variable?
+    # @overload variable?
+    #   Returns `true` if `self` is a {RDF::Query::Variable}, or does it contain a variable?
     #
-    # @return [Boolean]
+    #   @return [Boolean]
+    # @overload variable?(variable)
+    #   Returns `true` if `self` contains the given variable.
+    #
+    #   @param  [RDF::Resource] value
+    #   @return [Boolean]
     # @since  0.1.7
-    def variable?
-      false
+    def variable?(*args)
+      case args.length
+      when 0, 1 then false
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
 
     ##

data/lib/rdf/nquads.rb

@@ -69,9 +69,9 @@ module RDF
 
           begin
             unless blank? || read_comment
-              subject   = read_uriref || read_node || read_embTriple || fail_subject
+              subject   = read_uriref || read_node || read_quotedTriple || fail_subject
               predicate = read_uriref(intern: true) || fail_predicate
-              object    = read_uriref || read_node || read_literal || read_embTriple || fail_object
+              object    = read_uriref || read_node || read_literal || read_quotedTriple || fail_object
               graph_name    = read_uriref || read_node
               if validate? && !read_eos
                 log_error("Expected end of statement (found: #{current_line.inspect})", lineno: lineno, exception: RDF::ReaderError)

data/lib/rdf/ntriples/reader.rb

@@ -213,7 +213,7 @@ module RDF::NTriples
       begin
         read_statement
       rescue RDF::ReaderError
-        value = read_uriref || read_node || read_literal || read_embTriple
+        value = read_uriref || read_node || read_literal || read_quotedTriple
         log_recover
         value
       end
@@ -229,9 +229,9 @@ module RDF::NTriples
 
         begin
           unless blank? || read_comment
-            subject   = read_uriref || read_node || read_embTriple || fail_subject
+            subject   = read_uriref || read_node || read_quotedTriple || fail_subject
             predicate = read_uriref(intern: true) || fail_predicate
-            object    = read_uriref || read_node || read_literal || read_embTriple || fail_object
+            object    = read_uriref || read_node || read_literal || read_quotedTriple || fail_object
 
             if validate? && !read_eos
               log_error("Expected end of statement (found: #{current_line.inspect})", lineno: lineno, exception: RDF::ReaderError)
@@ -247,11 +247,11 @@ module RDF::NTriples
 
     ##
     # @return [RDF::Statement]
-    def read_embTriple
+    def read_quotedTriple
       if @options[:rdfstar] && match(ST_START)
-        subject   = read_uriref || read_node || read_embTriple || fail_subject
+        subject   = read_uriref || read_node || read_quotedTriple || fail_subject
         predicate = read_uriref(intern: true) || fail_predicate
-        object    = read_uriref || read_node || read_literal || read_embTriple || fail_object
+        object    = read_uriref || read_node || read_literal || read_quotedTriple || fail_object
         if !match(ST_END)
           log_error("Expected end of statement (found: #{current_line.inspect})", lineno: lineno, exception: RDF::ReaderError)
         end

data/lib/rdf/ntriples/writer.rb

@@ -227,7 +227,7 @@ module RDF::NTriples
     # @param  [RDF::Statement] statement
     # @param  [Hash{Symbol => Object}] options ({})
     # @return [String]
-    def format_embTriple(statement, **options)
+    def format_quotedTriple(statement, **options)
       "<<%s %s %s>>" % statement.to_a.map { |value| format_term(value, **options) }
     end
     ##

data/lib/rdf/query/pattern.rb

@@ -59,6 +59,12 @@ module RDF; class Query
       super
     end
 
+    ##
+    # Create a new pattern from the quads, recursivly dupping sub-patterns.
+    def dup
+      self.class.from(self.to_quad.map {|t| t.is_a?(RDF::Query::Pattern) ? t.dup : t})
+    end
+
     ##
     # Any additional options for this pattern.
     #

data/lib/rdf/query/solution.rb

@@ -23,10 +23,13 @@ class RDF::Query
   class Solution
     # Undefine all superfluous instance methods:
     alias_method :__send, :send
+
+    # Temporarily remember instance method for deprecation message in `method_missing`.
+    INSTANCE_METHODS = instance_methods
     undef_method(*instance_methods.
                   map(&:to_s).
                   select {|m| m.match?(/^\w+$/)}.
-                  reject {|m| %w(object_id dup instance_eval inspect to_s private_methods class should should_not pretty_print).include?(m) || m[0,2] == '__'}.
+                  reject {|m| %w(object_id dup instance_eval inspect to_s private_methods public_methods class method pretty_print).include?(m) || m[0,2] == '__'}.
                   map(&:to_sym))
 
     include Enumerable
@@ -114,15 +117,24 @@ class RDF::Query
     end
 
     ##
-    # Returns `true` if this solution contains bindings for any of the given
+    # @overload variable?
+    #   Returns `false`.
+    #
+    #   @return [Boolean]
+    # @overload variable?(variables)
+    #   Returns `true` if this solution contains bindings for any of the given
     # `variables`.
     #
-    # @param  [Array<Symbol, #to_sym>] variables
-    #   an array of variables to check
-    # @return [Boolean] `true` or `false`
+    #   @param  [Array<Symbol, #to_sym>] variables
+    #   @return [Boolean]
     # @since  0.3.0
-    def variable?(variables)
-      variables.any? { |variable| bound?(variable) }
+    def variable?(*args)
+      case args.length
+      when 0 then false
+      when 1
+        args.first.any? { |variable| bound?(variable) }
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
     alias_method :variables?, :variable?
     alias_method :has_variables?, :variable?
@@ -335,6 +347,12 @@ class RDF::Query
     #   @return [RDF::Term]
     def method_missing(name, *args, &block)
       if args.empty? && @bindings.key?(name.to_sym)
+        if INSTANCE_METHODS.include?(name)
+          warn "[DEPRECATION] RDF::Query::Solution##{name} is an overridden instance method.\n" +
+               "Its use as a solution accessor is deprecated and will be removed in a future version.\n" +
+               "Use #[] for safe access.\n" +
+               "Called from #{Gem.location_of_caller.join(':')}"
+        end
         @bindings[name.to_sym]
       else
         super # raises NoMethodError