bjhess-time-warp 1.0.1 → 1.0.2

data/README

@@ -11,6 +11,9 @@ mocking around with baseline Ruby classes to be asking for trouble.  Eventually
 unusual behavior will rear its head and a day will be lost debugging
 tests - the most excruciating debugging one can be subjected to.
 
+Rather than mock Time.now, the time-warp gem will temporarily stub its return
+value for the duration of the block defined within a pretend_now_is method
+call.  See examples below for practical usage.
 
 Installation
 ============
@@ -24,6 +27,10 @@ Gem:
 $ gem sources -a http://gems.github.com
 $ sudo gem install bjhess-time-warp
 
+Gem config in a Rails app.  environment.rb:
+
+config.gem 'bjhess-time-warp', :lib => 'time_warp', :source => "http://gems.github.com"
+
 Example
 =======
 
@@ -66,6 +73,18 @@ goal is to assure a particular day of week when each test method executes:
   end
 end
 
+The pretend_now_is method may also be called with the arguments for the
+Time#utc call, rather than a Time argument.  So:
+
+  pretend_now_is(Time.utc(2008,"jul",24,20)) do
+    # Shifted code
+  end
+  
+Becomes:
+
+  pretend_now_is(2008,"jul",24,20) do
+    # Shifted code
+  end
 
 Credits
 =======

data/lib/time_warp.rb

@@ -6,14 +6,21 @@ module Test # :nodoc:
 
       ##
       # Time warp to the specified time for the duration of the passed block.
-      def pretend_now_is(time)
+      def pretend_now_is(*args)
         begin
-          Time.testing_offset = Time.now - time
+          Time.testing_offset = Time.now - time_from(*args)
           yield
         ensure
           Time.testing_offset = 0
         end
       end
+    
+    private
+    
+      def time_from(*args)
+        return args[0] if 1 == args.size && args[0].is_a?(Time)
+        Time.utc(*args)
+      end
 
     end
   end

data/test/time_warp_test.rb

@@ -44,4 +44,15 @@ class TimeWarpTest < Test::Unit::TestCase
     assert_equal   now_hour, Time.now.hour
     assert_equal now_minute, Time.now.min
   end
+  
+  def test_pretend_now_resolves_to_the_same_value_regardless_of_setting_by_time_argument_or_time_utc_arguments
+    now_with_time_argument = now_with_time_utc_arguments = nil
+    pretend_now_is(Time.utc(2008,"jul",25,6,15)) do #=> Fri Jul 25 06:15:00 UTC 2008
+      now_with_time_argument = Time.now.utc
+    end
+    pretend_now_is(2008,"jul",25,6,15) do           #=> Fri Jul 25 06:15:00 UTC 2008
+      now_with_time_utc_arguments = Time.now.utc
+    end
+    assert_equal now_with_time_argument.to_s, now_with_time_utc_arguments.to_s
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: bjhess-time-warp
 version: !ruby/object:Gem::Version 
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors: 
 - Barry Hess