reprise 0.1.2-x64-mingw-ucrt → 0.1.3-x64-mingw-ucrt

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 945b9f5b0e31195e6e82c91b2cb3e0434ece7b649cb34e4bc01959d2f2c0795f
-  data.tar.gz: 25a7008ddcf6720e9384f8a708b5ab0d4ae4de34bd9270afa971aacbd0959baa
+  metadata.gz: ce911aec52544af3b3c5940ab437f506fef94efe9a2130703b2be9c37c5826b5
+  data.tar.gz: bd44bc05d06e2a81b5a338dc5dc28618b2b65e4a979a3accfd8020df23bcc275
 SHA512:
-  metadata.gz: fc3fbbc7f2b888cfa6b4693b559d68578cbd53edc6f2acf1701d139c93589fdd7d5a87dddce0ed7c1d21bf3368d9dc9ea5b3da285a73d098626929c8f959c926
-  data.tar.gz: 8460b347b0b90b014668ec40c4f0c5303c71b1b71e4d4479ee8efe4289af461e4e96dc10940d2dc280b5ddc4e8d8f6a06548dd028604b7761efeb3c7ff6b44f4
+  metadata.gz: 353d72834f4aa5df21e85ca21f2d4c8d1221616efab806229e30024ee68d430c6da4ca9eb94956a44d737da46146c6a208bcb4eeedb1e1066f691e76aea5c63c
+  data.tar.gz: 58f3f6bb632e1b3c3e223536a145fa95231a6ab90310e50a4dbc0efeacaf5323e69493023e39bc1dfc0f00b6fcf4eb18b8dd7951fe62e94d72bedc585a4bae2e

data/Cargo.lock

@@ -594,7 +594,7 @@ checksum = "7a66a03ae7c801facd77a29370b4faec201768915ac14a721ba36f20bc9c209b"
 
 [[package]]
 name = "reprise"
-version = "0.1.2"
+version = "0.1.3"
 dependencies = [
  "chrono",
  "chrono-tz",

data/README.md

@@ -229,7 +229,7 @@ you would probably be much better served by choosing one of those two gems inste
   the influence of Rust leaks into its Ruby API. Alternative gems offer much more flexible APIs that support a variety
   of more idiomatic calling conventions: they have better, more forgiving ergonomics. Reprise may invest more efforts
   here in the future, but not until we have landed on a feature-complete, performant core - our primary design goal. 
-  Until then, out API will remain sparse but sufficient.
+  Until then, our API will remain sparse but sufficient.
 - **Stability.** Reprise is still experimental; we do not yet have a `1.0.0` release or a public roadmap. Breaking changes
   may be frequent across releases. If you do not want to pin Reprise to a specific version and want a library that you can
   upgrade without reviewing the changelog, you may want to consider an alternative for now.
@@ -317,8 +317,6 @@ How do you filter out recurring series occurrences that conflict with other sche
 in your application?
 
 At time of writing, alternative gems' solutions to this problem are somewhat wanting:
-- **None**: It is entirely the responsibility of the client application to handle occurrence exclusions,
-  despite this logic being core to the domain of recurring schedule management.
 - **Date-based exclusion**: Client applications can pass specific dates when occurrences should be excluded.
   This is not sufficient except for in the most simple of circumstances. Again, consider our hypothetical
   Monday @ 12:30 PM recurring series: being able to exclude a specific _date_ from your recurrence rule still 

data/lib/reprise/schedule.rb

@@ -85,6 +85,12 @@ module Reprise
     #     influences occurrence queries, and whether any added exclusions conflict with any of the schedule's
     #     occurrences.
 
+    # @!macro [new] count
+    #   @param count [Integer, nil] An optional count limit to apply to the occurrences
+    #     of a series; once the schedule has generated the requested number of occurrences,
+    #     it will halt further expansion of that specific series. The count takes precedence
+    #     over the optional +ends_at+ param.
+
     # @!macro [new] label
     #   @param label [String, nil] An optional label to apply to all of the occurrences
     #     that are generated from the series. See {Reprise::Core::Occurrence#label}.
@@ -93,15 +99,17 @@ module Reprise
     # @!macro duration_in_seconds
     # @!macro interval
     # @!macro recurring_series_start_and_end_times
+    # @!macro count
     # @!macro label
     # @return [void]
-    def repeat_minutely(time_of_day: nil, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, label: nil)
+    def repeat_minutely(time_of_day: nil, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, count: nil, label: nil)
       internal_schedule.repeat_minutely(
         time_of_day: TimeOfDay.new(time_of_day || self.starts_at).to_h,
         duration_in_seconds:,
         interval:,
         starts_at_unix_timestamp: starts_at.presence&.to_i,
         ends_at_unix_timestamp: ends_at.presence&.to_i,
+        count:,
         label:
       )
     end
@@ -110,15 +118,17 @@ module Reprise
     # @!macro duration_in_seconds
     # @!macro interval
     # @!macro recurring_series_start_and_end_times
+    # @!macro count
     # @!macro label
     # @return [void]
-    def repeat_hourly(time_of_day: nil, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, label: nil)
+    def repeat_hourly(time_of_day: nil, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, count: nil, label: nil)
       internal_schedule.repeat_hourly(
         time_of_day: TimeOfDay.new(time_of_day || self.starts_at).to_h,
         duration_in_seconds:,
         interval:,
         starts_at_unix_timestamp: starts_at.presence&.to_i,
         ends_at_unix_timestamp: ends_at.presence&.to_i,
+        count:,
         label:
       )
     end
@@ -127,15 +137,17 @@ module Reprise
     # @!macro duration_in_seconds
     # @!macro interval
     # @!macro recurring_series_start_and_end_times
+    # @!macro count
     # @!macro label
     # @return [void]
-    def repeat_daily(time_of_day: nil, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, label: nil)
+    def repeat_daily(time_of_day: nil, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, count: nil, label: nil)
       internal_schedule.repeat_daily(
         time_of_day: TimeOfDay.new(time_of_day || self.starts_at).to_h,
         duration_in_seconds:,
         interval:,
         starts_at_unix_timestamp: starts_at.presence&.to_i,
         ends_at_unix_timestamp: ends_at.presence&.to_i,
+        count:,
         label:
       )
     end
@@ -145,6 +157,7 @@ module Reprise
     # @!macro duration_in_seconds
     # @!macro interval
     # @!macro recurring_series_start_and_end_times
+    # @!macro count
     # @!macro label
     # @return [void]
     # @example with a +time_of_day+ hash
@@ -152,7 +165,7 @@ module Reprise
     # @example with a local time for +time_of_day+
     #   local_time = Time.current.in_time_zone(my_current_time_zone)
     #   schedule.repeat_weekly(:monday, time_of_day: local_time, duration_in_seconds: 30)
-    def repeat_weekly(weekday, time_of_day: nil, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, label: nil)
+    def repeat_weekly(weekday, time_of_day: nil, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, count: nil, label: nil)
       internal_schedule.repeat_weekly(
         weekday,
         time_of_day: TimeOfDay.new(time_of_day || self.starts_at).to_h,
@@ -160,6 +173,7 @@ module Reprise
         interval:,
         starts_at_unix_timestamp: starts_at.presence&.to_i,
         ends_at_unix_timestamp: ends_at.presence&.to_i,
+        count:,
         label:
       )
     end
@@ -169,11 +183,12 @@ module Reprise
     # @!macro duration_in_seconds
     # @!macro interval
     # @!macro recurring_series_start_and_end_times
+    # @!macro count
     # @!macro label
     # @return [void]
     # @example
     #   schedule.repeat_monthly_by_day(15, time_of_day: { hour: 9 }, duration_in_seconds: 30)
-    def repeat_monthly_by_day(day_number, time_of_day:, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, label: nil)
+    def repeat_monthly_by_day(day_number, time_of_day:, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, count: nil, label: nil)
       internal_schedule.repeat_monthly_by_day(
         day_number,
         time_of_day: TimeOfDay.new(time_of_day || self.starts_at).to_h,
@@ -181,6 +196,7 @@ module Reprise
         interval:,
         starts_at_unix_timestamp: starts_at.presence&.to_i,
         ends_at_unix_timestamp: ends_at.presence&.to_i,
+        count:,
         label:
       )
     end
@@ -191,9 +207,10 @@ module Reprise
     # @!macro duration_in_seconds
     # @!macro interval
     # @!macro recurring_series_start_and_end_times
+    # @!macro count
     # @!macro label
     # @return [void]
-    def repeat_monthly_by_nth_weekday(weekday, nth_day, time_of_day:, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, label: nil)
+    def repeat_monthly_by_nth_weekday(weekday, nth_day, time_of_day:, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, count: nil, label: nil)
       internal_schedule.repeat_monthly_by_nth_weekday(
         weekday,
         nth_day,
@@ -202,6 +219,7 @@ module Reprise
         interval:,
         starts_at_unix_timestamp: starts_at.presence&.to_i,
         ends_at_unix_timestamp: ends_at.presence&.to_i,
+        count:,
         label:
       )
     end
@@ -211,11 +229,12 @@ module Reprise
     # @!macro duration_in_seconds
     # @!macro interval
     # @!macro recurring_series_start_and_end_times
+    # @!macro count
     # @!macro label
     # @return [void]
     # @example
     #   schedule.repeat_annually_by_day(200, duration_in_seconds: 30)
-    def repeat_annually_by_day(day_number, time_of_day:, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, label: nil)
+    def repeat_annually_by_day(day_number, time_of_day:, duration_in_seconds:, interval: 1, starts_at: nil, ends_at: nil, count: nil, label: nil)
       internal_schedule.repeat_annually_by_day(
         day_number,
         time_of_day: TimeOfDay.new(time_of_day || self.starts_at).to_h,
@@ -223,6 +242,7 @@ module Reprise
         interval:,
         starts_at_unix_timestamp: starts_at.presence&.to_i,
         ends_at_unix_timestamp: ends_at.presence&.to_i,
+        count:,
         label:
       )
     end

data/lib/reprise/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: reprise
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: x64-mingw-ucrt
 authors:
 - Jordan Hiltunen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-07-20 00:00:00.000000000 Z
+date: 2024-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: benchmark-ips