recurrence 0.1.1 → 0.1.2

data/lib/recurrence/version.rb

@@ -0,0 +1,8 @@
+class Recurrence
+  module Version
+    MAJOR = 0
+    MINOR = 1
+    PATCH = 2
+    STRING = "#{MAJOR}.#{MINOR}.#{PATCH}"
+  end
+end

data/recurrence.gemspec

@@ -1,32 +1,60 @@
-# WARNING : RAKE AUTO-GENERATED FILE. DO NOT MANUALLY EDIT!
-# RUN : 'rake gem:update_gemspec'
+# 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.homepage = "http://github.com/fnando/recurrence"
-  s.bindir = "bin"
-  s.name = "recurrence"
-  s.summary = "A simple library to handle recurring events"
-  s.add_dependency "activesupport", ">= 2.1.1"
-  s.require_paths = ["lib"]
-  s.files = ["init.rb",
- "Rakefile",
- "recurrence.gemspec",
- "History.txt",
- "License.txt",
- "README.markdown",
- "lib/recurrence",
- "lib/recurrence/base.rb",
- "lib/recurrence/event",
- "lib/recurrence/event/daily.rb",
- "lib/recurrence/event/monthly.rb",
- "lib/recurrence/event/weekly.rb",
- "lib/recurrence/event/yearly.rb",
- "lib/recurrence/event.rb",
- "lib/recurrence/shortcuts.rb",
- "lib/recurrence.rb"]
+  s.name = %q{recurrence}
+  s.version = "0.1.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Nando Vieira"]
-  s.required_rubygems_version = ">= 0"
-  s.version = "0.1.1"
-  s.has_rdoc = true
-  s.email = ["fnando.vieira@gmail.com"]
-end
+  s.date = %q{2010-09-09}
+  s.description = %q{}
+  s.email = %q{fnando.vieira@gmail.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    "History.txt",
+     "License.txt",
+     "README.markdown",
+     "Rakefile",
+     "init.rb",
+     "lib/recurrence.rb",
+     "lib/recurrence/event.rb",
+     "lib/recurrence/event/base.rb",
+     "lib/recurrence/event/daily.rb",
+     "lib/recurrence/event/monthly.rb",
+     "lib/recurrence/event/weekly.rb",
+     "lib/recurrence/event/yearly.rb",
+     "lib/recurrence/version.rb",
+     "recurrence.gemspec",
+     "spec/recurrence_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/fnando/recurrence}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{A simple library to handle recurring events}
+  s.test_files = [
+    "spec/recurrence_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 2.0.0"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 2.0.0"])
+      s.add_dependency(%q<activesupport>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 2.0.0"])
+    s.add_dependency(%q<activesupport>, [">= 0"])
+  end
+end
+

data/spec/recurrence_spec.rb

@@ -0,0 +1,523 @@
+require "recurrence"
+
+Date::DATE_FORMATS[:date] = "%d/%m/%Y"
+Time::DATE_FORMATS[:date] = "%d/%m/%Y"
+
+describe "recurrence" do
+  it "should require :every option" do
+    expect { recurrence({}) }.to raise_error(ArgumentError)
+  end
+
+  it "should require valid :every option" do
+    expect { recurrence(:every => "invalid") }.to raise_error(ArgumentError)
+  end
+
+  it "should require :interval to be greater than zero when provided" do
+    expect { recurrence(:every => :day, :interval => 0) }.to raise_error(ArgumentError)
+  end
+
+  Recurrence::Event::Monthly::INTERVALS.each do |interval|
+    it "should accept valid :interval symbol for monthly recurrence (#{interval[0]})" do
+      expect { recurrence(:every => :month, :on => 10, :interval => interval[0]) }.to_not raise_error(ArgumentError)
+    end
+  end
+
+  Recurrence::Event::Yearly::MONTHS.each do |month_name, month_number|
+    it "should accept month as symbol for yearly recurrence (#{month_name})" do
+      expect { recurrence(:every => :year, :on => [month_name, 10]) }.to_not raise_error(ArgumentError)
+    end
+  end
+
+  it "should require month to be a valid symbol for yearly recurrence" do
+    expect { recurrence(:every => :year, :on => [:invalid, 10]) }.to raise_error(ArgumentError)
+  end
+
+  it "should require :interval to be a valid symbol for monthly recurrence" do
+    expect { recurrence(:every => :month, :on => 10, :interval => :invalid) }.to raise_error(ArgumentError)
+  end
+
+  context "with daily recurring" do
+    it "should recur until limit date" do
+      @recurrence = Recurrence.daily
+      @recurrence.events[-1].should == Date.parse("2037-12-31")
+    end
+
+    it "should repeat until 1 month from now" do
+      date = 1.month.from_now
+      @recurrence = recurrence(:every => :day, :until => date.to_date)
+      @recurrence.events[-1].should == date.to_date
+    end
+
+    it "should start 2 months ago (#{2.months.ago.to_s(:date)})" do
+      date = 2.months.ago
+      @recurrence = recurrence(:every => :day, :starts => date.to_date)
+      @recurrence.events[0].should == date.to_date
+      @recurrence.events[1].should == (date + 1.day).to_date
+      @recurrence.events[2].should == (date + 2.day).to_date
+    end
+
+    it "should start at 2008-03-19 and repeat until 2008-04-24" do
+      @recurrence = recurrence(:every => :day, :starts => "2008-03-19", :until => "2008-04-24")
+      @recurrence.events[0].to_s.should == "2008-03-19"
+      @recurrence.events[1].to_s.should == "2008-03-20"
+      @recurrence.events[-1].to_s.should == "2008-04-24"
+    end
+
+    it "should use interval" do
+      @recurrence = recurrence(:every => :day, :interval => 2, :starts => "2008-09-21")
+      @recurrence.events[0].to_s.should == "2008-09-21"
+      @recurrence.events[1].to_s.should == "2008-09-23"
+      @recurrence.events[2].to_s.should == "2008-09-25"
+    end
+
+    it "should have a lacking day if the interval does not match the last day" do
+      @recurrence = recurrence(:every => :day, :starts => "2008-03-19", :until => "2008-04-25", :interval => 2)
+      @recurrence.events[-1].to_s.should == "2008-04-24"
+    end
+  end
+
+  context "with weekly recurring" do
+    it "should recur until limit date" do
+      @recurrence = Recurrence.weekly(:on => :thursday)
+      @recurrence.events[-1].should == Date.parse("2037-12-31")
+    end
+
+    it "should repeat 6 weeks from now" do
+      date = 6.weeks.from_now
+      @recurrence = recurrence(:every => :week, :on => date.wday, :until => date.to_date)
+      @recurrence.events[-1].should == date.to_date
+    end
+
+    it "should start 3 months ago (#{3.months.ago.to_s(:date)})" do
+      date = 3.months.ago
+
+      @recurrence = recurrence(:every => :week, :on => date.wday, :starts => date.to_date)
+      @recurrence.events[0].should == date.to_date
+      @recurrence.events[1].should == (date + 1.week).to_date
+      @recurrence.events[2].should == (date + 2.weeks).to_date
+      @recurrence.events[3].should == (date + 3.weeks).to_date
+      @recurrence.events[4].should == (date + 4.weeks).to_date
+      @recurrence.events[5].should == (date + 5.weeks).to_date
+      @recurrence.events[6].should == (date + 6.weeks).to_date
+    end
+
+    it "should start at 2008-02-29 and repeat until 2008-03-14" do
+      starts = Date.parse("2008-02-29")
+      ends = Date.parse("2008-03-14")
+
+      @recurrence = recurrence(:every => :week, :on => :friday, :starts => starts, :until => ends.to_date)
+      @recurrence.events[0].to_s.should == "2008-02-29"
+      @recurrence.events[1].to_s.should == "2008-03-07"
+      @recurrence.events[-1].to_s.should == ends.to_s
+    end
+
+    it "should use interval" do
+      starts = Date.parse("2008-09-21")
+      @recurrence = recurrence(:every => :week, :on => starts.wday, :interval => 2, :starts => starts, :until => "2009-01-01")
+      @recurrence.events[0].to_s.should == "2008-09-21"
+      @recurrence.events[1].to_s.should == "2008-10-05"
+      @recurrence.events[2].to_s.should == "2008-10-19"
+      @recurrence.events[3].to_s.should == "2008-11-02"
+      @recurrence.events[4].to_s.should == "2008-11-16"
+      @recurrence.events[5].to_s.should == "2008-11-30"
+      @recurrence.events[6].to_s.should == "2008-12-14"
+    end
+
+    it "should occur several times per week" do
+      starts = Date.parse("2008-09-21") #=> sunday
+      @recurrence = recurrence(:every => :week, :on => [ :saturday, :sunday ], :interval => 2, :starts => starts, :until => "2009-01-01")
+      @recurrence.events[0].to_s.should == "2008-09-21"
+      @recurrence.events[1].to_s.should == "2008-09-27"
+      @recurrence.events[2].to_s.should == "2008-10-05"
+      @recurrence.events[3].to_s.should == "2008-10-11"
+      @recurrence.events[4].to_s.should == "2008-10-19"
+      @recurrence.events[5].to_s.should == "2008-10-25"
+      @recurrence.events[6].to_s.should == "2008-11-02"
+      @recurrence.events[7].to_s.should == "2008-11-08"
+
+      starts = Date.parse("2008-09-21") #=> sunday
+      @recurrence = recurrence(:every => :week, :on => [ :monday, :wednesday, :friday ], :starts => starts, :until => "2009-01-01")
+      @recurrence.events[0].to_s.should == "2008-09-22"
+      @recurrence.events[1].to_s.should == "2008-09-24"
+      @recurrence.events[2].to_s.should == "2008-09-26"
+      @recurrence.events[3].to_s.should == "2008-09-29"
+      @recurrence.events[4].to_s.should == "2008-10-01"
+      @recurrence.events[5].to_s.should == "2008-10-03"
+    end
+
+    it "should run until next available saturday" do
+      starts = Date.parse("2008-09-21") # => sunday
+      @recurrence = recurrence(:every => :week, :on => :saturday, :starts => starts, :until => "2009-01-01")
+      @recurrence.events[0].to_s.should == "2008-09-27"
+    end
+  end
+
+  context "with monthly recurring" do
+    context "using day" do
+      it "should recur until limit date" do
+        @recurrence = Recurrence.monthly(:on => 31)
+        @recurrence.events[-1].should == Date.parse("2037-12-31")
+      end
+
+      it "should repeat until 8 months from now" do
+        date = 8.months.from_now
+        @recurrence = recurrence(:every => :month, :on => date.day, :until => date.to_date)
+        @recurrence.events[-1].should == date.to_date
+      end
+
+      it "should start 9 months ago" do
+        date = 9.months.ago
+
+        @recurrence = recurrence(:every => :month, :on => date.day, :starts => date.to_date)
+        @recurrence.events[0].should == date.to_date
+      end
+
+      it "should start at 2008-06-07 and repeat until 2008-11-07" do
+        starts = Date.parse("2008-06-07")
+        ends = Date.parse("2008-11-07")
+
+        @recurrence = recurrence(:every => :month, :on => starts.day, :starts => starts, :until => ends)
+        @recurrence.events[0].to_s.should == "2008-06-07"
+        @recurrence.events[-1].to_s.should == "2008-11-07"
+      end
+
+      it "should run until next available 27th" do
+        starts = Date.parse("2008-09-28")
+
+        @recurrence = recurrence(:every => :month, :on => 27, :starts => starts, :until => "2009-01-01")
+        @recurrence.events[0].to_s.should == "2008-10-27"
+      end
+
+      it "should use interval" do
+        starts = Date.parse("2008-01-31")
+        @recurrence = recurrence(:every => :month, :on => 31, :interval => 2, :starts => starts, :until => "2010-01-01")
+        @recurrence.events[0].to_s.should == "2008-01-31"
+        @recurrence.events[1].to_s.should == "2008-03-31"
+        @recurrence.events[2].to_s.should == "2008-05-31"
+        @recurrence.events[3].to_s.should == "2008-07-31"
+        @recurrence.events[4].to_s.should == "2008-09-30"
+        @recurrence.events[5].to_s.should == "2008-11-30"
+        @recurrence.events[6].to_s.should == "2009-01-31"
+
+        starts = Date.parse("2008-01-31")
+        @recurrence = recurrence(:every => :month, :on => 29, :interval => 3, :starts => starts, :until => "2010-01-01")
+        @recurrence.events[0].to_s.should == "2008-04-29"
+        @recurrence.events[1].to_s.should == "2008-07-29"
+        @recurrence.events[2].to_s.should == "2008-10-29"
+        @recurrence.events[3].to_s.should == "2009-01-29"
+        @recurrence.events[4].to_s.should == "2009-04-29"
+        @recurrence.events[5].to_s.should == "2009-07-29"
+
+        starts = Date.parse("2008-02-29")
+        @recurrence = recurrence(:every => :month, :on => 31, :interval => 4, :starts => starts, :until => "2010-01-01")
+        @recurrence.events[0].to_s.should == "2008-02-29"
+        @recurrence.events[1].to_s.should == "2008-06-30"
+        @recurrence.events[2].to_s.should == "2008-10-31"
+        @recurrence.events[3].to_s.should == "2009-02-28"
+      end
+    end
+
+    context "using weekday" do
+      it "should recur until limit date" do
+        @recurrence = Recurrence.daily(:on => 5, :weekday => :thursday)
+        @recurrence.events[-1].should == Date.parse("2037-12-31")
+      end
+
+      it "should repeat until 8 months from now" do
+        date = 8.months.from_now
+        week = (date.day - 1) / 7 + 1
+        @recurrence = recurrence(:every => :month, :on => week, :weekday => date.wday, :until => date.to_date)
+        @recurrence.events[-1].should == date.to_date
+      end
+
+      it "should start 9 months ago" do
+        date = 9.months.ago
+        week = (date.day - 1) / 7 + 1
+        @recurrence = recurrence(:every => :month, :on => week, :weekday => date.wday, :starts => date.to_date)
+        @recurrence.events[0].should == date.to_date
+      end
+
+      it "should start at 2008-06-07 and repeat until 2008-11-01 (first saturday)" do
+        starts = Date.parse("2008-06-07")
+        ends = Date.parse("2008-11-01")
+
+        @recurrence = recurrence(:every => :month, :on => :first, :weekday => :saturday, :starts => starts, :until => ends)
+        @recurrence.events[0].to_s.should == "2008-06-07"
+        @recurrence.events[-1].to_s.should == "2008-11-01"
+      end
+
+      it "should start at 2008-06-29 and repeat until 2008-11-30 (last sunday)" do
+        starts = Date.parse("2008-06-29")
+        ends = Date.parse("2008-11-30")
+
+        @recurrence = recurrence(:every => :month, :on => :last, :weekday => :sunday, :starts => starts, :until => ends)
+        @recurrence.events[0].to_s.should == "2008-06-29"
+        @recurrence.events[-1].to_s.should == "2008-11-30"
+      end
+
+      it "should use interval" do
+        starts = Date.parse("2009-01-01")
+        @recurrence = recurrence(:every => :month, :on => :third, :weekday => :sunday, :interval => 2, :starts => starts, :until => "2010-02-01")
+        @recurrence.events[0].to_s.should == "2009-01-18"
+        @recurrence.events[1].to_s.should == "2009-03-15"
+        @recurrence.events[2].to_s.should == "2009-05-17"
+        @recurrence.events[3].to_s.should == "2009-07-19"
+        @recurrence.events[4].to_s.should == "2009-09-20"
+        @recurrence.events[5].to_s.should == "2009-11-15"
+        @recurrence.events[6].to_s.should == "2010-01-17"
+      end
+    end
+
+    context "using interval" do
+      before(:each) do
+        @starts = Date.parse("2008-09-03")
+      end
+
+      it "should use numeric interval" do
+        @recurrence = recurrence(:every => :month, :on => 21, :interval => 2, :starts => @starts)
+        @recurrence.events[0].to_s.should == "2008-09-21"
+        @recurrence.events[1].to_s.should == "2008-11-21"
+        @recurrence.events[2].to_s.should == "2009-01-21"
+        @recurrence.events[3].to_s.should == "2009-03-21"
+      end
+
+      it "should accept monthly symbol" do
+        @recurrence = recurrence(:every => :month, :on => 10, :starts => @starts, :interval => :monthly)
+        @recurrence.events[0].to_s.should == "2008-09-10"
+        @recurrence.events[1].to_s.should == "2008-10-10"
+      end
+
+      it "should accept bimonthly symbol" do
+        @recurrence = recurrence(:every => :month, :on => 10, :starts => @starts, :interval => :bimonthly)
+        @recurrence.events[0].to_s.should == "2008-09-10"
+        @recurrence.events[1].to_s.should == "2008-11-10"
+      end
+
+      it "should accept quarterly symbol" do
+        @recurrence = recurrence(:every => :month, :on => 10, :starts => @starts, :interval => :quarterly)
+        @recurrence.events[0].to_s.should == "2008-09-10"
+        @recurrence.events[1].to_s.should == "2008-12-10"
+      end
+
+      it "should accept semesterly symbol" do
+        @recurrence = recurrence(:every => :month, :on => 10, :starts => @starts, :interval => :semesterly)
+        @recurrence.events[0].to_s.should == "2008-09-10"
+        @recurrence.events[1].to_s.should == "2009-03-10"
+      end
+    end
+  end
+
+  describe "with yearly recurring" do
+    it "should recur until limit date" do
+      @recurrence = Recurrence.yearly(:on => [12,31])
+      @recurrence.events[-1].should == Date.parse("2037-12-31")
+    end
+
+    it "should repeat until 7 years from now" do
+      date = 7.years.from_now
+      @recurrence = recurrence(:every => :year, :on => [date.month, date.day], :until => date.to_date)
+      @recurrence.events[-1].should == date.to_date
+    end
+
+    it "should start 2 years ago" do
+      date = 2.years.ago
+      @recurrence = recurrence(:every => :year, :on => [date.month, date.day], :starts => date.to_date)
+      @recurrence.events[0].should == date.to_date
+    end
+
+    it "should start at 2003-06-07 and repeat until 2018-06-07" do
+      starts = Date.parse("2003-06-07")
+      ends = Date.parse("2018-06-07")
+
+      @recurrence = recurrence(:every => :year, :on => [starts.month, starts.day], :starts => starts, :until => ends)
+      @recurrence.events[0].to_s.should == "2003-06-07"
+      @recurrence.events[-1].to_s.should == "2018-06-07"
+    end
+
+    it "should use interval" do
+      starts = Date.parse("2008-09-21")
+
+      @recurrence = recurrence(:every => :year, :on => [starts.month, starts.day], :interval => 2, :starts => starts)
+      @recurrence.events[0].to_s.should == "2008-09-21"
+      @recurrence.events[1].to_s.should == "2010-09-21"
+      @recurrence.events[2].to_s.should == "2012-09-21"
+      @recurrence.events[3].to_s.should == "2014-09-21"
+    end
+
+    it "should run until next available date when chosen settings are greater than start date" do
+      starts = Date.parse("2008-09-03")
+
+      @recurrence = recurrence(:every => :year, :on => [10, 27], :starts => starts)
+      @recurrence.events[0].to_s.should == "2008-10-27"
+    end
+
+    it "should run until next available date when chosen settings are smaller than start date" do
+      starts = Date.parse("2008-09-03")
+      @recurrence = recurrence(:every => :year, :on => [7, 1], :starts => starts)
+      @recurrence.events[0].to_s.should == "2009-07-01"
+
+      starts = Date.parse("2008-09-03")
+      @recurrence = recurrence(:every => :year, :on => [9, 1], :starts => starts)
+      @recurrence.events[0].to_s.should == "2009-09-01"
+    end
+  end
+
+  describe "#include?" do
+    it "should include date (day)" do
+      @recurrence = recurrence(:every => :day, :starts => "2008-09-30")
+      @recurrence.include?("2008-09-30").should be_true
+      @recurrence.include?("2008-10-01").should be_true
+    end
+
+    it "should include date (week)" do
+      @recurrence = recurrence(:every => :week, :on => :thursday, :starts => "2008-09-30")
+      @recurrence.include?("2008-09-30").should be_false
+      @recurrence.include?("2008-10-02").should be_true
+
+      @recurrence = recurrence(:every => :week, :on => :monday, :starts => "2008-09-29")
+      @recurrence.include?("2008-09-29").should be_true
+      @recurrence.include?("2008-10-06").should be_true
+    end
+
+    it "should include date (month)" do
+      @recurrence = recurrence(:every => :month, :on => 10, :starts => "2008-09-30")
+      @recurrence.include?("2008-09-30").should be_false
+      @recurrence.include?("2008-10-10").should be_true
+
+      @recurrence = recurrence(:every => :month, :on => 10, :starts => "2008-09-10")
+      @recurrence.include?("2008-09-10").should be_true
+      @recurrence.include?("2008-10-10").should be_true
+    end
+
+    it "should include date (year)" do
+      @recurrence = recurrence(:every => :year, :on => [6,28], :starts => "2008-09-30")
+      @recurrence.include?("2009-09-30").should be_false
+      @recurrence.include?("2009-06-28").should be_true
+
+      @recurrence = recurrence(:every => :year, :on => [6,28], :starts => "2008-06-28")
+      @recurrence.include?("2009-06-28").should be_true
+      @recurrence.include?("2009-06-28").should be_true
+    end
+
+    it "should not include date when is smaller than starting date (day)" do
+      @recurrence = recurrence(:every => :day, :starts => "2008-09-30")
+      @recurrence.include?("2008-09-29").should be_false
+    end
+
+    it "should not include date when is smaller than starting date (week)" do
+      @recurrence = recurrence(:every => :week, :on => :friday, :starts => "2008-09-30")
+      @recurrence.include?("2008-09-24").should be_false
+    end
+
+    it "should not include date when is smaller than starting date (month)" do
+      @recurrence = recurrence(:every => :month, :on => 10, :starts => "2008-09-30")
+      @recurrence.include?("2008-09-10").should be_false
+    end
+
+    it "should not include date when is smaller than starting date (year)" do
+      @recurrence = recurrence(:every => :year, :on => [6,28], :starts => "2008-09-30")
+      @recurrence.include?("2008-06-28").should be_false
+    end
+
+    it "should not include date when is greater than ending date (day)" do
+      @recurrence = recurrence(:every => :day, :until => "2008-09-30")
+      @recurrence.include?("2008-10-01").should be_false
+    end
+
+    it "should not include date when is greater than ending date (week)" do
+      @recurrence = recurrence(:every => :week, :on => :friday, :until => "2008-09-30")
+      @recurrence.include?("2008-10-03").should be_false
+    end
+
+    it "should not include date when is greater than ending date (year)" do
+      @recurrence = recurrence(:every => :year, :on => [6,28], :until => "2008-09-30")
+      @recurrence.include?("2009-06-28").should be_false
+    end
+  end
+
+  describe "#next" do
+    it "should return next date" do
+      @recurrence = recurrence(:every => :day)
+
+      @recurrence.next.to_s.should == Date.today.to_s
+      @recurrence.next.to_s.should == Date.today.to_s
+    end
+
+    it "should return next! date" do
+      @recurrence = recurrence(:every => :day)
+
+      @recurrence.next!.to_s.should == Date.today.to_s
+      @recurrence.next!.to_s.should == 1.day.from_now.to_date.to_s
+      @recurrence.next!.to_s.should == 2.days.from_now.to_date.to_s
+      @recurrence.next!.to_s.should == 3.days.from_now.to_date.to_s
+    end
+  end
+
+  describe "#reset!" do
+    it "should reset to the first available date" do
+      @recurrence = recurrence(:every => :year, :on => [2, 31], :starts => "2008-01-01")
+      @recurrence.next!.to_s.should  == "2008-02-29"
+      @recurrence.next!.to_s.should  == "2009-02-28"
+      @recurrence.reset!
+      @recurrence.next.to_s.should == "2008-02-29"
+    end
+  end
+
+  describe "event initialization" do
+    it "should return the first available date" do
+      @recurrence = recurrence(:every => :year, :on => [2, 31], :starts => "2008-01-01")
+      @recurrence.next!.to_s.should == "2008-02-29"
+      @recurrence.next!.to_s.should == "2009-02-28"
+      @recurrence.next!.to_s.should == "2010-02-28"
+      @recurrence.next!.to_s.should == "2011-02-28"
+      @recurrence.next!.to_s.should == "2012-02-29"
+    end
+  end
+
+  context "when generating events" do
+    before(:each) do
+      @recurrence = recurrence(:every => :day, :starts => "2009-01-06", :until => "2009-01-15")
+    end
+
+    it "should return starting and ending recurrences" do
+      @recurrence.events[0].to_s.should == "2009-01-06"
+      @recurrence.events[-1].to_s.should == "2009-01-15"
+    end
+
+    it "should reset cache" do
+      @recurrence.event.should_receive(:reset!).exactly(3).times
+      @recurrence.events(:starts => "2009-01-11")
+      @recurrence.events(:until => "2009-01-14")
+      @recurrence.events(:starts => "2009-01-11", :until => "2009-01-14")
+    end
+
+    it "should return only events greater than starting date" do
+      @events = @recurrence.events(:starts => "2009-01-10")
+      @events[0].to_s.should == "2009-01-10"
+    end
+
+    it "should return only events smaller than until date" do
+      @events = @recurrence.events(:until => "2009-01-10")
+      @events[0].to_s.should == "2009-01-06"
+      @events[-1].to_s.should == "2009-01-10"
+    end
+
+    it "should return only events between starting and until date" do
+      @events = @recurrence.events(:starts => "2009-01-12", :until => "2009-01-14")
+      @events[0].to_s.should == "2009-01-12"
+      @events[-1].to_s.should == "2009-01-14"
+    end
+
+    it "should not iterate all dates when using until" do
+      @events = @recurrence.events(:starts => "2009-01-06", :until => "2009-01-08")
+      @recurrence.instance_variable_get("@events").size.should == 3
+      @events.size.should == 3
+      @events[-1].to_s.should == "2009-01-08"
+    end
+  end
+
+  private
+  def recurrence(options)
+    Recurrence.new(options)
+  end
+end