date_easter 0.0.1

data/README

@@ -0,0 +1,29 @@
+= date_easter:  calculate the day upon which Easter Sunday falls
+-----
+
+
+== OVERVIEW
+-----
+This module calculates the date upon which Easter falls, a date upon 
+which many holidays in the Western world depend.  It extends the
+Date class available in the Ruby standard library, adding the 
+class method Date::easter(year) and the instance method easter().
+
+
+== BUGS
+-----
+Julian / Orthodox easter calculations are not yet implemented.
+
+
+== LICENSE
+-----
+This program is free software!  You can copy, modify, share and
+distribute it under the same license as Ruby itself.
+
+
+== AUTHOR
+-----
+Rick Scott
+rick@shadowspar.dyndns.org
+
+Patches, feature requests, and bug reports are welcome.

data/lib/date_easter.rb

@@ -0,0 +1,91 @@
+# date_easter:  calculate the day upon which Easter Sunday falls
+#
+# This program is free software!  You can copy, modify, share and
+# distribute it under the same license as Ruby itself.
+#
+# Rick Scott
+# rick@shadowspar.dyndns.org
+#
+# Tue Nov 28 22:57:01 EST 2006
+# 
+# 
+# == Overview 
+#
+# This module calculates the date upon which Easter falls, a date
+# upon which many holidays in the Western world depend.  
+# It extends the Date class available in the Ruby standard library,
+# adding the class method Date::easter(year) and the instance
+# method easter().  It returns the correct date of Easter Sunday for 
+# the Gregorian calendar years 1583 to 4099.
+# 
+# == Background 
+# 
+# Determining when Easter falls is a somewhat arcane process,
+# largely due to the numerous adjustments that have been made to
+# the Gregorian calendar in an attempt to `fit together' the
+# cycles of the sun, moon, and earth.  Detailed discussion here
+# would be somewhat pointless in light of the far superior
+# resources available online -- see 'References', below, for some
+# starting points.
+#
+# == References
+# 
+# http://en.wikipedia.org/wiki/Computus
+# http://www.phys.uu.nl/~vgent/easter/easter_text2a.htm
+# http://users.chariot.net.au/~gmarts/eastcalc.htm
+
+
+
+require 'date'
+
+class Date
+
+  # :call-seq: 
+  #   Date::easter(year)    => easter_sunday_Date
+  #
+  # Return the Date upon which Easter Sunday falls in _year_.
+  # The Gregorian calendar is used.
+  def self.easter(year) 
+    unless year.is_a? Numeric
+      raise TypeError, "year must be Numeric" 
+    end
+
+    if year < 1583 
+      raise ArgumentError, "Years before 1583 not supported"  
+    elsif year > 4099
+      raise ArgumentError, "Years after 4099 not supported"  
+    end
+
+    golden_number     = (year % 19) + 1
+    century           = (year / 100) + 1
+    julian_epact      = (11 * (golden_number -1)) % 30 
+    solar_correction  = (3 * century) / 4
+    lunar_correction  = ((8 * century) + 5) / 25
+  
+    gregorian_epact   = 
+        (julian_epact - solar_correction + lunar_correction + 8) % 30
+  
+    days_fm_ve_to_pfm = (23 - gregorian_epact) % 30
+
+    if gregorian_epact == 24 or gregorian_epact == 25 && golden_number > 11
+      days_fm_ve_to_pfm -= 1 
+    end
+
+    vernal_equinox    = Date.new(year, 3, 21) 
+    paschal_full_moon = vernal_equinox + days_fm_ve_to_pfm
+  
+    days_to_sunday    = 7 - paschal_full_moon.wday
+  
+    easter_sunday     = paschal_full_moon + days_to_sunday
+  end
+  
+
+  # :call-seq: 
+  #   ref.easter()    => easter_sunday_Date
+  #
+  # Return the Date of Easter Sunday for the year in which _ref_
+  # falls.  The Gregorian calendar is used.
+  def easter
+    Date::easter(self.year)
+  end
+end

data/test/t01fast.rb

@@ -0,0 +1,142 @@
+# t01fast.rb:  abbreviated test suite for date_easter
+#
+# This program is free software!  You can copy, modify, share and
+# distribute it under the same license as Ruby itself.
+#
+# Rick Scott
+# rick@shadowspar.dyndns.org
+#
+# Wed Nov 29 21:21:16 EST 2006
+# 
+# for rationale on choosing these dates, have a look at:
+# http://en.wikipedia.org/wiki/Epoch_%28reference_date%29
+# http://www.theiet.org/publicaffairs/scs/problemdates.cfm
+
+require 'test/unit'
+require 'date_easter'
+
+
+class TC_Correctness < Test::Unit::TestCase
+  def test_correctness
+    test_dates = %w{
+      10 04 1583
+      01 04 1584
+      07 04 1602
+      02 04 1752
+
+      04 04 1858
+      02 04 1899
+      15 04 1900
+      07 04 1901
+      03 04 1904
+
+      06 04 1969
+      29 03 1970
+      11 04 1971
+      10 04 1977
+      26 03 1978
+      15 04 1979
+      06 04 1980
+
+      19 04 1981
+      11 04 1982
+      03 04 1983
+      22 04 1984
+      07 04 1985
+      30 03 1986
+      19 04 1987
+      03 04 1988
+      26 03 1989
+      15 04 1990
+      
+      31 03 1991
+      19 04 1992
+      11 04 1993
+      03 04 1994
+      16 04 1995
+      07 04 1996
+      30 03 1997
+      12 04 1998
+      04 04 1999
+      23 04 2000
+      
+      15 04 2001
+      31 03 2002
+      20 04 2003
+      11 04 2004
+      27 03 2005
+      16 04 2006
+      08 04 2007
+      23 03 2008
+      12 04 2009
+      04 04 2010
+      
+      24 04 2011
+      08 04 2012
+      31 03 2013
+      20 04 2014
+      05 04 2015
+      27 03 2016
+      16 04 2017
+      01 04 2018
+      21 04 2019
+      12 04 2020
+      
+      04 04 2021
+      17 04 2022
+      09 04 2023
+      31 03 2024
+      20 04 2025
+      05 04 2026
+      28 03 2027
+      16 04 2028
+      01 04 2029
+      21 04 2030
+      
+      13 04 2031
+      28 03 2032
+      17 04 2033
+      09 04 2034
+      25 03 2035
+      13 04 2036
+      05 04 2037
+      25 04 2038
+      10 04 2039
+      01 04 2040
+      
+      21 04 2041
+      06 04 2042
+      29 03 2043
+      17 04 2044
+      09 04 2045
+      25 03 2046
+      14 04 2047
+      05 04 2048
+      18 04 2049
+      10 04 2050
+      
+      18 04 2060
+      30 03 2070
+      07 04 2080
+      16 04 2090
+      12 04 2099
+      28 03 2100
+      17 04 2101
+
+      06 04 4098
+      19 04 4099
+    }
+
+    until test_dates.empty?  
+      day   = test_dates.shift.to_i
+      month = test_dates.shift.to_i
+      year  = test_dates.shift.to_i
+
+      easter_date = Date::easter(year) 
+      assert_equal(year,  easter_date.year,  "Year of Easter #{year}" )
+      assert_equal(month, easter_date.month, "Month of Easter #{year}") 
+      assert_equal(day,   easter_date.day ,  "Day of Easter #{year}"  )
+    end
+  end
+end
+

data/test/t02stress.rb

@@ -0,0 +1,54 @@
+# t02stress.rb:  stress tests for date_easter
+#
+# This program is free software!  You can copy, modify, share and
+# distribute it under the same license as Ruby itself.
+#
+# Rick Scott
+# rick@shadowspar.dyndns.org
+#
+# Wed Nov 29 21:21:16 EST 2006
+# 
+# for rationale on choosing these dates, have a look at:
+# http://en.wikipedia.org/wiki/Epoch_%28reference_date%29
+# http://www.theiet.org/publicaffairs/scs/problemdates.cfm
+
+require 'test/unit'
+require 'date_easter'
+
+
+class TC_Stress < Test::Unit::TestCase
+  def test_year_rubbish
+    assert_raise TypeError do
+      Date::easter(nil)
+    end
+
+    assert_raise TypeError do
+      Date::easter('asdf')
+    end
+  end
+
+  def test_year_toobig
+    assert_raise ArgumentError do
+      Date::easter(9999)
+    end
+
+    ridiculous_future_date = Date.new(12345, 12, 31)
+
+    assert_raise ArgumentError do
+      ridiculous_future_date.easter() 
+    end
+  end
+
+  def test_year_toosmall
+    assert_raise ArgumentError do
+      Date::easter(1)
+    end
+
+    ridiculous_ancient_date = Date.new(-1234, 12, 31)
+
+    assert_raise ArgumentError do
+      ridiculous_ancient_date.easter() 
+    end
+  end
+end
+

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: date_easter
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+date: 2006-11-30 00:00:00 -05:00
+summary: Calculate the date on which Easter falls.
+require_paths: 
+  - lib
+email: rick@shadowspar.dyndns.org
+homepage: http://shadowspar.dyndns.org/rick/
+rubyforge_project: date_easter
+description: "This module calculates the date upon which Easter falls, a date upon which many
+  holidays in the Western world depend.  It extends the Date class available in
+  the Ruby standard library, adding the class method Date::easter(year) and the
+  instance method easter()."
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+    - 
+      - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+  - Rick Scott
+files: 
+  - lib/date_easter.rb
+  - test/t01fast.rb
+  - test/t02stress.rb
+  - README
+test_files: 
+  - test/t01fast.rb
+  - test/t02stress.rb
+rdoc_options: []
+extra_rdoc_files: 
+  - README
+executables: []
+extensions: []
+requirements: []
+dependencies: []