month 1.2.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 99d3a1f9ba6751770d9a06df16bd73ee776a8726
-  data.tar.gz: 2939e754f6952365f4874ecf4cd6ae262975a723
+SHA256:
+  metadata.gz: dc374de89e555a551ec3e4f67ca198a4fd0103d9bc256068b892f2405a049a6a
+  data.tar.gz: 8cc382ea4e97c8bbd0f234fcdb8808db495ad4ed487fbe8acb1ce7585c03d4d6
 SHA512:
-  metadata.gz: c2e439bbb93bc6b10b0a7a0f0ead067c366660ecaa884c3a2eda73681f1ffa2032600b1964e6cc6fdb75b266f05d2065b7ab6f5a1e723de4179af7a4c82b8f11
-  data.tar.gz: 38a4336b1e7c8ad7c258241379a174e4b9538dd76b826e0c1399efbf8e0db7fb00acf9080875f12383e9445b6665f30c3edc07d4fec4b2fb5837981e21a1e70e
+  metadata.gz: 11816342dee7af3574b80824283675823d703232fe39d3170e3f3ad424073584a0f4a95bae6b2ee1218b164a9d845245c2f8fe2ab63043554d2093c00abc7279
+  data.tar.gz: 0327fe3d9a9df8ea2957b13e28e1670585241187510a6f047883c2d0e02caea0cbb7ecb05b19f118f333ae46fd3b55d4774e654f72c785fe6cf5493142108fd1

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright the authors and contributors. All rights reserved.
+Copyright (c) 2014-2020 TIMCRAFT
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

data/README.md

@@ -1,18 +1,24 @@
-month
-=====
+# month
 
+![Gem Version](https://badge.fury.io/rb/month.svg)
+![Build Status](https://github.com/readysteady/month/workflows/Test/badge.svg)
 
-A little Ruby library for working with months.
 
+Ruby gem for working with months.
 
-Installation
-------------
+
+## Install
+
+Using Bundler:
+
+    $ bundle add month
+
+Using RubyGems:
 
     $ gem install month
 
 
-Feature tour
-------------
+## Feature tour
 
 You can create a new Month object with a year and month number:
 
@@ -117,8 +123,7 @@ Month objects can be used in ranges.
 Month objects are comparable.
 
 
-Bonus Extras
-------------
+## Bonus extras
 
 The Month::Methods module provides methods for constructing Month objects
 and Date objects in a manner that closely resembles written english:
@@ -135,8 +140,7 @@ It is not included globally by default; you can either include it within
 your own modules/classes or globally within your own application/script.
 
 
-History
--------
+## Thanks
 
 This current implementation is an accidental rewrite of an older library/gem
 with the same name/purpose ([fhwang / month](https://github.com/fhwang/month)).

data/lib/month.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'date'
 
 class Month
@@ -17,19 +18,25 @@ class Month
   }
 
   def initialize(year, number)
-    unless NAMES.has_key?(number)
+    unless NAMES.key?(number)
       raise ArgumentError, 'invalid month number'
     end
 
     @year, @number = year, number
+
+    freeze
   end
 
   attr_reader :year, :number
 
+  alias_method :month, :number
+
   def to_s
     "#@year-#{@number.to_s.rjust(2, '0')}"
   end
 
+  alias_method :iso8601, :to_s
+
   def name
     NAMES.fetch(@number)
   end
@@ -49,6 +56,8 @@ class Month
   end
 
   def <=>(month)
+    return unless month.class == self.class
+
     if @year == month.year
       @number <=> month.number
     else
@@ -68,6 +77,18 @@ class Month
 
   alias_method :succ, :next
 
+  def >>(n)
+    self + n
+  end
+
+  alias_method :next_month, :>>
+
+  def <<(n)
+    self - n
+  end
+
+  alias_method :prev_month, :<<
+
   def step(limit, step = 1)
     raise ArgumentError if step.zero?
 
@@ -110,7 +131,7 @@ class Month
     if object.is_a?(Integer)
       self + (-object)
     else
-      (year * 12 + @number) - (object.year * 12 + object.number)
+      12 * (year - object.year) + (@number - object.number)
     end
   end
 
@@ -137,11 +158,17 @@ class Month
   end
 end
 
-def Month.parse(string)
-  if string =~ /\A(\d{4})-(\d{2})\z/
-    Month.new($1.to_i, $2.to_i)
-  else
-    raise ArgumentError, 'invalid month'
+class Month
+  REGEXP = /\A(\d{4})-(\d{2})\z/
+
+  private_constant :REGEXP
+
+  def self.parse(string)
+    if string =~ REGEXP
+      Month.new($1.to_i, $2.to_i)
+    else
+      raise ArgumentError, 'invalid month'
+    end
   end
 end
 
@@ -156,6 +183,14 @@ def Month(object)
   end
 end
 
+def Month.today
+  Month(Date.today)
+end
+
+def Month.now
+  Month(Time.now)
+end
+
 class Month
   module Methods
     NAMES.each do |number, name|

data/lib/month/yaml.rb

@@ -0,0 +1,23 @@
+require 'yaml'
+
+class Month
+  def encode_with(coder)
+    coder.represent_scalar(nil, to_s)
+  end
+
+  module ScalarScannerPatch
+    REGEXP = /\A(\d{4})-(\d{2})\z/
+
+    def tokenize(string)
+      if !string.empty? && string.match(REGEXP)
+        return Month.new($1.to_i, $2.to_i)
+      end
+
+      super string
+    end
+
+    YAML::ScalarScanner.prepend(self)
+  end
+
+  private_constant :ScalarScannerPatch
+end

data/month.gemspec

@@ -1,16 +1,20 @@
 Gem::Specification.new do |s|
   s.name = 'month'
-  s.version = '1.2.0'
+  s.version = '1.7.0'
   s.license = 'MIT'
   s.platform = Gem::Platform::RUBY
   s.authors = ['Tim Craft']
   s.email = ['mail@timcraft.com']
-  s.homepage = 'http://github.com/timcraft/month'
-  s.description = 'A little Ruby library for working with months'
+  s.homepage = 'https://github.com/readysteady/month'
+  s.description = 'Ruby gem for working with months'
   s.summary = 'See description'
-  s.files = Dir.glob('{lib,spec}/**/*') + %w(LICENSE.txt README.md month.gemspec)
+  s.files = Dir.glob('lib/**/*.rb') + %w(LICENSE.txt README.md month.gemspec)
   s.required_ruby_version = '>= 1.9.3'
-  s.add_development_dependency('rake', '~> 10.0')
-  s.add_development_dependency('minitest', '~> 5.0')
   s.require_path = 'lib'
+  s.metadata = {
+    'homepage' => 'https://github.com/readysteady/month',
+    'source_code_uri' => 'https://github.com/readysteady/month',
+    'bug_tracker_uri' => 'https://github.com/readysteady/month/issues',
+    'changelog_uri' => 'https://github.com/readysteady/month/blob/master/CHANGES.md'
+  }
 end

metadata

@@ -1,44 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: month
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Tim Craft
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-25 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-description: A little Ruby library for working with months
+date: 2020-06-10 00:00:00.000000000 Z
+dependencies: []
+description: Ruby gem for working with months
 email:
 - mail@timcraft.com
 executables: []
@@ -48,12 +20,16 @@ files:
 - LICENSE.txt
 - README.md
 - lib/month.rb
+- lib/month/yaml.rb
 - month.gemspec
-- spec/month_spec.rb
-homepage: http://github.com/timcraft/month
+homepage: https://github.com/readysteady/month
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage: https://github.com/readysteady/month
+  source_code_uri: https://github.com/readysteady/month
+  bug_tracker_uri: https://github.com/readysteady/month/issues
+  changelog_uri: https://github.com/readysteady/month/blob/master/CHANGES.md
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -69,8 +45,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: See description

data/spec/month_spec.rb

@@ -1,308 +0,0 @@
-require 'minitest/autorun'
-
-require_relative '../lib/month'
-
-describe 'Month' do
-  it 'raises an exception when initialized with an invalid number' do
-    proc { Month.new(2014, 0) }.must_raise(ArgumentError)
-    proc { Month.new(2014, 100) }.must_raise(ArgumentError)
-  end
-
-  describe 'year method' do
-    it 'returns the integer year of the month' do
-      Month.new(2014, 1).year.must_equal(2014)
-    end
-  end
-
-  describe 'number method' do
-    it 'returns the integer number of the month' do
-      Month.new(2014, 1).number.must_equal(1)
-    end
-  end
-
-  describe 'to_s method' do
-    it 'returns a string containing the year and zero padded number of the month' do
-      Month.new(2014, 1).to_s.must_equal('2014-01')
-    end
-  end
-
-  describe 'name method' do
-    it 'returns the name of the month' do
-      Month.new(2014, 1).name.must_equal(:January)
-    end
-  end
-
-  describe 'january predicate method' do
-    it 'returns true if the month is january' do
-      Month.new(2014, 1).january?.must_equal(true)
-    end
-
-    it 'returns false otherwise' do
-      Month.new(2014, 2).january?.must_equal(false)
-    end
-  end
-
-  describe 'february predicate method' do
-    it 'returns true if the month is february' do
-      Month.new(2014, 2).february?.must_equal(true)
-    end
-
-    it 'returns false otherwise' do
-      Month.new(2014, 1).february?.must_equal(false)
-    end
-  end
-
-  it 'supports being used as a hash key' do
-    hash, n = Hash.new(0), 10
-
-    n.times { hash[Month.new(2014, 1)] += 1 }
-
-    hash.count.must_equal(1)
-    hash[Month.new(2014, 1)].must_equal(n)
-  end
-
-  it 'supports comparison between month objects' do
-    Month.new(2014, 1).must_be_kind_of(Comparable)
-
-    (Month.new(2014, 1) == Month.new(2014, 1)).must_equal(true)
-    (Month.new(2014, 1) == Month.new(2014, 2)).must_equal(false)
-
-    (Month.new(2014, 1) < Month.new(2014, 2)).must_equal(true)
-    (Month.new(2014, 2) > Month.new(2014, 1)).must_equal(true)
-  end
-
-  it 'supports being used in a range' do
-    range = Month.new(2014, 1) .. Month.new(2014, 4)
-
-    range.map(&:number).must_equal([1, 2, 3, 4])
-  end
-
-  describe 'next method' do
-    it 'returns a month object denoting the next month' do
-      Month.new(2014, 1).next.must_equal(Month.new(2014, 2))
-      Month.new(2014, 12).next.must_equal(Month.new(2015, 1))
-    end
-  end
-
-  describe 'succ method' do
-    it 'returns a month object denoting the next month' do
-      Month.new(2014, 1).succ.must_equal(Month.new(2014, 2))
-      Month.new(2014, 12).succ.must_equal(Month.new(2015, 1))
-    end
-  end
-
-  describe 'step method' do
-    it 'calls the block for every month until the given limit' do
-      months = []
-
-      Month.new(2014, 1).step(Month.new(2014, 3)) { |month| months << month }
-
-      months.must_equal([Month.new(2014, 1), Month.new(2014, 2), Month.new(2014, 3)])
-    end
-
-    it 'returns an enumerator if no block was given' do
-      months = Month.new(2014, 1).step(Month.new(2014, 3))
-
-      months.must_be_instance_of(Enumerator)
-
-      months.next.must_equal(Month.new(2014, 1))
-      months.next.must_equal(Month.new(2014, 2))
-      months.next.must_equal(Month.new(2014, 3))
-    end
-
-    it 'raises an exception when the given step argument is zero' do
-      proc { Month.new(2014, 1).step(Month.new(2014, 3), 0) }.must_raise(ArgumentError)
-    end
-
-    it 'increases by the given number of months if the step argument is positive' do
-      months = []
-
-      Month.new(2014, 1).step(Month.new(2014, 3), 2) { |month| months << month }
-
-      months.must_equal([Month.new(2014, 1), Month.new(2014, 3)])
-    end
-
-    it 'decreases by the given number of months if the step argument is negative' do
-      months = []
-
-      Month.new(2014, 3).step(Month.new(2014, 1), -1) { |month| months << month }
-
-      months.must_equal([Month.new(2014, 3), Month.new(2014, 2), Month.new(2014, 1)])
-    end
-  end
-
-  describe 'upto method' do
-    it 'calls the block for every month until the given limit' do
-      months = []
-
-      Month.new(2014, 1).upto(Month.new(2014, 3)) { |month| months << month }
-
-      months.must_equal([Month.new(2014, 1), Month.new(2014, 2), Month.new(2014, 3)])
-    end
-
-    it 'returns an enumerator if no block was given' do
-      months = Month.new(2014, 1).upto(Month.new(2014, 3))
-
-      months.must_be_instance_of(Enumerator)
-
-      months.next.must_equal(Month.new(2014, 1))
-      months.next.must_equal(Month.new(2014, 2))
-      months.next.must_equal(Month.new(2014, 3))
-    end
-  end
-
-  describe 'downto method' do
-    it 'calls the block for every month until the given limit' do
-      months = []
-
-      Month.new(2014, 3).downto(Month.new(2014, 1)) { |month| months << month }
-
-      months.must_equal([Month.new(2014, 3), Month.new(2014, 2), Month.new(2014, 1)])
-    end
-
-    it 'returns an enumerator if no block was given' do
-      months = Month.new(2014, 3).downto(Month.new(2014, 1))
-
-      months.must_be_instance_of(Enumerator)
-
-      months.next.must_equal(Month.new(2014, 3))
-      months.next.must_equal(Month.new(2014, 2))
-      months.next.must_equal(Month.new(2014, 1))
-    end
-  end
-
-  describe 'addition' do
-    it 'returns a month object denoting the given number of months after self' do
-      (Month.new(2014, 1) + 1).must_equal(Month.new(2014, 2))
-      (Month.new(2014, 1) + 12).must_equal(Month.new(2015, 1))
-      (Month.new(2014, 1) + 18).must_equal(Month.new(2015, 7))
-      (Month.new(2013, 11) + 1).must_equal(Month.new(2013, 12))
-      (Month.new(2013, 11) + 2).must_equal(Month.new(2014, 1))
-    end
-  end
-
-  describe 'subtraction' do
-    it 'returns a month object denoting the given number of months before self' do
-      (Month.new(2014, 2) - 1).must_equal(Month.new(2014, 1))
-      (Month.new(2014, 1) - 1).must_equal(Month.new(2013, 12))
-      (Month.new(2014, 1) - 12).must_equal(Month.new(2013, 1))
-      (Month.new(2014, 1) - 18).must_equal(Month.new(2012, 7))
-      (Month.new(2013, 12) - 1).must_equal(Month.new(2013, 11))
-      (Month.new(2014, 1) - 2).must_equal(Month.new(2013, 11))
-    end
-
-    it 'returns the number of months between the given month and self' do
-      (Month.new(2014, 3) - Month.new(2014, 1)).must_equal(2)
-      (Month.new(2015, 1) - Month.new(2014, 1)).must_equal(12)
-      (Month.new(2077, 4) - Month.new(2070, 4)).must_equal(84)
-    end
-  end
-
-  describe 'include predicate method' do
-    it 'returns true if the month includes the given date' do
-      Month.new(2014, 1).include?(Date.new(2014, 1, 1)).must_equal(true)
-    end
-
-    it 'returns false otherwise' do
-      Month.new(2014, 1).include?(Date.new(2014, 2, 1)).must_equal(false)
-    end
-  end
-
-  describe 'case equals method' do
-    it 'returns true if the month includes the given date' do
-      (Month.new(2014, 1) === Date.new(2014, 1, 1)).must_equal(true)
-    end
-
-    it 'returns false otherwise' do
-      (Month.new(2014, 1) === Date.new(2014, 2, 1)).must_equal(false)
-    end
-  end
-
-  describe 'start_date method' do
-    it 'returns a date object denoting the first day of the month' do
-      Month.new(2014, 1).start_date.must_equal(Date.new(2014, 1, 1))
-    end
-  end
-
-  describe 'end_date method' do
-    it 'returns a date object denoting the last day of the month' do
-      Month.new(2014, 1).end_date.must_equal(Date.new(2014, 1, 31))
-    end
-  end
-
-  describe 'dates method' do
-    it 'returns the range of dates in the month' do
-      dates = Month.new(2014, 1).dates
-      dates.must_be_instance_of(Range)
-      dates.count.must_equal(31)
-      dates.all? { |date| Date === date }.must_equal(true)
-      dates.first.must_equal(Date.new(2014, 1, 1))
-      dates.last.must_equal(Date.new(2014, 1, 31))
-    end
-  end
-
-  describe 'length method' do
-    it 'returns the integer number of days in the month' do
-      Month.new(2014, 1).length.must_equal(31)
-      Month.new(2014, 2).length.must_equal(28)
-    end
-  end
-end
-
-describe 'Month parse method' do
-  it 'returns the month corresponding to the given string representation' do
-    Month.parse('2014-01').must_equal(Month.new(2014, 1))
-  end
-
-  it 'raises an exception if the format of the string is not as expected' do
-    proc { Month.parse('January 2014') }.must_raise(ArgumentError)
-  end
-end
-
-describe 'Month method' do
-  it 'returns the month of the given date object' do
-    Month(Date.new(2014, 1, 1)).must_equal(Month.new(2014, 1))
-  end
-
-  it 'returns the month of the given time object' do
-    Month(Time.at(1234567890)).must_equal(Month.new(2009, 2))
-  end
-
-  it 'returns the month of the given datetime object' do
-    Month(DateTime.parse('2001-02-03T04:05:06+07:00')).must_equal(Month.new(2001, 2))
-  end
-
-  it 'returns the month of the given integer unix timestamp' do
-    Month(1234567890).must_equal(Month.new(2009, 2))
-  end
-
-  it 'idempotently returns the given month' do
-    month = Month.new(2014, 1)
-
-    Month(month).object_id.must_equal(month.object_id)
-  end
-end
-
-describe 'A method defined in Month::Methods' do
-  include Month::Methods
-
-  it 'returns a month object denoting that month in the given year' do
-    month = January 2014
-    month.must_equal(Month.new(2014, 1))
-
-    month = February 2014
-    month.must_equal(Month.new(2014, 2))
-  end
-
-  it 'returns a date object when given two arguments' do
-    date = January 31, 2014
-    date.must_equal(Date.new(2014, 1, 31))
-
-    date = February 28, 2014
-    date.must_equal(Date.new(2014, 2, 28))
-  end
-
-  it 'raises an exception if given too many arguments' do
-    proc { January 1, 2, 3 }.must_raise(ArgumentError)
-  end
-end