activesupport 3.0.0.beta4 → 3.0.pre

data/lib/active_support/vendor/tzinfo-0.3.13/lib/tzinfo/timezone_definition.rb

@@ -0,0 +1,56 @@
+#--
+# Copyright (c) 2006 Philip Ross
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#++
+
+require 'tzinfo/data_timezone_info'
+require 'tzinfo/linked_timezone_info'
+
+module TZInfo
+  
+  # TimezoneDefinition is included into Timezone definition modules.
+  # TimezoneDefinition provides the methods for defining timezones.
+  module TimezoneDefinition #:nodoc:
+    # Add class methods to the includee.
+    def self.append_features(base)
+      super
+      base.extend(ClassMethods)
+    end
+    
+    # Class methods for inclusion.
+    module ClassMethods #:nodoc:
+      # Returns and yields a DataTimezoneInfo object to define a timezone.
+      def timezone(identifier)
+        yield @timezone = DataTimezoneInfo.new(identifier)
+      end
+      
+      # Defines a linked timezone.
+      def linked_timezone(identifier, link_to_identifier)
+        @timezone = LinkedTimezoneInfo.new(identifier, link_to_identifier)
+      end
+      
+      # Returns the last TimezoneInfo to be defined with timezone or 
+      # linked_timezone.
+      def get
+        @timezone
+      end
+    end
+  end
+end

data/lib/active_support/vendor/tzinfo-0.3.13/lib/tzinfo/timezone_info.rb

@@ -0,0 +1,40 @@
+#--
+# Copyright (c) 2006 Philip Ross
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#++
+
+module TZInfo
+  # Represents a timezone defined in a data module.
+  class TimezoneInfo #:nodoc:
+    
+    # The timezone identifier.
+    attr_reader :identifier
+    
+    # Constructs a new TimezoneInfo with an identifier.
+    def initialize(identifier)
+      @identifier = identifier
+    end
+    
+    # Returns internal object state as a programmer-readable string.
+    def inspect
+      "#<#{self.class}: #@identifier>"
+    end
+  end
+end

data/lib/active_support/vendor/tzinfo-0.3.13/lib/tzinfo/timezone_offset_info.rb

@@ -0,0 +1,94 @@
+#--
+# Copyright (c) 2006 Philip Ross
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#++
+
+module TZInfo
+  # Represents an offset defined in a Timezone data file.
+  class TimezoneOffsetInfo #:nodoc:
+    # The base offset of the timezone from UTC in seconds.
+    attr_reader :utc_offset
+    
+    # The offset from standard time for the zone in seconds (i.e. non-zero if 
+    # daylight savings is being observed).
+    attr_reader :std_offset
+    
+    # The total offset of this observance from UTC in seconds 
+    # (utc_offset + std_offset).
+    attr_reader :utc_total_offset
+    
+    # The abbreviation that identifies this observance, e.g. "GMT" 
+    # (Greenwich Mean Time) or "BST" (British Summer Time) for "Europe/London". The returned identifier is a 
+    # symbol.
+    attr_reader :abbreviation
+    
+    # Constructs a new TimezoneOffsetInfo. utc_offset and std_offset are
+    # specified in seconds.
+    def initialize(utc_offset, std_offset, abbreviation)
+      @utc_offset = utc_offset
+      @std_offset = std_offset      
+      @abbreviation = abbreviation
+      
+      @utc_total_offset = @utc_offset + @std_offset
+    end
+    
+    # True if std_offset is non-zero.
+    def dst?
+      @std_offset != 0
+    end
+    
+    # Converts a UTC DateTime to local time based on the offset of this period.
+    def to_local(utc)
+      TimeOrDateTime.wrap(utc) {|wrapped|
+        wrapped + @utc_total_offset
+      }
+    end
+    
+    # Converts a local DateTime to UTC based on the offset of this period.
+    def to_utc(local)
+      TimeOrDateTime.wrap(local) {|wrapped|
+        wrapped - @utc_total_offset
+      }
+    end
+    
+    # Returns true if and only if toi has the same utc_offset, std_offset
+    # and abbreviation as this TimezoneOffsetInfo.
+    def ==(toi)
+      toi.respond_to?(:utc_offset) && toi.respond_to?(:std_offset) && toi.respond_to?(:abbreviation) &&
+        utc_offset == toi.utc_offset && std_offset == toi.std_offset && abbreviation == toi.abbreviation
+    end
+    
+    # Returns true if and only if toi has the same utc_offset, std_offset
+    # and abbreviation as this TimezoneOffsetInfo.
+    def eql?(toi)
+      self == toi
+    end
+    
+    # Returns a hash of this TimezoneOffsetInfo.
+    def hash
+      utc_offset.hash ^ std_offset.hash ^ abbreviation.hash
+    end
+    
+    # Returns internal object state as a programmer-readable string.
+    def inspect
+      "#<#{self.class}: #@utc_offset,#@std_offset,#@abbreviation>"
+    end
+  end
+end

data/lib/active_support/vendor/tzinfo-0.3.13/lib/tzinfo/timezone_period.rb

@@ -0,0 +1,198 @@
+#--
+# Copyright (c) 2005-2006 Philip Ross
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#++
+
+require 'tzinfo/offset_rationals'
+require 'tzinfo/time_or_datetime'
+
+module TZInfo
+  # A period of time in a timezone where the same offset from UTC applies.
+  #
+  # All the methods that take times accept instances of Time, DateTime or
+  # integer timestamps.
+  class TimezonePeriod
+    # The TimezoneTransitionInfo that defines the start of this TimezonePeriod 
+    # (may be nil if unbounded).
+    attr_reader :start_transition
+    
+    # The TimezoneTransitionInfo that defines the end of this TimezonePeriod
+    # (may be nil if unbounded).
+    attr_reader :end_transition
+    
+    # The TimezoneOffsetInfo for this period.
+    attr_reader :offset    
+    
+    # Initializes a new TimezonePeriod.
+    def initialize(start_transition, end_transition, offset = nil)
+      @start_transition = start_transition
+      @end_transition = end_transition
+      
+      if offset
+        raise ArgumentError, 'Offset specified with transitions' if @start_transition || @end_transition
+        @offset = offset
+      else
+        if @start_transition 
+          @offset = @start_transition.offset
+        elsif @end_transition
+          @offset = @end_transition.previous_offset
+        else
+          raise ArgumentError, 'No offset specified and no transitions to determine it from'
+        end
+      end
+      
+      @utc_total_offset_rational = nil      
+    end
+            
+    # Base offset of the timezone from UTC (seconds).
+    def utc_offset
+      @offset.utc_offset
+    end
+    
+    # Offset from the local time where daylight savings is in effect (seconds).
+    # E.g.: utc_offset could be -5 hours. Normally, std_offset would be 0. 
+    # During daylight savings, std_offset would typically become +1 hours.
+    def std_offset
+      @offset.std_offset
+    end
+    
+    # The identifier of this period, e.g. "GMT" (Greenwich Mean Time) or "BST"
+    # (British Summer Time) for "Europe/London". The returned identifier is a 
+    # symbol.
+    def abbreviation
+      @offset.abbreviation
+    end
+    alias :zone_identifier :abbreviation
+    
+    # Total offset from UTC (seconds). Equal to utc_offset + std_offset.
+    def utc_total_offset
+      @offset.utc_total_offset
+    end
+    
+    # Total offset from UTC (days). Result is a Rational.
+    def utc_total_offset_rational
+      unless @utc_total_offset_rational
+        @utc_total_offset_rational = OffsetRationals.rational_for_offset(utc_total_offset) 
+      end
+      @utc_total_offset_rational
+    end
+    
+    # The start time of the period in UTC as a DateTime. May be nil if unbounded.
+    def utc_start
+      @start_transition ? @start_transition.at.to_datetime : nil
+    end
+    
+    # The end time of the period in UTC as a DateTime. May be nil if unbounded.
+    def utc_end
+      @end_transition ? @end_transition.at.to_datetime : nil
+    end
+    
+    # The start time of the period in local time as a DateTime. May be nil if 
+    # unbounded.
+    def local_start
+      @start_transition ? @start_transition.local_start.to_datetime : nil
+    end
+    
+    # The end time of the period in local time as a DateTime. May be nil if 
+    # unbounded.
+    def local_end
+      @end_transition ? @end_transition.local_end.to_datetime : nil
+    end
+    
+    # true if daylight savings is in effect for this period; otherwise false.
+    def dst?
+      @offset.dst?
+    end
+    
+    # true if this period is valid for the given UTC DateTime; otherwise false.
+    def valid_for_utc?(utc)
+      utc_after_start?(utc) && utc_before_end?(utc) 
+    end
+    
+    # true if the given UTC DateTime is after the start of the period 
+    # (inclusive); otherwise false.
+    def utc_after_start?(utc)
+      !@start_transition || @start_transition.at <= utc
+    end
+    
+    # true if the given UTC DateTime is before the end of the period 
+    # (exclusive); otherwise false.
+    def utc_before_end?(utc)
+      !@end_transition || @end_transition.at > utc
+    end
+    
+    # true if this period is valid for the given local DateTime; otherwise false.
+    def valid_for_local?(local)      
+      local_after_start?(local) && local_before_end?(local) 
+    end
+    
+    # true if the given local DateTime is after the start of the period 
+    # (inclusive); otherwise false.
+    def local_after_start?(local)
+      !@start_transition || @start_transition.local_start <= local
+    end
+    
+    # true if the given local DateTime is before the end of the period 
+    # (exclusive); otherwise false.
+    def local_before_end?(local)
+      !@end_transition || @end_transition.local_end > local
+    end
+    
+    # Converts a UTC DateTime to local time based on the offset of this period.
+    def to_local(utc)
+      @offset.to_local(utc)
+    end
+    
+    # Converts a local DateTime to UTC based on the offset of this period.
+    def to_utc(local)
+      @offset.to_utc(local)
+    end
+    
+    # Returns true if this TimezonePeriod is equal to p. This compares the 
+    # start_transition, end_transition and offset using ==.
+    def ==(p)
+      p.respond_to?(:start_transition) && p.respond_to?(:end_transition) &&
+        p.respond_to?(:offset) && start_transition == p.start_transition &&
+        end_transition == p.end_transition && offset == p.offset
+    end
+    
+    # Returns true if this TimezonePeriods is equal to p. This compares the
+    # start_transition, end_transition and offset using eql?
+    def eql?(p)
+      p.respond_to?(:start_transition) && p.respond_to?(:end_transition) &&
+        p.respond_to?(:offset) && start_transition.eql?(p.start_transition) &&
+        end_transition.eql?(p.end_transition) && offset.eql?(p.offset)
+    end
+    
+    # Returns a hash of this TimezonePeriod.
+    def hash
+      result = @start_transition.hash ^ @end_transition.hash
+      result ^= @offset.hash unless @start_transition || @end_transition
+      result       
+    end
+    
+    # Returns internal object state as a programmer-readable string.
+    def inspect
+      result = "#<#{self.class}: #{@start_transition.inspect},#{@end_transition.inspect}"
+      result << ",#{@offset.inspect}>" unless @start_transition || @end_transition
+      result + '>'
+    end
+  end
+end

data/lib/active_support/vendor/tzinfo-0.3.13/lib/tzinfo/timezone_transition_info.rb

@@ -0,0 +1,129 @@
+#--
+# Copyright (c) 2006 Philip Ross
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#++
+
+require 'date'
+require 'tzinfo/time_or_datetime'
+
+module TZInfo
+  # Represents an offset defined in a Timezone data file.
+  class TimezoneTransitionInfo #:nodoc:
+    # The offset this transition changes to (a TimezoneOffsetInfo instance).
+    attr_reader :offset
+    
+    # The offset this transition changes from (a TimezoneOffsetInfo instance).
+    attr_reader :previous_offset
+    
+    # The numerator of the DateTime if the transition time is defined as a 
+    # DateTime, otherwise the transition time as a timestamp.
+    attr_reader :numerator_or_time
+    protected :numerator_or_time
+    
+    # Either the denominotor of the DateTime if the transition time is defined
+    # as a DateTime, otherwise nil. 
+    attr_reader :denominator
+    protected :denominator
+    
+    # Creates a new TimezoneTransitionInfo with the given offset, 
+    # previous_offset (both TimezoneOffsetInfo instances) and UTC time. 
+    # if denominator is nil, numerator_or_time is treated as a number of 
+    # seconds since the epoch. If denominator is specified numerator_or_time
+    # and denominator are used to create a DateTime as follows:
+    # 
+    #  DateTime.new!(Rational.send(:new!, numerator_or_time, denominator), 0, Date::ITALY)
+    #
+    # For performance reasons, the numerator and denominator must be specified
+    # in their lowest form.
+    def initialize(offset, previous_offset, numerator_or_time, denominator = nil)
+      @offset = offset
+      @previous_offset = previous_offset
+      @numerator_or_time = numerator_or_time
+      @denominator = denominator
+      
+      @at = nil
+      @local_end = nil
+      @local_start = nil
+    end
+    
+    # A TimeOrDateTime instance representing the UTC time when this transition
+    # occurs.
+    def at
+      unless @at
+        unless @denominator 
+          @at = TimeOrDateTime.new(@numerator_or_time)
+        else
+          r = RubyCoreSupport.rational_new!(@numerator_or_time, @denominator)
+          dt = RubyCoreSupport.datetime_new!(r, 0, Date::ITALY)
+          @at = TimeOrDateTime.new(dt)
+        end
+      end
+      
+      @at
+    end
+    
+    # A TimeOrDateTime instance representing the local time when this transition
+    # causes the previous observance to end (calculated from at using 
+    # previous_offset).
+    def local_end
+      @local_end = at.add_with_convert(@previous_offset.utc_total_offset) unless @local_end      
+      @local_end
+    end
+    
+    # A TimeOrDateTime instance representing the local time when this transition
+    # causes the next observance to start (calculated from at using offset).
+    def local_start
+      @local_start = at.add_with_convert(@offset.utc_total_offset) unless @local_start
+      @local_start
+    end
+    
+    # Returns true if this TimezoneTransitionInfo is equal to the given
+    # TimezoneTransitionInfo. Two TimezoneTransitionInfo instances are 
+    # considered to be equal by == if offset, previous_offset and at are all 
+    # equal.
+    def ==(tti)
+      tti.respond_to?(:offset) && tti.respond_to?(:previous_offset) && tti.respond_to?(:at) &&
+        offset == tti.offset && previous_offset == tti.previous_offset && at == tti.at
+    end
+    
+    # Returns true if this TimezoneTransitionInfo is equal to the given
+    # TimezoneTransitionInfo. Two TimezoneTransitionInfo instances are 
+    # considered to be equal by eql? if offset, previous_offset, 
+    # numerator_or_time and denominator are all equal. This is stronger than ==,
+    # which just requires the at times to be equal regardless of how they were
+    # originally specified.
+    def eql?(tti)
+      tti.respond_to?(:offset) && tti.respond_to?(:previous_offset) &&
+        tti.respond_to?(:numerator_or_time) && tti.respond_to?(:denominator) &&
+        offset == tti.offset && previous_offset == tti.previous_offset &&
+        numerator_or_time == tti.numerator_or_time && denominator == tti.denominator        
+    end
+    
+    # Returns a hash of this TimezoneTransitionInfo instance.
+    def hash
+      @offset.hash ^ @previous_offset.hash ^ @numerator_or_time.hash ^ @denominator.hash
+    end
+    
+    # Returns internal object state as a programmer-readable string.
+    def inspect
+      "#<#{self.class}: #{at.inspect},#{@offset.inspect}>"      
+    end
+  end
+end