month.rb 0.10.3 → 0.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10fd25796a52b78a7dee921eff3ad951b886cda473cd327ee3ac5aaa906ec991
-  data.tar.gz: a53923f40a0fb25c29dbecb5ca7c034b0aa7473d0a71fc69d88412f797be3868
+  metadata.gz: 143cb13b6147f69bcc9547c1e2c322d5a5834b341e7151fd0462279434996bda
+  data.tar.gz: a6f735def7556a0944c29badda59dee8aef2941a28c1cc00d499c581ab745d01
 SHA512:
-  metadata.gz: 88d28a35a4bf5c1cc7367bf4a6702a1cb391d37d03ef27998f1337bad2fbea5c6440ed99a1255f3fbf6adfd347b47fc6d2b2f21e8fdaf4d9203a2a1c8615887f
-  data.tar.gz: e827e393a33db436eda515b38e020d8bfff7aedc4ab3cbbc933fe57b7d59f74494679b3e75309384ec5068be4eba8b760de2e8d914268761e67dbe9afcb35ff5
+  metadata.gz: 6967cc8e70165761e05b1e2c1cff0f7bf221827c4efe24d649bd156b524a2b10c141420abea46a0930f30a1b0a6316fd68574ca65baf5bc55dd2bfed8402cfa4
+  data.tar.gz: d7feb1ad56abe79c3325e125b160c43e86b204afe4c0e2b43593168071439ae87b298fd8cab910d8f1063bd7daa54f6062e42f62ae756f63bbe969614c5f8034

data/CHANGELOG

@@ -0,0 +1,66 @@
+# CHANGELOG
+
+## 20260819
+
+0.11.1: Tidy the gemspec, ship what it should, fill in its metadata, and guard it with a test.
+
+1. - month.rb.gemspec: spec.date, pinned to '2024-03-06'. A build sets the date; pinning it means every gem built since has claimed to be from that day. impuri removed the same at its 0.9.0.
+2. ~ month.rb.gemspec: spec.files was Dir['lib/**/*.rb'] alone, so the gem shipped the library and nothing else — no CHANGELOG, no README, no Gemfile, not even the gemspec. Now the two Dir globs first and the loose files alphabetically after, as moby and measurand have it.
+3. ~ month.rb.gemspec: /required_ruby_version >= 1.8.6/>= 2.7/, matching impuri. The declared floor was impossible: the gemspec's own <<~ heredoc needs 2.3, and the suite needs a Minitest which needs more than that again.
+4. ~ month.rb.gemspec: /http:\/\/github.com/https:\/\/github.com/.
+5. + month.rb.gemspec: spec.metadata, being bug_tracker_uri, changelog_uri, source_code_uri and documentation_uri. These are the links rubygems shows beside the gem, and with none declared the page offers the homepage alone.
+6. + month.rb.gemspec: spec.require_paths, and a header comment naming the file, as every other file here carries.
+7. + test/tc_gemspec.rb: that the specification validates, that it pins no date, that its version is Month::VERSION, that the four metadata keys are declared and no blob link names a branch other than master, that the loose files ship and not lib alone, and which dependencies it declares. The harness loads test/*.rb by glob, so it needed no registering.
+8. ~ Month::VERSION: /0.11.0/0.11.1/
+
+
+0.11.0: Month#to_s: raise upon an argument it does not know, and correct the examples documenting it.
+
+1. ~ Month#to_s: + an else branch raising ArgumentError, naming the argument and the four it accepts. An unknown name length returned nil, and nil from #to_s is worse than most wrong answers: interpolation of the call yields an empty string, so a mistyped format printed nothing at all rather than complaining. This is the breaking change, such as it is — anything relying upon the nil now gets an exception.
+2. ~ Month#to_s: the argument is converted with `month_name_length.to_sym if month_name_length.respond_to?(:to_sym)`, so that a value which cannot be a symbol falls to the same else rather than raising NoMethodError from #to_sym before the case is reached. to_s(3), to_s(nil) and to_s([:long]) now give the same ArgumentError as to_s(:medium), and the message names the original argument rather than the nil the case saw.
+3. ~ Month#to_s: - 'short' from the `when :short, 'short'` clause. The argument is symbolised before the case, so the string could never match there; the string form worked, and still works, by way of the conversion. The clause read as though it handled something it did not.
+4. + test/tc_Month_to_s.rb: that an unknown name length raises, in both symbol and string form, and that an argument which cannot be a symbol raises the same. Verified to have teeth by removing the raise, upon which they fail and nothing else does.
+5. ~ README.md: /Month.new(2011, 1).to_s(:long)/Month.new(1).to_s(:long)/, and likewise for 'long', :short and 'short'. All four stated their output as "January #{Date.today.year}" or "Jan #{Date.today.year}", which is what the year-less form gives and is wrong for a month built with 2011. The receiver was the typo and not the output, and the correct copies of those same four calls with an explicit year already sat below. The examples and the method are one subject, so they move together.
+6. - README.md: a stray end inside the section 3 code fence, left over from an earlier edit and not Ruby anybody could run.
+7. + README.md: blank lines between the year-less, the 2006 and the 2011 groups, so that the pattern the section follows is visible rather than inferred.
+8. ~ Month::VERSION: /0.10.3/0.11.0/
+
+
+0.10.3: Populate the .gitignore, which had been committed empty.
+
+1. ~ .gitignore: 47 lines, covering gem builds, bundler, RDoc and YARD output, .DS_Store, editor files, the Ruby version managers, test artefacts and .claude. The file existed and was empty, which git-boot creates it as and nothing had since filled in. jira, mercurial, skyhooks, git-boot and git-import-all each took this as a release of its own.
+2. ~ Month::VERSION: /0.10.2/0.10.3/
+
+
+0.10.2: Tidy the CHANGELOG into the form every other gem here uses.
+
+1. ~ CHANGELOG.txt --> CHANGELOG, as every other gem here spells it. impuri made the same rename at its 0.9.0.
+2. ~ CHANGELOG: /# 20240306/## 20240306/. A single hash makes the date a top-level heading, level with the file itself, so every date read as a title rather than as a section within one.
+3. ~ CHANGELOG: 20240306 carried two headings, the first holding 0.10.0 and the second 0.10.1 alone, so one day's work read as two. Merged, and impuri met the same duplication at its 0.12.4.
+4. ~ CHANGELOG: the entries reordered newest first. They had been oldest first, which is the reverse of every other gem here and means the version in hand is found at the bottom of a file which only grows.
+5. + CHANGELOG: a # CHANGELOG title, and a blank line between each summary line and its first item, both of which the standard form has and this did not.
+6. ~ Month::VERSION: /0.10.1/0.10.2/
+
+
+## 20240306
+
+0.10.1: + README.md
+
+1. + README.md
+
+0.10.0: Use a more conventional structure by removing the Month.rbl directory, get it working again, and create a gem.
+
+1. - Month.rbl directory.
+2. + Gemfile
+3. + month.rb.gemspec
+4. - lib/Array/lastX.rb: Not sure why this was here.
+5. - lib/Array/all_but_last.rb: Not sure why this was here.
+6. /ideas.txt/TODO.txt/
+7. ~ lib/Month.rb: Removed date, version, description, and changes to the gemspec and the CHANGELOG.
+8. + CHANGELOG.txt
+9. ~ lib/Month/Constants.rb: - VERSION
+10. + lib/Month/VERSION.rb
+11. /Fixnum/Integer/ (It's been that long!)
+12. /MiniTest/Minitest/ (It's been that long!)
+13. /assert_equal nil,/assert_nil/: Now ready for Minitest 6!
+14. ~ lib/Month.rb: + require 'Date/to_month'

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://www.rubygems.org'
+gemspec

data/README.md

@@ -0,0 +1,145 @@
+# month.rb
+
+## Description
+
+This library enables the use of numeric or text representations of months, conversions between month and date objects, the ability to find the number of days and retrieve the dates for all days in a month, and the ability to move forward and back a month at a time.
+
+## Installation
+
+Add this line to your application's Gemfile:
+```ruby
+gem 'month.rb'
+```
+And then execute:
+```shell
+$ bundle
+```
+Or install it yourself as:
+```shell
+$ gem install month.rb
+```
+
+## Usage
+
+### 1. Instantiate a month in different ways
+```ruby
+  Month.new(2006, 1)
+  # => #<Month @year = 2006, @month = 1>
+  Month.new(1)
+  # => #<Month @year = Date.today.year, @month = 1>
+  Month.of('January')
+  # => #<Month @year = Date.today.year, @month = 1>
+  Month.of('Jan')
+  # => #<Month @year = Date.today.year, @month = 1>
+  Month.today
+  # => #<Month @year = Date.today.year, @month = Date.today.month)>
+```
+
+### 2. Convert between month and date objects
+```ruby
+  Date.new(2006, 1, 1).to_month
+  # => #<Month @year = 2006, @month = 1>
+  Month.new(2006, 1).to_date
+  # => #<Date @year = 2006, @month = 1, @day = 1>
+```
+
+### 3. Convert between numeric and text representations
+```ruby
+  Month.new(1).to_number
+  # => 1
+  Month.new(1).to_short
+  # => 'Jan'
+  Month.new(1).to_long
+  # => 'January'
+
+  Month.new(2006, 1).to_number
+  # => 1
+  Month.new(2006, 1).to_short
+  # => 'Jan'
+  Month.new(2006, 1).to_long
+  # => 'January'
+
+  Month.new(1).to_s
+  # => "January #{Date.today.year}"
+  Month.new(1).to_s(:long)
+  # => "January #{Date.today.year}"
+  Month.new(1).to_s('long')
+  # => "January #{Date.today.year}"
+  Month.new(1).to_s(:short)
+  # => "Jan #{Date.today.year}"
+  Month.new(1).to_s('short')
+  # => "Jan #{Date.today.year}"
+
+  Month.new(2011, 1).to_s
+  # => 'January 2011'
+  Month.new(2011, 1).to_s(:long)
+  # => 'January 2011'
+  Month.new(2011, 1).to_s('long')
+  # => 'January 2011'
+  Month.new(2011, 1).to_s(:short)
+  # => 'Jan 2011'
+  Month.new(2011, 1).to_s('short')
+  # => 'Jan 2011'
+```
+
+### 4. Compare months
+```ruby
+  Month.of('January') == Month.of('January')
+  # => true
+  Month.of('January') > Month.of('January')
+  # => false
+  Month.of('February') > Month.of('January')
+  # => true
+  Month.of('January') < Month.of('February')
+  # => true
+```
+
+### 5. Find the dates at the beginning and end of the month
+```ruby
+  Month.beginning_of_month(2006, 1)
+  # => #<Date @year = 2006, @month = 1, @day = 1>
+  Month.end_of_month(2006, 1)
+  # => #<Date @year = 2006, @month = 1, @day = 31>
+  Month.new(2006, 1).beginning_of_month
+  # => #<Date @year = 2006, @month = 1, @day = 1>
+  Month.new(2006, 1).end_of_month
+  # => #<Date @year = 2006, @month = 1, @day = 31>
+```
+
+### 6. Return day numbers or day name for all the days of a week for a given month or just for one day
+```ruby
+  Month.dates(2006, 10, day: 'Sunday')
+  # => [1, 8, 15, 22, 29]
+  Month.new(2011, 1).date('First', 'Monday')
+  # => 3
+  Month.new(2006, 10).day(1) # Return the day name of first day of the month.
+  # => 'Sunday'
+```
+
+### 7. Return the number of days in a month
+```ruby
+  Month.days('January')
+  # => 31
+  Month.of('January').days
+  # => 31
+```
+
+### 8. Move forward and backward a month or a year at a time
+```ruby
+  Month.new(2011, 1).previous_month
+  # => #<Month @year = 2010, @month = 12>
+  Month.new(2011, 1).next_month
+  # => #<Month @year = 2011, @month = 2>
+  Month.new(2011, 1).last_year
+  # => #<Month @year = 2010, @month = 2>
+  Month.new(2011, 1).next_year
+  # => #<Month @year = 2012, @month = 1>
+```
+
+## Contributing
+
+1. Fork it: https://github.com/thoran/month.rb/fork
+2. Create your feature branch: `git checkout -b my-new-feature`
+3. Commit your changes: `git commit -am 'Add some feature'`
+4. Push to the branch: `git push origin my-new-feature`
+5. Create a new pull request

data/TODO.txt

@@ -0,0 +1,26 @@
+# 20111205, 20140606
+
+Month.new(2).dates('sundays'), Month.new(2).dates('Sundays')
+=> nil
+irb(main):040:0> Month.sunday
+=> [4, 11, 18, 25]
+Month.sundays
+=> [4, 11, 18, 25]
+Month.new(2).dates('sunday'), Month.new(2).dates('Sunday')
+=> [4, 11, 18, 25]
+
+
+# 20140606
+
+Month.from_long('January')
+Month.from_short('Jan')
+Month.from_number(1)
+
+Month.parse, can be derived in part from Date.parse
+
+Should Month.parse be able to handle all of the what the from_... methods do and therefore they alias Month.parse, or should it hand off to them?
+
+
+# 20240306
+
+Consider consolidating all the methods into a single file or a lot fewer files anyway, instead of there being one file per method. This stems from some experimentation around how to structure a Ruby library quite some time ago.

data/lib/Month/VERSION.rb

@@ -2,5 +2,5 @@
 # Month::VERSION
 
 class Month
-  VERSION = '0.10.3' unless defined?(VERSION)
+  VERSION = '0.11.1' unless defined?(VERSION)
 end

data/lib/Month/to_s.rb

@@ -8,10 +8,11 @@ require 'Month/to_short'
 class Month
 
   def to_s(month_name_length = :long)
-    case month_name_length.to_sym
+    case (month_name_length.to_sym if month_name_length.respond_to?(:to_sym))
     when :long; "#{to_long} #{year}"
-    when :short, 'short'; "#{to_short} #{year}"
+    when :short; "#{to_short} #{year}"
     when :iso, :iso_8601; "#{year}-" + "%02d" % month
+    else; raise ArgumentError, "unknown month name length #{month_name_length.inspect} (expected :long, :short, :iso, or :iso_8601)"
     end
   end
 

data/month.rb.gemspec

@@ -0,0 +1,43 @@
+# month.rb.gemspec
+
+require_relative './lib/Month/VERSION'
+
+Gem::Specification.new do |spec|
+  spec.name = 'month.rb'
+  spec.version = Month::VERSION
+
+  spec.summary = "A library to help working with months."
+  spec.description = <<~DESCRIPTION
+    This library enables the use of numeric or text representations of months,
+    conversions between month and date objects,
+    the ability to find the number of days and retrieve the dates for all days in a month,
+    and the ability to move forward and back a month at a time.
+  DESCRIPTION
+
+  spec.author = 'thoran'
+  spec.email = 'code@thoran.com'
+  spec.homepage = 'https://github.com/thoran/month.rb'
+  spec.license = 'MIT'
+
+  spec.metadata = {
+    'bug_tracker_uri' => 'https://github.com/thoran/month.rb/issues',
+    'changelog_uri' => 'https://github.com/thoran/month.rb/blob/master/CHANGELOG',
+    'source_code_uri' => 'https://github.com/thoran/month.rb',
+    'documentation_uri' => 'https://github.com/thoran/month.rb/blob/master/README.md',
+  }
+
+  spec.required_ruby_version = '>= 2.7'
+  spec.require_paths = ['lib']
+
+  spec.files = [
+    Dir['lib/**/*.rb'],
+    Dir['test/**/*.rb'],
+    'CHANGELOG',
+    'Gemfile',
+    'month.rb.gemspec',
+    'README.md',
+    'TODO.txt',
+  ].flatten
+
+  spec.add_development_dependency('minitest')
+end

data/test/tc_Date_to_month.rb

@@ -0,0 +1,21 @@
+# test/tc_Month_begin_date.rb
+
+class TC_Date_to_month < Minitest::Test
+  
+  def test_Date_to_month
+    assert_equal Date.new(2006, 1, 1).to_month, Month.new(2006, 1)
+    assert_equal Date.new(2006, 2, 1).to_month, Month.new(2006, 2)
+    assert_equal Date.new(2008, 2, 1).to_month, Month.new(2008, 2)
+    assert_equal Date.new(2006, 3, 1).to_month, Month.new(2006, 3)
+    assert_equal Date.new(2006, 4, 1).to_month, Month.new(2006, 4)
+    assert_equal Date.new(2006, 5, 1).to_month, Month.new(2006, 5)
+    assert_equal Date.new(2006, 6, 1).to_month, Month.new(2006, 6)
+    assert_equal Date.new(2006, 7, 1).to_month, Month.new(2006, 7)
+    assert_equal Date.new(2006, 8, 1).to_month, Month.new(2006, 8)
+    assert_equal Date.new(2006, 9, 1).to_month, Month.new(2006, 9)
+    assert_equal Date.new(2006, 10, 1).to_month, Month.new(2006, 10)
+    assert_equal Date.new(2006, 11, 1).to_month, Month.new(2006, 11)
+    assert_equal Date.new(2006, 12, 1).to_month, Month.new(2006, 12)
+  end
+  
+end

data/test/tc_Month_begin_date.rb

@@ -0,0 +1,21 @@
+# test/tc_Month_begin_date.rb
+
+class TC_Month_begin_date < Minitest::Test
+  
+  def test_begin_date
+    assert_equal Date.new(2006, 1, 1), Month.new(2006, 1).begin_date
+    assert_equal Date.new(2006, 2, 1), Month.new(2006, 2).begin_date
+    assert_equal Date.new(2008, 2, 1), Month.new(2008, 2).begin_date
+    assert_equal Date.new(2006, 3, 1), Month.new(2006, 3).begin_date
+    assert_equal Date.new(2006, 4, 1), Month.new(2006, 4).begin_date
+    assert_equal Date.new(2006, 5, 1), Month.new(2006, 5).begin_date
+    assert_equal Date.new(2006, 6, 1), Month.new(2006, 6).begin_date
+    assert_equal Date.new(2006, 7, 1), Month.new(2006, 7).begin_date
+    assert_equal Date.new(2006, 8, 1), Month.new(2006, 8).begin_date
+    assert_equal Date.new(2006, 9, 1), Month.new(2006, 9).begin_date
+    assert_equal Date.new(2006, 10, 1), Month.new(2006, 10).begin_date
+    assert_equal Date.new(2006, 11, 1), Month.new(2006, 11).begin_date
+    assert_equal Date.new(2006, 12, 1), Month.new(2006, 12).begin_date
+  end
+  
+end

data/test/tc_Month_beginning.rb

@@ -0,0 +1,21 @@
+# test/tc_Month_beginning.rb
+
+class TC_Month_beginning < Minitest::Test
+  
+  def test_beginning
+    assert_equal Date.new(2006, 1, 1), Month.new(2006, 1).beginning
+    assert_equal Date.new(2006, 2, 1), Month.new(2006, 2).beginning
+    assert_equal Date.new(2008, 2, 1), Month.new(2008, 2).beginning
+    assert_equal Date.new(2006, 3, 1), Month.new(2006, 3).beginning
+    assert_equal Date.new(2006, 4, 1), Month.new(2006, 4).beginning
+    assert_equal Date.new(2006, 5, 1), Month.new(2006, 5).beginning
+    assert_equal Date.new(2006, 6, 1), Month.new(2006, 6).beginning
+    assert_equal Date.new(2006, 7, 1), Month.new(2006, 7).beginning
+    assert_equal Date.new(2006, 8, 1), Month.new(2006, 8).beginning
+    assert_equal Date.new(2006, 9, 1), Month.new(2006, 9).beginning
+    assert_equal Date.new(2006, 10, 1), Month.new(2006, 10).beginning
+    assert_equal Date.new(2006, 11, 1), Month.new(2006, 11).beginning
+    assert_equal Date.new(2006, 12, 1), Month.new(2006, 12).beginning
+  end
+  
+end

data/test/tc_Month_beginning_of_month.rb

@@ -0,0 +1,21 @@
+# test/tc_Month_beginning_of_month.rb
+
+class TC_Month_beginning_of_month < Minitest::Test
+  
+  def test_beginning_of_month
+    assert_equal Date.new(2006, 1, 1), Month.new(2006, 1).beginning_of_month
+    assert_equal Date.new(2006, 2, 1), Month.new(2006, 2).beginning_of_month
+    assert_equal Date.new(2008, 2, 1), Month.new(2008, 2).beginning_of_month
+    assert_equal Date.new(2006, 3, 1), Month.new(2006, 3).beginning_of_month
+    assert_equal Date.new(2006, 4, 1), Month.new(2006, 4).beginning_of_month
+    assert_equal Date.new(2006, 5, 1), Month.new(2006, 5).beginning_of_month
+    assert_equal Date.new(2006, 6, 1), Month.new(2006, 6).beginning_of_month
+    assert_equal Date.new(2006, 7, 1), Month.new(2006, 7).beginning_of_month
+    assert_equal Date.new(2006, 8, 1), Month.new(2006, 8).beginning_of_month
+    assert_equal Date.new(2006, 9, 1), Month.new(2006, 9).beginning_of_month
+    assert_equal Date.new(2006, 10, 1), Month.new(2006, 10).beginning_of_month
+    assert_equal Date.new(2006, 11, 1), Month.new(2006, 11).beginning_of_month
+    assert_equal Date.new(2006, 12, 1), Month.new(2006, 12).beginning_of_month
+  end
+  
+end

data/test/tc_Month_beginning_of_the_month.rb

@@ -0,0 +1,21 @@
+# test/tc_Month_beginning_of_the_month.rb
+
+class TC_Month_beginning_of_the_month < Minitest::Test
+  
+  def test_beginning_of_the_month
+    assert_equal Date.new(2006, 1, 1), Month.new(2006, 1).beginning_of_the_month
+    assert_equal Date.new(2006, 2, 1), Month.new(2006, 2).beginning_of_the_month
+    assert_equal Date.new(2008, 2, 1), Month.new(2008, 2).beginning_of_the_month
+    assert_equal Date.new(2006, 3, 1), Month.new(2006, 3).beginning_of_the_month
+    assert_equal Date.new(2006, 4, 1), Month.new(2006, 4).beginning_of_the_month
+    assert_equal Date.new(2006, 5, 1), Month.new(2006, 5).beginning_of_the_month
+    assert_equal Date.new(2006, 6, 1), Month.new(2006, 6).beginning_of_the_month
+    assert_equal Date.new(2006, 7, 1), Month.new(2006, 7).beginning_of_the_month
+    assert_equal Date.new(2006, 8, 1), Month.new(2006, 8).beginning_of_the_month
+    assert_equal Date.new(2006, 9, 1), Month.new(2006, 9).beginning_of_the_month
+    assert_equal Date.new(2006, 10, 1), Month.new(2006, 10).beginning_of_the_month
+    assert_equal Date.new(2006, 11, 1), Month.new(2006, 11).beginning_of_the_month
+    assert_equal Date.new(2006, 12, 1), Month.new(2006, 12).beginning_of_the_month
+  end
+  
+end

data/test/tc_Month_cdate.rb

@@ -0,0 +1,34 @@
+# test/tc_Month_cdate.rb
+
+if __FILE__ == $0
+  require 'minitest/autorun'
+  $LOAD_PATH.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+  require 'Month/Constants'
+  require 'Month/initialize'
+  require 'Month/cdate'
+end
+
+class TC_Month_cdate < Minitest::Test
+  
+  def test_cdate
+    assert_equal 3, Month.new(2011, 1).cdate('First', 'Monday')
+    assert_equal 14, Month.new(2011, 2).cdate('Second', 'Monday')
+    assert_equal 21, Month.new(2011, 3).cdate('Third', 'Monday')
+    assert_equal 25, Month.new(2011, 4).cdate('Fourth', 'Monday')
+    assert_equal 30, Month.new(2011, 5).cdate('Fifth', 'Monday')
+    assert_equal 27, Month.new(2011, 6).cdate('Last', 'Monday')
+    assert_equal 18, Month.new(2011, 7).cdate('Second Last', 'Monday')
+    assert_equal 15, Month.new(2011, 8).cdate('Third Last', 'Monday')
+    assert_equal 5, Month.new(2011, 9).cdate('Fourth Last', 'Monday')
+    assert_equal 2, Month.new(2011, 1).cdate('First', 'Sunday')
+    assert_equal 13, Month.new(2011, 2).cdate('Second', 'Sunday')
+    assert_equal 20, Month.new(2011, 3).cdate('Third', 'Sunday')
+    assert_equal 24, Month.new(2011, 4).cdate('Fourth', 'Sunday')
+    assert_equal 29, Month.new(2011, 5).cdate('Fifth', 'Sunday')
+    assert_equal 26, Month.new(2011, 6).cdate('Last', 'Sunday')
+    assert_equal 24, Month.new(2011, 7).cdate('Second Last', 'Sunday')
+    assert_equal 14, Month.new(2011, 8).cdate('Third Last', 'Sunday')
+    assert_equal 4, Month.new(2011, 9).cdate('Fourth Last', 'Sunday')
+  end
+  
+end

data/test/tc_Month_cdates.rb

@@ -0,0 +1,111 @@
+# test/tc_Month_cdates.rb
+
+if __FILE__ == $0
+  require 'minitest/autorun'
+  $LOAD_PATH.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+  require 'Month/Constants'
+  require 'Month/initialize'
+  require 'Month/cdates'
+end
+
+class TC_Month_cdates < Minitest::Test
+  
+  def test_cdates
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 1).cdates('Monday')
+    assert_equal [3, 10, 17, 24, 31], Month.new(2006, 1).cdates('Tuesday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 1).cdates('Wednesday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 1).cdates('Thursday')
+    assert_equal [6, 13, 20, 27], Month.new(2006, 1).cdates('Friday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 1).cdates('Saturday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 1).cdates('Sunday')
+    
+    assert_equal [6, 13, 20, 27], Month.new(2006, 2).cdates('Monday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 2).cdates('Tuesday')
+    assert_equal [1, 8, 15, 22], Month.new(2006, 2).cdates('Wednesday')
+    assert_equal [2, 9, 16, 23], Month.new(2006, 2).cdates('Thursday')
+    assert_equal [3, 10, 17, 24], Month.new(2006, 2).cdates('Friday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 2).cdates('Saturday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 2).cdates('Sunday')
+    
+    assert_equal [6, 13, 20, 27], Month.new(2006, 3).cdates('Monday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 3).cdates('Tuesday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 3).cdates('Wednesday')
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 3).cdates('Thursday')
+    assert_equal [3, 10, 17, 24, 31], Month.new(2006, 3).cdates('Friday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 3).cdates('Saturday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 3).cdates('Sunday')
+    
+    assert_equal [3, 10, 17, 24], Month.new(2006, 4).cdates('Monday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 4).cdates('Tuesday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 4).cdates('Wednesday')
+    assert_equal [6, 13, 20, 27], Month.new(2006, 4).cdates('Thursday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 4).cdates('Friday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 4).cdates('Saturday')
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 4).cdates('Sunday')
+    
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 5).cdates('Monday')
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 5).cdates('Tuesday')
+    assert_equal [3, 10, 17, 24, 31], Month.new(2006, 5).cdates('Wednesday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 5).cdates('Thursday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 5).cdates('Friday')
+    assert_equal [6, 13, 20, 27], Month.new(2006, 5).cdates('Saturday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 5).cdates('Sunday')
+    
+    assert_equal [5, 12, 19, 26], Month.new(2006, 6).cdates('Monday')
+    assert_equal [6, 13, 20, 27], Month.new(2006, 6).cdates('Tuesday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 6).cdates('Wednesday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 6).cdates('Thursday')
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 6).cdates('Friday')
+    assert_equal [3, 10, 17, 24], Month.new(2006, 6).cdates('Saturday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 6).cdates('Sunday')
+    
+    assert_equal [3, 10, 17, 24, 31], Month.new(2006, 7).cdates('Monday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 7).cdates('Tuesday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 7).cdates('Wednesday')
+    assert_equal [6, 13, 20, 27], Month.new(2006, 7).cdates('Thursday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 7).cdates('Friday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 7).cdates('Saturday')
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 7).cdates('Sunday')
+    
+    assert_equal [7, 14, 21, 28], Month.new(2006, 8).cdates('Monday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 8).cdates('Tuesday')
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 8).cdates('Wednesday')
+    assert_equal [3, 10, 17, 24, 31], Month.new(2006, 8).cdates('Thursday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 8).cdates('Friday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 8).cdates('Saturday')
+    assert_equal [6, 13, 20, 27], Month.new(2006, 8).cdates('Sunday')
+    
+    assert_equal [4, 11, 18, 25], Month.new(2006, 9).cdates('Monday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 9).cdates('Tuesday')
+    assert_equal [6, 13, 20, 27], Month.new(2006, 9).cdates('Wednesday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 9).cdates('Thursday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 9).cdates('Friday')
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 9).cdates('Saturday')
+    assert_equal [3, 10, 17, 24], Month.new(2006, 9).cdates('Sunday')
+    
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 10).cdates('Monday')
+    assert_equal [3, 10, 17, 24, 31], Month.new(2006, 10).cdates('Tuesday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 10).cdates('Wednesday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 10).cdates('Thursday')
+    assert_equal [6, 13, 20, 27], Month.new(2006, 10).cdates('Friday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 10).cdates('Saturday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 10).cdates('Sunday')
+    
+    assert_equal [6, 13, 20, 27], Month.new(2006, 11).cdates('Monday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 11).cdates('Tuesday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 11).cdates('Wednesday')
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 11).cdates('Thursday')
+    assert_equal [3, 10, 17, 24], Month.new(2006, 11).cdates('Friday')
+    assert_equal [4, 11, 18, 25], Month.new(2006, 11).cdates('Saturday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 11).cdates('Sunday')
+    
+    assert_equal [4, 11, 18, 25], Month.new(2006, 12).cdates('Monday')
+    assert_equal [5, 12, 19, 26], Month.new(2006, 12).cdates('Tuesday')
+    assert_equal [6, 13, 20, 27], Month.new(2006, 12).cdates('Wednesday')
+    assert_equal [7, 14, 21, 28], Month.new(2006, 12).cdates('Thursday')
+    assert_equal [1, 8, 15, 22, 29], Month.new(2006, 12).cdates('Friday')
+    assert_equal [2, 9, 16, 23, 30], Month.new(2006, 12).cdates('Saturday')
+    assert_equal [3, 10, 17, 24, 31], Month.new(2006, 12).cdates('Sunday')
+  end
+  
+end

data/test/tc_Month_comparator.rb

@@ -0,0 +1,17 @@
+# test/tc_Month_comparator.rb
+
+class TC_Month_comparator < Minitest::Test
+  
+  def test_equivalence
+    assert_equal true, Month.new(2011, 1) == Month.new(2011, 1)
+  end
+  
+  def test_greater_than
+    assert_equal true, Month.new(2011, 2) > Month.new(2011, 1)
+  end
+  
+  def test_less_than
+    assert_equal true, Month.new(2011, 1) < Month.new(2011, 2)
+  end
+  
+end

data/test/tc_Month_date.rb

@@ -0,0 +1,34 @@
+# test/tc_Month_date.rb
+
+if __FILE__ == $0
+  require 'minitest/autorun'
+  $LOAD_PATH.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+  require 'Month/Constants'
+  require 'Month/initialize'
+  require 'Month/date'
+end
+
+class TC_Month_date < Minitest::Test
+  
+  def test_date
+    assert_equal 3, Month.new(2011, 1).date('First', 'Monday')
+    assert_equal 14, Month.new(2011, 2).date('Second', 'Monday')
+    assert_equal 21, Month.new(2011, 3).date('Third', 'Monday')
+    assert_equal 25, Month.new(2011, 4).date('Fourth', 'Monday')
+    assert_equal 30, Month.new(2011, 5).date('Fifth', 'Monday')
+    assert_equal 27, Month.new(2011, 6).date('Last', 'Monday')
+    assert_equal 18, Month.new(2011, 7).date('Second Last', 'Monday')
+    assert_equal 15, Month.new(2011, 8).date('Third Last', 'Monday')
+    assert_equal 5, Month.new(2011, 9).date('Fourth Last', 'Monday')
+    assert_equal 2, Month.new(2011, 1).date('First', 'Sunday')
+    assert_equal 13, Month.new(2011, 2).date('Second', 'Sunday')
+    assert_equal 20, Month.new(2011, 3).date('Third', 'Sunday')
+    assert_equal 24, Month.new(2011, 4).date('Fourth', 'Sunday')
+    assert_equal 29, Month.new(2011, 5).date('Fifth', 'Sunday')
+    assert_equal 26, Month.new(2011, 6).date('Last', 'Sunday')
+    assert_equal 24, Month.new(2011, 7).date('Second Last', 'Sunday')
+    assert_equal 14, Month.new(2011, 8).date('Third Last', 'Sunday')
+    assert_equal 4, Month.new(2011, 9).date('Fourth Last', 'Sunday')
+  end
+  
+end