time_range 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d90559eb4d0630208384e2daa03679dc45fb7399
+  data.tar.gz: 15b6b124c1dc63d1464c353dbeea8e7a2a7ff6d8
+SHA512:
+  metadata.gz: 99e02e3ec2de2865b262ebef8417aeba44eb9972f373c1853046afe2fc5c015b3c7520ec8dc8ad2dfc14b50ab0ac9aff0cd62fb11dced1b3a22d168936cd211c
+  data.tar.gz: 9c31884bc13a23a723192ce4223f023d7f48d4dbd21bb5d85a980e6a6634112dfa76a09c2f3804484ff153a26ee45dcbc4d87cbc5682ffaadba5effeaf47a1d6

data/lib/time_range.rb

@@ -0,0 +1,128 @@
+
+WRONG_ARG = "is not time"
+# the TimeRange 
+# 
+# helps in Issues with time time ranges,
+# such as intersecton of time ranges,
+# union of time ranges, etc.
+# 
+# == Examples
+#   require "time_range"
+#
+#   range = TimeRange.new(Time.now - 1000, Time.now + 1000)
+#   # => 2013-09-13 23:32:16 +0400..2013-09-14 00:05:36 +0400
+#   today = TimeRange.for_date(Date.today)
+#   # =>  2013-09-13 00:00:00 +0400..2013-09-13 23:59:59 +0400
+#
+# Check time presence in time range
+#   range.include?(Time.now)
+#   # => true
+# 
+# Check time range presense in another time_range
+#   range2 = TimeRange.new(Time.now - 10, Time.now + 10)
+#   # => 2013-09-13 23:50:31 +0400..2013-09-13 23:50:51 +0400
+# 
+#   range.fully_include?(range2)
+#   # => true
+#
+# Check time ranges intersects each other:
+#   range.intersects?(range2)
+#   # => true
+#
+# Intersect time ranges
+#   range.intersection(range2)
+#   # => 2013-09-13 23:50:31 +0400..2013-09-13 23:50:51 +0400 # i.e equal range2
+#
+# Union time ranges 
+#   range3 = TimeRange.new(Time.now + 10000, Time.now + 20000)
+#   TimeRange.union(range, range2, range3)
+#   # => [2013-09-13 23:32:16 +0400..2013-09-14 00:05:36 +0400, 
+#   #     2013-09-14 02:41:17 +0400..2013-09-14 05:27:57 +0400]
+#
+# Subtract time ranges from one time range
+#   TimeRange.for_date(Date.today).subtract(TimeRange.new(Time.now + 900, Time.now + 1200),    
+#                                           TimeRange.new(Time.now + 300, Time.now + 600))
+#   # => [2013-09-14 00:00:00 +0400..2013-09-14 00:55:51 +0400, 
+#   #     2013-09-14 01:00:51 +0400..2013-09-14 01:05:51 +0400, 
+#   #     2013-09-14 01:10:51 +0400..2013-09-14 23:59:59 +0400]
+class TimeRange < Range
+
+  alias_method :orig_init, :initialize
+  def initialize(rbegin, rend)
+    raise WrongTimeRangeError, WRONG_ARG unless (rbegin.is_a?(Time) && rend.is_a?(Time))
+    rbegin, rend = rend, rbegin if rbegin > rend
+    orig_init(rbegin, rend)
+  end
+
+  def intersects?(range)
+    (self.begin >= range.begin &&  self.begin <= range.end) || (self.end >= range.begin &&  self.end <= range.end) ||
+      (range.begin >= self.begin &&  range.begin  <= self.end) || (range.end >= self.begin &&  range.end <= self.end)
+  end
+
+  def intersection(range)
+    TimeRange.intersection(self, range)
+  end
+
+  def include?(time)
+    self.begin <= time && self.end >= time
+  end
+
+  def fully_include?(time_rage)
+    self.include?(time_rage.begin) && self.include?(time_rage.end)
+  end
+
+  def subtract(*ranges)
+    ranges = ranges.flatten.sort{|a, b| a.begin <=> b.begin}
+    return self if ranges.empty?
+    result = []
+    ranges.each do |range|
+      subtraction = self.intersection(TimeRange.new(self.begin, range.begin) ) if range.eql?(ranges.first)
+      result << subtraction if subtraction
+
+      if range.eql?(ranges.last)
+        subtraction = self.intersection(TimeRange.new(range.end, self.end ) )
+        result << subtraction if subtraction
+      else
+        subtraction = self.intersection(TimeRange.new(range.end, ranges[ranges.index(range) + 1].begin ))
+        result << subtraction if subtraction
+      end
+    end
+    TimeRange.union(result)
+  end
+
+  def self.for_date(date)
+    TimeRange.new(date.to_time, (date + 1).to_time - 1)
+  end
+
+  def self.intersection(*tranges)
+    return tranges if tranges.is_a?(TimeRange)
+    tranges = tranges.flatten.sort!{|a,b| a.begin <=> b.begin}
+    return tranges.first if (tranges.count == 1)
+    first, second = tranges[0], tranges[1]
+    if(tranges.count == 2)
+      return nil unless first.intersects?(second)
+      tbegin = [first.begin, second.begin].max
+      tend =   [first.end, second.end].min
+      return TimeRange.new(tbegin, tend)
+    elsif tranges.count > 2
+      return intersection([intersection(first, second), tranges[2..-1] ].flatten) if first.intersects?(second)
+    end
+  end
+
+  def self.union(*tranges)
+    return tranges if tranges.is_a?(TimeRange) && tranges.begin != tranges.end
+    tranges = tranges.flatten.sort{|a,b| a.begin <=> b.begin}.select{|trange| trange.begin != trange.end}
+    return tranges.first if (tranges.count == 1)
+    first, second = tranges[0], tranges[1]
+    if(tranges.count == 2)
+      return [first, second] unless first.intersects?(second)
+      tbegin = [first.begin, second.begin].min
+      tend =   [first.end, second.end].max
+      return TimeRange.new(tbegin, tend)
+    elsif tranges.count > 2
+      return [ first, union(tranges[1..-1])].flatten unless first.intersects?(second)
+      result = union([ union(first, second), tranges[2..-1]])
+      return result.is_a?(Array) ? result.flatten : result
+    end
+  end
+end

metadata

@@ -0,0 +1,43 @@
+--- !ruby/object:Gem::Specification
+name: time_range
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Ilya Boltnev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-14 00:00:00.000000000 Z
+dependencies: []
+description: Time ranges Intersection, union, etc
+email: ilya@boltnev.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/time_range.rb
+homepage: https://github.com/boltnev/time_ranges
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: The TimeRange class for help with some time range manipulations
+test_files: []