month 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3f998e2e63d6369b8d84bfbfa5702e905ea7a902
-  data.tar.gz: eb30605ca6b103a606a74fe833f191d24847c37d
+  metadata.gz: 99d3a1f9ba6751770d9a06df16bd73ee776a8726
+  data.tar.gz: 2939e754f6952365f4874ecf4cd6ae262975a723
 SHA512:
-  metadata.gz: 8de438f976fd1e79aa70c61bc900d99658ba70abaf59e254b37e486bfcceb7b504376bf373a2a2679315a06ef694ab15f69e5168e2aa9a16ab98417c7e8288ed
-  data.tar.gz: dba1269a852a8d2a1974a931fd79f03d16dcb94ac9eb3d68b2d9e7ef54b6058b6b227f27c47af7b6a7311943f06e2e6cec993929fa83377517bab63360f18aa5
+  metadata.gz: c2e439bbb93bc6b10b0a7a0f0ead067c366660ecaa884c3a2eda73681f1ffa2032600b1964e6cc6fdb75b266f05d2065b7ab6f5a1e723de4179af7a4c82b8f11
+  data.tar.gz: 38a4336b1e7c8ad7c258241379a174e4b9538dd76b826e0c1399efbf8e0db7fb00acf9080875f12383e9445b6665f30c3edc07d4fec4b2fb5837981e21a1e70e

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright the authors and contributors. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -2,7 +2,7 @@ month
 =====
 
 
-A little library for working with months.
+A little Ruby library for working with months.
 
 
 Installation

data/lib/month.rb

@@ -68,20 +68,38 @@ class Month
 
   alias_method :succ, :next
 
-  def step(limit)
+  def step(limit, step = 1)
+    raise ArgumentError if step.zero?
+
     unless block_given?
-      return enum_for(:step, limit)
+      return enum_for(:step, limit, step)
     end
 
     month = self
 
-    until month > limit
-      yield month
+    if step > 0
+      until month > limit
+        yield month
 
-      month = month.succ
+        month += step
+      end
+    else
+      until month < limit
+        yield month
+
+        month += step
+      end
     end
   end
 
+  def upto(max, &block)
+    step(max, 1, &block)
+  end
+
+  def downto(min, &block)
+    step(min, -1, &block)
+  end
+
   def +(number)
     a, b = (@number - 1 + number).divmod(12)
 

data/month.gemspec

@@ -1,13 +1,14 @@
 Gem::Specification.new do |s|
   s.name = 'month'
-  s.version = '1.1.0'
+  s.version = '1.2.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 library for working with months'
+  s.description = 'A little Ruby library for working with months'
   s.summary = 'See description'
-  s.files = Dir.glob('{lib,spec}/**/*') + %w(README.md month.gemspec)
+  s.files = Dir.glob('{lib,spec}/**/*') + %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')

data/spec/month_spec.rb

@@ -109,6 +109,66 @@ describe 'Month' do
       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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: month
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Tim Craft
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-19 00:00:00.000000000 Z
+date: 2015-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -38,19 +38,21 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
-description: A little library for working with months
+description: A little Ruby library for working with months
 email:
 - mail@timcraft.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE.txt
 - README.md
 - lib/month.rb
 - month.gemspec
 - spec/month_spec.rb
 homepage: http://github.com/timcraft/month
-licenses: []
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []