date_breakup 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21887235144f6659466a3e0d709417dab4bd9d9dd6f5686e036e01f8890d8e3d
-  data.tar.gz: 7842cf3953652600cd749bd8a1b212d4967476f0aade5899dba0100ddb642ed2
+  metadata.gz: b0b112a6229d63cd8d490c5309d553c488533a819b09874b8f8019bf1c60f867
+  data.tar.gz: 57286315af767547d74f7efa1d346fbfb4785593a3d3eb47e7a35ebc2f7ccd8d
 SHA512:
-  metadata.gz: 1b964d8d15cb315b57fef5109c2c013fdfbfe0f740d09eea092152ae02b29bda6dffb852cd77138d462ad99b3b9105f23b7b3e759119078ae5014d5e03045a87
-  data.tar.gz: 37aaf14964872d38432d51135915065913224db2f82d9e813946b5bccfafaf4b8fbbe29d720d641ebd23b0fc77b889bf9f36c9169d5d6483e21038d1d5715b55
+  metadata.gz: f9d67f0444647971676cbfb76d2bce7ac11d4fd1dea4516d330bcf415a7b4384a94db13beb83571321947979c62ff349f21a283610f4dbf22ff530a78abbf0f1
+  data.tar.gz: 2124f3c66ce6f2bbdbe8bf4cb27554f9c9af746e78403c3c14fa45b23533ee398d3fd762adff3bd3fa8aeff94c1058bfdea193719b48e748408fd6d97007a132

data/.claude/settings.json

@@ -0,0 +1,23 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(git rev-parse --show-toplevel)\" && file=$(jq -r '.tool_input.file_path // \"\"') && if echo \"$file\" | grep -qE '\\.rb$'; then bundle exec rubocop \"$file\" --format simple --no-color 2>/dev/null; fi",
+            "timeout": 30,
+            "statusMessage": "Running RuboCop..."
+          },
+          {
+            "type": "command",
+            "command": "cd \"$(git rev-parse --show-toplevel)\" && bundle exec rspec --format progress --no-color 2>/dev/null",
+            "timeout": 60,
+            "statusMessage": "Running tests..."
+          }
+        ]
+      }
+    ]
+  }
+}

data/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: ['3.3']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rspec
+      - run: bundle exec rubocop

data/.gitignore

@@ -11,4 +11,7 @@
 .rspec_status
 
 *.gem
-*.DS_STORE
+*.DS_STORE
+
+# Claude Code personal overrides (machine-specific)
+.claude/settings.local.json

data/.mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "3.3"

data/.rubocop.yml

@@ -0,0 +1,29 @@
+AllCops:
+  NewCops: disable
+  TargetRubyVersion: 3.3
+  SuggestExtensions: false
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/MethodLength:
+  Max: 30
+
+Metrics/AbcSize:
+  Max: 40
+
+Metrics/CyclomaticComplexity:
+  Max: 12
+
+Metrics/PerceivedComplexity:
+  Max: 13
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - '*.gemspec'
+
+Layout/LineLength:
+  Max: 120
+  Exclude:
+    - 'spec/**/*'

data/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.1.0] - 2026-05-10
+
+### Added
+- `.between` now accepts `Date` and `Time` objects in addition to date strings.
+- `ArgumentError` raised when `start_date` is after `end_date` (previously returned silently empty results).
+- GitHub Actions CI replacing Travis CI.
+- `.mise.toml` to pin Ruby version for consistent local development.
+- RuboCop added as a development dependency with a project `.rubocop.yml`.
+
+### Changed
+- Replaced `define_method` metaprogramming loop with four explicit public methods (`in_years`, `in_months`, `in_weeks`, `in_days`) backed by a shared private `build_breakdown` method. No change to public API behaviour.
+- All result arrays are now method-local variables — calling any `in_*` method twice on the same instance no longer returns duplicated data.
+- `frozen_string_literal: true` added to all Ruby files.
+- Bundler constraint relaxed from `~> 2.2` to `~> 2.0`.
+
+### Removed
+- Runtime dependency on `time_difference` and implicit dependency on ActiveSupport — replaced with pure stdlib `Date` arithmetic. The gem now has zero runtime dependencies.
+
+### Fixed
+- `bundle install` previously failed because `time_difference` was required in `lib/date_breakup.rb` but never declared as a dependency.
+
+## [3.0.1] - 2021-10-01
+
+### Changed
+- Dependency bump: `date` gem updated to `3.2.1`.
+
+## [3.0.0] - 2021-09-01
+
+### Changed
+- Class renamed from `DateBreakup::Range` to `DateBreakup`.
+- Methods renamed: `get_years` → `in_years`, `get_months` → `in_months`, `get_weeks` → `in_weeks`, `get_days` → `in_days`.
+- Internal code generation made dynamic via `define_method`.
+
+## [1.0.0] - 2019-01-01
+
+### Added
+- Initial release. `DateBreakup::Range.between` with `get_years`, `get_months`, `get_weeks`, `get_days`.

data/CLAUDE.md

@@ -0,0 +1,39 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+# Install dependencies
+bin/setup
+
+# Run all tests
+bundle exec rake spec
+# or
+bundle exec rspec
+
+# Run a single spec file
+bundle exec rspec spec/date_breakup_spec.rb
+
+# Interactive console (loads the gem)
+bin/console
+
+# Install gem locally
+bundle exec rake install
+
+# Release gem (bumps version tag, pushes to RubyGems)
+bundle exec rake release
+```
+
+## Architecture
+
+This is a single-file Ruby gem (`lib/date_breakup.rb`). The entire logic lives in the `DateBreakup` class.
+
+**Entry point:** `DateBreakup.between(start_date, end_date)` — accepts `Date`, `Time`, or date strings; returns a `DateBreakup` instance. Raises `ArgumentError` if start is after end.
+
+**Core pattern:** The four public methods (`in_years`, `in_months`, `in_weeks`, `in_days`) are all generated dynamically via `define_method` in a single `%w[years months weeks days].each` loop. Each method walks day-by-day from `@start_date` to `@end_date`, greedily consuming the largest possible unit (year > month > week > day) at each step. The `unit` variable in the loop controls which units are eligible — `in_days` only ever appends to `days`; `in_weeks` can use weeks and days; `in_months` can use months, weeks, and days; `in_years` can use all four.
+
+**Return shape:** All four methods return the same hash `{ years: [], months: [], weeks: [], days: [] }` — higher-granularity methods simply leave the coarser arrays empty.
+
+**Dependencies:** Zero runtime dependencies — uses only stdlib `require 'date'`.

data/Gemfile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }

data/Gemfile.lock

@@ -1,20 +1,30 @@
 PATH
   remote: .
   specs:
-    date_breakup (3.0.1)
-      date (~> 3.1, >= 3.1.1)
+    date_breakup (3.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    ast (2.4.3)
     coderay (1.1.3)
-    date (3.1.1)
     diff-lcs (1.4.4)
+    json (2.19.5)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
     method_source (1.0.0)
+    parallel (2.1.0)
+    parser (3.3.11.1)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
     pry (0.14.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
     rake (13.0.3)
+    regexp_parser (2.12.0)
     rspec (3.10.0)
       rspec-core (~> 3.10.0)
       rspec-expectations (~> 3.10.0)
@@ -28,16 +38,37 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.10.0)
     rspec-support (3.10.2)
+    rubocop (1.86.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
 
 PLATFORMS
+  arm64-darwin-23
   x86_64-darwin-20
+  x86_64-linux
 
 DEPENDENCIES
-  bundler (~> 2.2, >= 2.2.20)
+  bundler (~> 2.0)
   date_breakup!
   pry (~> 0.14.1)
   rake (~> 13.0, >= 13.0.3)
   rspec (~> 3.10)
+  rubocop (~> 1.65)
 
 BUNDLED WITH
-   2.2.20
+   2.7.2

data/README.md

@@ -1,10 +1,6 @@
 # DateBreakup
-VERSION 3 is Live Now.
 
-What's New?
-- The code to generate data has been cleaned and made dynamic.
-- Dependencies has been updated.
-- The class name has changed and methods too. (Please refer the examples below)
+Pass two dates and get a breakdown of the range grouped into years, months, weeks, and days. Accepts `Date`, `Time`, or date strings.
 
 ## Installation
 
@@ -14,163 +10,137 @@ Add this line to your application's Gemfile:
 gem 'date_breakup'
 ```
 
-And then execute:
+Then run:
 
-    $ bundle install
+```sh
+bundle install
+```
 
-Or install it yourself as:
+Or install directly:
 
-    $ gem install date_breakup
+```sh
+gem install date_breakup
+```
 
 ## Usage
 
-### Pass in 2 Date(String) & get a breakup of dates in years, months, weeks & days
+All four methods return the same hash shape — `{ years:, months:, weeks:, days: }` — with coarser arrays left empty depending on the method used.
+
+`.between` accepts `Date`, `Time`, or a date string:
+
+```ruby
+DateBreakup.between(Date.new(2019, 1, 1), Date.new(2019, 12, 31))
+DateBreakup.between(Time.new(2019, 1, 1), Time.new(2019, 12, 31))
+DateBreakup.between('01/01/2019', '31/12/2019')
+```
+
+Passing a start date after the end date raises `ArgumentError`.
+
+### `in_years` — greedy breakdown from years down
 
-#### FOR YEARS (BREAKUP in YEARS, MONTHS, WEEKS, DAYS)
 ```ruby
-# Was: DateBreakup::Range.between('01/01/2019', '31/12/2019').get_years
 DateBreakup.between('01/01/2019', '31/12/2019').in_years
-=> {
-    :years=>[
-      {:year=>2019, :start_date=>Sat, 01 Jan 2019, :end_date=>Sat, 31 Dec 2019}
-    ],
-    :months=>[],
-    :weeks=>[],
-    :days=>[]
-  }
+# => {
+#   years:  [{ year: 2019, start_date: Sat 01 Jan 2019, end_date: Sat 31 Dec 2019 }],
+#   months: [],
+#   weeks:  [],
+#   days:   []
+# }
 ```
 
-#### FOR MONTHS (BREAKUP in MONTHS, WEEKS, DAYS)
+For a range that doesn't align to full years, the remainder falls through to months, weeks, and days:
+
 ```ruby
-# Was: DateBreakup::Range.between('01/01/2019', '31/12/2019').get_months
-DateBreakup.between('01/01/2019', '31/12/2019').in_months
-=> {
-    :years=>[],
-    :months=>[
-      {:month=>1, :year=>2019, :start_date=>Tue, 01 Jan 2019, :end_date=>Thu, 31 Jan 2019},
-      {:month=>2, :year=>2019, :start_date=>Fri, 01 Feb 2019, :end_date=>Thu, 28 Feb 2019},
-      {:month=>3, :year=>2019, :start_date=>Fri, 01 Mar 2019, :end_date=>Sun, 31 Mar 2019},
-      {:month=>4, :year=>2019, :start_date=>Mon, 01 Apr 2019, :end_date=>Tue, 30 Apr 2019},
-      {:month=>5, :year=>2019, :start_date=>Wed, 01 May 2019, :end_date=>Fri, 31 May 2019},
-      {:month=>6, :year=>2019, :start_date=>Sat, 01 Jun 2019, :end_date=>Sun, 30 Jun 2019},
-      {:month=>7, :year=>2019, :start_date=>Mon, 01 Jul 2019, :end_date=>Wed, 31 Jul 2019},
-      {:month=>8, :year=>2019, :start_date=>Thu, 01 Aug 2019, :end_date=>Sat, 31 Aug 2019},
-      {:month=>9, :year=>2019, :start_date=>Sun, 01 Sep 2019, :end_date=>Mon, 30 Sep 2019},
-      {:month=>10, :year=>2019, :start_date=>Tue, 01 Oct 2019, :end_date=>Thu, 31 Oct 2019},
-      {:month=>11, :year=>2019, :start_date=>Fri, 01 Nov 2019, :end_date=>Sat, 30 Nov 2019},
-      {:month=>12, :year=>2019, :start_date=>Sun, 01 Dec 2019, :end_date=>Tue, 31 Dec 2019}
-    ],
-    :weeks=>[],
-    :days=>[]
-  }
+DateBreakup.between('10/10/2010', '12/12/2012').in_years
+# => {
+#   years:  [{ year: 2011, start_date: Sat 01 Jan 2011, end_date: Sat 31 Dec 2011 }],
+#   months: [
+#     { month: 11, year: 2010, start_date: Mon 01 Nov 2010, end_date: Tue 30 Nov 2010 },
+#     { month: 12, year: 2010, start_date: Wed 01 Dec 2010, end_date: Fri 31 Dec 2010 },
+#     ...
+#   ],
+#   weeks:  [{ week: 41, month: 10, year: 2010, start_date: Mon 11 Oct 2010, end_date: Sun 17 Oct 2010 }, ...],
+#   days:   [{ day: 283, month_day: 10, month: 10, year: 2010, start_date: Sun 10 Oct 2010, end_date: Sun 10 Oct 2010 }, ...]
+# }
 ```
-#### FOR WEEKS (BREAKUP in WEEKS, DAYS)
+
+### `in_months` — greedy breakdown from months down
+
 ```ruby
-# Was: DateBreakup::Range.between('01/01/2019', '31/12/2019').get_weeks
-DateBreakup.between('01/01/2019', '31/12/2019').in_weeks
-=> {
-    :years=>[],
-    :months=>[],
-    :weeks=>[
-      {:week=>2, :month=>1, :year=>2019, :start_date=>Mon, 07 Jan 2019, :end_date=>Sun, 13 Jan 2019},
-      {:week=>3, :month=>1, :year=>2019, :start_date=>Mon, 14 Jan 2019, :end_date=>Sun, 20 Jan 2019},
-      {:week=>4, :month=>1, :year=>2019, :start_date=>Mon, 21 Jan 2019, :end_date=>Sun, 27 Jan 2019},
-      {:week=>5, :month=>1, :year=>2019, :start_date=>Mon, 28 Jan 2019, :end_date=>Sun, 03 Feb 2019},
-      {:week=>6, :month=>2, :year=>2019, :start_date=>Mon, 04 Feb 2019, :end_date=>Sun, 10 Feb 2019},
-      {:week=>7, :month=>2, :year=>2019, :start_date=>Mon, 11 Feb 2019, :end_date=>Sun, 17 Feb 2019},
-      {:week=>8, :month=>2, :year=>2019, :start_date=>Mon, 18 Feb 2019, :end_date=>Sun, 24 Feb 2019},
-      {:week=>9, :month=>2, :year=>2019, :start_date=>Mon, 25 Feb 2019, :end_date=>Sun, 03 Mar 2019},
-      {:week=>10, :month=>3, :year=>2019, :start_date=>Mon, 04 Mar 2019, :end_date=>Sun, 10 Mar 2019},
-      ...
-      {:week=>43, :month=>10, :year=>2019, :start_date=>Mon, 21 Oct 2019, :end_date=>Sun, 27 Oct 2019},
-      {:week=>44, :month=>10, :year=>2019, :start_date=>Mon, 28 Oct 2019, :end_date=>Sun, 03 Nov 2019},
-      {:week=>45, :month=>11, :year=>2019, :start_date=>Mon, 04 Nov 2019, :end_date=>Sun, 10 Nov 2019},
-      {:week=>46, :month=>11, :year=>2019, :start_date=>Mon, 11 Nov 2019, :end_date=>Sun, 17 Nov 2019},
-      {:week=>47, :month=>11, :year=>2019, :start_date=>Mon, 18 Nov 2019, :end_date=>Sun, 24 Nov 2019},
-      {:week=>48, :month=>11, :year=>2019, :start_date=>Mon, 25 Nov 2019, :end_date=>Sun, 01 Dec 2019},
-      {:week=>49, :month=>12, :year=>2019, :start_date=>Mon, 02 Dec 2019, :end_date=>Sun, 08 Dec 2019},
-      {:week=>50, :month=>12, :year=>2019, :start_date=>Mon, 09 Dec 2019, :end_date=>Sun, 15 Dec 2019},
-      {:week=>51, :month=>12, :year=>2019, :start_date=>Mon, 16 Dec 2019, :end_date=>Sun, 22 Dec 2019},
-      {:week=>52, :month=>12, :year=>2019, :start_date=>Mon, 23 Dec 2019, :end_date=>Sun, 29 Dec 2019}
-    ],
-    :days=>[
-      {:day=>1, :month_day=>1, :month=>1, :year=>2019, :start_date=>Tue, 01 Jan 2019, :end_date=>Tue, 01 Jan 2019},
-      {:day=>2, :month_day=>2, :month=>1, :year=>2019, :start_date=>Wed, 02 Jan 2019, :end_date=>Wed, 02 Jan 2019},
-      {:day=>3, :month_day=>3, :month=>1, :year=>2019, :start_date=>Thu, 03 Jan 2019, :end_date=>Thu, 03 Jan 2019},
-      {:day=>4, :month_day=>4, :month=>1, :year=>2019, :start_date=>Fri, 04 Jan 2019, :end_date=>Fri, 04 Jan 2019},
-      {:day=>5, :month_day=>5, :month=>1, :year=>2019, :start_date=>Sat, 05 Jan 2019, :end_date=>Sat, 05 Jan 2019},
-      {:day=>6, :month_day=>6, :month=>1, :year=>2019, :start_date=>Sun, 06 Jan 2019, :end_date=>Sun, 06 Jan 2019},
-      {:day=>364, :month_day=>30, :month=>12, :year=>2019, :start_date=>Mon, 30 Dec 2019, :end_date=>Mon, 30 Dec 2019},
-      {:day=>365, :month_day=>31, :month=>12, :year=>2019, :start_date=>Tue, 31 Dec 2019, :end_date=>Tue, 31 Dec 2019}
-    ]
-  }
+DateBreakup.between('01/01/2019', '31/12/2019').in_months
+# => {
+#   years:  [],
+#   months: [
+#     { month: 1,  year: 2019, start_date: Tue 01 Jan 2019, end_date: Thu 31 Jan 2019 },
+#     { month: 2,  year: 2019, start_date: Fri 01 Feb 2019, end_date: Thu 28 Feb 2019 },
+#     ...
+#     { month: 12, year: 2019, start_date: Sun 01 Dec 2019, end_date: Tue 31 Dec 2019 }
+#   ],
+#   weeks:  [],
+#   days:   []
+# }
 ```
-#### FOR DAYS (BREAKUP in DAYS)
+
+### `in_weeks` — greedy breakdown from weeks down
+
+Partial weeks at the start or end of the range fall through to individual days.
+
 ```ruby
-# Was: DateBreakup::Range.between('01/01/2019', '31/12/2019').get_days
-DateBreakup.between('01/01/2019', '31/12/2019').in_days
-=> {
-    :years=>[],
-    :months=>[],
-    :weeks=>[],
-    :days=>[
-      {:day=>1, :month_day=>1, :month=>1, :year=>2019, :start_date=>Tue, 01 Jan 2019, :end_date=>Tue, 01 Jan 2019},
-      {:day=>2, :month_day=>2, :month=>1, :year=>2019, :start_date=>Wed, 02 Jan 2019, :end_date=>Wed, 02 Jan 2019},
-      {:day=>3, :month_day=>3, :month=>1, :year=>2019, :start_date=>Thu, 03 Jan 2019, :end_date=>Thu, 03 Jan 2019},
-      {:day=>4, :month_day=>4, :month=>1, :year=>2019, :start_date=>Fri, 04 Jan 2019, :end_date=>Fri, 04 Jan 2019},
-      {:day=>5, :month_day=>5, :month=>1, :year=>2019, :start_date=>Sat, 05 Jan 2019, :end_date=>Sat, 05 Jan 2019},
-      {:day=>6, :month_day=>6, :month=>1, :year=>2019, :start_date=>Sun, 06 Jan 2019, :end_date=>Sun, 06 Jan 2019},
-      ...
-      {:day=>364, :month_day=>30, :month=>12, :year=>2019, :start_date=>Mon, 30 Dec 2019, :end_date=>Mon, 30 Dec 2019},
-      {:day=>365, :month_day=>31, :month=>12, :year=>2019, :start_date=>Tue, 31 Dec 2019, :end_date=>Tue, 31 Dec 2019}
-    ]
-  }
+DateBreakup.between('01/01/2019', '31/12/2019').in_weeks
+# => {
+#   years:  [],
+#   months: [],
+#   weeks: [
+#     { week: 2, month: 1, year: 2019, start_date: Mon 07 Jan 2019, end_date: Sun 13 Jan 2019 },
+#     ...
+#     { week: 52, month: 12, year: 2019, start_date: Mon 23 Dec 2019, end_date: Sun 29 Dec 2019 }
+#   ],
+#   days: [
+#     { day: 1, month_day: 1, month: 1, year: 2019, start_date: Tue 01 Jan 2019, end_date: Tue 01 Jan 2019 },
+#     ...
+#   ]
+# }
 ```
 
-### More Further Apart Dates
+### `in_days` — every day individually
 
 ```ruby
-# Was: DateBreakup::Range.between('10/10/2010', '12/12/2012').get_years
-DateBreakup.between('10/10/2010', '12/12/2012').in_years
-=> {
-    :years=>[
-      {:year=>2011, :start_date=>Sat, 01 Jan 2011, :end_date=>Sat, 31 Dec 2011}
-    ],
-    :months=>[
-      {:month=>11, :year=>2010, :start_date=>Mon, 01 Nov 2010, :end_date=>Tue, 30 Nov 2010},
-      {:month=>12, :year=>2010, :start_date=>Wed, 01 Dec 2010, :end_date=>Fri, 31 Dec 2010},
-      {:month=>1, :year=>2012, :start_date=>Sun, 01 Jan 2012, :end_date=>Tue, 31 Jan 2012},
-      {:month=>2, :year=>2012, :start_date=>Wed, 01 Feb 2012, :end_date=>Wed, 29 Feb 2012},
-      {:month=>3, :year=>2012, :start_date=>Thu, 01 Mar 2012, :end_date=>Sat, 31 Mar 2012},
-      {:month=>4, :year=>2012, :start_date=>Sun, 01 Apr 2012, :end_date=>Mon, 30 Apr 2012},
-      {:month=>5, :year=>2012, :start_date=>Tue, 01 May 2012, :end_date=>Thu, 31 May 2012},
-      {:month=>6, :year=>2012, :start_date=>Fri, 01 Jun 2012, :end_date=>Sat, 30 Jun 2012},
-      {:month=>7, :year=>2012, :start_date=>Sun, 01 Jul 2012, :end_date=>Tue, 31 Jul 2012},
-      {:month=>8, :year=>2012, :start_date=>Wed, 01 Aug 2012, :end_date=>Fri, 31 Aug 2012},
-      {:month=>9, :year=>2012, :start_date=>Sat, 01 Sep 2012, :end_date=>Sun, 30 Sep 2012},
-      {:month=>10, :year=>2012, :start_date=>Mon, 01 Oct 2012, :end_date=>Wed, 31 Oct 2012},
-      {:month=>11, :year=>2012, :start_date=>Thu, 01 Nov 2012, :end_date=>Fri, 30 Nov 2012}],
-    :weeks=>[
-      {:week=>41, :month=>10, :year=>2010, :start_date=>Mon, 11 Oct 2010, :end_date=>Sun, 17 Oct 2010},
-      {:week=>42, :month=>10, :year=>2010, :start_date=>Mon, 18 Oct 2010, :end_date=>Sun, 24 Oct 2010},
-      {:week=>43, :month=>10, :year=>2010, :start_date=>Mon, 25 Oct 2010, :end_date=>Sun, 31 Oct 2010},
-      {:week=>49, :month=>12, :year=>2012, :start_date=>Mon, 03 Dec 2012, :end_date=>Sun, 09 Dec 2012}],
-    :days=>[
-      {:day=>283, :month_day=>10, :month=>10, :year=>2010, :start_date=>Sun, 10 Oct 2010, :end_date=>Sun, 10 Oct 2010},
-      {:day=>336, :month_day=>1, :month=>12, :year=>2012, :start_date=>Sat, 01 Dec 2012, :end_date=>Sat, 01 Dec 2012},
-      {:day=>337, :month_day=>2, :month=>12, :year=>2012, :start_date=>Sun, 02 Dec 2012, :end_date=>Sun, 02 Dec 2012},
-      {:day=>345, :month_day=>10, :month=>12, :year=>2012, :start_date=>Mon, 10 Dec 2012, :end_date=>Mon, 10 Dec 2012},
-      {:day=>346, :month_day=>11, :month=>12, :year=>2012, :start_date=>Tue, 11 Dec 2012, :end_date=>Tue, 11 Dec 2012},
-      {:day=>347, :month_day=>12, :month=>12, :year=>2012, :start_date=>Wed, 12 Dec 2012, :end_date=>Wed, 12 Dec 2012}
-    ]
-  }
+DateBreakup.between('01/01/2019', '03/01/2019').in_days
+# => {
+#   years:  [],
+#   months: [],
+#   weeks:  [],
+#   days: [
+#     { day: 1, month_day: 1, month: 1, year: 2019, start_date: Tue 01 Jan 2019, end_date: Tue 01 Jan 2019 },
+#     { day: 2, month_day: 2, month: 1, year: 2019, start_date: Wed 02 Jan 2019, end_date: Wed 02 Jan 2019 },
+#     { day: 3, month_day: 3, month: 1, year: 2019, start_date: Thu 03 Jan 2019, end_date: Thu 03 Jan 2019 }
+#   ]
+# }
 ```
 
-<!-- ## Development
+## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+This project uses [mise](https://mise.jdx.dev) to manage the Ruby version.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org). -->
+```sh
+# Install the required Ruby version
+mise install
+
+# Install dependencies
+bin/setup
+
+# Run tests
+bundle exec rspec
+
+# Run a single spec file
+bundle exec rspec spec/date_breakup_spec.rb
+
+# Open an interactive console with the gem loaded
+bin/console
+
+# Install the gem locally
+bundle exec rake install
+```
 
 ## Contributing
 

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 

data/bin/console

@@ -1,14 +1,8 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'bundler/setup'
 require 'date_breakup'
+require 'pry'
 
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require 'irb'
-IRB.start(__FILE__)
+Pry.start

data/date_breakup.gemspec

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'date_breakup'
@@ -6,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.name          = 'date_breakup'
   spec.version       = DateBreakup::VERSION
   spec.authors       = ['Huzaifa Saifuddin']
-  spec.email         = ['Huzaifa@Huzaifas-MacBook-Pro.local']
+  spec.email         = ['huzaifasp18@gmail.com']
 
   spec.summary       = 'Feed in 2 dates and get a breakup of dates grouped in years, months, weeks & days'
   spec.description   = 'Feed in 2 dates and get a breakup of dates grouped in years, months, weeks & days'
@@ -30,11 +32,11 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
+  spec.required_ruby_version = '>= 3.3'
 
-  spec.add_development_dependency 'bundler', '~> 2.2', '>= 2.2.20'
+  spec.add_development_dependency 'bundler', '~> 2.0'
   spec.add_development_dependency 'pry', '~> 0.14.1'
   spec.add_development_dependency 'rake', '~> 13.0', '>= 13.0.3'
   spec.add_development_dependency 'rspec', '~> 3.10'
-
-  spec.add_runtime_dependency 'date', '~> 3.1', '>= 3.1.1'
+  spec.add_development_dependency 'rubocop', '~> 1.65'
 end

data/lib/date_breakup.rb

@@ -1,49 +1,66 @@
 # frozen_string_literal: true
 
-require 'rubygems'
-require 'time_difference'
+require 'date'
 
 class DateBreakup
-  VERSION = '3.0.1'
+  VERSION = '3.1.0'
 
   def self.between(start_date, end_date)
-    new(Date.parse(start_date), Date.parse(end_date))
+    new(coerce_to_date(start_date), coerce_to_date(end_date))
   end
 
   def initialize(start_date, end_date)
+    raise ArgumentError, 'start_date must be before or equal to end_date' if start_date > end_date
+
     @start_date = start_date
-    @end_date = end_date
+    @end_date   = end_date
+  end
+
+  def in_years  = build_breakdown(years: true,  months: true,  weeks: true)
+  def in_months = build_breakdown(years: false, months: true,  weeks: true)
+  def in_weeks  = build_breakdown(years: false, months: false, weeks: true)
+  def in_days   = build_breakdown(years: false, months: false, weeks: false)
 
-    @years = []
-    @months = []
-    @weeks = []
-    @days = []
+  private_class_method def self.coerce_to_date(value)
+    case value
+    when Date   then value
+    when Time   then value.to_date
+    when String then Date.parse(value)
+    else raise ArgumentError, "expected a Date, Time, or String, got #{value.class}"
+    end
   end
 
-  # Methods
-  # in_years, in_months, in_weeks, in_days
-  %w[years months weeks days].each do |method|
-    define_method "in_#{method}" do
-      date = @start_date
-      while date <= @end_date
-        if ['years'].include?(method) && date.beginning_of_year == date && @end_date >= date.end_of_year
-          @years << { year: date.year, start_date: date, end_date: date.end_of_year }
-          date = date.end_of_year + 1.day
-        elsif ['years', 'months'].include?(method) && date.beginning_of_month == date && @end_date >= date.end_of_month
-          @months << { month: date.month, year: date.year, start_date: date, end_date: date.end_of_month }
-          date = date.end_of_month + 1.day
-        elsif ['years', 'months', 'weeks'].include?(method) && date.beginning_of_week == date && @end_date >= date.end_of_week
-          @weeks << { week: date.cweek, month: date.month, year: date.year, start_date: date,
-                      end_date: date.end_of_week }
-          date = date.end_of_week + 1.day
-        else
-          @days << { day: date.yday, month_day: date.mday, month: date.month, year: date.year, start_date: date,
-                     end_date: date }
-          date += 1.day
-        end
-      end
+  private
 
-      { years: @years, months: @months, weeks: @weeks, days: @days }
+  def build_breakdown(years: false, months: false, weeks: false)
+    y = []
+    m = []
+    w = []
+    d = []
+    date = @start_date
+
+    while date <= @end_date
+      year_end   = Date.new(date.year, 12, 31)
+      month_end  = Date.new(date.year, date.month, -1)
+      week_start = date - (date.cwday - 1)
+      week_end   = date + (7 - date.cwday)
+
+      if years && date == Date.new(date.year, 1, 1) && @end_date >= year_end
+        y << { year: date.year, start_date: date, end_date: year_end }
+        date = year_end + 1
+      elsif months && date == Date.new(date.year, date.month, 1) && @end_date >= month_end
+        m << { month: date.month, year: date.year, start_date: date, end_date: month_end }
+        date = month_end + 1
+      elsif weeks && date == week_start && @end_date >= week_end
+        w << { week: date.cweek, month: date.month, year: date.year, start_date: date, end_date: week_end }
+        date = week_end + 1
+      else
+        d << { day: date.yday, month_day: date.mday, month: date.month, year: date.year,
+               start_date: date, end_date: date }
+        date += 1
+      end
     end
+
+    { years: y, months: m, weeks: w, days: d }
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: date_breakup
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
 - Huzaifa Saifuddin
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-06-22 00:00:00.000000000 Z
+date: 2026-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,20 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.2.20
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.2.20
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -79,36 +73,35 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.10'
 - !ruby/object:Gem::Dependency
-  name: date
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.1.1
-  type: :runtime
+        version: '1.65'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.1.1
+        version: '1.65'
 description: Feed in 2 dates and get a breakup of dates grouped in years, months,
   weeks & days
 email:
-- Huzaifa@Huzaifas-MacBook-Pro.local
+- huzaifasp18@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".claude/settings.json"
+- ".github/workflows/ci.yml"
 - ".gitignore"
+- ".mise.toml"
 - ".rspec"
-- ".travis.yml"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CLAUDE.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -131,14 +124,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Feed in 2 dates and get a breakup of dates grouped in years, months, weeks

data/.travis.yml

@@ -1,5 +0,0 @@
-sudo: false
-language: ruby
-rvm:
-  - 2.4.2
-before_install: gem install bundler -v 1.16.2