Sha256: 6c480a4ba5be9c9b899a0a6b6f3d7d4fd6fa917c615503f92f8e3b562ad9dd05

Contents?: true

Size: 1.84 KB

Versions: 8

Compression:

Stored size: 1.84 KB

Contents

require 'digest'

module SPARQL; module Algebra
  class Operator
    ##
    # The SPARQL logical `sha512` operator.
    #
    # Returns the SHA512 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.
    #
    # [121] BuiltInCall ::= ... | 'SHA512' '(' Expression ')' 
    #
    # @example SPARQL Grammar
    #   PREFIX : <http://example.org/>
    #   SELECT (SHA512(?l) AS ?hash) WHERE {
    #    :s1 :str ?l
    #   }
    #
    # @example SSE
    #     (prefix ((: <http://example.org/>))
    #       (project (?hash)
    #         (extend ((?hash (sha512 ?l)))
    #           (bgp (triple :s1 :str ?l)))))
    #
    # @see https://www.w3.org/TR/sparql11-query/#func-sha512
    class SHA512 < Operator::Unary
      include Evaluatable

      NAME = :sha512

      ##
      # Returns the SHA512 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.
      #
      # @param  [RDF::Literal] operand
      #   the operand
      # @return [RDF::Literal]
      # @raise  [TypeError] if the operand is not a simple literal
      def apply(operand, **options)
        raise TypeError, "expected an RDF::Literal, but got #{operand.inspect}" unless operand.literal?
        raise TypeError, "expected simple literal or xsd:string, but got #{operand.inspect}" unless (operand.datatype || RDF::XSD.string) == RDF::XSD.string
        RDF::Literal(Digest::SHA512.new.hexdigest(operand.to_s))
      end

      ##
      #
      # Returns a partial SPARQL grammar for this operator.
      #
      # @return [String]
      def to_sparql(**options)
        "SHA512(" + operands.to_sparql(**options) + ")"
      end
    end # SHA512
  end # Operator
end; end # SPARQL::Algebra

Version data entries

8 entries across 8 versions & 1 rubygems

Version Path
sparql-3.3.1 lib/sparql/algebra/operator/sha512.rb
sparql-3.3.0 lib/sparql/algebra/operator/sha512.rb
sparql-3.2.6 lib/sparql/algebra/operator/sha512.rb
sparql-3.2.5 lib/sparql/algebra/operator/sha512.rb
sparql-3.2.4 lib/sparql/algebra/operator/sha512.rb
sparql-3.2.3 lib/sparql/algebra/operator/sha512.rb
sparql-3.2.1 lib/sparql/algebra/operator/sha512.rb
sparql-3.2.0 lib/sparql/algebra/operator/sha512.rb