rdf 3.2.4 → 3.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fac2b932398cb302e6b2ecf300e6508879ed43314c52822d7a7ae9482127ea05
-  data.tar.gz: 6f78f54676b45f1bfd4767b30b545ec3016de440fcb8d5803ead213eed0e799d
+  metadata.gz: 62ac7574f98336ccea36385134d2007029e6e4edb182920c45fefb8f50fcccb7
+  data.tar.gz: b89e554b9961e6038408a29e8ca104aac8b6692a39fa9dddbab0779479e1b2bc
 SHA512:
-  metadata.gz: fa02358aa8f3362695cd433767c966a5c47fc3ba4c4bc8b95952e207dbf1e693a3468ea75735c34461d012b9efcd8f72e842d007e4dd1239b26d480d9e4f3f4c
-  data.tar.gz: e524ebef2e88903b3c8b0a48aa7b15b843924a8f6bc97fe06f524378d101409b1d88c07756b6a1be8002a38648b03d4ab362b6033f53bd810d05cc6dee141194
+  metadata.gz: 15af5338e8d3a4ff0c1601aad011a9b340b2b1b0f93da4d383bfb4b81da58c3dda68ea8e6e03a034b7decf81650f5f6e3b398b564205f5a0a39ffbf134974dde
+  data.tar.gz: 7ba7aa6f6af2a6e61b5b0da249bf084a84d0ef75245438bf091acbdb55e6fcc4c0c8dc904058e8ad0e11ced53cd373e68a4ebaef93867b7cf60f253f4581ded8

data/VERSION

@@ -1 +1 @@
-3.2.4
+3.2.7

data/lib/rdf/cli.rb

@@ -572,7 +572,8 @@ module RDF
     #   @param [Hash{Symbol => Object}] options already set
     #   @return [Array<String>] list of executable commands
     # @overload commands(format: :json, **options)
-    #   @param [:json] format (:json)
+    #   Returns commands as JSON, for API usage.
+    #   @param [:json] format
     #   @param [Hash{Symbol => Object}] options already set
     #   @return [Array{Object}]
     #     Returns an array of commands including the command symbol
@@ -593,7 +594,7 @@ module RDF
         # Subset commands based on filter options
         cmds = COMMANDS.reject do |k, c|
           c.fetch(:filter, {}).any? do |opt, val|
-            options[opt].to_s != val.to_s
+            options.merge(format: format)[opt].to_s != val.to_s
           end
         end
 

data/lib/rdf/format.rb

@@ -23,7 +23,9 @@ module RDF
   #
   # @example Defining a new RDF serialization format class
   #   class RDF::NTriples::Format < RDF::Format
-  #     content_type     'application/n-triples', extension: :nt
+  #     content_type     'application/n-triples',
+  #                      extension: :nt,
+  #                      uri: RDF::URI("http://www.w3.org/ns/formats/N-Triples")
   #     content_encoding 'utf-8'
   #     
   #     reader RDF::NTriples::Reader
@@ -222,6 +224,19 @@ module RDF
       @@file_extensions
     end
 
+    ##
+    # Returns the unique URI for the format.
+    #
+    # @example retrieving a list of supported file format URIs
+    #
+    #     RDF::Format.uris.keys
+    #
+    # @see https://www.w3.org/ns/formats/
+    # @return [Hash{Symbol => URI}]
+    def self.uris
+      @@uris
+    end
+
     ##
     # Returns the set of format symbols for available RDF::Reader subclasses.
     #
@@ -465,6 +480,7 @@ module RDF
     #   @option options [Array<String>]  :aliases (nil)
     #   @option options [Symbol]         :extension  (nil)
     #   @option options [Array<Symbol>]  :extensions (nil)
+    #   @option options [URI]            :uri   (nil)
     #   @return [void]
     #
     # @overload content_type
@@ -504,6 +520,10 @@ module RDF
             @@content_types[aa] << self unless @@content_types[aa].include?(self)
           end
         end
+        # URI identifying this format
+        if uri = options[:uri]
+          @@uris[RDF::URI(uri)] = self
+        end
       end
     end
 
@@ -517,7 +537,7 @@ module RDF
     end
 
     ##
-    # Retrieves or defines file extensions for this RDF serialization format.
+    # Retrieves file extensions for this RDF serialization format.
     #
     # The return is an array where the first element is the cannonical
     # file extension for the format and following elements are alias file extensions.
@@ -527,6 +547,17 @@ module RDF
       @@file_extensions.map {|ext, formats| ext if formats.include?(self)}.compact
     end
 
+    ##
+    # Retrieves any format URI defined for this format..
+    #
+    # @return [URI]
+    def self.uri
+      @@uris.invert[self]
+    end
+    class << self
+      alias_method :to_uri, :uri
+    end
+
   protected
 
     ##
@@ -568,6 +599,7 @@ module RDF
     @@readers          = {} # @private
     @@writers          = {} # @private
     @@subclasses       = [] # @private
+    @@uris             = {} # @private
 
     ##
     # @private

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

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

@@ -78,7 +78,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
       (n = to_i) && n > 0 ? self : self.class.new(n.abs)
@@ -87,7 +90,10 @@ module RDF; class Literal
     ##
     # Returns `self`.
     #
+    # From the XQuery function [fn:round](https://www.w3.org/TR/xpath-functions/#func-round).
+    #
     # @return [RDF::Literal]
+    # @see https://www.w3.org/TR/xpath-functions/#func-round
     def round
       self
     end