philiprehberger-cron_parser 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3be8924f48f35f97ea4d356f5368d7907cf23bda63af8af43c4b3776f1a47a69
-  data.tar.gz: 0d0284d3e84fe3b93db4911a30149333bf0faaba73f2857ec28ae95f83455509
+  metadata.gz: 2d7e8b08d65ab34dacc640a348cd965a7a604840a0a5c10ad13327740ddb323e
+  data.tar.gz: 353889bda7ae0edd7074fc0a3a84056dff6ca731ab5daa65fa4c4ace54cedacf
 SHA512:
-  metadata.gz: 4cf277261fcf00a553dc1defe27a24b74ace4d34f7760e5033d5b52dbbb2fa87bacb0a36b32e8847bd3af4e2d93381caf3fa17b8f5e6fa0953fc32a3105f2b01
-  data.tar.gz: 6e5f421543e3a2871f1b8e068f12dab5ebec5586ff18ee297dcbca94261cca57e931c72e00af468a783170462edd333939b1e1370d715a5770b32fb3f457f4fc
+  metadata.gz: b3a8cef0c91c1f4056005b846d1b1d9960abca68cb1821c1fe602b9d4f8e9b73e4d70df8b11fd4971b46e0f4c65fbd9bfa6c466713f3a664037f1b373de93821
+  data.tar.gz: a89b2d2bef776c9f2ff5f0edba5fd163db301e0566ed0a9a6062b5af2633ec45731f90fae38e46ef4a4cf7f376804b7a21f6bff9f42b334527214cd540e4ceb8

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-05-12
+
+### Added
+- `Expression#each_in(from:, to:, &block)` iterator over every matching occurrence in an inclusive window; returns an Enumerator when no block is given so callers can chain `Enumerable` methods like `first`, `take`, and `lazy`
+
 ## [0.4.0] - 2026-04-30
 
 ### Added

data/README.md

@@ -58,6 +58,20 @@ to   = Time.new(2026, 4, 30, 10, 0, 0)
 cron.count_in(from: from, to: to)  # => 5
 ```
 
+### Iterating Occurrences in a Window
+
+```ruby
+cron = Philiprehberger::CronParser.new('*/15 * * * *')
+from = Time.new(2026, 4, 30, 9, 0, 0)
+to   = Time.new(2026, 4, 30, 10, 0, 0)
+
+cron.each_in(from: from, to: to) { |t| puts t }
+
+# Without a block, returns an Enumerator
+cron.each_in(from: from, to: to).first(2)
+# => [2026-04-30 09:00:00, 2026-04-30 09:15:00]
+```
+
 ### Human-Readable Description
 
 ```ruby
@@ -128,6 +142,7 @@ Philiprehberger::CronParser.new('0 9 * * MON-FRI') # named weekdays
 | `Expression#prev(from:)` | Calculate the previous matching time |
 | `Expression#next_n(n, from:)` | Calculate the next N matching times |
 | `Expression#count_in(from:, to:)` | Count occurrences within an inclusive `[from, to]` window |
+| `Expression#each_in(from:, to:, &block)` | Yield each matching occurrence in `[from, to]`; returns an Enumerator without a block |
 | `Expression#matches?(time)` | Check if a time matches the expression |
 | `Expression#human_readable` | Human-readable description of the expression |
 | `Expression#description` | Alias for `human_readable` |

data/lib/philiprehberger/cron_parser/expression.rb

@@ -130,6 +130,32 @@ module Philiprehberger
         count
       end
 
+      # Iterate every matching time within an inclusive `[from, to]` window.
+      #
+      # When called with a block, yields each occurrence and returns `self`.
+      # Without a block, returns an `Enumerator` so callers can chain `Enumerable`
+      # methods (`take`, `lazy`, `to_a`, ...).
+      #
+      # @param from [Time] start of the window
+      # @param to [Time] end of the window
+      # @yieldparam time [Time] a matching occurrence
+      # @return [self, Enumerator] self when a block is given, otherwise an Enumerator
+      # @raise [Error] if `to` is earlier than `from`
+      def each_in(from:, to:, &block)
+        raise Error, '`to` must be greater than or equal to `from`' if to < from
+
+        return enum_for(:each_in, from: from, to: to) unless block
+
+        cursor = round_to_minute(from) - 60
+        loop do
+          cursor = self.next(from: cursor)
+          break if cursor > to
+
+          block.call(cursor)
+        end
+        self
+      end
+
       # Return a human-readable description of the expression
       #
       # @return [String]

data/lib/philiprehberger/cron_parser/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module CronParser
-    VERSION = '0.4.0'
+    VERSION = '0.5.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-cron_parser
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-01 00:00:00.000000000 Z
+date: 2026-05-12 00:00:00.000000000 Z
 dependencies: []
 description: Parse standard 5-field cron expressions and calculate next/previous occurrences,
   match times against patterns, and generate human-readable descriptions.