sparql 3.1.0 → 3.1.6

data/lib/sparql/algebra/operator/seconds.rb

@@ -11,7 +11,7 @@ module SPARQL; module Algebra
     #         (extend ((?x (seconds ?date)))
     #           (bgp (triple ?s :date ?date)))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-seconds
+    # @see https://www.w3.org/TR/sparql11-query/#func-seconds
     class Seconds < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/seq.rb

@@ -28,7 +28,7 @@ module SPARQL; module Algebra
       #   each matching solution
       # @yieldparam  [RDF::Query::Solution] solution
       # @yieldreturn [void] ignored
-      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
+      # @see    https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
       def execute(queryable, **options, &block)
         subject, object = options[:subject], options[:object]
         debug(options) {"Seq #{[subject, operands, object].to_sse}"}

data/lib/sparql/algebra/operator/sequence.rb

@@ -34,7 +34,7 @@ module SPARQL; module Algebra
       #   each matching solution
       # @yieldparam  [RDF::Query::Solution] solution
       # @yieldreturn [void] ignored
-      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
+      # @see    https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
       def execute(queryable, **options)
         debug(options) {"Sequence #{operands.to_sse}"}
 

data/lib/sparql/algebra/operator/sha1.rb

@@ -13,7 +13,7 @@ module SPARQL; module Algebra
     #         (extend ((?hash (sha1 ?l)))
     #           (bgp (triple :s1 :str ?l)))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-sha1
+    # @see https://www.w3.org/TR/sparql11-query/#func-sha1
     class SHA1 < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/sha256.rb

@@ -13,7 +13,7 @@ module SPARQL; module Algebra
     #         (extend ((?hash (sha256 ?l)))
     #           (bgp (triple :s1 :str ?l)))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-sha256
+    # @see https://www.w3.org/TR/sparql11-query/#func-sha256
     class SHA256 < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/sha384.rb

@@ -13,7 +13,7 @@ module SPARQL; module Algebra
     #         (extend ((?hash (sha384 ?l)))
     #           (bgp (triple :s1 :str ?l)))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-sha384
+    # @see https://www.w3.org/TR/sparql11-query/#func-sha384
     class SHA384 < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/sha512.rb

@@ -13,7 +13,7 @@ module SPARQL; module Algebra
     #         (extend ((?hash (sha512 ?l)))
     #           (bgp (triple :s1 :str ?l)))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-sha512
+    # @see https://www.w3.org/TR/sparql11-query/#func-sha512
     class SHA512 < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/slice.rb

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #         (order (?v)
     #           (bgp (triple ??0 :num ?v))))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
+    # @see https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
     class Slice < Operator::Ternary
       include Query
       
@@ -42,7 +42,7 @@ module SPARQL; module Algebra
       # @yieldreturn [void] ignored
       # @return [RDF::Query::Solutions]
       #   the resulting solution sequence
-      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
+      # @see    https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
       def execute(queryable, **options, &block)
         offset = operands[0] == :_ ? 0 : operands[0].to_i
         limit = operands[1] == :_ ? -1 : operands[1].to_i
@@ -52,16 +52,6 @@ module SPARQL; module Algebra
         @solutions.each(&block) if block_given?
         @solutions
       end
-      
-      ##
-      # Returns an optimized version of this query.
-      #
-      # Return optimized query
-      #
-      # @return [Union, RDF::Query] `self`
-      def optimize
-        operands = operands.map(&:optimize)
-      end
     end # Slice
   end # Operator
 end; end # SPARQL::Algebra

data/lib/sparql/algebra/operator/str.rb

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #       (filter (= (str ?v) "1")
     #         (bgp (triple ?x :p ?v)))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-str
+    # @see https://www.w3.org/TR/sparql11-query/#func-str
     class Str < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/strafter.rb

@@ -6,8 +6,8 @@ module SPARQL; module Algebra
     # @example
     #   (strafter ?x ?y)
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-strafter
-    # @see http://www.w3.org/TR/xpath-functions/#func-substring-after
+    # @see https://www.w3.org/TR/sparql11-query/#func-strafter
+    # @see https://www.w3.org/TR/xpath-functions/#func-substring-after
     class StrAfter < Operator::Binary
       include Evaluatable
 

data/lib/sparql/algebra/operator/strbefore.rb

@@ -6,8 +6,8 @@ module SPARQL; module Algebra
     # @example
     #   (strbefore ?x ?y)
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-strbefore
-    # @see http://www.w3.org/TR/xpath-functions/#func-substring-before
+    # @see https://www.w3.org/TR/sparql11-query/#func-strbefore
+    # @see https://www.w3.org/TR/xpath-functions/#func-substring-before
     class StrBefore < Operator::Binary
       include Evaluatable
 

data/lib/sparql/algebra/operator/strdt.rb

@@ -9,7 +9,7 @@ module SPARQL; module Algebra
     #         (filter (langMatches (lang ?str) "en")
     #           (bgp (triple ?s :str ?str))))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-strdt
+    # @see https://www.w3.org/TR/sparql11-query/#func-strdt
     class StrDT < Operator::Binary
       include Evaluatable
 
@@ -23,7 +23,7 @@ module SPARQL; module Algebra
       # @param  [RDF::URI] datatypeIRI
       #   datatype
       # @return [RDF::Literal] a datatyped literal
-      # @see http://www.w3.org/TR/sparql11-query/#func-strdt
+      # @see https://www.w3.org/TR/sparql11-query/#func-strdt
       def apply(value, datatypeIRI)
         raise TypeError, "Literal #{value.inspect} is not simple" unless value.simple?
         RDF::Literal.new(value.to_s, datatype: datatypeIRI)

data/lib/sparql/algebra/operator/strends.rb

@@ -6,8 +6,8 @@ module SPARQL; module Algebra
     # @example
     #   (strends ?x ?y)
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-strends
-    # @see http://www.w3.org/TR/xpath-functions/#func-ends-with
+    # @see https://www.w3.org/TR/sparql11-query/#func-strends
+    # @see https://wwww.w3.org/TR/xpath-functions/#func-ends-with
     class StrEnds < Operator::Binary
       include Evaluatable
 

data/lib/sparql/algebra/operator/strlang.rb

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #           (filter (langMatches (lang ?str) "en")
     #             (bgp (triple ?s :str ?str))))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-strlang
+    # @see https://www.w3.org/TR/sparql11-query/#func-strlang
     class StrLang < Operator::Binary
       include Evaluatable
 
@@ -24,7 +24,7 @@ module SPARQL; module Algebra
       # @param  [RDF::Literal] langTag
       #   datatype
       # @return [RDF::Literal] a datatyped literal
-      # @see http://www.w3.org/TR/sparql11-query/#func-strlang
+      # @see https://www.w3.org/TR/sparql11-query/#func-strlang
       def apply(value, langTag)
         raise TypeError, "Literal #{value.inspect} is not simple" unless value.simple?
         RDF::Literal.new(value.to_s, language: langTag.to_s)

data/lib/sparql/algebra/operator/strlen.rb

@@ -6,8 +6,8 @@ module SPARQL; module Algebra
     # @example
     #   (strlen ?x)
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-strlen
-    # @see http://www.w3.org/TR/xpath-functions/#func-string-length
+    # @see https://www.w3.org/TR/sparql11-query/#func-strlen
+    # @see https://www.w3.org/TR/xpath-functions/#func-string-length
     class StrLen < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/strstarts.rb

@@ -6,8 +6,8 @@ module SPARQL; module Algebra
     # @example
     #   (strstarts ?x ?y)
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-strstarts
-    # @see http://www.w3.org/TR/xpath-functions/#func-starts-with
+    # @see https://www.w3.org/TR/sparql11-query/#func-strstarts
+    # @see https://www.w3.org/TR/xpath-functions/#func-starts-with
     class StrStarts < Operator::Binary
       include Evaluatable
 

data/lib/sparql/algebra/operator/struuid.rb

@@ -14,7 +14,7 @@ module SPARQL; module Algebra
     #             (extend ((?uuid (struuid)))
     #               (bgp))))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-struuid
+    # @see https://www.w3.org/TR/sparql11-query/#func-struuid
     class StrUUID < Operator::Nullary
       include Evaluatable
 

data/lib/sparql/algebra/operator/subject.rb

@@ -0,0 +1,29 @@
+module SPARQL; module Algebra
+  class Operator
+    ##
+    # The SPARQL `SUBJECT` operator.
+    #
+    # Returns the subject part of `arg` as a term.
+    #
+    # If triple is an RDF-star triple, the function returns the subject of this triple. Passing anything other than an RDF-star triple is an error.
+    #
+    # @see https://w3c.github.io/rdf-star/rdf-star-cg-spec.html#subject
+    class Subject < Operator::Unary
+      include Evaluatable
+
+      NAME = :subject
+
+      ##
+      # Returns the subject part of arg.
+      #
+      # @param  [RDF::Statement] operand
+      #   the operand
+      # @return [RDF::Literal]
+      # @raise  [TypeError] if the operand is not a statement
+      def apply(operand)
+        raise TypeError, "expected an RDF::Statement, but got #{operand.inspect}" unless operand.is_a?(RDF::Statement)
+        operand.subject
+      end
+    end # Subject
+  end # Operator
+end; end # SPARQL::Algebra

data/lib/sparql/algebra/operator/substr.rb

@@ -6,8 +6,8 @@ module SPARQL; module Algebra
     # @example
     #   (substr ?x ?y)
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-substr
-    # @see http://www.w3.org/TR/xpath-functions/#func-substring
+    # @see https://www.w3.org/TR/sparql11-query/#func-substr
+    # @see https://www.w3.org/TR/xpath-functions/#func-substring
     class SubStr < Operator::Ternary
       include Evaluatable
 
@@ -71,7 +71,7 @@ module SPARQL; module Algebra
       # Remove the optional argument.
       #
       # @return [Array] `self`
-      # @see    http://openjena.org/wiki/SSE
+      # @see    https://openjena.org/wiki/SSE
       def to_sxp_bin
         [NAME] + operands.reject {|o| o.to_s == ""}
       end

data/lib/sparql/algebra/operator/subtract.rb

@@ -5,7 +5,7 @@ module SPARQL; module Algebra
     #   (- ?x ?y)
     #   (subtract ?x ?y)
     #
-    # @see http://www.w3.org/TR/xpath-functions/#func-numeric-subtract
+    # @see https://www.w3.org/TR/xpath-functions/#func-numeric-subtract
     class Subtract < Operator::Binary
       include Evaluatable
 

data/lib/sparql/algebra/operator/sum.rb

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #          (group () ((??.0 (sum ?o)))
     #            (bgp (triple ?s :dec ?o))))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#defn_aggSum
+    # @see https://www.w3.org/TR/sparql11-query/#defn_aggSum
     class Sum < Operator
       include Aggregate
 

data/lib/sparql/algebra/operator/table.rb

@@ -13,7 +13,7 @@ module SPARQL; module Algebra
     #
     # @example empty table
     #     (table unit)
-    # @see http://www.w3.org/TR/2013/REC-sparql11-query-20130321/#inline-data
+    # @see https://www.w3.org/TR/2013/REC-sparql11-query-20130321/#inline-data
     class Table < Operator
       include Query
       
@@ -32,7 +32,7 @@ module SPARQL; module Algebra
       # @yieldreturn [void] ignored
       # @return [RDF::Query::Solutions]
       #   the resulting solution sequence
-      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
+      # @see    https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
       def execute(queryable, **options, &block)
         @solutions = RDF::Query::Solutions()
         Array(operands[1..-1]).each do |row|

data/lib/sparql/algebra/operator/timezone.rb

@@ -11,7 +11,7 @@ module SPARQL; module Algebra
     #         (extend ((?x (timezone ?date)))
     #           (bgp (triple ?s :date ?date)))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-timezone
+    # @see https://www.w3.org/TR/sparql11-query/#func-timezone
     class Timezone < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/triple.rb

@@ -0,0 +1,27 @@
+module SPARQL; module Algebra
+  class Operator
+    ##
+    # The SPARQL `triple` operator.
+    #
+    # If the 3-tuple (term1, term2, term3) is an RDF-star triple, the function returns this triple. If the 3-tuple is not an RDF-star triple, then the function raises an error.
+    #
+    # @see https://w3c.github.io/rdf-star/rdf-star-cg-spec.html#triple
+    class Triple < Operator::Ternary
+      include Evaluatable
+
+      NAME = :triple
+
+      ##
+      # @param  [RDF::Term] subject
+      # @param  [RDF::Term] predicate
+      # @param  [RDF::Term] object
+      # @return [RDF::URI]
+      # @raise  [TypeError] if the operand is not a simple literal
+      def apply(subject, predicate, object)
+        triple = RDF::Statement(subject, predicate, object)
+        raise TypeError, "valid components, but got #{triple.inspect}" unless triple.valid?
+        triple
+      end
+    end # Triple
+  end # Operator
+end; end # SPARQL::Algebra

data/lib/sparql/algebra/operator/tz.rb

@@ -11,7 +11,7 @@ module SPARQL; module Algebra
     #         (extend ((?x (tz ?date)))
     #           (bgp (triple ?s :date ?date)))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-tz
+    # @see https://www.w3.org/TR/sparql11-query/#func-tz
     class TZ < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/ucase.rb

@@ -6,8 +6,8 @@ module SPARQL; module Algebra
     # @example
     #   (ucase ?x)
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-ucase
-    # @see http://www.w3.org/TR/xpath-functions/#func-ucase
+    # @see https://www.w3.org/TR/sparql11-query/#func-ucase
+    # @see https://www.w3.org/TR/xpath-functions/#func-ucase
     class UCase < Operator::Unary
       include Evaluatable
 

data/lib/sparql/algebra/operator/union.rb

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #       (graph ?g
     #         (bgp (triple ?s ?p ?o)))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
+    # @see https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
     class Union < Operator::Binary
       include Query
       
@@ -30,7 +30,7 @@ module SPARQL; module Algebra
       # @yieldreturn [void] ignored
       # @return [RDF::Query::Solutions]
       #   the resulting solution sequence
-      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
+      # @see    https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
       def execute(queryable, **options, &block)
         debug(options) {"Union"}
         @solutions = RDF::Query::Solutions(operands.inject([]) do |memo, op|
@@ -55,13 +55,14 @@ module SPARQL; module Algebra
       end
 
       ##
-      # Returns an optimized version of this query.
+      # Optimizes this query.
       #
       # Optimize operands and remove any which are empty.
       #
-      # @return [Union, RDF::Query] `self`
-      def optimize
-        ops = operands.map {|o| o.optimize }.select {|o| o.respond_to?(:empty?) && !o.empty?}
+      # @return [self]
+      # @see SPARQL::Algebra::Expression#optimize!
+      def optimize!(**options)
+        ops = operands.map {|o| o.optimize(**options) }.select {|o| o.respond_to?(:empty?) && !o.empty?}
         @operands = ops
         self
       end

data/lib/sparql/algebra/operator/update.rb

@@ -9,7 +9,7 @@ module SPARQL; module Algebra
     #       (bgp (triple ?s ?p ?o))
     #       (insert ((triple ?s ?p "q")))))
     #
-    # @see http://www.w3.org/TR/sparql11-update/#graphUpdate
+    # @see https://www.w3.org/TR/sparql11-update/#graphUpdate
     class Update < Operator
       include SPARQL::Algebra::Update
       
@@ -30,7 +30,7 @@ module SPARQL; module Algebra
       #   If an attempt is made to perform an unsupported operation
       # @raise [IOError]
       #   If `queryable` is immutable
-      # @see    http://www.w3.org/TR/sparql11-update/
+      # @see    https://www.w3.org/TR/sparql11-update/
       def execute(queryable, **options)
         debug(options) {"Update"}
         raise IOError, "queryable is not mutable" unless queryable.mutable?

data/lib/sparql/algebra/operator/using.rb

@@ -9,7 +9,7 @@ module SPARQL; module Algebra
     # @example
     #   (using (:g1) (bgp (triple ?s ?p ?o)))
     #
-    # @see http://www.w3.org/TR/sparql11-update/#add
+    # @see https://www.w3.org/TR/sparql11-update/#add
     class Using < Operator
       include SPARQL::Algebra::Query
 
@@ -30,7 +30,7 @@ module SPARQL; module Algebra
       #   Returns queryable.
       # @raise [IOError]
       #   If `from` does not exist, unless the `silent` operator is present
-      # @see    http://www.w3.org/TR/sparql11-update/
+      # @see    https://www.w3.org/TR/sparql11-update/
       def execute(queryable, **options, &block)
         debug(options) {"Using"}
         Dataset.new(*operands).execute(queryable, depth: options[:depth].to_i + 1, **options, &block)