sparql 3.2.3 → 3.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 853c52b99bab0b9455b25a81c8c946e5bcb1429dddadf010b66315f1dbafda51
-  data.tar.gz: 90d89877c031476efdaa1d0b119b2a2404925186b4e0b3de99818d75ead76bff
+  metadata.gz: 932897287930ea7265a07628e73c13a06b02b9e0d1572b578356166d3c8fe70a
+  data.tar.gz: 9d17310bc07080475780c8acccbe57acb4bbeb40e3f66ab7b74a09b15ccf0863
 SHA512:
-  metadata.gz: 98816c81664147aa0fa4ccd90ed14461eb51b652b011395f38f044934c2ff335197fbc3d2d7f447771a5b1e46fa24042aef45fd1f95356b91f52bafee48d1a72
-  data.tar.gz: 5545d7ddd245d73382229ed6f9996b24bd66a4285ee18d6295f697202ad5901eb4221cbf2533ef1539b98ccc0c095519e531b541db3e1c4757d813ab888cb9fd
+  metadata.gz: e701784500aece828b2cfd41eb0af78a809bda575eed047158e962ff38678d524b179c0c3faef21fc5b5724894ada3066637b608778a1809fdc7b9bda2ffe2a2
+  data.tar.gz: 77c2520a5f4923a1fe27d589ea6a09b6f5a36fa9c17b564184f206971204fec6988b0941c350e10d812ccfd9b0934e6ae629b82207abfaabf8d7bcc3a380ab33

data/VERSION

@@ -1 +1 @@
-3.2.3
+3.2.4

data/lib/sparql/algebra/expression.rb

@@ -140,7 +140,7 @@ module SPARQL; module Algebra
       logger = options[:logger]
       options.delete_if {|k, v| [:debug, :logger, :depth, :prefixes, :base_uri, :update, :validate].include?(k) }
       begin
-        # Due to confusiong over (triple) and special-case for (qtriple)
+        # Due to confusion over (triple) and special-case for (qtriple)
         if operator == RDF::Query::Pattern
           options = options.merge(quoted: true) if sse.first == :qtriple
         elsif operator == Operator::Triple && PATTERN_PARENTS.include?(parent_operator)

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

@@ -84,6 +84,11 @@ module SPARQL; module Algebra
         debug(options) {"Extend"}
         @solutions = operand(1).execute(queryable, depth: options[:depth].to_i + 1, **options)
         @solutions.each do |solution|
+          # Re-bind to bindings, if defined, as they might not be found in solution
+          options[:bindings].each_binding do |name, value|
+            solution[name] = value if operands.first.variables.include?(name)
+          end if options[:bindings] && operands.first.respond_to?(:variables)
+
           debug(options) {"===> soln #{solution.to_h.inspect}"}
           operand(0).each do |(var, expr)|
             begin

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

@@ -49,6 +49,11 @@ module SPARQL; module Algebra
         opts = options.merge(queryable: queryable, depth: options[:depth].to_i + 1)
         @solutions = RDF::Query::Solutions()
         queryable.query(operands.last, depth: options[:depth].to_i + 1, **options) do |solution|
+          # Re-bind to bindings, if defined, as they might not be found in solution
+          options[:bindings].each_binding do |name, value|
+            solution[name] ||= value if operands.first.variables.include?(name)
+          end if options[:bindings] && operands.first.respond_to?(:variables)
+
           begin
             pass = boolean(operands.first.evaluate(solution, **opts)).true?
             debug(options) {"(filter) #{pass.inspect} #{solution.to_h.inspect}"}

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

@@ -66,6 +66,11 @@ module SPARQL; module Algebra
           load_left = true
           right.each do |s2|
             s = s2.merge(s1)
+            # Re-bind to bindings, if defined, as they might not be found in solution
+            options[:bindings].each_binding do |name, value|
+              s[name] = value if filter.variables.include?(name)
+            end if options[:bindings] && filter.respond_to?(:variables)
+
             expr = filter ? boolean(filter.evaluate(s)).true? : true rescue false
             debug(options) {"===>(evaluate) #{s.inspect}"} if filter
 

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

@@ -0,0 +1,86 @@
+module SPARQL; module Algebra
+  class Operator
+    ##
+    # The SPARQL Service operator.
+    #
+    # [59]  ServiceGraphPattern ::= 'SERVICE' 'SILENT'? VarOrIri GroupGraphPattern
+    #
+    # @example SPARQL Grammar
+    #   PREFIX : <http://example.org/> 
+    #   
+    #   SELECT ?s ?o1 ?o2  {
+    #     ?s ?p1 ?o1 .
+    #     SERVICE <http://example.org/sparql> {
+    #       ?s ?p2 ?o2
+    #     }
+    #   } 
+    #
+    # @example SSE
+    #   (prefix ((: <http://example.org/>))
+    #     (project (?s ?o1 ?o2)
+    #       (join
+    #         (bgp (triple ?s ?p1 ?o1))
+    #         (service :sparql
+    #           (bgp (triple ?s ?p2 ?o2))))))
+    #
+    # @see https://www.w3.org/TR/sparql11-query/#QSynIRI
+    class Service < Operator
+      include Query
+  
+      NAME = [:service]
+
+      ##
+      # Executes this query on the given `queryable` graph or repository.
+      # Really a pass-through, as this is a syntactic object used for providing
+      # graph_name for URIs.
+      #
+      # @param  [RDF::Queryable] queryable
+      #   the graph or repository to query
+      # @param  [Hash{Symbol => Object}] options
+      #   any additional keyword options
+      # @yield  [solution]
+      #   each matching solution, statement or boolean
+      # @yieldparam  [RDF::Statement, RDF::Query::Solution, Boolean] solution
+      # @yieldreturn [void] ignored
+      # @return [RDF::Query::Solutions]
+      #   the resulting solution sequence
+      # @see    https://www.w3.org/TR/sparql11-query/#sparqlAlgebra
+      def execute(queryable, **options, &block)
+        debug(options) {"Service"}
+        silent = operands.first == :silent
+        location, query = operands
+        query_sparql = query.to_sparql
+        debug(options) {"query: #{query_sparql}"}
+        raise NotImplementedError, "SERVICE operator not implemented"
+      end
+
+      ##
+      # Returns an optimized version of this query.
+      #
+      # Replace with the query with URIs having their lexical shortcut removed
+      #
+      # @return [Prefix] a copy of `self`
+      # @see SPARQL::Algebra::Expression#optimize
+      def optimize(**options)
+        operands.last.optimize(**options)
+      end
+
+      ##
+      #
+      # Returns a partial SPARQL grammar for this term.
+      #
+      # @return [String]
+      def to_sparql(**options)
+        silent = operands.first == :silent
+        ops = silent ? operands[1..-1] : operands
+        location, query = ops
+
+        
+        str = "SERVICE "
+        str << "SILENT " if silent
+        str << location.to_sparql(**options) + " {" + query.to_sparql(**options) + "}"
+        str
+      end
+    end # Service
+  end # Operator
+end; end # SPARQL::Algebra

data/lib/sparql/algebra/operator.rb

@@ -134,6 +134,7 @@ module SPARQL; module Algebra
     autoload :Prefix,             'sparql/algebra/operator/prefix'
     autoload :Project,            'sparql/algebra/operator/project'
     autoload :Reduced,            'sparql/algebra/operator/reduced'
+    autoload :Service,            'sparql/algebra/operator/service'
     autoload :Slice,              'sparql/algebra/operator/slice'
     autoload :Table,              'sparql/algebra/operator/table'
     autoload :Union,              'sparql/algebra/operator/union'
@@ -236,6 +237,7 @@ module SPARQL; module Algebra
         when :seconds         then Seconds
         when :seq             then Seq
         when :sequence        then Sequence
+        when :service         then Service
         when :sha1            then SHA1
         when :sha256          then SHA256
         when :sha384          then SHA384

data/lib/sparql/grammar/parser11.rb

@@ -916,6 +916,19 @@ module SPARQL::Grammar
       end
     end
 
+    # [59]  ServiceGraphPattern ::= 'SERVICE' 'SILENT'? VarOrIri GroupGraphPattern
+    #
+    # Input from `data` is TODO.
+    # Output to prod_data is TODO.
+    production(:ServiceGraphPattern) do |input, data, callback|
+      args = []
+      args << :silent if data[:silent]
+      args << (data[:VarOrIri]).last
+      args << data.fetch(:query, [SPARQL::Algebra::Operator::BGP.new]).first
+      service = SPARQL::Algebra::Expression.for(:service, *args)
+      add_prod_data(:query, service)
+    end
+
     # [60]  Bind ::= 'BIND' '(' Expression 'AS' Var ')'
     #
     # Input from `data` is TODO.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sparql
 version: !ruby/object:Gem::Version
-  version: 3.2.3
+  version: 3.2.4
 platform: ruby
 authors:
 - Gregg Kellogg
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-05 00:00:00.000000000 Z
+date: 2022-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rdf
@@ -20,7 +20,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.7
+        version: 3.2.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -30,7 +30,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.7
+        version: 3.2.8
 - !ruby/object:Gem::Dependency
   name: rdf-aggregate-repo
   requirement: !ruby/object:Gem::Requirement
@@ -389,6 +389,7 @@ files:
 - lib/sparql/algebra/operator/seconds.rb
 - lib/sparql/algebra/operator/seq.rb
 - lib/sparql/algebra/operator/sequence.rb
+- lib/sparql/algebra/operator/service.rb
 - lib/sparql/algebra/operator/sha1.rb
 - lib/sparql/algebra/operator/sha256.rb
 - lib/sparql/algebra/operator/sha384.rb