active_date_range 0.4.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39f9a839e43c1880dc6316e99c40e0c07ad5fd18de9cf19658737eeb7e584d7a
-  data.tar.gz: 7d2827d72f24425b5ec13e2fe6a1783834e414da75f602a530bc3ff335842723
+  metadata.gz: fc26289633430de8df95f11a9f5daae40517b28bd84659aaef39b98a3af14fa7
+  data.tar.gz: effca528bd820224332d65ba526d71632cb8663d167817748392c78ca7118d24
 SHA512:
-  metadata.gz: b3754ca3eda22da5b853ad54643a1842f97606b15318c472da86ea379da540dd026d1c2de201d5d1b0838d9275e1e197df1ac0cd742f33885b1d6593bc145341
-  data.tar.gz: e4ccdd0cfbb3b39cb24b2f322ef2bf7be823793721f3bb00546f7054503649804f1045091d50b907b32fd75d410024bf5afbf801bf9190241f4cae811d1bfb19
+  metadata.gz: c9d483ffcb44834773674421bb5a4fce07b6256ce6629e724e3c4180db96ab048da817d7fa644575c0abe7591e9c893874965ed1db9d1d136e383738c3fd700f
+  data.tar.gz: 82e99bbd1690fdd21fe74ea824b7ef072d6ff1f2ca9b9b0ab673ce0050af7336fe17ffa2bf2a8cf14ba43d6b0d6031585a8eb30ce88de07788e5514b7a9b7246

data/CHANGELOG.md

@@ -1,3 +1,25 @@
+## 0.5.0
+
+* Add `size` and `length` methods that return an `ActiveSupport::Duration`, compatible with `validates_length_of`:
+
+```ruby
+validates_length_of :period, maximum: 10.years
+```
+
+  *Edwin Vlieg*
+
+* Add `cap_end` and `cap_begin` to limit a range to a given duration:
+
+```ruby
+DateRange.parse("202101..202512").cap_end(2.years)
+# => DateRange(2021-01-01..2022-12-31)
+
+DateRange.parse("202101..202512").cap_begin(2.years)
+# => DateRange(2024-01-01..2025-12-31)
+```
+
+  *Edwin Vlieg*
+
 ## 0.4.2
 
 * Add shorthand class methods for creating DateRanges:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    active_date_range (0.4.2)
+    active_date_range (0.5.0)
       activesupport (~> 8.0)
       i18n (~> 1.6)
 

data/lib/active_date_range/date_range.rb

@@ -134,6 +134,18 @@ module ActiveDateRange
       @days ||= (self.end - self.begin).to_i + 1
     end
 
+    # Returns the duration of the range as an ActiveSupport::Duration, compatible with
+    # validates_length_of. Use Duration values for the constraint:
+    #
+    #   validates_length_of :period, maximum: 10.years
+    #   validates_length_of :period, maximum: 6.months
+    #   validates_length_of :period, maximum: 30.days
+    def size
+      days&.days
+    end
+
+    alias :length :size
+
     # Returns the number of months in the range or nil when range is no full month
     def months
       return nil unless full_month?
@@ -441,6 +453,24 @@ module ActiveDateRange
       self.days > limit.in_days.ceil
     end
 
+    # Returns a new DateRange with the end date capped to the given duration from the begin date.
+    #
+    #   DateRange.parse("202101..202512").cap_end(2.years) # => DateRange(2021-01-01..2022-12-31)
+    def cap_end(duration)
+      return self if boundless? || !exceeds?(duration)
+
+      DateRange.new(self.begin, self.begin + duration - 1.day)
+    end
+
+    # Returns a new DateRange with the begin date capped to the given duration from the end date.
+    #
+    #   DateRange.parse("202101..202512").cap_begin(2.years) # => DateRange(2024-01-01..2025-12-31)
+    def cap_begin(duration)
+      return self if boundless? || !exceeds?(duration)
+
+      DateRange.new(self.end - duration + 1.day, self.end)
+    end
+
     private
       def grouped_collection(granularity, amount: 1)
         raise UnknownGranularity, "Unknown granularity #{granularity}. Valid are: month, quarter and year" unless %w[month quarter year].include?(granularity.to_s)

data/lib/active_date_range/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveDateRange
-  VERSION = "0.4.2"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: active_date_range
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.5.0
 platform: ruby
 authors:
 - Edwin Vlieg