tempora 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 459b4b52f06524a60b3a661aea7d7abdaff9893f92d1396b628e20003e26b985
-  data.tar.gz: 32bfd35efcbbb4342de00d19c1e08df914dcf85472ff576f745630d9d143d0dd
+  metadata.gz: df646739fb8d7d27a0bb3eed5a3981c668b300e7f105245cb340a233bf447a54
+  data.tar.gz: 45821e6f2200f5dc69838086ab76bcedfee33773bf7883dfd5fa82fb9a736195
 SHA512:
-  metadata.gz: b8eb1686ef5c168d8eb95a415012428e07703d2c531b8a424ab8fc4e2612f283c5295eb83a1fc00bb91d757e01262836a9cc9bfc1fcdc32f1a2ed30acebe8298
-  data.tar.gz: 6cdca41e418c828b85c31fb5140286b5585a49a776618d2d813bbd19a875d5c48657d80617a0de7d5da0420613fedeaf419d780c86a59acdc626bc56c545e8a5
+  metadata.gz: 3bce9a11d0bc1fedc9f975392c629ebe449a3ddae1ed50584941d0f3256d4b09729a69da168f7fed2cd04cd34d33457788a3cb00a511e9256687d25a51a76fc1
+  data.tar.gz: d44541c8c7894193804b6d1fce6adf731c8acfa14ffe2d528487f4c839d66e85d2a01992f7209184d1d9323f4fa32ebbcb79be05364b424f03999d4d0ec0eb4e

data/lib/_timespan.rb

@@ -0,0 +1,106 @@
+require 'date'
+
+class TimeSpan
+  include Comparable
+
+  attr_reader :start_date, :end_date
+
+  def initialize(start_date, end_date)
+    @start_date = TimeSpan.from_date_like(start_date)
+    @end_date = TimeSpan.from_date_like(end_date)
+
+    raise ArgumentError, "start_date must be before end_date" if @start_date > @end_date
+  end
+
+  def self.from_date_like(date_like)
+    if date_like.respond_to?(:year) && date_like.respond_to?(:month) && date_like.respond_to?(:day)
+      Date.new(date_like.year, date_like.month, date_like.day)
+    else
+      raise ArgumentError, "Invalid date-like object: #{date_like.inspect}"
+    end
+  end
+
+  def range
+    @start_date..@end_date
+  end
+
+  def duration
+    (@end_date - @start_date).to_i + 1
+  end
+
+  def overlaps?(other)
+    @start_date <= other.end_date && @end_date >= other.start_date
+  end
+
+  def contains?(date)
+    range.cover?(TimeSpan.from_date_like(date))
+  end
+
+  def shift(days)
+    TimeSpan.new(@start_date + days, @end_date + days)
+  end
+
+  def intersection(other)
+    return nil unless overlaps?(other)
+
+    new_start = [@start_date, other.start_date].max
+    new_end = [@end_date, other.end_date].min
+
+    TimeSpan.new(new_start, new_end)
+  end
+
+  def <=>(other)
+    start_date <=> other.start_date
+  end
+
+  def to_s
+    "#{@start_date} to #{@end_date} (#{duration} days)"
+  end
+end
+# 🔹 TimeSpan Class (For Any Date Range)
+#
+# This will handle custom periods, like fiscal years, school semesters, or project timelines.
+#
+# 🔹 How TimeSpan Works
+#
+# ✅ Define Any Custom Date Range
+# fiscal_year = TimeSpan.new(Date.new(2024, 4, 1), Date.new(2025, 3, 31))
+# puts fiscal_year.to_s
+# # => "2024-04-01 to 2025-03-31 (365 days)"
+# ✅ Check Overlaps
+# q2 = TimeSpan.new(Date.new(2024, 4, 1), Date.new(2024, 6, 30))
+# q3 = TimeSpan.new(Date.new(2024, 7, 1), Date.new(2024, 9, 30))
+# puts q2.overlaps?(q3)  # => false
+# ✅ Check If a Date Falls Within the Range
+# semester = TimeSpan.new(Date.new(2024, 8, 1), Date.new(2024, 12, 15))
+# puts semester.contains?(Date.new(2024, 9, 10))  # => true
+# puts semester.contains?(Date.new(2025, 1, 1))   # => false
+# ✅ Shift Date Ranges
+# event = TimeSpan.new(Date.new(2024, 6, 10), Date.new(2024, 6, 15))
+# puts event.shift(7).to_s
+# # => "2024-06-17 to 2024-06-22 (6 days)"
+# 
+# 🔹 Why TimeSpan is Useful
+#
+# ✅ Handles custom time ranges (fiscal years, semesters, event durations)
+# ✅ Works alongside Week, Month, Quarter, and Year
+# ✅ Supports overlapping checks and shifts
+#
+# 🔹 How intersection Works
+#
+# ✅ Two Overlapping Periods
+# t1 = TimeSpan.new(Date.new(2024, 3, 1), Date.new(2024, 3, 20))
+# t2 = TimeSpan.new(Date.new(2024, 3, 10), Date.new(2024, 3, 25))
+#
+# overlap = t1.intersection(t2)
+# puts overlap.to_s
+# # => "2024-03-10 to 2024-03-20 (11 days)"
+# ✅ No Overlap Returns nil
+# t3 = TimeSpan.new(Date.new(2024, 4, 1), Date.new(2024, 4, 10))
+# puts t1.intersection(t3)
+# # => nil
+# 🔹 Why intersection is Useful
+#
+# ✅ Find common time slots (e.g., two employees' available time)
+# ✅ Determine overlapping project phases
+# ✅ Works with any time period comparisons

data/lib/month.rb

@@ -42,6 +42,10 @@ class Month
     Week.from(start_date)..Week.from(end_date)
   end
   
+  def each_week(&block)
+    weeks.each(&block)
+  end
+  
   alias_method :month, :number
   alias_method :succ, :next
   alias_method :pred, :prev

data/lib/tempora/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tempora
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

data/lib/week.rb

@@ -7,12 +7,12 @@ class Week
     
   def initialize(year, week)
     @year   = Integer(year)
-    @number = Integer(week).clamp(1,52)
+    @number = Integer(week)
     
     @start_date = Date.commercial(@year, @number, 1)
     @end_date   = start_date + 6
   end
-  
+    
   def id(seperator="-")
     "#{year}#{seperator}W#{format('%02d', number)}"
   end
@@ -31,7 +31,7 @@ class Week
   
   alias_method :succ, :next
   alias_method :pred, :prev
-  
+    
   private
   
   def self.initialization_parameter(date)

data/lib/year.rb

@@ -37,6 +37,14 @@ class Year
   def weeks
     Week.from(start_date)..Week.from(end_date)
   end
+  
+  def each_month(&block)
+    months.each(&block)
+  end
+  
+  def each_week(&block)
+    weeks.each(&block)
+  end
 
   alias_method :succ, :next
   alias_method :pred, :prev

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tempora
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Max Power
@@ -20,6 +20,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- lib/_timespan.rb
 - lib/initialization.rb
 - lib/month.rb
 - lib/quarter.rb