rdf 3.2.3 → 3.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4482866c0eb2c223af0f3a88f1eba8e1e2126c238c1136ff992a795de5047699
-  data.tar.gz: 38e58d5e2bab26f76b55affe2cb362aff85afb49c7692056837b69d34cad6081
+  metadata.gz: 58dcc9836c4302cad4bb46a86596235794a664d508cc002ce298b6c964265ba9
+  data.tar.gz: 941a3daf3a379acf33fe09688ea9cabefd25eb88dc80a7b31d05ac380b2cb2f9
 SHA512:
-  metadata.gz: 464c0043d3238fc3c4b077dfe6144a145b2c636b0e7de53ea6e8ce7ea96d2fd196b88053b1974d939650295416a2e4f07d298009d06d3a0320c297caf7883309
-  data.tar.gz: 0b27d632fe51c621bd50c27c2b7ecf5da91cd615e4e39ddf82e9f65517bddadcba4adb387a33807f8f2f0851b3a1d3c0429ccf41f4ec1610371c57fe28bd0709
+  metadata.gz: f384a93b62b93d574c3dae02e8285f77a3ea6fa26c60eb30aa387e7213343e763a00d9a58f33d0caf4acc5f68a4b27e55361beb792127486059e8afeb333053e
+  data.tar.gz: ed8a19309a2b2f042a3f10df60465b56bd5ea9ace1a305cbe595bab507a7606eae99438fe3ce1edbcd653f513bd015aaf19d5e7203c5903278e275dc591e9d15

data/README.md

@@ -3,7 +3,7 @@
 This is a pure-Ruby library for working with [Resource Description Framework
 (RDF)][RDF] data.
 
-* <https://ruby-rdf.github.com/rdf>
+* <https://ruby-rdf.github.io/rdf>
 
 [![Gem Version](https://badge.fury.io/rb/rdf.png)](https://badge.fury.io/rb/rdf)
 [![Build Status](https://github.com/ruby-rdf/rdf/workflows/CI/badge.svg?branch=develop)](https://github.com/ruby-rdf/rdf/actions?query=workflow%3ACI)
@@ -141,11 +141,11 @@ or
 ### Reading RDF data in the [N-Triples][] format
 
     require 'rdf/ntriples'
-    graph = RDF::Graph.load("https://ruby-rdf.github.com/rdf/etc/doap.nt")
+    graph = RDF::Graph.load("https://ruby-rdf.github.io/rdf/etc/doap.nt")
 
 or
 
-    RDF::Reader.open("https://ruby-rdf.github.com/rdf/etc/doap.nt") do |reader|
+    RDF::Reader.open("https://ruby-rdf.github.io/rdf/etc/doap.nt") do |reader|
       reader.each_statement do |statement|
         puts statement.inspect
       end
@@ -160,13 +160,13 @@ MimeType or file extension, where available.
 
     require 'rdf/nquads'
 
-    graph = RDF::Graph.load("https://ruby-rdf.github.com/rdf/etc/doap.nq", format: :nquads)
+    graph = RDF::Graph.load("https://ruby-rdf.github.io/rdf/etc/doap.nq", format: :nquads)
 
 A specific sub-type of Reader can also be invoked directly:
 
     require 'rdf/nquads'
 
-    RDF::NQuads::Reader.open("https://ruby-rdf.github.com/rdf/etc/doap.nq") do |reader|
+    RDF::NQuads::Reader.open("https://ruby-rdf.github.io/rdf/etc/doap.nq") do |reader|
       reader.each_statement do |statement|
         puts statement.inspect
       end
@@ -220,7 +220,7 @@ Note that no prefixes are loaded automatically, however they can be provided as
 
     require 'rdf/ntriples'
 
-    graph = RDF::Graph.load("https://ruby-rdf.github.com/rdf/etc/doap.nt")
+    graph = RDF::Graph.load("https://ruby-rdf.github.io/rdf/etc/doap.nt")
     query = RDF::Query.new({
       person: {
         RDF.type  => FOAF.Person,
@@ -295,7 +295,7 @@ Readers support a boolean valued `rdfstar` option.
 
 ## Documentation
 
-<https://rubydoc.info/github/ruby-rdf/rdf>
+<https://ruby-rdf.github.io/rdf>
 
 ### RDF Object Model
 
@@ -309,7 +309,7 @@ Readers support a boolean valued `rdfstar` option.
       * {RDF::Literal::Double}
       * {RDF::Literal::Integer}
       * {RDF::Literal::Time}
-      * [RDF::XSD](https://rubydoc.info/github/gkellogg/rdf-xsd) (extension)
+      * [RDF::XSD](https://ruby-rdf.github.io/rdf-xsd) (extension)
     * {RDF::Resource}
       * {RDF::Node}
       * {RDF::URI}
@@ -371,10 +371,10 @@ from BNode identity (i.e., they each entail the other)
   * {RDF::Mutable}
   * {RDF::Durable}
 * {RDF::Transaction}
-* [RDF::AllegroGraph](https://rubydoc.info/github/ruby-rdf/rdf-agraph) (extension)
-* [RDF::Mongo](https://rubydoc.info/github/ruby-rdf/rdf-mongo) (extension)
-* [RDF::DataObjects](https://rubydoc.info/github/ruby-rdf/rdf-do) (extension)
-* [RDF::Sesame](https://rubydoc.info/github/ruby-rdf/rdf-sesame) (extension)
+* [RDF::AllegroGraph](https://ruby-rdf.github.io/rdf-agraph) (extension)
+* [RDF::Mongo](https://ruby-rdf.github.io/rdf-mongo) (extension)
+* [RDF::DataObjects](https://ruby-rdf.github.io/rdf-do) (extension)
+* [RDF::Sesame](https://ruby-rdf.github.io/rdf-sesame) (extension)
 
 ### RDF Querying
 
@@ -384,7 +384,7 @@ from BNode identity (i.e., they each entail the other)
   * {RDF::Query::Solution}
   * {RDF::Query::Solutions}
   * {RDF::Query::Variable}
-* [SPARQL](https://rubydoc.info/github/ruby-rdf/sparql) (extension)
+* [SPARQL](https://ruby-rdf.github.io/sparql) (extension)
 
 
 ### RDF Vocabularies
@@ -422,7 +422,7 @@ follows:
 
 ## Resources
 
-* <https://rubydoc.info/github/ruby-rdf/rdf>
+* <https://ruby-rdf.github.io/rdf>
 * <https://github.com/ruby-rdf/rdf>
 * <https://rubygems.org/gems/rdf>
 * <https://www.ohloh.net/p/rdf>
@@ -486,33 +486,33 @@ see <https://unlicense.org/> or the accompanying {file:UNLICENSE} file.
 [YARD]:             https://yardoc.org/
 [YARD-GS]:          https://rubydoc.info/docs/yard/file/docs/GettingStarted.md
 [PDD]:              https://unlicense.org/#unlicensing-contributions
-[JSONLD doc]:       https://rubydoc.info/github/ruby-rdf/json-ld
-[LinkedData doc]:   https://rubydoc.info/github/ruby-rdf/linkeddata
-[Microdata doc]:    https://rubydoc.info/github/ruby-rdf/rdf-microdata
-[N3 doc]:           https://rubydoc.info/github/ruby-rdf/rdf-n3
-[RDFa doc]:         https://rubydoc.info/github/ruby-rdf/rdf-rdfa
-[RDFXML doc]:       https://rubydoc.info/github/ruby-rdf/rdf-rdfxml
-[Turtle doc]:       https://rubydoc.info/github/ruby-rdf/rdf-turtle
-[SPARQL doc]:       https://rubydoc.info/github/ruby-rdf/sparql
+[JSONLD doc]:       https://ruby-rdf.github.io/json-ld
+[LinkedData doc]:   https://ruby-rdf.github.io/linkeddata
+[Microdata doc]:    https://ruby-rdf.github.io/rdf-microdata
+[N3 doc]:           https://ruby-rdf.github.io/rdf-n3
+[RDFa doc]:         https://ruby-rdf.github.io/rdf-rdfa
+[RDFXML doc]:       https://ruby-rdf.github.io/rdf-rdfxml
+[Turtle doc]:       https://ruby-rdf.github.io/rdf-turtle
+[SPARQL doc]:       https://ruby-rdf.github.io/sparql
 [RDF 1.0]:          https://www.w3.org/TR/2004/REC-rdf-concepts-20040210/
 [RDF 1.1]:          https://www.w3.org/TR/rdf11-concepts/
 [SPARQL 1.1]:       https://www.w3.org/TR/sparql11-query/
-[RDF.rb]:           https://ruby-rdf.github.com/
-[RDF::DO]:          https://ruby-rdf.github.com/rdf-do
-[RDF::Mongo]:       https://ruby-rdf.github.com/rdf-mongo
-[RDF::Sesame]:      https://ruby-rdf.github.com/rdf-sesame
-[RDF::JSON]:        https://ruby-rdf.github.com/rdf-json
-[RDF::Microdata]:   https://ruby-rdf.github.com/rdf-microdata
-[RDF::N3]:          https://ruby-rdf.github.com/rdf-n3
-[RDF::RDFa]:        https://ruby-rdf.github.com/rdf-rdfa
-[RDF::RDFXML]:      https://ruby-rdf.github.com/rdf-rdfxml
-[RDF::TriG]:        https://ruby-rdf.github.com/rdf-trig
-[RDF::TriX]:        https://ruby-rdf.github.com/rdf-trix
-[RDF::Turtle]:      https://ruby-rdf.github.com/rdf-turtle
-[RDF::Raptor]:      https://ruby-rdf.github.com/rdf-raptor
+[RDF.rb]:           https://ruby-rdf.github.io/
+[RDF::DO]:          https://ruby-rdf.github.io/rdf-do
+[RDF::Mongo]:       https://ruby-rdf.github.io/rdf-mongo
+[RDF::Sesame]:      https://ruby-rdf.github.io/rdf-sesame
+[RDF::JSON]:        https://ruby-rdf.github.io/rdf-json
+[RDF::Microdata]:   https://ruby-rdf.github.io/rdf-microdata
+[RDF::N3]:          https://ruby-rdf.github.io/rdf-n3
+[RDF::RDFa]:        https://ruby-rdf.github.io/rdf-rdfa
+[RDF::RDFXML]:      https://ruby-rdf.github.io/rdf-rdfxml
+[RDF::TriG]:        https://ruby-rdf.github.io/rdf-trig
+[RDF::TriX]:        https://ruby-rdf.github.io/rdf-trix
+[RDF::Turtle]:      https://ruby-rdf.github.io/rdf-turtle
+[RDF::Raptor]:      https://ruby-rdf.github.io/rdf-raptor
 [RDF*]:             https://w3c.github.io/rdf-star/rdf-star-cg-spec.html
-[LinkedData]:       https://ruby-rdf.github.com/linkeddata
-[JSON::LD]:         https://ruby-rdf.github.com/json-ld
+[LinkedData]:       https://ruby-rdf.github.io/linkeddata
+[JSON::LD]:         https://ruby-rdf.github.io/json-ld
 [RestClient]:       https://rubygems.org/gems/rest-client
 [RestClient Components]: https://rubygems.org/gems/rest-client-components
 [Rack::Cache]:      https://rtomayko.github.io/rack-cache/

data/VERSION

@@ -1 +1 @@
-3.2.3
+3.2.6

data/lib/rdf/mixin/countable.rb

@@ -2,9 +2,13 @@ module RDF
   ##
   # @since 0.2.0
   module Countable
-    autoload :Enumerator, 'rdf/mixin/enumerator'
     extend RDF::Util::Aliasing::LateBound
 
+    # Extends Enumerator with {Countable}, which is used by {Countable#enum_for}
+    class Enumerator < ::Enumerator
+      include RDF::Countable
+    end
+
     ##
     # Returns `true` if `self` contains no RDF statements.
     #

data/lib/rdf/mixin/enumerable.rb

@@ -57,11 +57,23 @@ module RDF
   # @see RDF::Graph
   # @see RDF::Repository
   module Enumerable
-    autoload :Enumerator, 'rdf/mixin/enumerator'
     extend  RDF::Util::Aliasing::LateBound
     include ::Enumerable
     include RDF::Countable # NOTE: must come after ::Enumerable
 
+    # Extends Enumerator with {Queryable} and {Enumerable}, which is used by {Enumerable#each_statement} and {Queryable#enum_for}
+    class Enumerator < ::Enumerator
+      include RDF::Queryable
+      include RDF::Enumerable
+
+      ##
+      # @return [Array]
+      # @note Make sure returned arrays are also queryable
+      def to_a
+        return super.to_a.extend(RDF::Queryable, RDF::Enumerable)
+      end
+    end
+
     ##
     # Returns `true` if this enumerable supports the given `feature`.
     #

data/lib/rdf/mixin/queryable.rb

@@ -9,9 +9,21 @@ module RDF
   # @see RDF::Graph
   # @see RDF::Repository
   module Queryable
-    autoload :Enumerator, 'rdf/mixin/enumerator'
     include ::Enumerable
 
+    # Extends Enumerator with {Queryable} and {Enumerable}, which is used by {Enumerable#each_statement} and {Queryable#enum_for}
+    class Enumerator < ::Enumerator
+      include RDF::Queryable
+      include RDF::Enumerable
+
+      ##
+      # @return [Array]
+      # @note Make sure returned arrays are also queryable
+      def to_a
+        return super.to_a.extend(RDF::Queryable, RDF::Enumerable)
+      end
+    end
+
     ##
     # Queries `self` for RDF statements matching the given `pattern`.
     #

data/lib/rdf/model/list.rb

@@ -476,7 +476,7 @@ module RDF
     # @return [Integer]
     # @see    http://ruby-doc.org/core-2.2.2/Array.html#method-i-3C-3D-3E
     def eql?(other)
-      to_a.eql? other.to_a # TODO: optimize this
+      to_a.eql? Array(other)
     end
 
     ##

data/lib/rdf/model/literal/date.rb

@@ -4,67 +4,41 @@ module RDF; class Literal
   #
   # @see   http://www.w3.org/TR/xmlschema11-2/#date
   # @since 0.2.1
-  class Date < Literal
+  class Date < Temporal
     DATATYPE = RDF::URI("http://www.w3.org/2001/XMLSchema#date")
     GRAMMAR  = %r(\A(-?\d{4}-\d{2}-\d{2})((?:[\+\-]\d{2}:\d{2})|UTC|GMT|Z)?\Z).freeze
     FORMAT   = '%Y-%m-%d'.freeze
 
     ##
-    # @param  [String, Date, #to_date] value
+    # Internally, a `Date` is represented using a native `::DateTime` object at midnight. If initialized from a `::Date`, there is no timezone component, If initialized from a `::DateTime`, the timezone is taken from that native object, otherwise, a timezone (or no timezone) is taken from the string representation having a matching `zzzzzz` component.
+    #
+    # @note If initialized using the `#to_datetime` method, time component is unchanged. Otherewise, it is set to 00:00 (midnight).
+    #
+    # @param  [String, Date, #to_datetime] value
     # @param  (see Literal#initialize)
     def initialize(value, datatype: nil, lexical: nil, **options)
       @datatype = RDF::URI(datatype || self.class.const_get(:DATATYPE))
       @string   = lexical || (value if value.is_a?(String))
       @object   = case
-        when value.is_a?(::Date)         then value
-        when value.respond_to?(:to_date) then value.to_date
-        else ::Date.parse(value.to_s)
-      end rescue ::Date.new
-    end
-
-    ##
-    # Converts this literal into its canonical lexical representation.
-    #
-    # Note that the timezone is recoverable for xsd:date, where it is not for xsd:dateTime and xsd:time, which are both transformed relative to Z, if a timezone is provided.
-    #
-    # @return [RDF::Literal] `self`
-    # @see    http://www.w3.org/TR/xmlschema11-2/#date
-    def canonicalize!
-      @string = @object.strftime(FORMAT) + self.tz.to_s if self.valid?
-      self
-    end
-
-    ##
-    # Returns `true` if the value adheres to the defined grammar of the
-    # datatype.
-    #
-    # Special case for date and dateTime, for which '0000' is not a valid year
-    #
-    # @return [Boolean]
-    # @since  0.2.1
-    def valid?
-      super && object && value !~ %r(\A0000)
-    end
-
-    ##
-    # Does the literal representation include a timezone? Note that this is only possible if initialized using a string, or `:lexical` option.
-    #
-    # @return [Boolean]
-    # @since 1.1.6
-    def timezone?
-      md = self.to_s.match(GRAMMAR)
-      md && !!md[2]
-    end
-    alias_method :tz?, :timezone?
-    alias_method :has_tz?, :timezone?
-    alias_method :has_timezone?, :timezone?
-
-    ##
-    # Returns the value as a string.
-    #
-    # @return [String]
-    def to_s
-      @string || @object.strftime(FORMAT)
+        when value.class == ::Date
+          @zone = nil
+          # Use midnight as midpoint of the interval
+          ::DateTime.parse(value.strftime('%FT00:00:00'))
+        when value.respond_to?(:to_datetime)
+          dt = value.to_datetime
+          @zone = dt.zone
+          dt
+        else
+          md = value.to_s.match(GRAMMAR)
+          _, dt, tz = Array(md)
+          if tz
+            @zone = tz == 'Z' ? '+00:00' : tz
+          else
+            @zone = nil # No timezone
+          end
+          # Use midnight as midpoint of the interval
+          ::DateTime.parse("#{dt}T00:00:00#{@zone}")
+      end rescue ::DateTime.new
     end
 
     ##
@@ -75,42 +49,13 @@ module RDF; class Literal
     def humanize(lang = :en)
       d = object.strftime("%A, %d %B %Y")
       if timezone?
-        d += if self.tz == 'Z'
+        d += if @zone == '+00:00'
           " UTC"
         else
-          " #{self.tz}"
+          " #{@zone}"
         end
       end
       d
     end
-
-    ##
-    # Returns the timezone part of arg as a simple literal. Returns the empty string if there is no timezone.
-    #
-    # @return [RDF::Literal]
-    # @since 1.1.6
-    def tz
-      md = self.to_s.match(GRAMMAR)
-      zone =  md[2].to_s
-      zone = "Z" if zone == "+00:00"
-      RDF::Literal(zone)
-    end
-
-    ##
-    # Equal compares as Date objects
-    def ==(other)
-      # If lexically invalid, use regular literal testing
-      return super unless self.valid?
-
-      case other
-      when Literal::Date
-        return super unless other.valid?
-        self.object == other.object
-      when Literal::Time, Literal::DateTime
-        false
-      else
-        super
-      end
-    end
   end # Date
 end; end # RDF::Literal

data/lib/rdf/model/literal/datetime.rb

@@ -2,117 +2,38 @@ module RDF; class Literal
   ##
   # A date/time literal.
   #
-  # @see   http://www.w3.org/TR/xmlschema11-2/#dateTime#boolean
+  # @see   http://www.w3.org/TR/xmlschema11-2/#dateTime
   # @since 0.2.1
-  class DateTime < Literal
+  class DateTime < Temporal
     DATATYPE = RDF::URI("http://www.w3.org/2001/XMLSchema#dateTime")
     GRAMMAR  = %r(\A(-?(?:\d{4}|[1-9]\d{4,})-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?)((?:[\+\-]\d{2}:\d{2})|UTC|GMT|Z)?\Z).freeze
-    FORMAT   = '%Y-%m-%dT%H:%M:%S.%L%:z'.freeze
+    FORMAT   = '%Y-%m-%dT%H:%M:%S.%L'.freeze
 
     ##
+    # Internally, a `DateTime` is represented using a native `::DateTime`. If initialized from a `::Date`, there is no timezone component, If initialized from a `::DateTime`, the timezone is taken from that native object, otherwise, a timezone (or no timezone) is taken from the string representation having a matching `zzzzzz` component.
+    #
     # @param  [DateTime] value
     # @option options [String] :lexical (nil)
     def initialize(value, datatype: nil, lexical: nil, **options)
       @datatype = RDF::URI(datatype || self.class.const_get(:DATATYPE))
       @string   = lexical || (value if value.is_a?(String))
       @object   = case
-        when value.is_a?(::DateTime)         then value
-        when value.respond_to?(:to_datetime) then value.to_datetime
-        else ::DateTime.parse(value.to_s)
-      end rescue ::DateTime.new
-    end
-
-    ##
-    # Converts this literal into its canonical lexical representation.
-    # with date and time normalized to UTC.
-    #
-    # @return [RDF::Literal] `self`
-    # @see    http://www.w3.org/TR/xmlschema11-2/#dateTime
-    def canonicalize!
-      if self.valid?
-        @string = if timezone?
-          @object.new_offset.new_offset.strftime(FORMAT[0..-4] + 'Z').sub('.000', '')
+        when value.is_a?(::DateTime)
+          @zone = value.zone
+          value
+        when value.respond_to?(:to_datetime) 
+          @zone = value.to_datetime.zone
+          value.to_datetime
         else
-          @object.strftime(FORMAT[0..-4]).sub('.000', '')
-        end
-      end
-      self
-    end
-
-    ##
-    # Returns the timezone part of arg as a simple literal. Returns the empty string if there is no timezone.
-    #
-    # @return [RDF::Literal]
-    # @see http://www.w3.org/TR/sparql11-query/#func-tz
-    def tz
-      zone =  timezone? ? object.zone : ""
-      zone = "Z" if zone == "+00:00"
-      RDF::Literal(zone)
-    end
-
-    ##
-    # Returns the timezone part of arg as an xsd:dayTimeDuration, or `nil`
-    # if lexical form of literal does not include a timezone.
-    #
-    # @return [RDF::Literal]
-    def timezone
-      if tz == 'Z'
-        RDF::Literal("PT0S", datatype: RDF::URI("http://www.w3.org/2001/XMLSchema#dayTimeDuration"))
-      elsif md = tz.to_s.match(/^([+-])?(\d+):(\d+)?$/)
-        plus_minus, hour, min = md[1,3]
-        plus_minus = nil unless plus_minus == "-"
-        hour = hour.to_i
-        min = min.to_i
-        res = "#{plus_minus}PT#{hour}H#{"#{min}M" if min > 0}"
-        RDF::Literal(res, datatype: RDF::URI("http://www.w3.org/2001/XMLSchema#dayTimeDuration"))
-      end
-    end
-
-    ##
-    # Returns `true` if the value adheres to the defined grammar of the
-    # datatype.
-    #
-    # Special case for date and dateTime, for which '0000' is not a valid year
-    #
-    # @return [Boolean]
-    # @since  0.2.1
-    def valid?
-      super && object && value !~ %r(\A0000)
-    end
-
-    ##
-    # Does the literal representation include millisectonds?
-    #
-    # @return [Boolean]
-    # @since 1.1.6
-    def milliseconds?
-      self.format("%L").to_i > 0
-    end
-    alias_method :has_milliseconds?, :milliseconds?
-    alias_method :has_ms?, :milliseconds?
-    alias_method :ms?, :milliseconds?
-
-    ##
-    # Does the literal representation include a timezone? Note that this is only possible if initialized using a string, or `:lexical` option.
-    #
-    # @return [Boolean]
-    # @since 1.1.6
-    def timezone?
-      md = self.to_s.match(GRAMMAR)
-      md && !!md[2]
-    end
-    alias_method :tz?, :timezone?
-    alias_method :has_tz?, :timezone?
-    alias_method :has_timezone?, :timezone?
-
-    ##
-    # Returns the `timezone` of the literal. If the
-    ##
-    # Returns the value as a string.
-    #
-    # @return [String]
-    def to_s
-      @string || @object.strftime(FORMAT).sub("+00:00", 'Z').sub('.000', '')
+          md = value.to_s.match(GRAMMAR)
+          _, _, tz = Array(md)
+          if tz
+            @zone = tz == 'Z' ? '+00:00' : tz
+          else
+            @zone = nil # No timezone
+          end
+          ::DateTime.parse(value.to_s)
+      end rescue ::DateTime.new
     end
 
     ##
@@ -123,31 +44,10 @@ module RDF; class Literal
     def humanize(lang = :en)
       d = object.strftime("%r on %A, %d %B %Y")
       if timezone?
-        zone = if self.tz == 'Z'
-          "UTC"
-        else
-          self.tz
-        end
-        d.sub!(" on ", " #{zone} on ")
+        z = @zone == '+00:00' ? "UTC" : @zone
+        d.sub!(" on ", " #{z} on ")
       end
       d
     end
-
-    ##
-    # Equal compares as DateTime objects
-    def ==(other)
-      # If lexically invalid, use regular literal testing
-      return super unless self.valid?
-
-      case other
-      when Literal::DateTime
-        return super unless other.valid?
-        self.object == other.object
-      when Literal::Time, Literal::Date
-        false
-      else
-        super
-      end
-    end
   end # DateTime
 end; end # RDF::Literal

data/lib/rdf/model/literal/decimal.rb

@@ -54,7 +54,10 @@ module RDF; class Literal
     ##
     # Returns the absolute value of `self`.
     #
+    # From the XQuery function [fn:abs](https://www.w3.org/TR/xpath-functions/#func-abs).
+    #
     # @return [RDF::Literal]
+    # @see https://www.w3.org/TR/xpath-functions/#func-abs
     # @since  0.2.3
     def abs
       (d = to_d) && d > 0 ? self : RDF::Literal(d.abs)
@@ -63,7 +66,10 @@ module RDF; class Literal
     ##
     # Returns the number with no fractional part that is closest to the argument. If there are two such numbers, then the one that is closest to positive infinity is returned. An error is raised if arg is not a numeric value.
     #
+    # From the XQuery function [fn:round](https://www.w3.org/TR/xpath-functions/#func-round).
+    #
     # @return [RDF::Literal::Decimal]
+    # @see https://www.w3.org/TR/xpath-functions/#func-round
     def round
       rounded = to_d.round(half: (to_d < 0 ? :down : :up))
       if rounded == -0.0
@@ -77,10 +83,13 @@ module RDF; class Literal
     ##
     # Returns the smallest integer greater than or equal to `self`.
     #
+    # From the XQuery function [fn:ceil](https://www.w3.org/TR/xpath-functions/#func-ceil).
+    #
     # @example
     #   RDF::Literal(1).ceil            #=> RDF::Literal(1)
     #
     # @return [RDF::Literal::Integer]
+    # @see https://www.w3.org/TR/xpath-functions/#func-ceil
     def ceil
       RDF::Literal::Integer.new(to_d.ceil)
     end
@@ -88,10 +97,13 @@ module RDF; class Literal
     ##
     # Returns the largest integer less than or equal to `self`.
     #
+    # From the XQuery function [fn:floor](https://www.w3.org/TR/xpath-functions/#func-floor).
+    #
     # @example
     #   RDF::Literal(1).floor            #=> RDF::Literal(1)
     #
     # @return [RDF::Literal::Integer]
+    # @see https://www.w3.org/TR/xpath-functions/#func-floor
     def floor
       RDF::Literal::Integer.new(to_d.floor)
     end

data/lib/rdf/model/literal/double.rb

@@ -34,6 +34,14 @@ module RDF; class Literal
       end
     end
 
+    # Approximation of the mathematical constant π
+    #
+    # From the XQuery function [math:pi](https://www.w3.org/TR/xpath-functions/#func-math-pi).
+    #
+    # @return [Double]
+    # @see https://www.w3.org/TR/xpath-functions/#func-math-pi
+    PI = Double.new(Math::PI)
+
     ##
     # Converts this literal into its canonical lexical representation.
     #
@@ -145,6 +153,8 @@ module RDF; class Literal
     ##
     # Returns the smallest integer greater than or equal to `self`.
     #
+    # From the XQuery function [fn:ceil](https://www.w3.org/TR/xpath-functions/#func-ceil).
+    #
     # @example
     #   RDF::Literal(1.2).ceil            #=> RDF::Literal(2)
     #   RDF::Literal(-1.2).ceil           #=> RDF::Literal(-1)
@@ -152,6 +162,7 @@ module RDF; class Literal
     #   RDF::Literal(-2.0).ceil           #=> RDF::Literal(-2)
     #
     # @return [RDF::Literal::Integer]
+    # @see https://www.w3.org/TR/xpath-functions/#func-ceil
     # @since  0.2.3
     def ceil
       RDF::Literal::Integer.new(to_f.ceil)
@@ -160,6 +171,8 @@ module RDF; class Literal
     ##
     # Returns the largest integer less than or equal to `self`.
     #
+    # From the XQuery function [fn:floor](https://www.w3.org/TR/xpath-functions/#func-floor).
+    #
     # @example
     #   RDF::Literal(1.2).floor           #=> RDF::Literal(1)
     #   RDF::Literal(-1.2).floor          #=> RDF::Literal(-2)
@@ -167,6 +180,7 @@ module RDF; class Literal
     #   RDF::Literal(-2.0).floor          #=> RDF::Literal(-2)
     #
     # @return [RDF::Literal::Integer]
+    # @see https://www.w3.org/TR/xpath-functions/#func-floor
     # @since  0.2.3
     def floor
       RDF::Literal::Integer.new(to_f.floor)
@@ -175,7 +189,10 @@ module RDF; class Literal
     ##
     # Returns the absolute value of `self`.
     #
+    # From the XQuery function [fn:abs](https://www.w3.org/TR/xpath-functions/#func-abs).
+    #
     # @return [RDF::Literal]
+    # @see https://www.w3.org/TR/xpath-functions/#func-abs
     # @since  0.2.3
     def abs
       (f = to_f) && f > 0 ? self : self.class.new(f.abs)
@@ -184,7 +201,10 @@ module RDF; class Literal
     ##
     # Returns the number with no fractional part that is closest to the argument. If there are two such numbers, then the one that is closest to positive infinity is returned. An error is raised if arg is not a numeric value.
     #
+    # From the XQuery function [fn:round](https://www.w3.org/TR/xpath-functions/#func-round).
+    #
     # @return [RDF::Literal::Double]
+    # @see https://www.w3.org/TR/xpath-functions/#func-round
     def round
       self.class.new(to_d.round(half: (to_d < 0 ? :down : :up)))
     end