sparql 3.0.0 → 3.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. checksums.yaml +5 -5
  2. data/README.md +184 -70
  3. data/UNLICENSE +1 -1
  4. data/VERSION +1 -1
  5. data/bin/sparql +28 -17
  6. data/lib/rack/sparql.rb +1 -1
  7. data/lib/rack/sparql/conneg.rb +3 -3
  8. data/lib/sinatra/sparql.rb +5 -5
  9. data/lib/sparql.rb +14 -10
  10. data/lib/sparql/algebra.rb +15 -23
  11. data/lib/sparql/algebra/aggregate.rb +4 -4
  12. data/lib/sparql/algebra/evaluatable.rb +2 -2
  13. data/lib/sparql/algebra/expression.rb +28 -21
  14. data/lib/sparql/algebra/extensions.rb +142 -16
  15. data/lib/sparql/algebra/operator.rb +37 -16
  16. data/lib/sparql/algebra/operator/abs.rb +2 -2
  17. data/lib/sparql/algebra/operator/add.rb +3 -3
  18. data/lib/sparql/algebra/operator/alt.rb +4 -4
  19. data/lib/sparql/algebra/operator/and.rb +7 -7
  20. data/lib/sparql/algebra/operator/asc.rb +3 -3
  21. data/lib/sparql/algebra/operator/ask.rb +4 -14
  22. data/lib/sparql/algebra/operator/avg.rb +6 -4
  23. data/lib/sparql/algebra/operator/base.rb +10 -10
  24. data/lib/sparql/algebra/operator/bgp.rb +1 -1
  25. data/lib/sparql/algebra/operator/bnode.rb +5 -5
  26. data/lib/sparql/algebra/operator/bound.rb +3 -3
  27. data/lib/sparql/algebra/operator/ceil.rb +2 -2
  28. data/lib/sparql/algebra/operator/clear.rb +3 -3
  29. data/lib/sparql/algebra/operator/coalesce.rb +3 -13
  30. data/lib/sparql/algebra/operator/compare.rb +8 -8
  31. data/lib/sparql/algebra/operator/concat.rb +4 -4
  32. data/lib/sparql/algebra/operator/construct.rb +4 -14
  33. data/lib/sparql/algebra/operator/contains.rb +2 -2
  34. data/lib/sparql/algebra/operator/copy.rb +3 -3
  35. data/lib/sparql/algebra/operator/count.rb +3 -3
  36. data/lib/sparql/algebra/operator/create.rb +3 -3
  37. data/lib/sparql/algebra/operator/dataset.rb +5 -16
  38. data/lib/sparql/algebra/operator/datatype.rb +1 -1
  39. data/lib/sparql/algebra/operator/day.rb +1 -1
  40. data/lib/sparql/algebra/operator/delete.rb +7 -5
  41. data/lib/sparql/algebra/operator/delete_data.rb +3 -3
  42. data/lib/sparql/algebra/operator/delete_where.rb +5 -5
  43. data/lib/sparql/algebra/operator/desc.rb +1 -1
  44. data/lib/sparql/algebra/operator/describe.rb +3 -13
  45. data/lib/sparql/algebra/operator/distinct.rb +4 -14
  46. data/lib/sparql/algebra/operator/divide.rb +1 -1
  47. data/lib/sparql/algebra/operator/drop.rb +3 -3
  48. data/lib/sparql/algebra/operator/encode_for_uri.rb +3 -3
  49. data/lib/sparql/algebra/operator/equal.rb +3 -3
  50. data/lib/sparql/algebra/operator/exists.rb +5 -5
  51. data/lib/sparql/algebra/operator/exprlist.rb +3 -13
  52. data/lib/sparql/algebra/operator/extend.rb +21 -20
  53. data/lib/sparql/algebra/operator/filter.rb +6 -16
  54. data/lib/sparql/algebra/operator/floor.rb +2 -2
  55. data/lib/sparql/algebra/operator/graph.rb +5 -16
  56. data/lib/sparql/algebra/operator/greater_than.rb +5 -5
  57. data/lib/sparql/algebra/operator/greater_than_or_equal.rb +5 -5
  58. data/lib/sparql/algebra/operator/group.rb +25 -25
  59. data/lib/sparql/algebra/operator/group_concat.rb +6 -6
  60. data/lib/sparql/algebra/operator/hours.rb +1 -1
  61. data/lib/sparql/algebra/operator/if.rb +5 -15
  62. data/lib/sparql/algebra/operator/in.rb +4 -14
  63. data/lib/sparql/algebra/operator/insert.rb +6 -4
  64. data/lib/sparql/algebra/operator/insert_data.rb +3 -3
  65. data/lib/sparql/algebra/operator/iri.rb +1 -1
  66. data/lib/sparql/algebra/operator/is_blank.rb +1 -1
  67. data/lib/sparql/algebra/operator/is_iri.rb +1 -1
  68. data/lib/sparql/algebra/operator/is_literal.rb +1 -1
  69. data/lib/sparql/algebra/operator/is_numeric.rb +1 -1
  70. data/lib/sparql/algebra/operator/join.rb +12 -10
  71. data/lib/sparql/algebra/operator/lang.rb +1 -1
  72. data/lib/sparql/algebra/operator/lang_matches.rb +3 -3
  73. data/lib/sparql/algebra/operator/lcase.rb +2 -2
  74. data/lib/sparql/algebra/operator/left_join.rb +15 -12
  75. data/lib/sparql/algebra/operator/less_than.rb +5 -5
  76. data/lib/sparql/algebra/operator/less_than_or_equal.rb +5 -5
  77. data/lib/sparql/algebra/operator/load.rb +3 -3
  78. data/lib/sparql/algebra/operator/max.rb +6 -4
  79. data/lib/sparql/algebra/operator/md5.rb +1 -1
  80. data/lib/sparql/algebra/operator/min.rb +6 -4
  81. data/lib/sparql/algebra/operator/minus.rb +12 -11
  82. data/lib/sparql/algebra/operator/minutes.rb +1 -1
  83. data/lib/sparql/algebra/operator/modify.rb +4 -4
  84. data/lib/sparql/algebra/operator/month.rb +1 -1
  85. data/lib/sparql/algebra/operator/move.rb +3 -3
  86. data/lib/sparql/algebra/operator/multiply.rb +1 -1
  87. data/lib/sparql/algebra/operator/negate.rb +1 -1
  88. data/lib/sparql/algebra/operator/not.rb +1 -1
  89. data/lib/sparql/algebra/operator/not_equal.rb +2 -2
  90. data/lib/sparql/algebra/operator/notexists.rb +4 -4
  91. data/lib/sparql/algebra/operator/notin.rb +4 -14
  92. data/lib/sparql/algebra/operator/notoneof.rb +5 -6
  93. data/lib/sparql/algebra/operator/now.rb +1 -1
  94. data/lib/sparql/algebra/operator/or.rb +7 -7
  95. data/lib/sparql/algebra/operator/order.rb +6 -16
  96. data/lib/sparql/algebra/operator/path.rb +6 -5
  97. data/lib/sparql/algebra/operator/path_opt.rb +16 -16
  98. data/lib/sparql/algebra/operator/path_plus.rb +8 -8
  99. data/lib/sparql/algebra/operator/path_star.rb +4 -4
  100. data/lib/sparql/algebra/operator/plus.rb +3 -3
  101. data/lib/sparql/algebra/operator/prefix.rb +10 -10
  102. data/lib/sparql/algebra/operator/project.rb +4 -14
  103. data/lib/sparql/algebra/operator/rand.rb +1 -1
  104. data/lib/sparql/algebra/operator/reduced.rb +4 -14
  105. data/lib/sparql/algebra/operator/regex.rb +6 -6
  106. data/lib/sparql/algebra/operator/replace.rb +4 -4
  107. data/lib/sparql/algebra/operator/reverse.rb +4 -4
  108. data/lib/sparql/algebra/operator/round.rb +2 -2
  109. data/lib/sparql/algebra/operator/same_term.rb +8 -5
  110. data/lib/sparql/algebra/operator/sample.rb +3 -3
  111. data/lib/sparql/algebra/operator/seconds.rb +1 -1
  112. data/lib/sparql/algebra/operator/seq.rb +5 -6
  113. data/lib/sparql/algebra/operator/sequence.rb +4 -4
  114. data/lib/sparql/algebra/operator/sha1.rb +1 -1
  115. data/lib/sparql/algebra/operator/sha256.rb +1 -1
  116. data/lib/sparql/algebra/operator/sha384.rb +1 -1
  117. data/lib/sparql/algebra/operator/sha512.rb +1 -1
  118. data/lib/sparql/algebra/operator/slice.rb +4 -14
  119. data/lib/sparql/algebra/operator/str.rb +1 -1
  120. data/lib/sparql/algebra/operator/strafter.rb +2 -2
  121. data/lib/sparql/algebra/operator/strbefore.rb +2 -2
  122. data/lib/sparql/algebra/operator/strdt.rb +2 -2
  123. data/lib/sparql/algebra/operator/strends.rb +2 -2
  124. data/lib/sparql/algebra/operator/strlang.rb +2 -2
  125. data/lib/sparql/algebra/operator/strlen.rb +2 -2
  126. data/lib/sparql/algebra/operator/strstarts.rb +2 -2
  127. data/lib/sparql/algebra/operator/struuid.rb +1 -1
  128. data/lib/sparql/algebra/operator/substr.rb +4 -4
  129. data/lib/sparql/algebra/operator/subtract.rb +1 -1
  130. data/lib/sparql/algebra/operator/sum.rb +6 -4
  131. data/lib/sparql/algebra/operator/table.rb +6 -4
  132. data/lib/sparql/algebra/operator/timezone.rb +1 -1
  133. data/lib/sparql/algebra/operator/tz.rb +1 -1
  134. data/lib/sparql/algebra/operator/ucase.rb +2 -2
  135. data/lib/sparql/algebra/operator/union.rb +10 -9
  136. data/lib/sparql/algebra/operator/update.rb +4 -4
  137. data/lib/sparql/algebra/operator/using.rb +4 -4
  138. data/lib/sparql/algebra/operator/uuid.rb +1 -1
  139. data/lib/sparql/algebra/operator/with.rb +6 -6
  140. data/lib/sparql/algebra/operator/year.rb +1 -1
  141. data/lib/sparql/algebra/query.rb +2 -2
  142. data/lib/sparql/algebra/update.rb +2 -2
  143. data/lib/sparql/algebra/version.rb +1 -1
  144. data/lib/sparql/extensions.rb +5 -5
  145. data/lib/sparql/grammar.rb +111 -11
  146. data/lib/sparql/grammar/meta.rb +1372 -333
  147. data/lib/sparql/grammar/parser11.rb +56 -42
  148. data/lib/sparql/grammar/terminals11.rb +1 -0
  149. data/lib/sparql/results.rb +63 -44
  150. data/lib/sparql/version.rb +1 -1
  151. metadata +40 -47
@@ -13,7 +13,7 @@ module SPARQL; module Algebra
13
13
  # (extend ((?hash (sha384 ?l)))
14
14
  # (bgp (triple :s1 :str ?l)))))
15
15
  #
16
- # @see http://www.w3.org/TR/sparql11-query/#func-sha384
16
+ # @see https://www.w3.org/TR/sparql11-query/#func-sha384
17
17
  class SHA384 < Operator::Unary
18
18
  include Evaluatable
19
19
 
@@ -13,7 +13,7 @@ module SPARQL; module Algebra
13
13
  # (extend ((?hash (sha512 ?l)))
14
14
  # (bgp (triple :s1 :str ?l)))))
15
15
  #
16
- # @see http://www.w3.org/TR/sparql11-query/#func-sha512
16
+ # @see https://www.w3.org/TR/sparql11-query/#func-sha512
17
17
  class SHA512 < Operator::Unary
18
18
  include Evaluatable
19
19
 
@@ -10,7 +10,7 @@ module SPARQL; module Algebra
10
10
  # (order (?v)
11
11
  # (bgp (triple ??0 :num ?v))))))
12
12
  #
13
- # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
13
+ # @see https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
14
14
  class Slice < Operator::Ternary
15
15
  include Query
16
16
 
@@ -42,26 +42,16 @@ module SPARQL; module Algebra
42
42
  # @yieldreturn [void] ignored
43
43
  # @return [RDF::Query::Solutions]
44
44
  # the resulting solution sequence
45
- # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
46
- def execute(queryable, options = {}, &block)
45
+ # @see https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
46
+ def execute(queryable, **options, &block)
47
47
  offset = operands[0] == :_ ? 0 : operands[0].to_i
48
48
  limit = operands[1] == :_ ? -1 : operands[1].to_i
49
- @solutions = operands.last. execute(queryable, options.merge(depth: options[:depth].to_i + 1))
49
+ @solutions = operands.last. execute(queryable, depth: options[:depth].to_i + 1, **options)
50
50
  @solutions.offset(operands[0]) unless operands[0] == :_
51
51
  @solutions.limit(operands[1]) unless operands[1] == :_
52
52
  @solutions.each(&block) if block_given?
53
53
  @solutions
54
54
  end
55
-
56
- ##
57
- # Returns an optimized version of this query.
58
- #
59
- # Return optimized query
60
- #
61
- # @return [Union, RDF::Query] `self`
62
- def optimize
63
- operands = operands.map(&:optimize)
64
- end
65
55
  end # Slice
66
56
  end # Operator
67
57
  end; end # SPARQL::Algebra
@@ -10,7 +10,7 @@ module SPARQL; module Algebra
10
10
  # (filter (= (str ?v) "1")
11
11
  # (bgp (triple ?x :p ?v)))))
12
12
  #
13
- # @see http://www.w3.org/TR/sparql11-query/#func-str
13
+ # @see https://www.w3.org/TR/sparql11-query/#func-str
14
14
  class Str < Operator::Unary
15
15
  include Evaluatable
16
16
 
@@ -6,8 +6,8 @@ module SPARQL; module Algebra
6
6
  # @example
7
7
  # (strafter ?x ?y)
8
8
  #
9
- # @see http://www.w3.org/TR/sparql11-query/#func-strafter
10
- # @see http://www.w3.org/TR/xpath-functions/#func-substring-after
9
+ # @see https://www.w3.org/TR/sparql11-query/#func-strafter
10
+ # @see https://www.w3.org/TR/xpath-functions/#func-substring-after
11
11
  class StrAfter < Operator::Binary
12
12
  include Evaluatable
13
13
 
@@ -6,8 +6,8 @@ module SPARQL; module Algebra
6
6
  # @example
7
7
  # (strbefore ?x ?y)
8
8
  #
9
- # @see http://www.w3.org/TR/sparql11-query/#func-strbefore
10
- # @see http://www.w3.org/TR/xpath-functions/#func-substring-before
9
+ # @see https://www.w3.org/TR/sparql11-query/#func-strbefore
10
+ # @see https://www.w3.org/TR/xpath-functions/#func-substring-before
11
11
  class StrBefore < Operator::Binary
12
12
  include Evaluatable
13
13
 
@@ -9,7 +9,7 @@ module SPARQL; module Algebra
9
9
  # (filter (langMatches (lang ?str) "en")
10
10
  # (bgp (triple ?s :str ?str))))))
11
11
  #
12
- # @see http://www.w3.org/TR/sparql11-query/#func-strdt
12
+ # @see https://www.w3.org/TR/sparql11-query/#func-strdt
13
13
  class StrDT < Operator::Binary
14
14
  include Evaluatable
15
15
 
@@ -23,7 +23,7 @@ module SPARQL; module Algebra
23
23
  # @param [RDF::URI] datatypeIRI
24
24
  # datatype
25
25
  # @return [RDF::Literal] a datatyped literal
26
- # @see http://www.w3.org/TR/sparql11-query/#func-strdt
26
+ # @see https://www.w3.org/TR/sparql11-query/#func-strdt
27
27
  def apply(value, datatypeIRI)
28
28
  raise TypeError, "Literal #{value.inspect} is not simple" unless value.simple?
29
29
  RDF::Literal.new(value.to_s, datatype: datatypeIRI)
@@ -6,8 +6,8 @@ module SPARQL; module Algebra
6
6
  # @example
7
7
  # (strends ?x ?y)
8
8
  #
9
- # @see http://www.w3.org/TR/sparql11-query/#func-strends
10
- # @see http://www.w3.org/TR/xpath-functions/#func-ends-with
9
+ # @see https://www.w3.org/TR/sparql11-query/#func-strends
10
+ # @see https://wwww.w3.org/TR/xpath-functions/#func-ends-with
11
11
  class StrEnds < Operator::Binary
12
12
  include Evaluatable
13
13
 
@@ -10,7 +10,7 @@ module SPARQL; module Algebra
10
10
  # (filter (langMatches (lang ?str) "en")
11
11
  # (bgp (triple ?s :str ?str))))))
12
12
  #
13
- # @see http://www.w3.org/TR/sparql11-query/#func-strlang
13
+ # @see https://www.w3.org/TR/sparql11-query/#func-strlang
14
14
  class StrLang < Operator::Binary
15
15
  include Evaluatable
16
16
 
@@ -24,7 +24,7 @@ module SPARQL; module Algebra
24
24
  # @param [RDF::Literal] langTag
25
25
  # datatype
26
26
  # @return [RDF::Literal] a datatyped literal
27
- # @see http://www.w3.org/TR/sparql11-query/#func-strlang
27
+ # @see https://www.w3.org/TR/sparql11-query/#func-strlang
28
28
  def apply(value, langTag)
29
29
  raise TypeError, "Literal #{value.inspect} is not simple" unless value.simple?
30
30
  RDF::Literal.new(value.to_s, language: langTag.to_s)
@@ -6,8 +6,8 @@ module SPARQL; module Algebra
6
6
  # @example
7
7
  # (strlen ?x)
8
8
  #
9
- # @see http://www.w3.org/TR/sparql11-query/#func-strlen
10
- # @see http://www.w3.org/TR/xpath-functions/#func-string-length
9
+ # @see https://www.w3.org/TR/sparql11-query/#func-strlen
10
+ # @see https://www.w3.org/TR/xpath-functions/#func-string-length
11
11
  class StrLen < Operator::Unary
12
12
  include Evaluatable
13
13
 
@@ -6,8 +6,8 @@ module SPARQL; module Algebra
6
6
  # @example
7
7
  # (strstarts ?x ?y)
8
8
  #
9
- # @see http://www.w3.org/TR/sparql11-query/#func-strstarts
10
- # @see http://www.w3.org/TR/xpath-functions/#func-starts-with
9
+ # @see https://www.w3.org/TR/sparql11-query/#func-strstarts
10
+ # @see https://www.w3.org/TR/xpath-functions/#func-starts-with
11
11
  class StrStarts < Operator::Binary
12
12
  include Evaluatable
13
13
 
@@ -14,7 +14,7 @@ module SPARQL; module Algebra
14
14
  # (extend ((?uuid (struuid)))
15
15
  # (bgp))))))
16
16
  #
17
- # @see http://www.w3.org/TR/sparql11-query/#func-struuid
17
+ # @see https://www.w3.org/TR/sparql11-query/#func-struuid
18
18
  class StrUUID < Operator::Nullary
19
19
  include Evaluatable
20
20
 
@@ -6,8 +6,8 @@ module SPARQL; module Algebra
6
6
  # @example
7
7
  # (substr ?x ?y)
8
8
  #
9
- # @see http://www.w3.org/TR/sparql11-query/#func-substr
10
- # @see http://www.w3.org/TR/xpath-functions/#func-substring
9
+ # @see https://www.w3.org/TR/sparql11-query/#func-substr
10
+ # @see https://www.w3.org/TR/xpath-functions/#func-substring
11
11
  class SubStr < Operator::Ternary
12
12
  include Evaluatable
13
13
 
@@ -22,7 +22,7 @@ module SPARQL; module Algebra
22
22
  # @param [Hash{Symbol => Object}] options
23
23
  # any additional options (see {Operator#initialize})
24
24
  # @raise [TypeError] if any operand is invalid
25
- def initialize(source, startingLoc, length = RDF::Literal(""), options = {})
25
+ def initialize(source, startingLoc, length = RDF::Literal(""), **options)
26
26
  super
27
27
  end
28
28
 
@@ -71,7 +71,7 @@ module SPARQL; module Algebra
71
71
  # Remove the optional argument.
72
72
  #
73
73
  # @return [Array] `self`
74
- # @see http://openjena.org/wiki/SSE
74
+ # @see https://openjena.org/wiki/SSE
75
75
  def to_sxp_bin
76
76
  [NAME] + operands.reject {|o| o.to_s == ""}
77
77
  end
@@ -5,7 +5,7 @@ module SPARQL; module Algebra
5
5
  # (- ?x ?y)
6
6
  # (subtract ?x ?y)
7
7
  #
8
- # @see http://www.w3.org/TR/xpath-functions/#func-numeric-subtract
8
+ # @see https://www.w3.org/TR/xpath-functions/#func-numeric-subtract
9
9
  class Subtract < Operator::Binary
10
10
  include Evaluatable
11
11
 
@@ -6,12 +6,12 @@ module SPARQL; module Algebra
6
6
  # @example
7
7
  # (prefix ((: <http://www.example.org/>))
8
8
  # (project (?sum)
9
- # (extend ((?sum ?.0))
10
- # (group () ((?.0 (sum ?o)))
9
+ # (extend ((?sum ??.0))
10
+ # (group () ((??.0 (sum ?o)))
11
11
  # (bgp (triple ?s :dec ?o))))))
12
12
  #
13
- # @see http://www.w3.org/TR/sparql11-query/#defn_aggSum
14
- class Sum < Operator::Unary
13
+ # @see https://www.w3.org/TR/sparql11-query/#defn_aggSum
14
+ class Sum < Operator
15
15
  include Aggregate
16
16
 
17
17
  NAME = :sum
@@ -23,6 +23,8 @@ module SPARQL; module Algebra
23
23
  # enum of evaluated operand
24
24
  # @return [RDF::Literal::Numeric] The sum of the terms
25
25
  def apply(enum)
26
+ # FIXME: we don't actually do anything with distinct
27
+ operands.shift if distinct = (operands.first == :distinct)
26
28
  if enum.empty?
27
29
  RDF::Literal(0)
28
30
  elsif enum.flatten.all? {|n| n.is_a?(RDF::Literal::Numeric)}
@@ -11,7 +11,9 @@ module SPARQL; module Algebra
11
11
  # (row (?title "SPARQL Tutorial"))
12
12
  # (row (?book :book2)))
13
13
  #
14
- # @see http://www.w3.org/TR/2013/REC-sparql11-query-20130321/#inline-data
14
+ # @example empty table
15
+ # (table unit)
16
+ # @see https://www.w3.org/TR/2013/REC-sparql11-query-20130321/#inline-data
15
17
  class Table < Operator
16
18
  include Query
17
19
 
@@ -30,10 +32,10 @@ module SPARQL; module Algebra
30
32
  # @yieldreturn [void] ignored
31
33
  # @return [RDF::Query::Solutions]
32
34
  # the resulting solution sequence
33
- # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
34
- def execute(queryable, options = {}, &block)
35
+ # @see https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
36
+ def execute(queryable, **options, &block)
35
37
  @solutions = RDF::Query::Solutions()
36
- operands[1..-1].each do |row|
38
+ Array(operands[1..-1]).each do |row|
37
39
  next unless row.is_a?(Array)
38
40
  bindings = row[1..-1].inject({}) do |memo, (var, value)|
39
41
  memo[var.to_sym] = value unless value == :undef
@@ -11,7 +11,7 @@ module SPARQL; module Algebra
11
11
  # (extend ((?x (timezone ?date)))
12
12
  # (bgp (triple ?s :date ?date)))))
13
13
  #
14
- # @see http://www.w3.org/TR/sparql11-query/#func-timezone
14
+ # @see https://www.w3.org/TR/sparql11-query/#func-timezone
15
15
  class Timezone < Operator::Unary
16
16
  include Evaluatable
17
17
 
@@ -11,7 +11,7 @@ module SPARQL; module Algebra
11
11
  # (extend ((?x (tz ?date)))
12
12
  # (bgp (triple ?s :date ?date)))))
13
13
  #
14
- # @see http://www.w3.org/TR/sparql11-query/#func-tz
14
+ # @see https://www.w3.org/TR/sparql11-query/#func-tz
15
15
  class TZ < Operator::Unary
16
16
  include Evaluatable
17
17
 
@@ -6,8 +6,8 @@ module SPARQL; module Algebra
6
6
  # @example
7
7
  # (ucase ?x)
8
8
  #
9
- # @see http://www.w3.org/TR/sparql11-query/#func-ucase
10
- # @see http://www.w3.org/TR/xpath-functions/#func-ucase
9
+ # @see https://www.w3.org/TR/sparql11-query/#func-ucase
10
+ # @see https://www.w3.org/TR/xpath-functions/#func-ucase
11
11
  class UCase < Operator::Unary
12
12
  include Evaluatable
13
13
 
@@ -10,7 +10,7 @@ module SPARQL; module Algebra
10
10
  # (graph ?g
11
11
  # (bgp (triple ?s ?p ?o)))))
12
12
  #
13
- # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
13
+ # @see https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
14
14
  class Union < Operator::Binary
15
15
  include Query
16
16
 
@@ -30,11 +30,11 @@ module SPARQL; module Algebra
30
30
  # @yieldreturn [void] ignored
31
31
  # @return [RDF::Query::Solutions]
32
32
  # the resulting solution sequence
33
- # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
34
- def execute(queryable, options = {}, &block)
33
+ # @see https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
34
+ def execute(queryable, **options, &block)
35
35
  debug(options) {"Union"}
36
36
  @solutions = RDF::Query::Solutions(operands.inject([]) do |memo, op|
37
- solns = op.execute(queryable, options.merge(depth: options[:depth].to_i + 1))
37
+ solns = op.execute(queryable, depth: options[:depth].to_i + 1, **options)
38
38
  debug(options) {"=> (op) #{solns.inspect}"}
39
39
  memo + solns
40
40
  end)
@@ -45,7 +45,7 @@ module SPARQL; module Algebra
45
45
 
46
46
  # The same blank node label cannot be used in two different basic graph patterns in the same query
47
47
  def validate!
48
- left_nodes, right_nodes = operand(0).ndvars, operand(1).ndvars
48
+ left_nodes, right_nodes = operand(0).ndvars.map(&:name), operand(1).ndvars.map(&:name)
49
49
 
50
50
  unless (left_nodes.compact & right_nodes.compact).empty?
51
51
  raise ArgumentError,
@@ -55,13 +55,14 @@ module SPARQL; module Algebra
55
55
  end
56
56
 
57
57
  ##
58
- # Returns an optimized version of this query.
58
+ # Optimizes this query.
59
59
  #
60
60
  # Optimize operands and remove any which are empty.
61
61
  #
62
- # @return [Union, RDF::Query] `self`
63
- def optimize
64
- ops = operands.map {|o| o.optimize }.select {|o| o.respond_to?(:empty?) && !o.empty?}
62
+ # @return [self]
63
+ # @see SPARQL::Algebra::Expression#optimize!
64
+ def optimize!(**options)
65
+ ops = operands.map {|o| o.optimize(**options) }.select {|o| o.respond_to?(:empty?) && !o.empty?}
65
66
  @operands = ops
66
67
  self
67
68
  end
@@ -9,7 +9,7 @@ module SPARQL; module Algebra
9
9
  # (bgp (triple ?s ?p ?o))
10
10
  # (insert ((triple ?s ?p "q")))))
11
11
  #
12
- # @see http://www.w3.org/TR/sparql11-update/#graphUpdate
12
+ # @see https://www.w3.org/TR/sparql11-update/#graphUpdate
13
13
  class Update < Operator
14
14
  include SPARQL::Algebra::Update
15
15
 
@@ -30,12 +30,12 @@ module SPARQL; module Algebra
30
30
  # If an attempt is made to perform an unsupported operation
31
31
  # @raise [IOError]
32
32
  # If `queryable` is immutable
33
- # @see http://www.w3.org/TR/sparql11-update/
34
- def execute(queryable, options = {})
33
+ # @see https://www.w3.org/TR/sparql11-update/
34
+ def execute(queryable, **options)
35
35
  debug(options) {"Update"}
36
36
  raise IOError, "queryable is not mutable" unless queryable.mutable?
37
37
  operands.each do |op|
38
- op.execute(queryable, options.merge(depth: options[:depth].to_i + 1))
38
+ op.execute(queryable, depth: options[:depth].to_i + 1, **options)
39
39
  end
40
40
  queryable
41
41
  end
@@ -9,7 +9,7 @@ module SPARQL; module Algebra
9
9
  # @example
10
10
  # (using (:g1) (bgp (triple ?s ?p ?o)))
11
11
  #
12
- # @see http://www.w3.org/TR/sparql11-update/#add
12
+ # @see https://www.w3.org/TR/sparql11-update/#add
13
13
  class Using < Operator
14
14
  include SPARQL::Algebra::Query
15
15
 
@@ -30,10 +30,10 @@ module SPARQL; module Algebra
30
30
  # Returns queryable.
31
31
  # @raise [IOError]
32
32
  # If `from` does not exist, unless the `silent` operator is present
33
- # @see http://www.w3.org/TR/sparql11-update/
34
- def execute(queryable, options = {}, &block)
33
+ # @see https://www.w3.org/TR/sparql11-update/
34
+ def execute(queryable, **options, &block)
35
35
  debug(options) {"Using"}
36
- Dataset.new(*operands).execute(queryable, options.merge(depth: options[:depth].to_i + 1), &block)
36
+ Dataset.new(*operands).execute(queryable, depth: options[:depth].to_i + 1, **options, &block)
37
37
  end
38
38
  end # Using
39
39
  end # Operator
@@ -14,7 +14,7 @@ module SPARQL; module Algebra
14
14
  # (extend ((?uuid (uuid)))
15
15
  # (bgp))))))
16
16
  #
17
- # @see http://www.w3.org/TR/sparql11-query/#func-uuid
17
+ # @see https://www.w3.org/TR/sparql11-query/#func-uuid
18
18
  class UUID < Operator::Nullary
19
19
  include Evaluatable
20
20
 
@@ -11,7 +11,7 @@ module SPARQL; module Algebra
11
11
  # (bgp (triple ?s ?p ?o))
12
12
  # (insert ((triple ?s ?p "z"))))
13
13
  #
14
- # @see http://www.w3.org/TR/sparql11-update/#deleteInsert
14
+ # @see https://www.w3.org/TR/sparql11-update/#deleteInsert
15
15
  class With < Operator
16
16
  include SPARQL::Algebra::Update
17
17
 
@@ -32,8 +32,8 @@ module SPARQL; module Algebra
32
32
  # Returns queryable.
33
33
  # @raise [IOError]
34
34
  # If `from` does not exist, unless the `silent` operator is present
35
- # @see http://www.w3.org/TR/sparql11-update/
36
- def execute(queryable, options = {})
35
+ # @see https://www.w3.org/TR/sparql11-update/
36
+ def execute(queryable, **options)
37
37
  debug(options) {"With: #{operand.to_sse}"}
38
38
  # Bound variable
39
39
  name = operands.shift
@@ -42,7 +42,7 @@ module SPARQL; module Algebra
42
42
  debug(options) {"=> default data source #{name}"}
43
43
  load_opts = {debug: options.fetch(:debug, nil), base_uri: name}
44
44
  debug(options) {"=> load #{name}"}
45
- queryable.load(name.to_s, load_opts)
45
+ queryable.load(name.to_s, **load_opts)
46
46
  end
47
47
 
48
48
  # Set name for RDF::Graph descendants having no graph_name to the name variable
@@ -58,12 +58,12 @@ module SPARQL; module Algebra
58
58
  query = operands.shift
59
59
 
60
60
  # Restrict query portion to this graph
61
- queryable.query(query, options.merge(depth: options[:depth].to_i + 1)) do |solution|
61
+ queryable.query(query, depth: options[:depth].to_i + 1, **options) do |solution|
62
62
  debug(options) {"(solution)=>#{solution.inspect}"}
63
63
 
64
64
  # Execute each operand with queryable and solution
65
65
  operands.each do |op|
66
- op.execute(queryable, solution, options.merge(depth: options[:depth].to_i + 1))
66
+ op.execute(queryable, solutions: solution, depth: options[:depth].to_i + 1, **options)
67
67
  end
68
68
  end
69
69
  end