metra_schedule 0.2.1.2 → 0.2.2

data/.gitignore

@@ -0,0 +1,2 @@
+*.swp
+*.gem

data/README.rdoc

@@ -1,5 +1,7 @@
 = metra_schedule: A library to access the Chicago Metra schedule information as Ruby objects.
 
+This is the data library that powers http://metra.blakesmith.me
+
 Supported Lines:
   Union Pacific Northwest => :up_nw
   Union Pacific North => :up_n

data/Rakefile

@@ -21,3 +21,19 @@ Rake::TestTask.new(:test_integrations) do |t|
   t.test_files = FileList['test/integration/test*.rb']
   t.warning = false
 end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "metra_schedule"
+    gemspec.summary = "Chicago Metra parser and scheduler"
+    gemspec.description = "metra_schedule provides a ruby object interface to the Chicago metra train schedule"
+    gemspec.email = "blakesmith0@gmail.com"
+    gemspec.homepage = "http://github.com/blakesmith/metra_schedule"
+    gemspec.authors = ["Blake Smith"]
+    gemspec.add_dependency('nokogiri', '>=1.4.1')
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.2.2

data/lib/metra/extensions/time_extension.rb

@@ -0,0 +1,9 @@
+module MetraSchedule
+  module Extensions
+    module TimeExtension
+      def to_today
+        Time.local(Time.now.year, Time.now.month, Time.now.day, self.hour, self.min, self.sec)
+      end
+    end
+  end
+end

data/lib/metra/train.rb

@@ -36,7 +36,7 @@ module MetraSchedule
     def departure_and_arrival(start, destination)
       departure = @stops.find {|s| s.station == start}.time
       arrival = @stops.find {|s| s.station == destination}.time
-      {:departure => departure, :arrival => arrival}
+      {:departure => departure.to_today, :arrival => arrival.to_today}
     end
 
     def my_travel_time
@@ -88,6 +88,5 @@ module MetraSchedule
       return "#{my_travel_minutes} minutes" if my_travel_minutes > 1
     end
 
-
   end
 end

data/lib/metra.rb

@@ -4,7 +4,10 @@ require File.join(File.dirname(__FILE__), 'metra', 'train')
 require File.join(File.dirname(__FILE__), 'metra', 'stop')
 require File.join(File.dirname(__FILE__), 'metra', 'parser')
 require File.join(File.dirname(__FILE__), 'metra', 'cacher')
+require File.join(File.dirname(__FILE__), 'metra', 'extensions', 'time_extension')
 
 class Metra
   include MetraSchedule::InstanceMethods
 end
+
+Time.send(:include, MetraSchedule::Extensions::TimeExtension)

data/metra_schedule.gemspec

@@ -0,0 +1,91 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{metra_schedule}
+  s.version = "0.2.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Blake Smith"]
+  s.date = %q{2010-01-05}
+  s.description = %q{metra_schedule provides a ruby object interface to the Chicago metra train schedule}
+  s.email = %q{blakesmith0@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/metra.rb",
+     "lib/metra/cacher.rb",
+     "lib/metra/classmethods.rb",
+     "lib/metra/extensions/time_extension.rb",
+     "lib/metra/line.rb",
+     "lib/metra/parser.rb",
+     "lib/metra/stop.rb",
+     "lib/metra/train.rb",
+     "lib/metra/train_data.rb",
+     "metra_schedule.gemspec",
+     "test/fixture/UP_NW.html",
+     "test/functional/test_all_filters.rb",
+     "test/integration/test_line_integration.rb",
+     "test/test_helper.rb",
+     "test/timecop/History.rdoc",
+     "test/timecop/LICENSE",
+     "test/timecop/README.rdoc",
+     "test/timecop/Rakefile",
+     "test/timecop/VERSION.yml",
+     "test/timecop/lib/timecop.rb",
+     "test/timecop/lib/timecop/time_extensions.rb",
+     "test/timecop/lib/timecop/time_stack_item.rb",
+     "test/timecop/lib/timecop/timecop.rb",
+     "test/unit/test_cacher.rb",
+     "test/unit/test_line.rb",
+     "test/unit/test_metra.rb",
+     "test/unit/test_parser.rb",
+     "test/unit/test_stop.rb",
+     "test/unit/test_time_extension.rb",
+     "test/unit/test_train.rb"
+  ]
+  s.homepage = %q{http://github.com/blakesmith/metra_schedule}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Chicago Metra parser and scheduler}
+  s.test_files = [
+    "test/integration/test_line_integration.rb",
+     "test/functional/test_all_filters.rb",
+     "test/timecop/lib/timecop/time_stack_item.rb",
+     "test/timecop/lib/timecop/timecop.rb",
+     "test/timecop/lib/timecop/time_extensions.rb",
+     "test/timecop/lib/timecop.rb",
+     "test/unit/test_time_extension.rb",
+     "test/unit/test_train.rb",
+     "test/unit/test_line.rb",
+     "test/unit/test_metra.rb",
+     "test/unit/test_stop.rb",
+     "test/unit/test_parser.rb",
+     "test/unit/test_cacher.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<nokogiri>, [">= 1.4.1"])
+    else
+      s.add_dependency(%q<nokogiri>, [">= 1.4.1"])
+    end
+  else
+    s.add_dependency(%q<nokogiri>, [">= 1.4.1"])
+  end
+end
+

data/test/timecop/History.rdoc

@@ -0,0 +1,91 @@
+=== 0.3.4 / unreleased (RC2 released 2009-11-28)
+
+* Maintenance
+  * Fix various timezone-related issues.  Notably, when traveling to a DateTime
+    instance specified in a non-local timezone, convert provided DateTime 
+    instance to a local instance and return that from DateTime.now.
+    Code contributed by Michaël Witrant [piglop]
+  * Fix bug that would not allow Timecop to be used when Ruby's 'date'
+    library had not been previously loaded.
+    Code contributed by Tuomas Kareinen [tuomas]
+  * Fix bug when traveling to a DateTime across a DST boundary that
+    resulted in DateTime's being off by an hour.
+  * Migrate argument parsing into Timecop::TimeStackItem to reduce the
+    responsibility of the Timecop class.
+
+=== 0.3.3  2009-10-30
+
+* Revoked due to regression.
+
+=== 0.3.2 / 2009-10-24
+
+* Revoked due to regression.
+    
+=== 0.3.1 / 2009-09-30
+
+* Maintenance
+  * DRY up the Timecop class internals.
+
+=== 0.3.0 / 2009-09-20
+
+* API
+  * Completely remove Timecop#unset_all (deprecated by Timecop#return in 0.2.0)
+  * Return Time.now from #freeze, #travel and #return  -- code contributed by Keith Bennett [keithrbennett]
+
+* Maintenance
+  * Fix bug that left Time#mock_time set in some instances
+  * Upped build dependency to jeweler ~> 1.2.1
+  * Don't pollute top-level namespace with classes/constants
+
+* Documentation
+  * Clearer examples in the README, better description in the gemspec
+  * Improve RDoc
+
+=== 0.2.1 / 2009-03-06
+* API Changes
+  
+  * Introduced a 5th style of arguments to be passed into #travel and #freeze.  Now, if you pass in a single integer value,
+    it will be interpreted as a relative offset in seconds from the current Time.now.  Previously this was interpreted as
+    only the year, similar to calling Time.local(2008) --> Jan. 1, 2008.  This is no longer the case.
+    
+* Documentation
+
+  * Moved to Textile for the README.
+  
+  * Added documentation for the new feature, and fixed a few typos.
+
+=== 0.2.0 / 2008-12-23
+
+* API Changes
+
+  * Timecop#travel no longer freezes time.  Rather, it computes the current offset between the new "now" and the real "now", and
+    returns times as if Time had continued to move forward
+    
+  * Timecop#freeze now behaves exactly as the old Timecop#travel behaved.  Unless you depended on the actual freezing of time
+    (which I think would be rare), you should be able to continue to use #travel without worry.
+    
+  * Timecop#return is now exposed (previously Timecop#unset_all, but not well advertised).  It will completely unmock time,
+    and will probably be rarely used outside of the actual implementation of this library.
+    
+* More Test Coverage
+
+  * Tests now explicitly cover the cases when the Date and DateTime objects are not loaded, and ensures proper functionality
+    in their absence and existence.
+    
+  * Still haven't done regression testing against anything other than a few version of 1.8.6 (including REE).  We should
+    probably try to get this tested on both 1.8.7 and 1.9.1.
+
+* Documentation
+
+  * Fixed up a lot of the poorly-formatted rdoc syntax.  The public API should now be properly published in the rdoc,
+    and the internals are omitted.
+    
+=== 0.1.0 / 2008-11-09
+
+* Initial Feature Set
+
+  * Temporarily (or permanently if you prefer) change the concept of Time.now, DateTime.now (if defined), and Date.today (if defined)
+  * Timecop#travel api allows an argument to be passed in as one of: 1) Time instance, 2) DateTime instance, 3) Date instance,
+    4) individual arguments (year, month, day, hour, minute, second)
+  * Nested calls to Timecop#travel are supported -- each block will maintain it's interpretation of now.
+

data/test/timecop/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2008
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/test/timecop/README.rdoc

@@ -0,0 +1,68 @@
+= timecop
+
+* Source[http://github.com/jtrupiano/timecop]
+* Documentation[http://johntrupiano.rubyforge.org/timecop]
+
+== DESCRIPTION
+
+A gem providing "time travel" and "time freezing" capabilities, making it dead simple to test time-dependent code.  It provides a unified method to mock Time.now, Date.today, and DateTime.now in a single call.
+
+== INSTALL
+
+  gem install timecop
+
+== FEATURES
+
+* Freeze time to a specific point.
+* Travel back to a specific point in time, but allow time to continue moving forward from there.
+* No dependencies, can be used with _any_ ruby project
+* Timecop api allows arguments to be passed into #freeze and #travel as one of the following:
+  * Time instance
+  * DateTime instance
+  * Date instance
+  * individual arguments (year, month, day, hour, minute, second)
+  * a single integer argument that is interpreted as an offset in seconds from Time.now
+* Nested calls to Timecop#travel and Timecop#freeze are supported -- each block will maintain its interpretation of now.
+
+== USAGE
+
+Run a time-sensitive test
+
+  joe = User.find(1)
+  joe.purchase_home()
+  assert !joe.mortgage_due?
+  # move ahead a month and assert that the mortgage is due
+  Timecop.freeze(Date.today + 30) do
+    assert joe.mortgage_due?
+  end
+
+Set the time for the test environment of a rails app -- this is particularly helpful if your whole application is time-sensitive.  It allows you to build your test data at a single point in time, and to move in/out of that time as appropriate (within your tests)
+  
+in config/environments/test.rb
+
+  config.after_initialize do
+    # Set Time.now to September 1, 2008 10:05:00 AM (at this instant), but allow it to move forward
+    t = Time.local(2008, 9, 1, 10, 5, 0)
+    Timecop.travel(t)
+  end
+
+=== The difference between Timecop.freeze and Timecop.travel
+
+#freeze is used to statically mock the concept of now.  As your program executes, Time.now will not change unless you make subsequent calls into the Timecop API.  #travel, on the other hand, computes an offset between what we currently think Time.now is (recall that we support nested traveling) and the time passed in.  It uses this offset to simulate the passage of time.  To demonstrate, consider the following code snippets:
+
+  new_time = Time.local(2008, 9, 1, 12, 0, 0)
+  Timecop.freeze(new_time)
+  sleep(10)
+  new_time == Time.now # ==> true
+  
+  Timecop.return # "turn off" Timecop
+  Timecop.travel(new_time)
+  sleep(10)
+  new_time == Time.now # ==> false
+
+== REFERENCES
+
+* {0.3.4 release}[http://blog.smartlogicsolutions.com/2009/12/07/timecop-0-3-4-released/]
+* {0.3.0 release}[http://blog.smartlogicsolutions.com/2009/09/20/timecop-0-3-0-released/]
+* {0.2.0 release}[http://blog.smartlogicsolutions.com/2008/12/24/timecop-2-released-freeze-and-rebase-time-ruby/]
+* {0.1.0 release}[http://blog.smartlogicsolutions.com/2008/11/19/timecop-freeze-time-in-ruby-for-better-testing/]

data/test/timecop/Rakefile

@@ -0,0 +1,55 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+gem 'jeweler', '~> 1.3.0'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name = "timecop"
+    s.rubyforge_project = 'johntrupiano' # if different than lowercase project name
+    s.description = %q(A gem providing "time travel" and "time freezing" capabilities, making it dead simple to test time-dependent code.  It provides a unified method to mock Time.now, Date.today, and DateTime.now in a single call.)
+    s.summary = s.description # More details later??
+    s.email = "jtrupiano@gmail.com"
+    s.homepage = "http://github.com/jtrupiano/timecop"
+    s.authors = ["John Trupiano"]
+    s.files =  FileList["[A-Z]*", "{bin,lib,test}/**/*"]
+  end
+  Jeweler::GemcutterTasks.new
+  Jeweler::RubyforgeTasks.new do |rubyforge|
+    rubyforge.doc_task = "rdoc"
+    rubyforge.remote_doc_path = "timecop"
+  end
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+
+# Override the test task and instruct them how to actually run the tests.
+Rake.application.send(:eval, "@tasks.delete('test')")
+desc "Does not execute tests.  Manually run shell script ./run_tests.sh to execute tests."
+task :test do
+  puts <<-MSG
+    In order to run the test suite, run: cd test && ./run_tests.sh
+    The tests need to be run with different libraries loaded, which rules out using Rake
+    to automate them.
+  MSG
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.title = "timecop #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('History.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+task :default => :test

data/test/timecop/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:patch: 5
+:major: 0
+:minor: 3

data/test/timecop/lib/timecop/time_extensions.rb

@@ -0,0 +1,72 @@
+
+class Time #:nodoc:
+  class << self
+    # Time we are behaving as
+    def mock_time
+      mocked_time_stack_item = Timecop.top_stack_item
+      mocked_time_stack_item.nil? ? nil : mocked_time_stack_item.time
+    end
+    
+    # Alias the original now
+    alias_method :now_without_mock_time, :now
+
+    # Define now_with_mock_time
+    def now_with_mock_time
+      mock_time || now_without_mock_time
+    end
+    
+    # Alias now to now_with_mock_time
+    alias_method :now, :now_with_mock_time
+  end
+end 
+
+if Object.const_defined?(:Date) && Date.respond_to?(:today)
+  class Date #:nodoc:
+    class << self
+      # Date we are behaving as
+      def mock_date
+        mocked_time_stack_item = Timecop.top_stack_item
+        mocked_time_stack_item.nil? ? nil : mocked_time_stack_item.date
+      end
+      
+      # Alias the original today
+      alias_method :today_without_mock_date, :today
+    
+      # Define today_with_mock_date
+      def today_with_mock_date
+        mock_date || today_without_mock_date
+      end
+    
+      # Alias today to today_with_mock_date
+      alias_method :today, :today_with_mock_date
+    end
+  end
+end
+
+if Object.const_defined?(:DateTime) && DateTime.respond_to?(:now)
+  class DateTime #:nodoc:
+    class << self
+      # Time we are behaving as
+      def mock_time
+        mocked_time_stack_item = Timecop.top_stack_item
+        mocked_time_stack_item.nil? ? nil : mocked_time_stack_item.datetime
+      end
+      
+      # Fake alias :now_without_mock_time :now
+      # It appears that the DateTime library itself references Time.now
+      # for it's interpretation of now which caused 
+      # DateTime.now_without_mock_time to incorrectly return the frozen time.
+      def now_without_mock_time
+        Time.now_without_mock_time.send :to_datetime
+      end
+      
+      # Define now_with_mock_time
+      def now_with_mock_time
+        mock_time || now_without_mock_time
+      end
+
+      # Alias now to now_with_mock_time
+      alias_method :now, :now_with_mock_time
+    end
+  end
+end

data/test/timecop/lib/timecop/time_stack_item.rb

@@ -0,0 +1,113 @@
+
+class Timecop
+  # A data class for carrying around "time movement" objects.  Makes it easy to keep track of the time
+  # movements on a simple stack.
+  class TimeStackItem #:nodoc:
+  
+    attr_reader :mock_type
+    def initialize(mock_type, *args)
+      raise "Unknown mock_type #{mock_type}" unless [:freeze, :travel].include?(mock_type)
+      @mock_type      = mock_type
+      @time           = parse_time(*args)
+      @travel_offset  = compute_travel_offset
+      @dst_adjustment = compute_dst_adjustment
+    end
+    
+    def year
+      time.year
+    end
+    
+    def month
+      time.month
+    end
+    
+    def day
+      time.day
+    end
+    
+    def hour
+      time.hour
+    end
+    
+    def min
+      time.min
+    end
+    
+    def sec
+      time.sec
+    end
+    
+    def utc_offset
+      time.utc_offset
+    end
+    
+    def travel_offset
+      @travel_offset
+    end
+    
+    def time #:nodoc:
+      if travel_offset.nil?
+        @time
+      else
+        Time.now_without_mock_time + travel_offset
+      end
+    end
+    
+    def date
+      time.send(:to_date)
+    end
+    
+    def datetime
+      # DateTime doesn't know about DST, so let's remove its presence
+      our_offset = utc_offset + dst_adjustment
+      DateTime.new(year, month, day, hour, min, sec, utc_offset_to_rational(our_offset))
+    end
+    
+    def dst_adjustment
+      @dst_adjustment
+    end
+    
+    private
+      def rational_to_utc_offset(rational)
+        ((24.0 / rational.denominator) * rational.numerator) * (60 * 60)
+      end
+      
+      def utc_offset_to_rational(utc_offset)
+        Rational(utc_offset, 24 * 60 * 60)
+      end
+      
+      def parse_time(*args)
+        arg = args.shift
+        if arg.is_a?(Time)
+          arg.getlocal
+        elsif Object.const_defined?(:DateTime) && arg.is_a?(DateTime)
+          offset_difference = Time.now.utc_offset - rational_to_utc_offset(arg.offset)
+          Time.local(arg.year, arg.month, arg.day, arg.hour, arg.min, arg.sec) + offset_difference
+        elsif Object.const_defined?(:Date) && arg.is_a?(Date)
+          Time.local(arg.year, arg.month, arg.day, 0, 0, 0)
+        elsif args.empty? && arg.kind_of?(Integer)
+          Time.now + arg
+        else # we'll just assume it's a list of y/m/d/h/m/s
+          year   = arg        || 0
+          month  = args.shift || 1
+          day    = args.shift || 1
+          hour   = args.shift || 0
+          minute = args.shift || 0
+          second = args.shift || 0
+          Time.local(year, month, day, hour, minute, second)
+        end
+      end
+      
+      def compute_dst_adjustment
+        return 0 if !(time.dst? ^ Time.now.dst?)
+        return -1 * 60 * 60 if time.dst?
+        return 60 * 60
+      end
+      
+      def compute_travel_offset
+        return nil if mock_type == :freeze
+        @time - Time.now_without_mock_time
+      end
+      
+  end
+end

data/test/timecop/lib/timecop/timecop.rb

@@ -0,0 +1,103 @@
+require 'singleton'
+require File.join(File.dirname(__FILE__), 'time_extensions')
+require File.join(File.dirname(__FILE__), 'time_stack_item')
+
+# Timecop
+# * Wrapper class for manipulating the extensions to the Time, Date, and DateTime objects
+# * Allows us to "freeze" time in our Ruby applications.
+# * Optionally allows time travel to simulate a running clock, such time is not technically frozen.
+# 
+# This is very useful when your app's functionality is dependent on time (e.g. 
+# anything that might expire).  This will allow us to alter the return value of
+# Date.today, Time.now, and DateTime.now, such that our application code _never_ has to change.
+class Timecop
+  include Singleton
+  
+  # Allows you to run a block of code and "fake" a time throughout the execution of that block.
+  # This is particularly useful for writing test methods where the passage of time is critical to the business
+  # logic being tested.  For example:
+  #
+  #   joe = User.find(1)
+  #   joe.purchase_home()
+  #   assert !joe.mortgage_due?
+  #   Timecop.freeze(2008, 10, 5) do
+  #     assert joe.mortgage_due?
+  #   end
+  #
+  # freeze and travel will respond to several different arguments:
+  # 1. Timecop.freeze(time_inst)
+  # 2. Timecop.freeze(datetime_inst)
+  # 3. Timecop.freeze(date_inst)
+  # 4. Timecop.freeze(offset_in_seconds)
+  # 5. Timecop.freeze(year, month, day, hour=0, minute=0, second=0)
+  #
+  # When a block is also passed, Time.now, DateTime.now and Date.today are all reset to their
+  # previous values after the block has finished executing.  This allows us to nest multiple 
+  # calls to Timecop.travel and have each block maintain it's concept of "now."
+  #
+  # * Note: Timecop.freeze will actually freeze time.  This can cause unanticipated problems if
+  #   benchmark or other timing calls are executed, which implicitly expect Time to actually move
+  #   forward.
+  #
+  # * Rails Users: Be especially careful when setting this in your development environment in a 
+  #   rails project.  Generators will load your environment, including the migration generator, 
+  #   which will lead to files being generated with the timestamp set by the Timecop.freeze call 
+  #   in your dev environment
+  #
+  # Returns the frozen time.
+  def self.freeze(*args, &block)
+    instance().send(:travel, :freeze, *args, &block)
+    Time.now
+  end
+  
+  # Allows you to run a block of code and "fake" a time throughout the execution of that block.
+  # See Timecop#freeze for a sample of how to use (same exact usage syntax)
+  #
+  # * Note: Timecop.travel will not freeze time (as opposed to Timecop.freeze).  This is a particularly
+  #   good candidate for use in environment files in rails projects.
+  #
+  # Returns the 'new' current Time.
+  def self.travel(*args, &block)
+    instance().send(:travel, :travel, *args, &block)
+    Time.now
+  end
+  
+  # Reverts back to system's Time.now, Date.today and DateTime.now (if it exists).
+  #
+  # Returns Time.now, which is now the real current time.
+  def self.return
+    instance().send(:unmock!)
+    Time.now
+  end
+  
+  def self.top_stack_item #:nodoc:
+    instance().instance_variable_get(:@_stack).last
+  end
+
+  protected
+  
+    def initialize #:nodoc:
+      @_stack = []
+    end
+    
+    def travel(mock_type, *args, &block) #:nodoc:
+      stack_item = TimeStackItem.new(mock_type, *args)
+      
+      # store this time traveling on our stack...
+      @_stack << stack_item
+    
+      if block_given?
+        begin
+          yield
+        ensure
+          # pull it off the stack...
+          @_stack.pop
+        end
+      end
+    end
+  
+    def unmock! #:nodoc:
+      @_stack = []
+    end
+  
+end

data/test/timecop/lib/timecop.rb

@@ -0,0 +1,2 @@
+# Require Timecop 
+require File.join(File.dirname(__FILE__), 'timecop', 'timecop')

data/test/unit/test_time_extension.rb

@@ -0,0 +1,12 @@
+require File.join(File.dirname(__FILE__), "../", "test_helper.rb")
+
+class TestTimeExtension < Test::Unit::TestCase
+
+  def test_to_today
+    sample = Time.local(2009, 5, 5, 7, 30, 45)
+    today = Time.now
+    expected = Time.local(today.year, today.month, today.day, sample.hour, sample.min, sample.sec)
+    assert_equal(expected, sample.to_today)
+  end
+
+end

data/test/unit/test_train.rb

@@ -82,6 +82,20 @@ class TestLine < Test::Unit::TestCase
     assert_equal(Time.parse("12:40"), train.my_arrival)
   end
 
+  def test_my_departure_and_my_arrival_with_cached_from_another_day
+    Timecop.freeze(2010, 1, 5)
+    stop1 = MetraSchedule::Stop.new :station => :barrington, :time => Time.parse("12:30")
+    stop2 = MetraSchedule::Stop.new :station => :arlington_heights, :time => Time.parse("12:40")
+    @@t = MetraSchedule::Train.new :train_num => 651, :bike_limit => 12, :schedule => :weekday, :direction => :inbound, :stops => [stop1, stop2]
+
+    Timecop.freeze(2010, 1, 6)
+    l = Metra.new.line(:up_nw).from(:barrington).to(:arlington_heights)
+    l.engines = [@@t]
+    train = l.trains.first
+    assert_equal(Time.parse("12:30"), train.my_departure)
+    assert_equal(Time.parse("12:40"), train.my_arrival)
+  end
+
   def test_my_departure_and_my_arrival_with_no_start_or_destination
     stop1 = MetraSchedule::Stop.new :station => :barrington, :time => Time.parse("12:30")
     stop2 = MetraSchedule::Stop.new :station => :arlington_heights, :time => Time.parse("12:40")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: metra_schedule
 version: !ruby/object:Gem::Version 
-  version: 0.2.1.2
+  version: 0.2.2
 platform: ruby
 authors: 
 - Blake Smith
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-31 00:00:00 -06:00
+date: 2010-01-05 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -22,43 +22,58 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 1.4.1
     version: 
-description: metra_schedule provides a ruby object interface to the Chicago metra train schedule.
+description: metra_schedule provides a ruby object interface to the Chicago metra train schedule
 email: blakesmith0@gmail.com
 executables: []
 
 extensions: []
 
-extra_rdoc_files: []
-
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
 files: 
-- Rakefile
+- .gitignore
 - LICENSE
 - README.rdoc
+- Rakefile
+- VERSION
 - lib/metra.rb
 - lib/metra/cacher.rb
 - lib/metra/classmethods.rb
+- lib/metra/extensions/time_extension.rb
 - lib/metra/line.rb
 - lib/metra/parser.rb
 - lib/metra/stop.rb
 - lib/metra/train.rb
 - lib/metra/train_data.rb
-- test/test_helper.rb
+- metra_schedule.gemspec
 - test/fixture/UP_NW.html
+- test/functional/test_all_filters.rb
+- test/integration/test_line_integration.rb
+- test/test_helper.rb
+- test/timecop/History.rdoc
+- test/timecop/LICENSE
+- test/timecop/README.rdoc
+- test/timecop/Rakefile
+- test/timecop/VERSION.yml
+- test/timecop/lib/timecop.rb
+- test/timecop/lib/timecop/time_extensions.rb
+- test/timecop/lib/timecop/time_stack_item.rb
+- test/timecop/lib/timecop/timecop.rb
 - test/unit/test_cacher.rb
 - test/unit/test_line.rb
 - test/unit/test_metra.rb
 - test/unit/test_parser.rb
 - test/unit/test_stop.rb
+- test/unit/test_time_extension.rb
 - test/unit/test_train.rb
-- test/functional/test_all_filters.rb
-- test/integration/test_line_integration.rb
 has_rdoc: true
 homepage: http://github.com/blakesmith/metra_schedule
 licenses: []
 
 post_install_message: 
-rdoc_options: []
-
+rdoc_options: 
+- --charset=UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -79,6 +94,19 @@ rubyforge_project:
 rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
-summary: metra_schedule provides a ruby object interface to the Chicago metra train schedule.
-test_files: []
-
+summary: Chicago Metra parser and scheduler
+test_files: 
+- test/integration/test_line_integration.rb
+- test/functional/test_all_filters.rb
+- test/timecop/lib/timecop/time_stack_item.rb
+- test/timecop/lib/timecop/timecop.rb
+- test/timecop/lib/timecop/time_extensions.rb
+- test/timecop/lib/timecop.rb
+- test/unit/test_time_extension.rb
+- test/unit/test_train.rb
+- test/unit/test_line.rb
+- test/unit/test_metra.rb
+- test/unit/test_stop.rb
+- test/unit/test_parser.rb
+- test/unit/test_cacher.rb
+- test/test_helper.rb