active_date_range 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48f1d44d9e022c726c3432b029620448b87a87d031b4691f53ecd0b6df91c2f4
-  data.tar.gz: 8ab8a0b336c57512c0ec86ada1d78754f1a27aedd81e760e7c922a3184d75b37
+  metadata.gz: fc26289633430de8df95f11a9f5daae40517b28bd84659aaef39b98a3af14fa7
+  data.tar.gz: effca528bd820224332d65ba526d71632cb8663d167817748392c78ca7118d24
 SHA512:
-  metadata.gz: 88a50903fcc2658ac8dc33ef174e73c3e2e568f605cc09e356867f2a92eeaa69bd02d2372fec9e9ce3e3da8d3589640537def25e8d3056bf487cc9671c5eba68
-  data.tar.gz: b6cd444d1367f2a681642385b05d3ccaed7f6b5e806db1a2986b85831074c84e2508cf1ad675a6d556b5871d1d9b04f800f8afb96fa06210199eb280be3e1418
+  metadata.gz: c9d483ffcb44834773674421bb5a4fce07b6256ce6629e724e3c4180db96ab048da817d7fa644575c0abe7591e9c893874965ed1db9d1d136e383738c3fd700f
+  data.tar.gz: 82e99bbd1690fdd21fe74ea824b7ef072d6ff1f2ca9b9b0ab673ce0050af7336fe17ffa2bf2a8cf14ba43d6b0d6031585a8eb30ce88de07788e5514b7a9b7246

data/.gitignore

@@ -6,3 +6,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+.claude

data/CHANGELOG.md

@@ -1,3 +1,38 @@
+## 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:
+
+```ruby
+DateRange.year(2026)       # => DateRange(2026-01-01..2026-12-31)
+DateRange.quarter(2026, 4) # => DateRange(2026-10-01..2026-12-31)
+DateRange.month(2026, 1)   # => DateRange(2026-01-01..2026-01-31)
+DateRange.week(2026, 1)    # => DateRange for ISO week 1 of 2026
+```
+
+  *Edwin Vlieg*
+
 ## 0.4.1
 
 * Fix dependency issues in gemspec

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    active_date_range (0.4.0)
+    active_date_range (0.5.0)
       activesupport (~> 8.0)
       i18n (~> 1.6)
 
@@ -54,7 +54,6 @@ GEM
     erb (5.0.3)
     erubi (1.13.1)
     ffi (1.17.2)
-    ffi (1.17.2-x86_64-linux-gnu)
     formatador (1.2.1)
       reline
     guard (2.19.1)
@@ -98,8 +97,6 @@ GEM
     nokogiri (1.18.10)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    nokogiri (1.18.10-x86_64-linux-gnu)
-      racc (~> 1.4)
     notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)

data/lib/active_date_range/date_range.rb

@@ -64,6 +64,36 @@ module ActiveDateRange
       new(date, date + duration - 1.day)
     end
 
+    # Creates a DateRange for a full year.
+    #
+    #   DateRange.year(2026) # => DateRange(2026-01-01..2026-12-31)
+    def self.year(year)
+      new(Date.new(year, 1, 1).all_year)
+    end
+
+    # Creates a DateRange for a specific month.
+    #
+    #   DateRange.month(2026, 1) # => DateRange(2026-01-01..2026-01-31)
+    def self.month(year, month)
+      new(Date.new(year, month, 1).all_month)
+    end
+
+    # Creates a DateRange for a specific quarter (1-4).
+    #
+    #   DateRange.quarter(2026, 4) # => DateRange(2026-10-01..2026-12-31)
+    def self.quarter(year, quarter)
+      month = ((quarter - 1) * 3) + 1
+      new(Date.new(year, month, 1).all_quarter)
+    end
+
+    # Creates a DateRange for a specific ISO week.
+    #
+    #   DateRange.week(2026, 1) # => DateRange for ISO week 1 of 2026
+    def self.week(year, week)
+      date = Date.commercial(year, week, 1)
+      new(date.all_week)
+    end
+
     private_class_method :parse_date
 
     # Initializes a new DateRange. Accepts both a begin and end date or a range of dates.
@@ -104,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?
@@ -411,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.1"
+  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.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Edwin Vlieg