date_breakup 2.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f5169901ddfd246e1258b86eae3a6d7947c6f685a0c986f6b098d09519347e2
-  data.tar.gz: 9bad2347cb86b12f4e53552c0a2c59f22036445045f68e7580d1c6290442e56a
+  metadata.gz: b0b112a6229d63cd8d490c5309d553c488533a819b09874b8f8019bf1c60f867
+  data.tar.gz: 57286315af767547d74f7efa1d346fbfb4785593a3d3eb47e7a35ebc2f7ccd8d
 SHA512:
-  metadata.gz: d73dae5066c6f626f9bbf5a7be5aed0a11cc88f29138d88f907b8aca317534468229c4ccc049b4d6583bd8bdcc40e628255d27acf1fdc2b638a177cf3336818f
-  data.tar.gz: e85a1c91c06bea7d3a060230f8b9295f6a5a2f7f2baead68262b88dd6c3f3f09fd39672ea16da673c081b9e6714854339a108d23f6908bf19a872a3f3b244396
+  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

@@ -10,4 +10,8 @@
 # rspec failure tracking
 .rspec_status
 
-*.gem
+*.gem
+*.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,6 +1,8 @@
-source "https://rubygems.org"
+# frozen_string_literal: true
 
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in date_breakup.gemspec
 gemspec

data/Gemfile.lock

@@ -0,0 +1,74 @@
+PATH
+  remote: .
+  specs:
+    date_breakup (3.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    coderay (1.1.3)
+    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)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      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.0)
+  date_breakup!
+  pry (~> 0.14.1)
+  rake (~> 13.0, >= 13.0.3)
+  rspec (~> 3.10)
+  rubocop (~> 1.65)
+
+BUNDLED WITH
+   2.7.2

data/README.md

@@ -1,5 +1,7 @@
 # DateBreakup
 
+Pass two dates and get a breakdown of the range grouped into years, months, weeks, and days. Accepts `Date`, `Time`, or date strings.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -8,74 +10,141 @@ 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
+
+```ruby
+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:   []
+# }
+```
+
+For a range that doesn't align to full years, the remainder falls through to months, weeks, and days:
+
+```ruby
+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 }, ...]
+# }
+```
+
+### `in_months` — greedy breakdown from months down
+
+```ruby
+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:   []
+# }
+```
+
+### `in_weeks` — greedy breakdown from weeks down
+
+Partial weeks at the start or end of the range fall through to individual days.
 
 ```ruby
-DateBreakup::Range.between('01/01/2019', '31/12/2019').get_accurate
-=> {
-    :years=>[
-      {:year=>2019, :start_date=>Sat, 01 Jan 2019, :end_date=>Sat, 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
-DateBreakup::Range.between('10/10/2010', '12/12/2012').get_accurate
-=> {
-    :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
+
+This project uses [mise](https://mise.jdx.dev) to manage the Ruby version.
+
+```sh
+# Install the required Ruby version
+mise install
+
+# Install dependencies
+bin/setup
 
-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.
+# Run tests
+bundle exec rspec
 
-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).
+# 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
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/date_breakup. -->
+Bug reports and pull requests are welcome on GitHub at https://github.com/HuzaifaSaifuddin/date_breakup.
 
 ## License
 

data/Rakefile

@@ -1,6 +1,8 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/bin/console

@@ -1,14 +1,8 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require "bundler/setup"
-require "date_breakup"
+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,41 +1,42 @@
+# frozen_string_literal: true
 
-lib = File.expand_path("../lib", __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "date_breakup/version"
+require 'date_breakup'
 
 Gem::Specification.new do |spec|
-  spec.name          = "date_breakup"
+  spec.name          = 'date_breakup'
   spec.version       = DateBreakup::VERSION
-  spec.authors       = ["Huzaifa Saifuddin"]
-  spec.email         = ["Huzaifa@Huzaifas-MacBook-Pro.local"]
+  spec.authors       = ['Huzaifa Saifuddin']
+  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"
-  spec.homepage      = "https://github.com/HuzaifaSaifuddin/date_breakup"
-  spec.license       = "MIT"
+  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'
+  spec.homepage      = 'https://github.com/HuzaifaSaifuddin/date_breakup'
+  spec.license       = 'MIT'
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
   # to allow pushing to a single host or delete this section to allow pushing to any host.
   if spec.respond_to?(:metadata)
-    spec.metadata["allowed_push_host"] = "https://rubygems.org"
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
   else
-    raise "RubyGems 2.0 or newer is required to protect against " \
-      "public gem pushes."
+    raise 'RubyGems 2.0 or newer is required to protect against ' \
+      'public gem pushes.'
   end
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
+  spec.required_ruby_version = '>= 3.3'
 
-  spec.add_development_dependency "bundler", "~> 1.16"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "pry", "~> 1.0"
-
-  spec.add_runtime_dependency 'date', '~> 2.0'
+  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_development_dependency 'rubocop', '~> 1.65'
 end

data/lib/date_breakup.rb

@@ -1,183 +1,66 @@
-require "date_breakup/version"
-require "time_difference"
+# frozen_string_literal: true
 
-module DateBreakup
-  class Range
-    private_class_method :new
+require 'date'
 
-    def self.between(date1, date2)
-      new(Date.parse(date1), Date.parse(date2))
-    end
-
-    def get_years
-      get_year_array(@date1, @date2)
-
-      output = { years: @year_array, months: @month_array, weeks: @week_array, days: @day_array }
-    end
-
-    def get_months
-      get_month_array(@date1, @date2)
-
-      output = { years: @year_array, months: @month_array, weeks: @week_array, days: @day_array }
-    end
-
-    def get_weeks
-      get_week_array(@date1, @date2)
-
-      output = { years: @year_array, months: @month_array, weeks: @week_array, days: @day_array }
-    end
-
-    def get_days
-      get_day_array(@date1, @date2)
-
-      output = { years: @year_array, months: @month_array, weeks: @week_array, days: @day_array }
-    end
-
-    private
-
-    def initialize(date1, date2)
-      @date1 = date1
-      @date2 = date2
-      @year_array = Array.new
-      @month_array = Array.new
-      @week_array = Array.new
-      @day_array = Array.new
-    end
-
-    def get_year_array(date, end_date)
-      move_to_date = true
-      # YEAR
-      if move_to_date
-        if date.beginning_of_year == date
-          if date.end_of_year <= @date2
-            date, move_to_date = get_year_data(date)
-          end
-        end
-      end
-
-      # MONTH
-      if move_to_date
-        if date.beginning_of_month == date
-          if date.end_of_month <= @date2
-            date, move_to_date = get_month_data(date)
-          end
-        end
-      end
-
-      # Week
-      if move_to_date
-        if date.beginning_of_week == date && date.end_of_week <= @date2
-          if date.beginning_of_week.month == date.end_of_week.month || date.end_of_week.end_of_month >= @date2
-            date, move_to_date = get_week_data(date)
-          end
-        end
-      end
-
-      # DAY
-      if move_to_date
-        date, move_to_date = get_date_data(date)
-      end
-
-      if date <= end_date
-        get_year_array(date, end_date)
-      end
-    end
+class DateBreakup
+  VERSION = '3.1.0'
 
-    def get_month_array(date, end_date)
-      move_to_date = true
-      # MONTH
-      if move_to_date
-        if date.beginning_of_month == date
-          if date.end_of_month <= @date2
-            date, move_to_date = get_month_data(date)
-          end
-        end
-      end
-
-      # Week
-      if move_to_date
-        if date.beginning_of_week == date && date.end_of_week <= @date2
-          if date.beginning_of_week.month == date.end_of_week.month || date.end_of_week.end_of_month >= @date2
-            date, move_to_date = get_week_data(date)
-          end
-        end
-      end
-
-      # DAY
-      if move_to_date
-        date, move_to_date = get_date_data(date)
-      end
-
-      if date <= end_date
-        get_month_array(date, end_date)
-      end
-    end
+  def self.between(start_date, end_date)
+    new(coerce_to_date(start_date), coerce_to_date(end_date))
+  end
 
-    def get_week_array(date, end_date)
-      move_to_date = true
-      # Week
-      if move_to_date
-        if date.beginning_of_week == date && date.end_of_week <= @date2
-          date, move_to_date = get_week_data(date)
-        end
-      end
+  def initialize(start_date, end_date)
+    raise ArgumentError, 'start_date must be before or equal to end_date' if start_date > end_date
 
-      # DAY
-      if move_to_date
-        date, move_to_date = get_date_data(date)
-      end
+    @start_date = start_date
+    @end_date   = end_date
+  end
 
-      if date <= end_date
-        get_week_array(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)
+
+  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
 
-    def get_day_array(date, end_date)
-      move_to_date = true
-      # DAY
-      if move_to_date
-        date, move_to_date = get_date_data(date)
-      end
-
-      if date <= end_date
-        get_day_array(date, end_date)
+  private
+
+  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
 
-    def get_year_data(date)
-      year_hash = { year: date.year, start_date: date, end_date: date.end_of_year }
-      @year_array << year_hash
-      new_date = date.end_of_year + 1.day
-      move_to_date = false
-
-      return new_date, move_to_date
-    end
-
-    def get_month_data(date)
-      month_hash = { month: date.month, year: date.year, start_date: date, end_date: date.end_of_month }
-      @month_array << month_hash
-      new_date = date.end_of_month + 1.day
-      move_to_date = false
-
-      return new_date, move_to_date
-    end
-
-    def get_week_data(date)
-      week_hash = { week: date.cweek, month: date.month, year: date.year, start_date: date, end_date: date.end_of_week }
-      @week_array << week_hash
-      new_date = date.end_of_week + 1.day
-      move_to_date = false
-
-      return new_date, move_to_date
-    end
-
-    def get_date_data(date)
-      day_hash = { day: date.yday, month_day: date.mday, month: date.month, year: date.year, start_date: date, end_date: date }
-      @day_array << day_hash
-      new_date = date + 1.day
-      move_to_date = false
-
-      return new_date, move_to_date
-    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: 2.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Huzaifa Saifuddin
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2019-02-19 00:00:00.000000000 Z
+date: 2026-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,82 +16,94 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 0.14.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 0.14.1
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '13.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 13.0.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '13.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 13.0.3
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '3.10'
 - !ruby/object:Gem::Dependency
-  name: date
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :runtime
+        version: '1.65'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        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
 - README.md
 - Rakefile
@@ -99,14 +111,12 @@ files:
 - bin/setup
 - date_breakup.gemspec
 - lib/date_breakup.rb
-- lib/date_breakup/version.rb
-- lib/date_breakup_v1.rb
 homepage: https://github.com/HuzaifaSaifuddin/date_breakup
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -114,16 +124,15 @@ 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: []
-rubyforge_project: 
-rubygems_version: 2.7.7
-signing_key: 
+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
   & days

data/.travis.yml

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

data/lib/date_breakup/version.rb

@@ -1,3 +0,0 @@
-module DateBreakup
-  VERSION = "2.0.0"
-end

data/lib/date_breakup_v1.rb

@@ -1,215 +0,0 @@
-require "date_breakup/version"
-require "time_difference"
-
-module DateBreakup
-  class Range
-    private_class_method :new
-
-    def self.between(date1, date2)
-      new(Date.parse(date1), Date.parse(date2))
-    end
-
-    def get_accurate
-      years, remaining_dates_year = get_years(@date1, @date2)
-
-      months, remaining_dates_month = get_months(remaining_dates_year)
-
-      weeks, remaining_dates_week = get_weeks(remaining_dates_month)
-
-      days, remaining_dates_days = get_days(remaining_dates_week)
-
-      output = { years: years, months: months, weeks: weeks, days: days }
-    end
-
-    private
-
-    def initialize(date1, date2)
-      @date1 = date1
-      @date2 = date2
-    end
-
-    def get_years(date1, date2)
-      year_array = []
-      remaining_dates = []
-
-      if date1.beginning_of_year == date1 && date1.end_of_year <= date2
-        year_hash = { year: date1.year, start_date: date1.beginning_of_year, end_date: date1.end_of_year }
-        year_array << year_hash
-      end
-
-      get_year_range(date1, date2, year_array, year_hash)
-
-      if year_array.count > 0
-        if(date1 != year_array[0][:start_date])
-          remaining_dates_hash = { date1: date1, date2: year_array[0][:start_date] - 1 }
-          remaining_dates << remaining_dates_hash
-        end
-
-        if(date2 != year_array[-1][:end_date])
-          remaining_dates_hash = { date1: year_array[-1][:end_date] + 1, date2: date2 }
-          remaining_dates << remaining_dates_hash
-        end
-      else
-        remaining_dates << { date1: date1, date2: date2 }
-      end
-
-      return year_array, remaining_dates
-    end
-
-    def get_months(remaining_dates_year)
-      month_array = []
-      remaining_dates = []
-
-      remaining_dates_year.each do |rd|
-        date1, date2 = rd[:date1], rd[:date2]
-        if date1.beginning_of_month == date1 && date1.end_of_month <= date2
-          month_hash = { month: date1.month, year: date1.year, start_date: date1.beginning_of_month, end_date: date1.end_of_month }
-          month_array << month_hash
-        end
-
-        get_month_range(date1, date2, month_array, month_hash)
-      end
-
-
-      if month_array.count > 0
-        month_arrx1 = month_array.sort_by{ |ma| ma[:start_date] }.select{ |wa| wa[:year] == remaining_dates_year[0][:date1].year }.first
-
-        if month_arrx1
-          if(remaining_dates_year[0][:date1] != month_arrx1[:start_date])
-            remaining_dates_hash = { date1: remaining_dates_year[0][:date1], date2: month_arrx1[:start_date] - 1 }
-            remaining_dates << remaining_dates_hash
-          end
-        else
-          remaining_dates_hash = { date1: remaining_dates_year[0][:date1], date2: remaining_dates_year[0][:date2] }
-          remaining_dates << remaining_dates_hash
-        end
-
-        month_arrx2 = month_array.sort_by{ |ma| ma[:start_date] }.select{ |wa| wa[:year] == remaining_dates_year[-1][:date2].year }.last
-        if month_arrx2
-          if(remaining_dates_year[-1][:date2] != month_arrx2[:end_date])
-            remaining_dates_hash = { date1: month_arrx2[:end_date] + 1, date2: remaining_dates_year[-1][:date2] }
-            remaining_dates << remaining_dates_hash
-          end
-        else
-          remaining_dates_hash = { date1: remaining_dates_year[-1][:date1], date2: remaining_dates_year[-1][:date2] }
-          remaining_dates << remaining_dates_hash
-        end
-      else
-        remaining_dates = remaining_dates_year
-      end
-
-      return month_array, remaining_dates
-    end
-
-    def get_weeks(remaining_dates_month)
-      week_array = []
-      remaining_dates = []
-
-      remaining_dates_month.each do |rd|
-        date1, date2 = rd[:date1], rd[:date2]
-        if date1.beginning_of_week == date1 && date1.end_of_week <= date2
-          week_hash = { week: date1.cweek, month: date1.month, year: date1.year, start_date: date1.beginning_of_week, end_date: date1.end_of_week }
-          week_array << week_hash
-        end
-
-        get_week_range(date1, date2, week_array, week_hash)
-      end
-
-      if week_array.count > 0
-        week_arrx1 = week_array.sort_by{ |ma| ma[:start_date] }.select{ |wa| wa[:month] == remaining_dates_month[0][:date1].month }.first
-        if week_arrx1
-          if(remaining_dates_month[0][:date1] != week_arrx1[:start_date])
-            remaining_dates_hash = { date1: remaining_dates_month[0][:date1], date2: week_arrx1[:start_date] - 1 }
-            remaining_dates << remaining_dates_hash
-          end
-        end
-
-        week_arrx2 = week_array.sort_by{ |ma| ma[:start_date] }.select{ |wa| wa[:month] == remaining_dates_month[0][:date2].month }.last
-        if week_arrx2
-          if(remaining_dates_month[0][:date2] != week_arrx2[:end_date])
-            remaining_dates_hash = { date1: week_arrx2[:end_date] + 1, date2: remaining_dates_month[0][:date2] }
-            remaining_dates << remaining_dates_hash
-          end
-        end
-
-        week_arrx3 = week_array.sort_by{ |ma| ma[:start_date] }.select{ |wa| wa[:month] == remaining_dates_month[-1][:date1].month }.first
-        if week_arrx3
-          if(remaining_dates_month[0][:date1] != week_arrx3[:end_date])
-            remaining_dates_hash = { date1: remaining_dates_month[-1][:date1], date2: week_arrx3[:start_date] - 1 }
-            remaining_dates << remaining_dates_hash
-          end
-        end
-
-        week_arrx4 = week_array.sort_by{ |ma| ma[:start_date] }.select{ |wa| wa[:month] == remaining_dates_month[-1][:date1].month }.last
-        if week_arrx4
-          if(remaining_dates_month[-1][:date2] != week_arrx4[:end_date])
-            remaining_dates_hash = { date1: week_arrx4[:end_date] + 1, date2: remaining_dates_month[-1][:date2] }
-            remaining_dates << remaining_dates_hash
-          end
-        end
-      else
-        remaining_dates = remaining_dates_month
-      end
-
-      return week_array, remaining_dates
-    end
-
-    def get_days(remaining_dates_week)
-      day_array = []
-      remaining_dates = []
-
-      remaining_dates_week.each do |rd|
-        date1, date2 = rd[:date1], rd[:date2]
-        dates = (date1).upto(date2).to_a
-
-        dates.each do |date|
-          unless day_array.find{ |da| da[:start_date] == date }.present?
-            day_hash = { day: date.yday, month_day: date.mday, month: date.month, year: date.year, start_date: date, end_date: date }
-            day_array << day_hash
-          end
-        end
-      end
-
-      return day_array, remaining_dates
-    end
-
-    def get_year_range(date1, date2, year_array, year_hash)
-      next_year = (date1.end_of_year + 1.day)
-      end_next_year = next_year.end_of_year
-      if end_next_year <= date2
-        year = end_next_year.year
-        start_date = next_year.beginning_of_year
-        end_date = end_next_year
-        year_hash = { year: year, start_date: start_date, end_date: end_date }
-        year_array << year_hash
-        get_year_range(next_year, date2, year_array, year_hash)
-      end
-    end
-
-    def get_month_range(date1, date2, month_array, month_hash)
-      next_month = (date1.end_of_month + 1.day)
-      end_next_month = next_month.end_of_month
-      if end_next_month <= date2
-        month = end_next_month.month
-        start_date = next_month.beginning_of_month
-        end_date = end_next_month
-        month_hash = { month: month, year: end_next_month.year, start_date: start_date, end_date: end_date }
-        month_array << month_hash
-        get_month_range(next_month, date2, month_array, month_hash)
-      end
-    end
-
-    def get_week_range(date1, date2, week_array, week_hash)
-      next_week = (date1.end_of_week + 1.day)
-      end_next_week = next_week.end_of_week
-      if end_next_week <= date2
-        week = end_next_week.cweek
-        start_date = next_week.beginning_of_week
-        end_date = end_next_week
-        week_hash = { week: week, month: end_next_week.month, year: end_next_week.year, start_date: start_date, end_date: end_date }
-        week_array << week_hash
-        get_week_range(next_week, date2, week_array, week_hash)
-      end
-    end
-  end
-end