clock 0.1.3

data/README.markdown

@@ -0,0 +1,11 @@
+## Clock
+
+Clock is a simple wrapper for Ruby's Time object, with a few fancy additions for testing. In test mode, Clock
+will automatically load the mock_clock methods, allowing you to set the current time with <code>Clock.now=(time)</code>
+and manually advance time with <code>Clock.tick(seconds)</code>.
+
+In any other environment other than test, Clock will behave exactly like Time.
+
+## Requirements
+
+To initialize properly, this gem requires Rails 3.0 or above.

data/lib/clock.rb

@@ -0,0 +1,20 @@
+class Clock
+  def self.today
+    self.now.to_date
+  end
+end
+
+module Pivotal
+  module Clock
+    class Railtie < ::Rails::Railtie
+      config.before_configuration do
+        Pivotal::Clock.use_mock_clock? ? require("mock_clock") : require('real_clock')
+      end
+    end
+
+    def self.use_mock_clock?
+      return USE_MOCK_CLOCK if Object.const_defined?(:USE_MOCK_CLOCK)
+      return ::Rails.env.test?
+    end
+  end
+end

data/lib/mock_clock.rb

@@ -0,0 +1,26 @@
+=begin
+THREADING NOTE: The mock Clock is not thread-safe, ||= is not atomic.  Thus, thread A could modify @@now between thread
+B's comparison of @@now to nil and assignment of @@now to Time.now.  The #tick method has a similar issue.
+
+This should generally not be a problem, as tests shouldn't have a reason to modify the current time concurrently in
+multiple threads.
+=end
+
+class Clock
+  def self.now
+    @@now ||= Time.now
+  end
+
+  def self.now=(new)
+    @@now = new.to_time
+  end
+
+  def self.tick(duration)
+    self.now += duration
+  end
+
+  def self.zone
+    return nil if Time.zone.nil?
+    TimeZoneProxy.new(Time.zone)
+  end
+end

data/lib/real_clock.rb

@@ -0,0 +1,9 @@
+class Clock
+  def self.now
+    Time.now
+  end
+
+  def self.zone
+    Time.zone
+  end
+end

data/lib/time_zone_proxy.rb

@@ -0,0 +1,24 @@
+class TimeZoneProxy
+  attr_reader :target
+
+  def initialize(target)
+    raise "Target time zone may not be nil" if target.nil?
+    @target = target
+  end
+
+  def now
+    Clock.now.in_time_zone(@target)
+  end
+
+  def today
+    Clock.now.in_time_zone(@target).to_date
+  end
+
+  def ==(rhs)
+    super(rhs) || self.target == rhs || (rhs.respond_to?(:target) && self.target == rhs.target)
+  end
+
+  def method_missing(method, *args)
+    target.send(method, *args)
+  end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: clock
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 3
+  version: 0.1.3
+platform: ruby
+authors: 
+- Pivotal Labs
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-10 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        - 0
+        version: 3.0.0
+  type: :runtime
+  version_requirements: *id001
+description: Works exactly like Ruby's standard Time object, but in test mode adds some nice methods for setting or manually advancing time.
+email: pivotal-opensource@googlegroups.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- lib/clock.rb
+- lib/mock_clock.rb
+- lib/real_clock.rb
+- lib/time_zone_proxy.rb
+- README.markdown
+has_rdoc: true
+homepage: http://github.com/pivotal/clock
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A wrapper for Ruby's Time object that includes a mock for manipulating time in tests
+test_files: []
+