acts_as_flux_capacitor 0.5.4 → 0.6.0

data/History.txt

@@ -1,3 +1,14 @@
+== 0.6.0 2008-05-23
+
+* WAAAY more hardcore spec'ng
+* removed debugging printing to STDOUT
+* removed unnessary helper methods
+
+== 0.5.4 2008-05-22
+
+* Added Range specs
+* Refactored Range#overlaps? (thanks to Nick Ang)
+
 == 0.5.3 2008-05-21
 
 * Fixed git stuff

data/Manifest.txt

@@ -23,6 +23,7 @@ spec/report.html
 spec/schema.rb
 spec/spec.opts
 spec/spec_helper.rb
+spec/time_helper.rb
 tasks/deployment.rake
 tasks/environment.rake
 tasks/rspec.rake

data/lib/acts_as_flux_capacitor/acts_as_flux_capacitor.rb

@@ -58,16 +58,13 @@ module HolmesLabs #:nodoc:
 						def find(*args)
 							options = args.extract_options!
 							
-							current_time				= options.delete(:current_time)
+							current_time				= options.delete(:current_time) || Time.now
 							temporal_conditions = extract_temporal_conditions!(options)
 							sql_temporal 				= sql_generate_temporal(temporal_conditions,current_time)
 							
-							puts temporal_conditions.size
-							puts sql_temporal
-							
 							with_scope(	:find 	=> { 
-														:conditions => sql_temporal , 
-														:order 			=> sql_oldest_first }) do
+													:conditions => sql_temporal , 
+													:order 			=> sql_oldest_first }) do
 								original_find(*(args << options))
 							end
 						end
@@ -87,9 +84,6 @@ private
 								temporal_conditions.merge!({key, options.delete(key)}) if CUSTOM_FIND_OPTIONS.include?(key)
 							end
 							
-							
-							require 'pp'# ; pp "(#{temporal_conditions.class}) #{temporal_conditions.first.keys}: #{temporal_conditions.first.values}"
-							pp temporal_conditions
 							temporal_conditions
 						end
 					end
@@ -97,59 +91,59 @@ private
 					module QueryGenerators
 					private
 						
-						def sql_before(some_time, current_time = nil)
+						def sql_before(some_time, current_time)
 							# table_name comes from ActiveRecord.
 							"#{table_name}.ends_at < '#{some_time.to_s(:db)}'"
 						end
 						alias sql_to sql_before
 						alias sql_ends_before sql_before
 						
-						def sql_after(some_time , current_time = nil)
+						def sql_after(some_time , current_time)
 							# table_name comes from ActiveRecord.
 							"#{table_name}.begins_at > '#{some_time.to_s(:db)}'"
 						end
 						alias sql_from sql_after
 						alias sql_begins_after sql_after
 						
-						def sql_at(some_time , current_time = Time.now)
-							sql_join_conditions([	sql_starts_before(	some_time),
-																		sql_ends_after(			some_time)])
+						def sql_at(some_time , current_time)
+							sql_join_conditions([	sql_starts_before(	some_time , current_time),
+																		sql_ends_after(			some_time , current_time)])
 						end
 						
-						def sql_ends_after(some_time , current_time = nil)
+						def sql_ends_after(some_time, current_time)
 							"#{table_name}.ends_at > '#{some_time.to_s(:db)}'"
 						end
 						
-						def sql_starts_before(some_time , current_time = nil)
+						def sql_starts_before(some_time , current_time)
 							"#{table_name}.begins_at < '#{some_time.to_s(:db)}'"
 						end
 						
-						def sql_past(is_true , current_time = Time.now)
+						def sql_past(is_true , current_time)
 							if is_true
-								sql_before(current_time)
+								sql_before(current_time, current_time)
 							else
-								sql_join_conditions_or([	sql_present(	Time.now),
-																					sql_future(		Time.now)])
+								sql_join_conditions_or([	sql_present(	current_time),
+																					sql_future(		current_time)])
 							end
 						end
 						alias sql_ended sql_past
 						
-						def sql_present(is_true , current_time = Time.now)
+						def sql_present(is_true , current_time)
 							if is_true
-								sql_at(current_time)
+								sql_at(current_time,current_time)
 							else
-								sql_join_conditions_or([	sql_past(		Time.now),
-																					sql_future(	Time.now)])
+								sql_join_conditions_or([	sql_past(		current_time),
+																					sql_future(	current_time)])
 							end
 						end
 						alias sql_now sql_present
 						
-						def sql_future(is_true, current_time = Time.now)
+						def sql_future(is_true, current_time)
 							if is_true
-								sql_after(current_time)
+								sql_after(current_time,current_time)
 							else
-								sql_join_conditions_or([	sql_present(	Time.now),
-																					sql_past(			Time.now)])
+								sql_join_conditions_or([	sql_present(current_time),
+																					sql_past(			current_time)])
 							end
 						end
 						
@@ -165,15 +159,12 @@ private
 							"#{conditions.join(") OR (")}"
 						end
 						
-						def sql_generate_temporal(temporal_conditions,current_time)
+						def sql_generate_temporal temporal_conditions , current_time
 							sql_conditions = []
 							temporal_conditions.each do |condition,parameter|
-								puts "#{condition}: #{parameter}"
-								sql_conditions << send("sql_#{condition}" , parameter , current_time)
+								sql_conditions << send("sql_#{condition}".to_sym , parameter, current_time)
 							end
 							
-							require 'pp' ; pp sql_conditions
-							pp sql_join_conditions(sql_conditions)
 							sql_join_conditions(sql_conditions)
 						end
 					end

data/lib/acts_as_flux_capacitor/core_class_extensions.rb

@@ -1,6 +1,6 @@
 class Time
 	
-	@@approx_eql_tolerance_in_seconds = 2 # in seconds
+	@@approx_eql_tolerance_in_seconds = 2
 	
 	def Time.approx_eql_tolerance_in_seconds
 		@@approx_eql_tolerance_in_seconds
@@ -17,17 +17,19 @@ class Time
 end
 
 class Array
-	def within?(tolerance)
-		
-		# bah. doing this for more than two numbers is a pain in the ass :(
-		# obviously, I have not.
-		raise "within? only works with arrays of two numbers" unless self.size == 2
+	def within? tolerance
+
+		# thanks, nick ang!
+		unless self.size == 2
+			raise ArgumentError <<ERROR_STRING
+within? only works with arrays of two numbers. do something like 
+([a,b,c].max,[a,b,c].min).within?(tolerance) as an implementation
+for an array with more than two values
+ERROR_STRING
+		end
 		
 		difference = self.first - self.last
 		difference.abs <= tolerance
 	end
 end
 
-class Range
-	# to_event?
-end

data/lib/acts_as_flux_capacitor/range_overlap.rb

@@ -14,12 +14,7 @@ class Range
 
 	def overlap(other_range)
 		return 0 unless self.overlaps?(other_range)
-		
-		overlap_range = greater_of(self.first,other_range.first)..smaller_of(self.last,other_range.last)
-#		puts "overlap range: #{overlap_range}"
-#		puts "greater of firsts: #{greater_of(self.first,other_range.first)}"
-#		puts "smaller of lasts:  #{smaller_of(self.last,other_range.last)}"
-		return overlap_range
+		([self.first,other_range.first].max)..([self.last,other_range.last].min)
 	end
 	
 	def size
@@ -43,13 +38,5 @@ private
 	
 	def number_size # technically, off by infinity^(-1) when either or both endpoints are excluded. meh.
 		return self.last-self.first+1
-	end
-	
-	def greater_of(num1,num2)
-		num1 > num2 ? num1 : num2
-	end
-	
-	def smaller_of(num1,num2)
-		num1 < num2 ? num1 : num2
 	end
 end

data/lib/acts_as_flux_capacitor/temporal.rb

@@ -1,10 +1,5 @@
-# require 'activesupport'
-
 module Temporal
 
-	include ActiveSupport::CoreExtensions::Numeric::Time
-	include ActiveSupport::CoreExtensions::Time
-
   def self.included(base) # :nodoc:
     base.extend ClassMethods
     base.extend ClassAndInstanceMethods
@@ -12,7 +7,6 @@ module Temporal
 	
 	module ClassMethods
 		def range_between(obj,another_obj)
-			verify_temporal obj, another_obj
 			first_obj,second_obj = ordered_tuple(obj,another_obj)
 			beginning = extract_time(first_obj,:ends_at)
 			ending    = extract_time(second_obj,:begins_at)
@@ -23,36 +17,50 @@ module Temporal
 			first_obj,second_obj = ordered_tuple(obj,another_obj)
 			beginning = extract_time(first_obj,:ends_at)
 			ending    = extract_time(second_obj,:begins_at)
-			beginning.before?(ending) ? (ending - beginning) : nil
+			beginning.before_or_at?(ending) ? ending - beginning : nil
 		end
 		
-		def length_of_time_until(obj,reference_point=Time.now)
-			verify_temporal(obj,reference_point)
-			# raise TypeError,"Parameter must be a temporal object later than its reference_point." unless obj.after?(reference_point)
-			difference = extract_time(obj,:begins_at)-extract_time(reference_point,:ends_at)
-			difference>=0 ? difference : nil
+		def length_of_time_until(obj,reference_obj=Time.now)
+			begins_at = extract_time(obj,:begins_at)
+			ends_at = extract_time(obj,:ends_at)
+			reference_point = extract_time(reference_obj,:ends_at)
+			
+			time_until_begins = begins_at - reference_point
+			# has not started
+			if time_until_begins >= 0
+				time_until_begins
+			# has started, but not ended
+			elsif time_until_begins < 0 && reference_point.before?(ends_at)
+				0
+			# has ended
+			else
+				nil
+			end
 		end
 		
-		def length_of_time_since(obj,reference_point=Time.now)
-			verify_temporal(obj,reference_point)
-#			raise TypeError,"Parameter must be a temporal object earlier than its reference_point." unless obj.before?(reference_point)
-			difference = extract_time(reference_point,:begins_at)-extract_time(obj,:ends_at)
-			difference>=0 ? difference : nil			
+		def length_of_time_since(obj,reference_obj=Time.now)
+			begins_at = extract_time(obj,:begins_at)
+			ends_at = extract_time(obj,:ends_at)
+			
+			reference_point = extract_time(reference_obj,:begins_at)
+
+			time_since_ended = reference_point - ends_at
+			has_started_but_not_ended = time_since_ended <= 0 && reference_point.after?(begins_at)
+			has_ended = time_since_ended >= 0
+			if has_ended
+				time_since_ended
+			elsif has_started_but_not_ended
+				0
+			else # has not started
+				nil
+			end
 		end
 	end
 	
 	module ClassAndInstanceMethods
-		def verify_temporal(*args)
-			args.each do |obj|
-				unless obj.class.included_modules.include?(Temporal)
-					raise "This method requires objects it interacts with to have the Temporal module; instead received #{obj.class}."
-				end
-			end
-			return nil
-		end
+
 	private
 		def ordered_tuple(an_obj,other_obj)
-			verify_temporal an_obj , other_obj
 			if an_obj.before?(other_obj)
 				return an_obj,other_obj
 			else
@@ -64,7 +72,6 @@ module Temporal
 			# if object possesses accessor method, return obj.accessor.
 			# if not, return object. This is useful for fudging duck typing-
 			# style interaction between Events and Times/Dates, etc.
-			verify_temporal(obj)
 			obj.respond_to?(accessor.to_sym) ? obj.send(accessor.to_sym) : obj
 		end
 	end
@@ -76,7 +83,6 @@ module Temporal
 		end
 		
 		def before?(obj)
-			verify_temporal(obj)
 			extract_time(self,:ends_at) < extract_time(obj,:begins_at)
 		end
 		
@@ -85,7 +91,6 @@ module Temporal
 		end
 		
 		def after?(obj)
-			verify_temporal(obj)
 			extract_time(self,:begins_at) > extract_time(obj,:ends_at)
 		end
 		
@@ -103,12 +108,12 @@ module Temporal
 		end
     
     def in_the_future?(time = Time.now)
-			extract_time(self,:ends_at).after?(time)
+			extract_time(self,:begins_at).after?(time)
     end
 		alias future? in_the_future?
 		
 		def in_the_past?(time=Time.now)
-			extract_time(self,:begins_at).before?(time)
+			extract_time(self,:ends_at).before?(time)
 		end
 		alias past? in_the_past?
 	end

data/lib/acts_as_flux_capacitor/version.rb

@@ -4,8 +4,8 @@ module HolmesLabs #:nodoc:
       module VERSION #:nodoc:
         
         MAJOR = 0
-        MINOR = 5
-        TINY  = 4
+        MINOR = 6
+        TINY  = 0
 
         STRING = [MAJOR, MINOR, TINY].join('.')
         

data/spec/acts_as_flux_capacitor_spec.rb

@@ -1,5 +1,7 @@
 require File.dirname(__FILE__) + '/spec_helper.rb'
 
+# ...and no, it won't work to put everything in a giant Time.freeze block.
+
 describe "The Temporal mixin" do
 
   before(:all) do
@@ -15,34 +17,66 @@ describe "The Temporal mixin" do
 
   it "should determine the length of time between two Temporal objects" do
     Time.period_between(@present_time,@twenty_mins_later).should == 20.minutes
+    Time.period_between(@twenty_mins_later,@present_time).should == 20.minutes
+    
+    Time.period_between(@twenty_mins_later,@twenty_mins_later).should == 0.minutes
   end
   
   it "should determine the length of time until a Temporal object" do
     Time.length_of_time_until(@twenty_mins_later,@present_time).should == 20.minutes
+    Time.length_of_time_until(@present_time,@twenty_mins_later).should be_nil
+    Time.length_of_time_until(@present_time,@present_time).should == 0.minutes
+    
+    Time.freeze do
+      Time.length_of_time_until(20.minutes.from_now).should == 20.minutes
+      Time.length_of_time_until(20.minutes.ago).should be_nil
+      Time.length_of_time_until(Time.now).should == 0.minutes
+    end
   end
   
   it "should determine if a temporal object is in the future" do
     @twenty_mins_later.in_the_future?(@present_time).should be_true
     @present_time.in_the_future?(@twenty_mins_later).should be_false
+    @present_time.in_the_future?(@present_time).should be_false
+    
+    Time.freeze do
+      20.minutes.from_now.in_the_future?.should be_true
+      20.minutes.ago.in_the_future?.should be_false
+      Time.now.in_the_future?.should be_false
+    end
   end
   
   it "should determine the length of time since a Temporal object" do
     Time.length_of_time_since(@present_time,@twenty_mins_later).should == 20.minutes
+    
+    Time.freeze do
+      Time.length_of_time_since(20.minutes.ago).should == 20.minutes
+      Time.length_of_time_since(20.minutes.from_now).should be_nil
+      Time.length_of_time_since(Time.now).should == 0.minutes
+    end
   end
   
   it "should determine if a temporal object is in the past" do
     @present_time.in_the_past?(@twenty_mins_later).should be_true
     @twenty_mins_later.in_the_past?(@present_time).should be_false
+    
+    Time.freeze do
+      10.minutes.ago.in_the_past?.should be_true
+      10.minutes.from_now.in_the_past?.should be_false
+      Time.now.in_the_future?.should be_false
+    end
   end
   
   it "should determine if one Temporal object is before another" do
     @present_time.before?(@twenty_mins_later).should be_true
     @twenty_mins_later.before?(@present_time).should be_false
+    @twenty_mins_later.before?(@twenty_mins_later).should be_false
   end
   
   it "should determine if one Temporal object is after another" do
-    @twenty_mins_later.before?(@present_time).should be_false
-    @present_time.before?(@twenty_mins_later).should be_true
+    @twenty_mins_later.after?(@present_time).should be_true
+    @present_time.after?(@twenty_mins_later).should be_false
+    @present_time.after?(@present_time).should be_false
   end
   
 end
@@ -81,25 +115,57 @@ describe "The TimePeriod.find extensions" do
   it "should find time_periods in the present" do
     TimePeriod.find(:first,:present=>true   ,:current_time => present_time).
       happening_now?(present_time).should be_true
+          
+    Time.freeze(present_time) do
+      TimePeriod.find(:first,:present=>true).happening_now?.should be_true
+      
+      time_periods = TimePeriod.find(:all,:present=>true)
+      time_periods.size.should eql(2)
+      time_periods.each { |period| period.happening_now?.should be_true }
+    end
   end
   
   it "should find time_periods in the past" do
     TimePeriod.find(:first,:past=>true      ,:current_time => present_time).
       in_the_past?(present_time).should be_true
+      
+    Time.freeze(present_time) do
+      TimePeriod.find(:first,:past=>true).in_the_past?.should be_true
+      
+      time_periods = TimePeriod.find(:all,:past=>true)
+      time_periods.size.should eql(1)
+      time_periods.each { |period| period.past?.should be_true }
+    end
   end
   
   it "should find time_periods in the future" do
     TimePeriod.find(:first,:future=>true    ,:current_time => present_time).
       in_the_future?(present_time).should be_true
+      
+    Time.freeze(present_time) do
+      TimePeriod.find(:first,:future=>true).in_the_future?.should be_true
+      
+      time_periods = TimePeriod.find(:all,:future=>true)
+      time_periods.size.should eql(1)
+      time_periods.each { |period| period.future?.should be_true }
+    end
   end
   
   it "should find time_periods occuring at a specific time" do
     TimePeriod.find(:first,:at=>future_time).at?(future_time).should be_true
+    
+    time_periods = TimePeriod.find(:all,:at=>future_time)
+    time_periods.size.should eql(1)
+    time_periods.first.at?(future_time).should be_true
   end
   
   it "should find time_periods occuring within a specific range of time" do
     TimePeriod.find(:first,:from => more_past_time , :to => more_future_time).
     at?(present_time).should be_true
+    
+    time_periods = TimePeriod.find(:all,:from => more_past_time , :to => more_future_time)
+    time_periods.size.should eql(1)
+    time_periods.first.at?(present_time).should be_true
   end
   
 end
@@ -107,6 +173,18 @@ end
 describe "The TimePeriod comparison helpers" do
 
   include TimePeriodFixtures
+  
+  it "should determine if one time period is before another" do
+    present_period.before_or_at?(future_period).should be_true
+    future_period.before?(past_period).should be_false
+    present_period.before?(present_period).should be_false
+  end
+  
+  it "should determine if one time period is after another" do
+    future_period.after?(present_time).should be_true
+    present_time.after?(future_period).should be_false
+    past_period.after?(past_period).should be_false
+  end
 
   it "should calculate the time between time_periods" do
     TimePeriod.period_between(past_period,future_period).should == 140.minutes
@@ -133,6 +211,42 @@ end
 
 describe "The TimePeriod status helpers" do
 
+  before(:all) do
+    @present_time       = Time.parse "Sun May 18 16:41:58 2008"
+  end
+  
+  it "should determine the length of time until a time_period" do
+    Time.freeze(@present_time) do
+      Time.length_of_time_until(future_period).should == 20.minutes
+      Time.length_of_time_until(present_period).should == 0.minutes
+      Time.length_of_time_until(past_period).should be_nil
+    end
+  end
+  
+  it "should determine if a time_period is in the future" do
+    Time.freeze(@present_time) do
+      future_period.in_the_future?.should be_true
+      past_period.in_the_future?.should be_false
+      present_period.future?.should be_false
+    end
+  end
+  
+  it "should determine the length of time since a time_period ended" do    
+    Time.freeze(@present_time) do
+      Time.length_of_time_since(past_period).should == 2.hours
+      Time.length_of_time_since(future_period).should be_nil
+      Time.length_of_time_since(present_period).should == 0.minutes
+    end
+  end
+  
+  it "should determine if a time_period is in the past" do
+    Time.freeze(@present_time) do
+      past_period.past?.should be_true
+      present_period.past?.should be_false
+      future_period.past?.should be_false
+    end
+  end
+
   it "should determine if a time_period has started" do
     past_period.started?(present_time).should be_true
     present_period.started?(present_time).should be_true

data/spec/report.html

@@ -179,104 +179,116 @@ a {
 <div class="example_group">
   <dl>
   <dt id="example_group_1">The Temporal mixin</dt>
-    <script type="text/javascript">moveProgressBar('3.1');</script>
+    <script type="text/javascript">moveProgressBar('2.6');</script>
     <dd class="spec passed"><span class="passed_spec_name">should make Time, Date and DateTime into Temporal objects</span></dd>
-    <script type="text/javascript">moveProgressBar('6.2');</script>
+    <script type="text/javascript">moveProgressBar('5.2');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine the length of time between two Temporal objects</span></dd>
-    <script type="text/javascript">moveProgressBar('9.3');</script>
+    <script type="text/javascript">moveProgressBar('7.8');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine the length of time until a Temporal object</span></dd>
-    <script type="text/javascript">moveProgressBar('12.5');</script>
+    <script type="text/javascript">moveProgressBar('10.5');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if a temporal object is in the future</span></dd>
-    <script type="text/javascript">moveProgressBar('15.6');</script>
+    <script type="text/javascript">moveProgressBar('13.1');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine the length of time since a Temporal object</span></dd>
-    <script type="text/javascript">moveProgressBar('18.7');</script>
+    <script type="text/javascript">moveProgressBar('15.7');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if a temporal object is in the past</span></dd>
-    <script type="text/javascript">moveProgressBar('21.8');</script>
+    <script type="text/javascript">moveProgressBar('18.4');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if one Temporal object is before another</span></dd>
-    <script type="text/javascript">moveProgressBar('25.0');</script>
+    <script type="text/javascript">moveProgressBar('21.0');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if one Temporal object is after another</span></dd>
   </dl>
 </div>
 <div class="example_group">
   <dl>
   <dt id="example_group_2">The class TimePeriod &lt; ActiveRecord::Base</dt>
-    <script type="text/javascript">moveProgressBar('28.1');</script>
+    <script type="text/javascript">moveProgressBar('23.6');</script>
     <dd class="spec passed"><span class="passed_spec_name">should be a flux capacitor</span></dd>
-    <script type="text/javascript">moveProgressBar('31.2');</script>
+    <script type="text/javascript">moveProgressBar('26.3');</script>
     <dd class="spec passed"><span class="passed_spec_name">should be a Temporal object</span></dd>
-    <script type="text/javascript">moveProgressBar('34.3');</script>
+    <script type="text/javascript">moveProgressBar('28.9');</script>
     <dd class="spec passed"><span class="passed_spec_name">should possess all four bitemporal database attributes</span></dd>
-    <script type="text/javascript">moveProgressBar('37.5');</script>
+    <script type="text/javascript">moveProgressBar('31.5');</script>
     <dd class="spec passed"><span class="passed_spec_name">should not be valid if either of the two time spans are 0 or less</span></dd>
   </dl>
 </div>
 <div class="example_group">
   <dl>
   <dt id="example_group_3">The TimePeriod.find extensions</dt>
-    <script type="text/javascript">moveProgressBar('40.6');</script>
+    <script type="text/javascript">moveProgressBar('34.2');</script>
     <dd class="spec passed"><span class="passed_spec_name">should find time_periods in the present</span></dd>
-    <script type="text/javascript">moveProgressBar('43.7');</script>
+    <script type="text/javascript">moveProgressBar('36.8');</script>
     <dd class="spec passed"><span class="passed_spec_name">should find time_periods in the past</span></dd>
-    <script type="text/javascript">moveProgressBar('46.8');</script>
+    <script type="text/javascript">moveProgressBar('39.4');</script>
     <dd class="spec passed"><span class="passed_spec_name">should find time_periods in the future</span></dd>
-    <script type="text/javascript">moveProgressBar('50.0');</script>
+    <script type="text/javascript">moveProgressBar('42.1');</script>
     <dd class="spec passed"><span class="passed_spec_name">should find time_periods occuring at a specific time</span></dd>
-    <script type="text/javascript">moveProgressBar('53.1');</script>
+    <script type="text/javascript">moveProgressBar('44.7');</script>
     <dd class="spec passed"><span class="passed_spec_name">should find time_periods occuring within a specific range of time</span></dd>
   </dl>
 </div>
 <div class="example_group">
   <dl>
   <dt id="example_group_4">The TimePeriod comparison helpers</dt>
-    <script type="text/javascript">moveProgressBar('56.2');</script>
+    <script type="text/javascript">moveProgressBar('47.3');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should determine if one time period is before another</span></dd>
+    <script type="text/javascript">moveProgressBar('50.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should determine if one time period is after another</span></dd>
+    <script type="text/javascript">moveProgressBar('52.6');</script>
     <dd class="spec passed"><span class="passed_spec_name">should calculate the time between time_periods</span></dd>
-    <script type="text/javascript">moveProgressBar('59.3');</script>
+    <script type="text/javascript">moveProgressBar('55.2');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine whether two time_periods overlap</span></dd>
-    <script type="text/javascript">moveProgressBar('62.5');</script>
+    <script type="text/javascript">moveProgressBar('57.8');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine the length of time by which two time_periods overlap</span></dd>
-    <script type="text/javascript">moveProgressBar('65.6');</script>
+    <script type="text/javascript">moveProgressBar('60.5');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if two time_periods are back-to-back</span></dd>
-    <script type="text/javascript">moveProgressBar('68.7');</script>
+    <script type="text/javascript">moveProgressBar('63.1');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if a time_period is between two other time_periods</span></dd>
   </dl>
 </div>
 <div class="example_group">
   <dl>
   <dt id="example_group_5">The TimePeriod status helpers</dt>
-    <script type="text/javascript">moveProgressBar('71.8');</script>
+    <script type="text/javascript">moveProgressBar('65.7');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should determine the length of time until a time_period</span></dd>
+    <script type="text/javascript">moveProgressBar('68.4');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should determine if a time_period is in the future</span></dd>
+    <script type="text/javascript">moveProgressBar('71.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should determine the length of time since a time_period ended</span></dd>
+    <script type="text/javascript">moveProgressBar('73.6');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should determine if a time_period is in the past</span></dd>
+    <script type="text/javascript">moveProgressBar('76.3');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if a time_period has started</span></dd>
-    <script type="text/javascript">moveProgressBar('75.0');</script>
+    <script type="text/javascript">moveProgressBar('78.9');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine how much time has elapsed since an event started</span></dd>
-    <script type="text/javascript">moveProgressBar('78.1');</script>
+    <script type="text/javascript">moveProgressBar('81.5');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine what percentage of time has elapsed since an event started</span></dd>
-    <script type="text/javascript">moveProgressBar('81.2');</script>
+    <script type="text/javascript">moveProgressBar('84.2');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine how much time is remaining until an event ends</span></dd>
-    <script type="text/javascript">moveProgressBar('84.3');</script>
+    <script type="text/javascript">moveProgressBar('86.8');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine what percentage of time is remaining until an event ends</span></dd>
-    <script type="text/javascript">moveProgressBar('87.5');</script>
+    <script type="text/javascript">moveProgressBar('89.4');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if a time_period has ended</span></dd>
-    <script type="text/javascript">moveProgressBar('90.6');</script>
+    <script type="text/javascript">moveProgressBar('92.1');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine the duration of a time_period</span></dd>
   </dl>
 </div>
 <div class="example_group">
   <dl>
   <dt id="example_group_6">The TimePeriod modification helpers</dt>
-    <script type="text/javascript">moveProgressBar('93.7');</script>
+    <script type="text/javascript">moveProgressBar('94.7');</script>
     <dd class="spec passed"><span class="passed_spec_name">should shift a time_period into the past or future</span></dd>
   </dl>
 </div>
 <div class="example_group">
   <dl>
   <dt id="example_group_7">The Range overlap helpers</dt>
-    <script type="text/javascript">moveProgressBar('96.8');</script>
+    <script type="text/javascript">moveProgressBar('97.3');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if two ranges do not overlap</span></dd>
     <script type="text/javascript">moveProgressBar('100.0');</script>
     <dd class="spec passed"><span class="passed_spec_name">should determine if two ranges do overlap</span></dd>
   </dl>
 </div>
-<script type="text/javascript">document.getElementById('duration').innerHTML = "Finished in <strong>0.321167 seconds</strong>";</script>
-<script type="text/javascript">document.getElementById('totals').innerHTML = "32 examples, 0 failures";</script>
+<script type="text/javascript">document.getElementById('duration').innerHTML = "Finished in <strong>0.368839 seconds</strong>";</script>
+<script type="text/javascript">document.getElementById('totals').innerHTML = "38 examples, 0 failures";</script>
 </div>
 </div>
 </body>

data/spec/spec_helper.rb

@@ -11,6 +11,7 @@ require 'ruby-debug'
 require 'activerecord'
 require 'activesupport'
 require 'spec/fixtures.rb'
+require 'spec/time_helper.rb'
 
 config = YAML::load(IO.read(File.dirname(__FILE__) + '/database.yml'))
 ActiveRecord::Base.logger = Logger.new(File.dirname(__FILE__) + "/../log/debug.log")

data/spec/time_helper.rb

@@ -0,0 +1,54 @@
+class Time
+
+  # this code adds a Time.freeze method to make time "stand still"
+  # during execution of a block. This can be helpful during testing of
+  # methods that depend on Time.new or Time.now
+  #
+  # Example:
+  #
+  #   Time.freeze do
+  #      puts Time.new.to_f
+  #      # ... do stuff; real time passes
+  #      puts Time.new.to_f     # outputs same time as above
+  #   end
+  #   # ... time returns to normal
+  #
+  # An optional Time object may be passed to freeze to a specific time:
+  #
+  #   Time.freeze(Time.at(2007, 11, 15)) do
+  #      # ...
+  #   end
+  #
+  # While inside the block, Time.frozen? will return true
+
+  class << self
+
+    def now
+      @time || orig_new
+    end
+
+    alias_method :orig_freeze, :freeze
+    alias_method :orig_new, :new
+    alias_method :new, :now
+
+    # makes time "stand still" during execution of a block. if no time is
+    # supplied, the current time is used. While in the block, Time.new and
+    # Time.now will always return the "frozen" value.
+    def freeze(time = nil)
+      raise "A block is required" unless block_given?
+      begin
+        prev = @time
+        @time = time || now
+        yield
+      ensure
+        @time = prev
+      end
+    end
+
+    def frozen?
+      !@time.nil?
+    end
+
+  end
+end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: acts_as_flux_capacitor
 version: !ruby/object:Gem::Version 
-  version: 0.5.4
+  version: 0.6.0
 platform: ruby
 authors: 
 - Jim Cropcho
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-05-22 00:00:00 -04:00
+date: 2008-05-23 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -52,6 +52,7 @@ files:
 - spec/schema.rb
 - spec/spec.opts
 - spec/spec_helper.rb
+- spec/time_helper.rb
 - tasks/deployment.rake
 - tasks/environment.rake
 - tasks/rspec.rake