ranges 0.1.0

data/README

@@ -0,0 +1,8 @@
+Just a simple class I wrote for time ranges. Allows asking questions like:
+
+range_1.overlaps_with?(range_2)
+range_1.disjoint_to?(range_2)
+range_1.wraps?(range_2)
+range_1.within?(range_2)
+
+check out the tests for more information.

data/lib/date_extensions.rb

@@ -0,0 +1,6 @@
+
+module DateExtensions
+  def within?(range)
+    range.start_date <= self && range.end_date >= self
+  end
+end

data/lib/ranges.rb

@@ -0,0 +1,12 @@
+require_relative 'time_range.rb'
+require_relative 'date_extensions.rb'
+require_relative 'time_extensions.rb'
+
+class Date
+  include DateExtensions
+end
+
+class Time
+  include TimeExtensions
+end
+

data/lib/time_extensions.rb

@@ -0,0 +1,5 @@
+module TimeExtensions
+  def within?(range)
+    range.start_time <= self && range.end_time >= self
+  end
+end

data/lib/time_range.rb

@@ -0,0 +1,72 @@
+require 'date'
+
+class TimeRange
+  TIME_REQUIRED = "Parameters must be time objects"
+  START_BEFORE_END = "Start time must come before end time"
+  attr_reader :start_time, :end_time
+
+  def initialize(start_time, end_time)
+    unless start_time.is_a?(Time) && end_time.is_a?(Time)
+      raise ArgumentError.new(TIME_REQUIRED)
+    end
+    raise ArgumentError.new(START_BEFORE_END) unless start_time < end_time
+    @start_time = start_time
+    @end_time = end_time
+  end
+
+  def start_date
+    start_time.to_date
+  end
+
+  def end_date
+    end_time.to_date
+  end
+
+  def overlaps_with?(range)
+    range.start_time < end_time && range.end_time > start_time
+  end
+
+  def within?(range)
+    range.start_time < start_time && range.end_time > end_time
+  end
+
+  def wraps?(range)
+    range.within?(self)
+  end
+
+  def disjoint_to?(range)
+    !self.overlaps_with?(range) 
+  end
+
+  def starts_before?(range)
+    start_time < range.start_time
+  end
+
+  def starts_after?(range)
+    start_time > range.start_time
+  end
+
+  def ends_before?(range)
+    end_time < range.end_time
+  end
+
+  def ends_after?(range)
+    end_time > range.end_time
+  end
+
+  def length_in_seconds
+    end_time.to_i - start_time.to_i
+  end
+
+  def length_in_minutes
+    length_in_seconds / 60.0
+  end
+
+  def length_in_hours
+    length_in_seconds / 3600.0
+  end
+
+  def longer_than?(range)
+    length_in_seconds > range.length_in_seconds 
+  end 
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: ranges
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Peter Zimbelman
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-05 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Ranges is a gem which supplies a time/date range class and other functionality based around these ranges.
+email: pzimbelman@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/date_extensions.rb
+- lib/ranges.rb
+- lib/time_extensions.rb
+- lib/time_range.rb
+- README
+has_rdoc: true
+homepage: http://github.com/softwarewithfriends/ranges
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: "Ranges: A gem for time and date ranges."
+test_files: []
+