monthra 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 79f9ae5a25b04063d065b65051723f3fb3c6089e
-  data.tar.gz: eb5bf8ab4909feaf28f58db683d9fc526cd8a14b
+  metadata.gz: 45b36b845fabde171c235d4bcd98632a5e211442
+  data.tar.gz: a9d8c944ccd9c056b8dd29c794c4ee4859ee708b
 SHA512:
-  metadata.gz: 5626175dc02710b9ec19d2aa5ecd61fdbb585be0bd1d5695255118c3f27f5d90ec7e0cbcf24854fcfa8931096337aa1439f8268328d7dc33c77c0262b6d68dd1
-  data.tar.gz: c37f7ea73922de51e647d12541b0ba0f908609d709039af0bb00d6d7cd7c8706ab25bac74b49d816b1fc1d2fb2a7df240563566a98de3ef65452365048c9f1c8
+  metadata.gz: 3e4302f0388ea41bb927bf6fcacdd550b6401ba5b1603d156f7b66bf2bbdd545cb671eba5ff174bc70ae7b0fc1e570a8b2c32bb964839fedf2711417eb8bbd97
+  data.tar.gz: 5ece4f757bd79d160de0ae5f7abb8d6e43f42820476645ddbff32739dfb97cc1a50838d3066eea3f42598fe86d6165ba515639028690a29bb86049ede16b58cb

data/lib/monthra.rb

@@ -1,5 +1,10 @@
-require "monthra/version"
+require 'date'
+require 'time'
+
+require 'monthra/monkey_patches.rb'
+require 'monthra/version'
 require 'monthra/month'
+require 'monthra/month_range'
 
 module Monthra
   # Your code goes here...

data/lib/monthra/monkey_patches.rb

@@ -0,0 +1,13 @@
+# Decided not to use refinements due to backwards compatibility issues with Jruby 1.7.  Sorry.
+
+class Date
+  def to_monthra_month
+    Monthra::Month.at(self)
+  end
+end
+
+class Time
+  def to_monthra_month
+    Monthra::Month.at(self)
+  end
+end

data/lib/monthra/month.rb

@@ -1,6 +1,3 @@
-require 'date'
-require 'time'
-
 module Monthra
   class Month
     include Comparable
@@ -41,6 +38,11 @@ module Monthra
       end
     end
 
+    # @return [Month] To Match the monkey patch in Date and Time
+    def to_monthra_month
+      self
+    end
+
     # @return [Fixnum] The year
     def year
       @year
@@ -80,8 +82,61 @@ module Monthra
       strfmonth("%Y-%m")
     end
 
+    # @param [Integer or Month] offset How much to add to the current month.
+    # @return [Month]
+    def +(offset)
+      offsets = month_year_offset(offset)
+
+      new_year = year + offsets[:year]
+      new_month = month + offsets[:month]
+      
+      if new_month > 12
+        new_month -= 12
+        new_year += 1
+      end
+
+      self.class.new(new_year, new_month)
+    end
+
+    # @param [Integer or Month] offset How much to subtract to the current month.
+    # @return [Month]
+    def -(offset)
+      offsets = month_year_offset(offset)
+
+      new_year = year - offsets[:year]
+      new_month = month - offsets[:month]
+
+      if new_month < 1
+        new_month += 12 # note there is no month 0
+        new_year -= 1
+      end
+      
+      self.class.new(new_year, new_month)
+    end
+
     private
 
+    # @param [Integer or Month] offset How much to add to the current month.  If a month
+    #   object is passed in, both the year and month values are considered.  If an integer is passed
+    #   in, it represents the number of months.
+    # @return [Hash] With :year and :month keys with offsets
+    def month_year_offset(offset)
+      if offset.is_a?(Integer)
+        year_offset = offset / 12
+        month_offset = offset % 12
+      elsif offset.is_a?(Month)
+        year_offset = offset.year
+        month_offset = offset.month
+      else
+        raise ArgumentError, "Unsupported data type, #{month_offset.class.name}"
+      end
+
+      return {
+        year: year_offset,
+        month: month_offset
+      }
+    end
+
     # if month > 12 or < -12 or == 0, raise exception
     # if the month < 0, then subtract that number from 12 and decrement the year
     # otherwise, just set the month and year

data/lib/monthra/month_range.rb

@@ -0,0 +1,69 @@
+module Monthra
+  class MonthRange
+    include Enumerable
+    attr_accessor :months
+
+    # Note that this method will return a range with <size> number of months.
+    # It will not return a range from <start month> to <start month + size>
+    # It will actually return a range from <start month> to <start month + size - 1> because
+    #   that will return a range with <size> elements.
+    #
+    # @param [Month/Date/Time] start_month The beginning of the range.  Needs to include a year and month
+    #   method to match the interface.
+    # @param [Integer] size The Number of months in the range
+    def self.months_after_start(start_month, size)
+      start_month = Month.at(start_month)
+      # the end date is inclusive so it needs to end one month before <size> to get the correct
+      # number of months
+      end_month = start_month + (size - 1)
+
+      self.new(start_month, end_month)
+    end
+
+    # @param [Month/Date/Time] start_month The beginning of the range.  Needs to include a year and 
+    #   month method to match the interface.
+    # @param [Month/Date/Time] end_month The end of the range.  Needs to include a year and month
+    #   method to match the interface.
+    def initialize(start_month, end_month)
+      start_month = Month.at(start_month)
+      end_month = Month.at(end_month)
+
+      if end_month < start_month
+        raise ArgumentError, "Start month must occur before the end month"
+      end
+
+      setup_months(start_month, end_month)
+    end
+
+    # Iterates over the months to meet the conditions of Enumerable
+    def each
+      months.each do |m|
+        yield(m)
+      end
+    end
+
+    # @return [Integer] Number of months in the range
+    def size
+      months.size
+    end
+
+    # @return [Month] The last month in the range
+    def last
+      months.last
+    end
+
+    private
+
+    # Creates the internal representation of the month range
+    #
+    # @param [Month] start_month
+    # @param [Month] end_month
+    def setup_months(start_month, end_month)
+      @months = []
+      while start_month <= end_month
+        @months << start_month
+        start_month += 1
+      end
+    end
+  end
+end

data/lib/monthra/version.rb

@@ -1,3 +1,3 @@
 module Monthra
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: monthra
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - jeremiah.hemphill@gmail.com
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2018-07-13 00:00:00.000000000 Z
+date: 2018-07-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -70,7 +70,9 @@ files:
 - bin/console
 - bin/setup
 - lib/monthra.rb
+- lib/monthra/monkey_patches.rb
 - lib/monthra/month.rb
+- lib/monthra/month_range.rb
 - lib/monthra/version.rb
 - monthra.gemspec
 homepage: https://github.com/jeremiahishere/monthra