quarter 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ec19889b55f7693482a78ca92e13d9dc143a52dd22c7d1c97752343b95d3f70
-  data.tar.gz: 533c16ac28a0d94cc0f45cc760005661ab6f9c81edeec68195e277662103d6ba
+  metadata.gz: 43375d0c4b1028806f1a4e065d6da6b910b23e354377270125ac8953c629b15d
+  data.tar.gz: b40a713d14c5b278fe823571413117e7da417734d19fb5e522f6829e34a2ab79
 SHA512:
-  metadata.gz: 1ca11ce100186dc98c1274293fe883009b17273100047a64f678a33099c93b04d50dcd7d34150ab848816f72b6f77dd82194a5320e74c4e889fe4cdc7819dd7d
-  data.tar.gz: 85ac644ab0b7a8dea6d416adca67cc97e80f894b6e82a601ebb8b7dfed4522084cca3525de00a12007a1bd463e3a32f25427d72457d930e0556cdd881804360b
+  metadata.gz: d417b09e7c7aba1451fdbe4dd4c1c5672c5043622e8b076497e2c5af3d5e83aa7ec42efbbe36dd6a5a0dc04b91a8a02a4ac85c2d36145a80abae908db49212c8
+  data.tar.gz: 84932606227d90523473be6ee607b9c746211568b76e430f9b082c30270bb17931b5db6a10aa8cad5c03c15392b452b3b7e68de6338a3425c4adcbcc0841f1cd

data/README.md

@@ -34,3 +34,29 @@ p quarter.name
 p quarter.to_s
 p quarter.iso8601
 ```
+
+### Quarter::Methods
+
+Include the `Quarter::Methods` module for methods which can be used to get the quarter for a given year in a manner that resembles written english. For example:
+
+    include Quarter::Methods
+
+    q1 = Q1 2020
+
+### Quarter::Constants
+
+Include the `Quarter::Constants` module for constants which can be used to get the quarter for a given year in a manner that resembles written english. For example:
+
+    include Quarter::Constants
+
+    q1 = Q1/2020
+
+    q2 = 2020-Q2
+
+### YAML integration
+
+Require `quarter/yaml` for YAML integration which supports dumping and loading quarter objects to and from YAML as scalar values. For example:
+
+    require 'quarter/yaml'
+
+    puts YAML.dump([Quarter.now])

data/lib/quarter.rb

@@ -172,3 +172,54 @@ end
 def Quarter.now
   Quarter(Time.now)
 end
+
+module Quarter::Methods
+  def Q1(year)
+    Quarter.new(year, 1)
+  end
+
+  def Q2(year)
+    Quarter.new(year, 2)
+  end
+
+  def Q3(year)
+    Quarter.new(year, 3)
+  end
+
+  def Q4(year)
+    Quarter.new(year, 4)
+  end
+end
+
+class Quarter::Constant
+  def initialize(number)
+    @number = number
+  end
+
+  def -(other)
+    raise ArgumentError unless other.kind_of?(Integer)
+
+    Quarter.new(other, @number)
+  end
+
+  def /(other)
+    raise ArgumentError unless other.kind_of?(Integer)
+
+    Quarter.new(other, @number)
+  end
+
+  def coerce(other)
+    unless other.kind_of?(Integer)
+      raise TypeError, "#{self.class} can't be coerced with #{other.class}"
+    end
+
+    return self, other
+  end
+end
+
+module Quarter::Constants
+  Q1 = Quarter::Constant.new(1)
+  Q2 = Quarter::Constant.new(2)
+  Q3 = Quarter::Constant.new(3)
+  Q4 = Quarter::Constant.new(4)
+end

data/quarter.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name = 'quarter'
-  s.version = '1.1.0'
+  s.version = '1.2.0'
   s.license = 'LGPL-3.0'
   s.platform = Gem::Platform::RUBY
   s.authors = ['Tim Craft']

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quarter
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Tim Craft
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-06-23 00:00:00.000000000 Z
+date: 2020-10-13 00:00:00.000000000 Z
 dependencies: []
 description: Ruby gem for working with standard calendar quarters
 email:
@@ -45,7 +45,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.4
 signing_key:
 specification_version: 4
 summary: See description