month.rb 0.10.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ce3ea0d18a09b473fd683d198aa9fd6f6659cf481b4b8675794d28a486c68443
+  data.tar.gz: c5d6a37c5b8e13e7982aa39d2722264adc03cb1eda1fe8bb3f36c783f154fd14
+SHA512:
+  metadata.gz: ce09f0feae95b3d85e5a35ffcf56d3f2ddb4c96a91d822aeed0d43150ae525ee5a89ab16ae248c6a720e3fd0ff9c93887257850e178ec143f106d9bff203fe82
+  data.tar.gz: '083f31fbbbfe7301bce3985d09409ce56a0857650c0d2ed96974b08d5226e855f80b4690b7da2b4daca0f0fa1d3cc67d06bd76ef3d9e25555a83211fee824bf2'

data/lib/Array/extract_optionsX.rb

@@ -0,0 +1,14 @@
+# Array#extract_options!
+
+# 20090123
+# 0.0.0
+
+# History: Stolen wholesale from ActiveSupport.  
+
+class Array
+  
+  def extract_options!
+    last.is_a?(::Hash) ? pop : {}
+  end
+  
+end

data/lib/Date/to_month.rb

@@ -0,0 +1,12 @@
+# Date/to_month.rb
+# Date#to_month
+
+require 'Month/initialize'
+
+class Date
+
+  def to_month
+    Month.new(self.year, self.month)
+  end
+
+end

data/lib/Month/Constants.rb

@@ -0,0 +1,31 @@
+# Month/Constants.rb
+# Month::Constants
+
+require 'date'
+
+class Month
+  module Constants
+    MONTH_NAMES_LONG = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'] unless defined?(MONTH_NAMES_LONG)
+    MONTH_NAMES_SHORT = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'] unless defined?(MONTH_NAMES_SHORT)
+    MONTH_NUMBERS = 1..12 unless defined?(MONTH_NUMBERS)
+    MONTH_NUMBERS_AS_STRINGS = '1'..'12' unless defined?(MONTH_NUMBERS_AS_STRINGS)
+
+    MONTH_DAYS = [31, Proc.new{|year| Date.leap?(year) ? 29 : 28}, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31] unless defined?(MONTH_DAYS)
+
+    MONTH_DAY_NUMBERS = 1..31 unless defined?(MONTH_DAY_NUMBERS)
+
+    ISO_8601_WEEK_DAY_NAMES_LONG = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'] unless defined?(ISO_8601_WEEK_DAY_NAMES_LONG)
+    ISO_8601_WEEK_DAY_NAMES_SHORT = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] unless defined?(ISO_8601_WEEK_DAY_NAMES_SHORT)
+    ISO_8601_WEEK_DAY_NAMES_SHORTEST = ['Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su'] unless defined?(ISO_8601_WEEK_DAY_NAMES_SHORTEST)
+    ISO_8601_WEEK_DAY_NUMBERS = 1..7 unless defined?(ISO_8601_WEEK_DAY_NUMBERS)
+    ISO_8601_WEEK_DAY_NUMBERS_AS_STRINGS = '1'..'7' unless defined?(ISO_8601_WEEK_DAY_NUMBERS_AS_STRINGS)
+
+    WEEK_DAY_NAMES_LONG = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'] unless defined?(WEEK_DAY_NAMES_LONG)
+    WEEK_DAY_NAMES_SHORT = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'] unless defined?(WEEK_DAY_NAMES_SHORT)
+    WEEK_DAY_NAMES_SHORTEST = ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa'] unless defined?(WEEK_DAY_NAMES_SHORTEST)
+    WEEK_DAY_NUMBERS = 0..6 unless defined?(WEEK_DAY_NUMBERS)
+    WEEK_DAY_NUMBERS_AS_STRINGS = '0'..'6' unless defined?(WEEK_DAY_NUMBERS_AS_STRINGS)
+  end
+end
+
+Month.extend(Month::Constants)

data/lib/Month/VERSION.rb

@@ -0,0 +1,6 @@
+# Month/VERSION.rb
+# Month::VERSION
+
+class Month
+  VERSION = '0.10.0' unless defined?(VERSION)
+end

data/lib/Month/_comparator.rb

@@ -0,0 +1,18 @@
+# Month/_comparator.rb
+# Month#<=>
+
+require 'Month/initialize'
+
+class Month
+
+  include Comparable
+
+  def <=>(other_month)
+    if year == other_month.year
+      month <=> other_month.month
+    else
+      year <=> other_month.year
+    end
+  end
+
+end

data/lib/Month/begin_date.rb

@@ -0,0 +1,13 @@
+# Month/begin_date.rb
+# Month#begin_date
+
+require 'Month/initialize'
+require 'Month/self.begin_date'
+
+class Month
+
+  def begin_date
+    Month.begin_date(year, month)
+  end
+
+end

data/lib/Month/beginning.rb

@@ -0,0 +1,13 @@
+# Month/beginning.rb
+# Month#beginning
+
+require 'Month/initialize'
+require 'Month/self.beginning'
+
+class Month
+
+  def beginning
+    Month.beginning(year, month)
+  end
+
+end

data/lib/Month/beginning_of_month.rb

@@ -0,0 +1,13 @@
+# Month/beginning_of_month.rb
+# Month#beginning_of_month
+
+require 'Month/initialize'
+require 'Month/self.beginning_of_month'
+
+class Month
+
+  def beginning_of_month
+    Month.beginning_of_month(year, month)
+  end
+
+end

data/lib/Month/beginning_of_the_month.rb

@@ -0,0 +1,13 @@
+# Month/beginning_of_the_month.rb
+# Month#beginning_of_the_month
+
+require 'Month/initialize'
+require 'Month/self.beginning_of_the_month'
+
+class Month
+
+  def beginning_of_the_month
+    Month.beginning_of_the_month(year, month)
+  end
+
+end

data/lib/Month/cdate.rb

@@ -0,0 +1,13 @@
+# Month/cdate.rb
+# Month#cdate
+
+require 'Month/initialize'
+require 'Month/self.cdate'
+
+class Month
+
+  def cdate(which_day, day)
+    Month.cdate(which_day, day, year, month)
+  end
+
+end

data/lib/Month/cdates.rb

@@ -0,0 +1,13 @@
+# Month/cdates.rb
+# Month#cdates
+
+require 'Month/initialize'
+require 'Month/self.cdates'
+
+class Month
+
+  def cdates(day = nil)
+    Month.cdates(year, month, :day => day)
+  end
+
+end

data/lib/Month/date.rb

@@ -0,0 +1,13 @@
+# Month/date.rb
+# Month#date
+
+require 'Month/initialize'
+require 'Month/self.date'
+
+class Month
+
+  def date(which_day, day)
+    Month.date(which_day, day, year, month)
+  end
+
+end

data/lib/Month/dates.rb

@@ -0,0 +1,13 @@
+# Month/dates.rb
+# Month#dates
+
+require 'Month/initialize'
+require 'Month/self.dates'
+
+class Month
+
+  def dates(day = nil)
+    Month.dates(year, month, :day => day)
+  end
+
+end

data/lib/Month/day.rb

@@ -0,0 +1,12 @@
+# Month/day.rb
+# Month#day
+
+require 'Month/self.day'
+
+class Month
+
+  def day(date)
+    Month.day(date, month, year)
+  end
+
+end

data/lib/Month/day_long.rb

@@ -0,0 +1,12 @@
+# Month/day_long.rb
+# Month#day_long
+
+require 'Month/self.day_long'
+
+class Month
+
+  def day_long(date)
+    Month.day_long(date, month, year)
+  end
+
+end

data/lib/Month/day_short.rb

@@ -0,0 +1,12 @@
+# Month/day_short.rb
+# Month#day_short
+
+require 'Month/self.day_short'
+
+class Month
+
+  def day_short(date)
+    Month.day_short(date, month, year)
+  end
+
+end

data/lib/Month/day_shortest.rb

@@ -0,0 +1,12 @@
+# Month/day_shortest.rb
+# Month#day_shortest
+
+require 'Month/self.day_shortest'
+
+class Month
+
+  def day_shortest(date)
+    Month.day_shortest(date, month, year)
+  end
+
+end

data/lib/Month/days.rb

@@ -0,0 +1,13 @@
+# Month/days.rb
+# Month#days
+
+require 'Month/initialize'
+require 'Month/self.days'
+
+class Month
+
+  def days
+    Month.days(year, month)
+  end
+
+end

data/lib/Month/days_in_month.rb

@@ -0,0 +1,10 @@
+# Month/days_in_month.rb
+# Month#days_in_month
+
+require 'Month/days'
+
+class Month
+
+  alias_method :days_in_month, :days
+
+end

data/lib/Month/days_in_the_month.rb

@@ -0,0 +1,10 @@
+# Month/days_in_month.rb
+# Month#days_in_month
+
+require 'Month/days'
+
+class Month
+
+  alias_method :days_in_the_month, :days
+
+end

data/lib/Month/each_day.rb

@@ -0,0 +1,13 @@
+# Month/each_day.rb
+# Month#each_day 
+
+require 'Month/initialize'
+require 'Month/days'
+
+class Month
+
+  def each_day
+    (1..days).each{|day| yield day}
+  end
+
+end

data/lib/Month/end.rb

@@ -0,0 +1,13 @@
+# Month/end.rb
+# Month#end
+
+require 'Month/initialize'
+require 'Month/self.end'
+
+class Month
+
+  def end
+    Month.end(year, month)
+  end
+
+end

data/lib/Month/end_date.rb

@@ -0,0 +1,13 @@
+# Month/end_date.rb
+# Month#end_date
+
+require 'Month/initialize'
+require 'Month/self.end_date'
+
+class Month
+
+  def end_date
+    Month.end_date(year, month)
+  end
+
+end

data/lib/Month/end_of_month.rb

@@ -0,0 +1,13 @@
+# Month/end_of_month.rb
+# Month#end_of_month
+
+require 'Month/initialize'
+require 'Month/self.end_of_month'
+
+class Month
+
+  def end_of_month
+    Month.end_of_month(year, month)
+  end
+
+end

data/lib/Month/end_of_the_month.rb

@@ -0,0 +1,13 @@
+# Month/end_of_the_month.rb
+# Month#end_of_the_month
+
+require 'Month/initialize'
+require 'Month/self.end_of_the_month'
+
+class Month
+
+  def end_of_the_month
+    Month.end_of_the_month(year, month)
+  end
+
+end

data/lib/Month/eqlQ.rb

@@ -0,0 +1,11 @@
+# Month/eqlQ.rb
+# Month#eql?
+
+class Month
+
+  def eql?(other_month)
+    self.year == other_month.year && self.month == other_month.month
+  end
+  alias_method :==, :eql?
+
+end

data/lib/Month/finish.rb

@@ -0,0 +1,13 @@
+# Month/finish.rb
+# Month#finish
+
+require 'Month/initialize'
+require 'Month/self.finish'
+
+class Month
+
+  def finish
+    Month.finish(year, month)
+  end
+
+end

data/lib/Month/finish_date.rb

@@ -0,0 +1,13 @@
+# Month/finish_date.rb
+# Month#finish_date
+
+require 'Month/initialize'
+require 'Month/self.finish_date'
+
+class Month
+
+  def finish_date
+    Month.finish_date(year, month)
+  end
+
+end

data/lib/Month/finish_of_month.rb

@@ -0,0 +1,13 @@
+# Month/finish_of_month.rb
+# Month#finish_of_month
+
+require 'Month/initialize'
+require 'Month/self.finish_of_month'
+
+class Month
+
+  def finish_of_month
+    Month.finish_of_month(year, month)
+  end
+
+end

data/lib/Month/finish_of_the_month.rb

@@ -0,0 +1,13 @@
+# Month/finish_of_the_month.rb
+# Month#finish_of_the_month
+
+require 'Month/initialize'
+require 'Month/self.finish_of_the_month'
+
+class Month
+
+  def finish_of_the_month
+    Month.finish_of_the_month(year, month)
+  end
+
+end

data/lib/Month/hash.rb

@@ -0,0 +1,12 @@
+# Month/hash.rb
+# Month#hash
+
+require 'Month/initialize'
+
+class Month
+
+  def hash
+    "#{year}#{month}".to_i
+  end
+
+end

data/lib/Month/initialize.rb

@@ -0,0 +1,27 @@
+# Month/initialize.rb
+# Month#initialize
+
+# Notes:
+# 1. With a view to compatibility with Francis Hwang's version of a Month class, and as a nod to Ruby's Date class, I have made it possible to supply the year optionally, but first, rather than second if there are two arguments.
+# 2. It might actually be nice if the Date class worked the same way.
+# 3. Generally I find it the Ruby way to assume that which can be assumed, and to only require explicitness when necessary. In this instance that means that if I instantiate an object with a month only, then I should be able to assume the year.
+
+require 'date'
+
+class Month
+
+  attr_reader :month, :year
+
+  def initialize(*args)
+    @year, @month = (
+      case args.size
+      when 0; [Date.today.year, Date.today.month]
+      when 1; [Date.today.year, args[0]]
+      when 2; [args[0], args[1]]
+      else; raise ArgumentError, "too many arguments (#{args.size} for 0, 1, or 2)"
+      end
+    )
+    fail unless (1..12).include?(@month)
+  end
+
+end

data/lib/Month/last.rb

@@ -0,0 +1,13 @@
+# Month/last.rb
+# Month#last
+
+require 'Month/initialize'
+require 'Month/self.last'
+
+class Month
+
+  def last
+    Month.last(year, month)
+  end
+
+end

data/lib/Month/last_month.rb

@@ -0,0 +1,13 @@
+# Month/last_month.rb
+# Month#last_month
+
+require 'Month/initialize'
+require 'Month/self.last_month'
+
+class Month
+
+  def last_month
+    Month.last_month(year, month)
+  end
+
+end

data/lib/Month/last_year.rb

@@ -0,0 +1,13 @@
+# Month/last_year.rb
+# Month#last_year
+
+require 'Month/Constants'
+require 'Month/initialize'
+
+class Month
+
+  def last_year
+    Month.new(self.year - 1, self.month)
+  end
+
+end

data/lib/Month/method_missing.rb

@@ -0,0 +1,21 @@
+# Month/method_missing.rb
+# Month#method_missing
+
+require 'Month/self.dates'
+
+class Month
+
+  def method_missing(method_name, *args, &block)
+    case method_name.to_s
+    when /^((m|M)o)|((m|M)on)(day|days)*$/; Month.dates(year, month, :day => 'Monday')
+    when /^((t|T)u)|((t|T)ue)(sday|sdays)*$/; Month.dates(year, month, :day => 'Tuesday')
+    when /^((w|W)e)|((w|W)ed)(nesday|nesdays)*$/; Month.dates(year, month, :day => 'Wednesday')
+    when /^((t|T)h)|((t|T)hu)(rsday|rsdays)*$/; Month.dates(year, month, :day => 'Thursday')
+    when /^((f|F)r)|((f|F)ri)(day|days)*$/; Month.dates(year, month, :day => 'Friday')
+    when /^((s|S)a)|((s|S)at)(urday|urdays)*$/; Month.dates(year, month, :day => 'Saturday')
+    when /^((s|S)u)|((s|S)un)(day|days)*$/; Month.dates(year, month, :day => 'Sunday')
+    else; super(method_name, *args, &block)
+    end
+  end
+
+end

data/lib/Month/minus.rb

@@ -0,0 +1,20 @@
+# Month/minus.rb
+# Month#minus
+
+require 'Month/initialize'
+
+class Month
+
+  def minus(subtracted_months)
+    subtracted_years, remaining_months = subtracted_months.divmod(12)
+    preliminary_year = self.year - subtracted_years
+    if self.month > remaining_months
+      year, month = preliminary_year, self.month - remaining_months
+    else
+      year, month = preliminary_year - 1, 12 - (remaining_months - self.month)
+    end
+    Month.new(year, month)
+  end
+  alias_method :-, :minus
+
+end

data/lib/Month/next.rb

@@ -0,0 +1,13 @@
+# Month/next.rb
+# Month#next
+
+require 'Month/initialize'
+require 'Month/self.next'
+
+class Month
+
+  def next
+    Month.next(year, month)
+  end
+
+end

data/lib/Month/next_month.rb

@@ -0,0 +1,13 @@
+# Month/next_month.rb
+# Month#next_month
+
+require 'Month/initialize'
+require 'Month/self.next_month'
+
+class Month
+
+  def next_month
+    Month.next_month(year, month)
+  end
+
+end

data/lib/Month/next_year.rb

@@ -0,0 +1,13 @@
+# Month/next_year.rb
+# Month#next_year
+
+require 'Month/Constants'
+require 'Month/initialize'
+
+class Month
+
+  def next_year
+    Month.new(self.year + 1, self.month)
+  end
+
+end

data/lib/Month/plus.rb

@@ -0,0 +1,16 @@
+# Month/plus.rb
+# Month#plus
+
+require 'Month/initialize'
+
+class Month
+
+  def plus(added_months)
+    added_years, remaining_months = added_months.divmod(12)
+    overflow_year, month = (self.month + remaining_months).divmod(12)
+    year = self.year + added_years + overflow_year
+    Month.new(year, month)
+  end
+  alias_method :+, :plus
+
+end

data/lib/Month/prev.rb

@@ -0,0 +1,13 @@
+# Month/prev.rb
+# Month#prev
+
+require 'Month/initialize'
+require 'Month/self.prev'
+
+class Month
+
+  def prev
+    Month.prev(year, month)
+  end
+
+end

data/lib/Month/prev_month.rb

@@ -0,0 +1,13 @@
+# Month/prev_month.rb
+# Month#prev_month
+
+require 'Month/initialize'
+require 'Month/self.prev_month'
+
+class Month
+
+  def prev_month
+    Month.prev_month(year, month)
+  end
+
+end