sparql 1.99.1 → 2.0.0.beta1

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

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #       (project (?v)
     #         (bgp (triple ?x ?p ?v)))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
+    # @see http://www.w3.org/TR/sparql11-query/#sparqlDistinct
     class Distinct < Operator::Unary
       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/rdf-sparql-query/#sparqlAlgebra
+      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
       def execute(queryable, options = {}, &block)
         @solutions = queryable.query(operands.last, options.merge(depth: options[:depth].to_i + 1)).distinct
         @solutions.each(&block) if block_given?

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

@@ -16,7 +16,7 @@ module SPARQL; module Algebra
       NAME = :encode_for_uri
 
       ##
-      # The ENCODE_FOR_URI function corresponds to the XPath fn:encode-for-uri function. It returns a simple literal with the lexical form obtained from the lexical form of its input after translating reserved characters according to the fn:encode-for-uri function.
+      # The `ENCODE_FOR_URI` function corresponds to the XPath fn:encode-for-uri function. It returns a simple literal with the lexical form obtained from the lexical form of its input after translating reserved characters according to the fn:encode-for-uri function.
       #
       # @example
       #     encode_for_uri("Los Angeles")	"Los%20Angeles"

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

@@ -6,13 +6,17 @@ module SPARQL; module Algebra
     # @example
     #   (= ?x ?y)
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#OperatorMapping
-    # @see http://www.w3.org/TR/rdf-sparql-query/#func-RDFterm-equal
+    # @see http://www.w3.org/TR/sparql11-query/#OperatorMapping
+    # @see http://www.w3.org/TR/sparql11-query/#func-RDFterm-equal
     class Equal < Compare
       NAME = :'='
 
       ##
-      # Returns `true` if the operands are equal; returns `false` otherwise.
+      # Returns TRUE if `term1` and `term2` are the same RDF term as defined in Resource Description Framework (RDF): Concepts and Abstract Syntax [CONCEPTS]; produces a type error if the arguments are both literal but are not the same RDF term *; returns FALSE otherwise. `term1` and `term2` are the same if any of the following is true:
+      #
+      # * term1 and term2 are equivalent IRIs as defined in 6.4 RDF URI References of [CONCEPTS].
+      # * term1 and term2 are equivalent literals as defined in 6.5.1 Literal Equality of [CONCEPTS].
+      # * term1 and term2 are the same blank node as described in 6.6 Blank Nodes of [CONCEPTS].
       #
       # @param  [RDF::Term] term1
       #   an RDF term

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

@@ -3,13 +3,14 @@ module SPARQL; module Algebra
     ##
     # The SPARQL logical `exists` operator.
     #
+    # There is a filter operator EXISTS that takes a graph pattern. EXISTS returns `true`/`false` depending on whether the pattern matches the dataset given the bindings in the current group graph pattern, the dataset and the active graph at this point in the query evaluation. No additional binding of variables occurs. The `NOT EXISTS` form translates into `fn:not(EXISTS{...})`.
+    #
     # @example
     #    (prefix ((ex: <http://www.example.org/>))
     #      (filter (exists (bgp (triple ?s ?p ex:o)))
     #      (bgp (triple ?s ?p ?o))))
     #
-    # @see http://www.w3.org/TR/sparql11-query/#func-abs
-    # @see http://www.w3.org/TR/xpath-functions/#func-abs
+    # @see http://www.w3.org/TR/sparql11-query/#func-filter-exists
     class Exists < Operator::Unary
       include Evaluatable
 

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

@@ -14,7 +14,7 @@ module SPARQL; module Algebra
     #           (triple ?s :q ?w)
     #         ))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#evaluation
+    # @see http://www.w3.org/TR/sparql11-query/#evaluation
     class Exprlist < Operator
       include Evaluatable
 

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

@@ -11,7 +11,7 @@ module SPARQL; module Algebra
     #       (extend ((?z (+ ?o 10)))
     #         (bgp (triple ?s <http://example/p> ?o)))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#evaluation
+    # @see http://www.w3.org/TR/sparql11-query/#evaluation
     class Extend < Operator::Binary
       include Query
       
@@ -38,7 +38,7 @@ module SPARQL; module Algebra
       # @yieldreturn [void] ignored
       # @return [RDF::Query::Solutions]
       #   the resulting solution sequence
-      # @see http://www.w3.org/TR/rdf-sparql-query/#evaluation
+      # @see http://www.w3.org/TR/sparql11-query/#evaluation
       def execute(queryable, options = {}, &block)
         debug(options) {"Extend"}
         @solutions = operand(1).execute(queryable, options.merge(depth: options[:depth].to_i + 1))

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

@@ -9,7 +9,7 @@ module SPARQL; module Algebra
     #       (filter (= ?v 2)
     #         (bgp (triple ?s <http://example/p> ?v)))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#evaluation
+    # @see http://www.w3.org/TR/sparql11-query/#evaluation
     class Filter < Operator::Binary
       include Query
       
@@ -34,8 +34,8 @@ module SPARQL; module Algebra
       # @yieldreturn [void] ignored
       # @return [RDF::Query::Solutions]
       #   the resulting solution sequence
-      # @see    http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
-      # @see    http://www.w3.org/TR/rdf-sparql-query/#ebv
+      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
+      # @see    http://www.w3.org/TR/sparql11-query/#ebv
       def execute(queryable, options = {}, &block)
         debug(options) {"Filter #{operands.first.to_sxp}"}
         opts = options.merge(queryable: queryable, depth: options[:depth].to_i + 1)

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

@@ -14,7 +14,9 @@ module SPARQL; module Algebra
       NAME = [:floor]
 
       ##
-      # Returns the largest (closest to positive infinity) number with no fractional part that is not greater than the value of $arg. If type of $arg is one of the four numeric types xs:float, xs:double, xs:decimal or xs:integer the type of the result is the same as the type of $arg. If the type of $arg is a type derived from one of the numeric types, the result is an instance of the base numeric type.
+      # Returns the largest (closest to positive infinity) number with no fractional part that is not greater than the value of `arg`. An error is raised if `arg` is not a numeric value.
+      #
+      # If type of $arg is one of the four numeric types xs:float, xs:double, xs:decimal or xs:integer the type of the result is the same as the type of $arg. If the type of $arg is a type derived from one of the numeric types, the result is an instance of the base numeric type.
       #
       # For float and double arguments, if the argument is positive zero, then positive zero is returned. If the argument is negative zero, then negative zero is returned.
       #

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

@@ -15,7 +15,7 @@ module SPARQL; module Algebra
     #     (graph :g
     #       ((triple :s :p :o))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
+    # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
     class Graph < Operator::Binary
       include Query
       
@@ -63,7 +63,7 @@ module SPARQL; module Algebra
       # @yieldreturn [void] ignored
       # @return [RDF::Query::Solutions]
       #   the resulting solution sequence
-      # @see    http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
+      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
       def execute(queryable, options = {}, &block)
         debug(options) {"Graph #{operands.first}"}
         graph_name, query = operands.first, operands.last

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

@@ -6,7 +6,7 @@ module SPARQL; module Algebra
     # @example
     #   (> ?x ?y)
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#OperatorMapping
+    # @see http://www.w3.org/TR/sparql11-query/#OperatorMapping
     # @see http://www.w3.org/TR/xpath-functions/#func-compare
     # @see http://www.w3.org/TR/xpath-functions/#func-numeric-greater-than
     # @see http://www.w3.org/TR/xpath-functions/#func-boolean-greater-than

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

@@ -7,7 +7,7 @@ module SPARQL; module Algebra
     # @example
     #   (>= ?x ?y)
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#OperatorMapping
+    # @see http://www.w3.org/TR/sparql11-query/#OperatorMapping
     # @see http://www.w3.org/TR/xpath-functions/#func-compare
     # @see http://www.w3.org/TR/xpath-functions/#func-numeric-greater-than
     # @see http://www.w3.org/TR/xpath-functions/#func-boolean-greater-than

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

@@ -17,7 +17,7 @@ module SPARQL; module Algebra
     #               (bgp (triple ?s :p ?v))
     #               (bgp (triple ?s :q ?w)))))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
+    # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
     class Group < Operator
       include Query
       

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

@@ -3,6 +3,8 @@ module SPARQL; module Algebra
     ##
     # The SPARQL `groupconcat` set function.
     #
+    # GroupConcat is a set function which performs a string concatenation across the values of an expression with a group. The order of the strings is not specified. The separator character used in the concatenation may be given with the scalar argument SEPARATOR.
+    #
     # @example
     #    (prefix ((: <http://www.example.org/>))
     #      (filter (|| (= ?g "1 22") (= ?g "22 1"))
@@ -16,9 +18,8 @@ module SPARQL; module Algebra
       include Aggregate
 
       NAME = :group_concat
-
       ##
-      # One, two or three operands, the first may be `distinct`, the last operand, if it exists, is a separator, defaulting to ' '.
+      # One or two operands, the second operand, if it exists, is a separator, defaulting to ' '.
       #
       # @param  [Enumerable<RDF::Query::Solution>] solutions ([])
       #   an enumerable set of query solutions
@@ -28,7 +29,6 @@ module SPARQL; module Algebra
       # @raise [TypeError]
       # @abstract
       def aggregate(solutions = [], options = {})
-        operands.shift if distinct = (operands.first == :distinct)
         sep = operands.length == 2 ? operand(0).last : RDF::Literal(' ')
         args_enum = solutions.map do |solution|
           begin
@@ -38,9 +38,10 @@ module SPARQL; module Algebra
             nil
           end
         end
-        apply(distinct ? args_enum.uniq : args_enum, sep)
+        apply(args_enum, sep)
       end
 
+
       ##
       # GroupConcat is a set function which performs a string concatenation across the values of an expression with a group. The order of the strings is not specified. The separator character used in the concatenation may be given with the scalar argument SEPARATOR.
       #

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

@@ -16,7 +16,7 @@ module SPARQL; module Algebra
       NAME = :hours
 
       ##
-      # Returns the hours part of arg as an integer.
+      # Returns the hours part of `arg` as an integer. The value is as given in the lexical form of the XSD dateTime.
       #
       # @param  [RDF::Literal] operand
       #   the operand

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

@@ -17,7 +17,7 @@ module SPARQL; module Algebra
       NAME = :if
 
       ##
-      # The IF function form evaluates the first argument, interprets it as a effective boolean value, then returns the value of expression2 if the EBV is true, otherwise it returns the value of expression3. Only one of expression2 and expression3 is evaluated. If evaluating the first argument raises an error, then an error is raised for the evaluation of the IF expression.
+      # The IF function form evaluates the first argument, interprets it as a effective boolean value, then returns the value of `expression2` if the EBV is true, otherwise it returns the value of `expression3`. Only one of `expression2` and `expression3` is evaluated. If evaluating the first argument raises an error, then an error is raised for the evaluation of the IF expression.
       #
       # @example
       #

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

@@ -3,8 +3,6 @@ module SPARQL; module Algebra
     ##
     # The SPARQL GraphPattern `in` operator.
     #
-    # Used for filters with more than one expression.
-    #
     # @example
     #   (ask (filter (in 2 1 2 3) (bgp)))
     #
@@ -16,11 +14,11 @@ module SPARQL; module Algebra
 
       ##
       # The IN operator tests whether the RDF term on the left-hand side is found in the values of list of expressions on the right-hand side. The test is done with "=" operator, which tests for the same value, as determined by the operator mapping.
-      # 
+      #
       # A list of zero terms on the right-hand side is legal.
-      # 
+      #
       # Errors in comparisons cause the IN expression to raise an error if the RDF term being tested is not found elsewhere in the list of terms.
-      # 
+      #
       # The IN operator is equivalent to the SPARQL expression:
       # 
       #     (lhs = expression1) || (lhs = expression2) || ...

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

@@ -8,7 +8,7 @@ module SPARQL; module Algebra
     #       (extend ((?uri (uri "uri")) (?iri (iri "iri")))
     #         (bgp))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#func-iri
+    # @see http://www.w3.org/TR/sparql11-query/#func-iri
     class IRI < Operator::Unary
       include Evaluatable
 
@@ -16,13 +16,13 @@ module SPARQL; module Algebra
 
       ##
       # The IRI function constructs an IRI by resolving the string argument (see RFC 3986 and RFC 3987 or any later RFC that superceeds RFC 3986 or RFC 3987). The IRI is resolved against the base IRI of the query and must result in an absolute IRI.
-      #
+      # 
       # The URI function is a synonym for IRI.
-      #
+      # 
       # If the function is passed an IRI, it returns the IRI unchanged.
-      #
+      # 
       # Passing any RDF term other than a simple literal, xsd:string or an IRI is an error.
-      #
+      # 
       # An implementation may normalize the IRI.
       #
       # @param  [RDF::Term] literal

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

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #       (filter (isBlank ?v)
     #         (bgp (triple ?x :p ?v)))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#func-isBlank
+    # @see http://www.w3.org/TR/sparql11-query/#func-isBlank
     class IsBlank < Operator::Unary
       include Evaluatable
 

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

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #       (filter (isIRI ?v)
     #         (bgp (triple ?x :p ?v)))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#func-isIRI
+    # @see http://www.w3.org/TR/sparql11-query/#func-isIRI
     class IsIRI < Operator::Unary
       include Evaluatable
 

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

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #       (filter (isLiteral ?v)
     #         (bgp (triple ?x :p ?v)))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#func-isLiteral
+    # @see http://www.w3.org/TR/sparql11-query/#func-isLiteral
     class IsLiteral < Operator::Unary
       include Evaluatable
 

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

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #       (graph ?g
     #         (bgp (triple ?s ?q ?v)))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
+    # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
     class Join < Operator::Binary
       include Query
       
@@ -31,7 +31,7 @@ module SPARQL; module Algebra
       # @yieldreturn [void] ignored
       # @return [RDF::Query::Solutions]
       #   the resulting solution sequence
-      # @see    http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
+      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
       # @see    http://rdf.rubyforge.org/RDF/Query/Solution.html#merge-instance_method
       # @see    http://rdf.rubyforge.org/RDF/Query/Solution.html#compatible%3F-instance_method
       def execute(queryable, options = {}, &block)

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

@@ -3,7 +3,7 @@ module SPARQL; module Algebra
     ##
     # The SPARQL `lang` operator.
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#func-lang
+    # @see http://www.w3.org/TR/sparql11-query/#func-lang
     class Lang < Operator::Unary
       include Evaluatable
 

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

@@ -8,7 +8,7 @@ module SPARQL; module Algebra
     #     (filter (langMatches (lang ?v) "en-GB")
     #       (bgp (triple :x ?p ?v))))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#func-langMatches
+    # @see http://www.w3.org/TR/sparql11-query/#func-langMatches
     # @see http://tools.ietf.org/html/rfc4647#section-3.3.1
     class LangMatches < Operator::Binary
       include Evaluatable

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

@@ -10,7 +10,7 @@ module SPARQL; module Algebra
     #       (bgp (triple ?y :q ?w))
     #       (= ?v 2)))
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
+    # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
     class LeftJoin < Operator
       include Query
       
@@ -31,7 +31,7 @@ module SPARQL; module Algebra
       # @yieldreturn [void] ignored
       # @return [RDF::Query::Solutions]
       #   the resulting solution sequence
-      # @see    http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
+      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
       # @see    http://rdf.rubyforge.org/RDF/Query/Solution.html#merge-instance_method
       # @see    http://rdf.rubyforge.org/RDF/Query/Solution.html#compatible%3F-instance_method
       def execute(queryable, options = {}, &block)

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

@@ -6,7 +6,7 @@ module SPARQL; module Algebra
     # @example
     #   (< ?x ?y)
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#OperatorMapping
+    # @see http://www.w3.org/TR/sparql11-query/#OperatorMapping
     # @see http://www.w3.org/TR/xpath-functions/#func-compare
     # @see http://www.w3.org/TR/xpath-functions/#func-numeric-less-than
     # @see http://www.w3.org/TR/xpath-functions/#func-boolean-less-than

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

@@ -6,7 +6,7 @@ module SPARQL; module Algebra
     # @example
     #   (<= ?x ?y)
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#OperatorMapping
+    # @see http://www.w3.org/TR/sparql11-query/#OperatorMapping
     # @see http://www.w3.org/TR/xpath-functions/#func-compare
     # @see http://www.w3.org/TR/xpath-functions/#func-numeric-less-than
     # @see http://www.w3.org/TR/xpath-functions/#func-boolean-less-than

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

@@ -5,6 +5,8 @@ module SPARQL; module Algebra
     ##
     # The SPARQL logical `md5` operator.
     #
+    # Returns the MD5 checksum, as a hex digit string, calculated on the UTF-8 representation of the simple literal or lexical form of the `xsd:string`. Hex digits `SHOULD` be in lower case.
+    #
     # @example
     #     (prefix ((: <http://example.org/>))
     #       (project (?hash)

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

@@ -12,7 +12,7 @@ module SPARQL; module Algebra
     #            (bgp (triple ?animal <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> ?type))))))
     #
     # @see http://www.w3.org/TR/xpath-functions/#func-numeric-unary-minus
-    # @see http://www.w3.org/TR/rdf-sparql-query/#sparqlAlgebra
+    # @see http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
     class Minus < Operator::Binary
       include Query
 

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

@@ -3,6 +3,8 @@ module SPARQL; module Algebra
     ##
     # The SPARQL logical `minutes` operator.
     #
+    # Returns the minutes part of the lexical form of `arg`. The value is as given in the lexical form of the XSD dateTime.
+    #
     # @example
     #     (prefix ((: <http://example.org/>))
     #       (project (?s ?x)

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

@@ -3,6 +3,8 @@ module SPARQL; module Algebra
     ##
     # The SPARQL logical `month` operator.
     #
+    # Returns the month part of `arg` as an integer.
+    #
     # @example
     #     (prefix ((: <http://example.org/>))
     #       (project (?s ?x)

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

@@ -3,8 +3,8 @@ module SPARQL; module Algebra
     ##
     # The SPARQL relational `!=` (not equal) comparison operator.
     #
-    # @see http://www.w3.org/TR/rdf-sparql-query/#OperatorMapping
-    # @see http://www.w3.org/TR/rdf-sparql-query/#func-RDFterm-equal
+    # @see http://www.w3.org/TR/sparql11-query/#OperatorMapping
+    # @see http://www.w3.org/TR/sparql11-query/#func-RDFterm-equal
     class NotEqual < Equal
       NAME = :'!='