cron_calc 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df5dd3a2f576d78996d783668af59a058a4fd9256072dfa25b84760d64e09797
-  data.tar.gz: 922e53ae27d369035d3b7fff81e1ba624756fa365c30694e6871abc54421473e
+  metadata.gz: 29ac47b06a1dc188f3fb9ed5c10f9fa1a6ef748e8d15a6783eb7b8f99de85b38
+  data.tar.gz: 8f136ff6c1010357acd75942e80bc7d4a2f4b0d1b8555041486f1cc9bdd97f00
 SHA512:
-  metadata.gz: 85a0d0ea11962ee78495e6c6c8ee40ea9695d20df2635efbb67cdc32502086032b3aa85aaa419b39cc1a736a31c6d1ecc577afd60b571d4e8d120c5adcd922fc
-  data.tar.gz: aab193b3c8afe9551dd46fe1b9e0061702cc69e3fa739c08c774d5f77ef40dabbd5c90c816b93a1e864d2e05c6c5278eda102c07649c83afd3a43553c5cc5ef8
+  metadata.gz: 38f8b7a5a0f80d10f6c4867a8a2e687b9ebb508c5e79031856cbb9bc81a9a97b6f399e0b37f332f5ec5aeb7d2839e29d11b6e76b0fdc5601b675a6a5ed82e806
+  data.tar.gz: d1545c32cd0559370fc1778c3517567ee0be5f4fecf41ad32af0a2a3fd3202d52f0b9d5014f202ab736c8174675d2c7692610fa72968f247022082aa7a2b5567

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.4.0] - 2023-12-22
+
+- Added support for named months and wdays
+- Keyword arguments: before:, after:
+
+## [0.3.0] - 2023-12-22
+
+- Added support for DOWs
+
 ## [0.2.0] - 2023-12-19
 
 - Added #next method

data/README.md

@@ -21,9 +21,10 @@ Now, you can use one of three methods `#in`, `#next`, `#last` to determine cron
 
 ### Using `#in`
 
-Calculates cron job occurrences within a given time period.
-@param period [Range] The time period for which to calculate cron job occurrences.
-@return [Array<Time>] An array of Time instances representing each occurrence.
+Calculates cron job occurrences within a given time period.\
+**Parameters:**
+- `period` - a Range object defining the start and end times for the calculation.\
+
 
 ```ruby
     period = Time.new(2024, 1, 1, 0, 0)..Time.new(2024, 1, 4, 0, 0)
@@ -34,11 +35,11 @@ Calculates cron job occurrences within a given time period.
 
 ### Using `#next`
 
-Calculates the next 'n' occurrences of the cron job from a given start time.
-@param count [Integer] The number of occurrences to calculate. Defaults to `1`.
-@param period_start [Time] The start time from which to calculate occurrences. Defaults to `Time.now`.
-@param max_years [Integer] The maximum number of years to consider for the period. Defaults to `5`.
-@return [Array<Time>] An array of the next 'n' occurrences.
+Calculates the next 'n' occurrences of the cron job from a given start time.\
+**Parameters:**
+- `count` - (optional, Integer) The number of occurrences to calculate. Defaults to 1.
+- `after:` - (optional, Time, keyword argument) The start time from which to calculate occurrences. If not provided, defaults to the current time (Time.now).
+- `max_years` - (optional, Integer, keyword argument) The maximum number of years to search for future occurrences. Defaults to 5.
 
 ```ruby
     cron_calc.next
@@ -47,30 +48,28 @@ Calculates the next 'n' occurrences of the cron job from a given start time.
     cron_calc.next(3)
     # => [2023-12-20 05:05:00 +0100, 2023-12-21 05:05:00 +0100, 2023-12-22 05:05:00 +0100]
 
-    cron_calc.next(2, Time.new(2024, 1, 1, 0, 0))
+    cron_calc.next(2, after: Time.new(2024, 1, 1, 0, 0))
     # => [2024-01-01 05:05:00 +0100, 2024-01-02 05:05:00 +0100]
 ```
 
 ### Using `#last`
 
-Calculates the last 'n' occurrences of the cron job until a given end time.
-@param count [Integer] The number of past occurrences to calculate.
-@param period_end [Time] The end time until which to calculate occurrences.
-@param max_years [Integer] The maximum number of years to consider for the period.
-@return [Array<Time>] An array of the last 'n' occurrences.
+Calculates the last 'n' occurrences of the cron job until a given end time.\
+**Parameters:**
+- `count` - (optional, Integer) The number of occurrences to calculate. Defaults to 1.
+- `before:` - (optional, Time, keyword argument) The end time from which to calculate past occurrences. If not provided, defaults to the current time (Time.now).
+- `max_years` - (optional, Integer, keyword argument) The maximum number of years to search backward for past occurrences. Defaults to 5.
 
 ```ruby
     cron_calc.last
     # => [2023-12-19 05:05:00 +0100]
 
-    cron_calc.last(4, Time.new(2024, 1, 1, 0, 0))
+    cron_calc.last(4, before: Time.new(2024, 1, 1, 0, 0))
     # => [2023-12-31 05:05:00 +0100, 2023-12-30 05:05:00 +0100, 2023-12-29 05:05:00 +0100, 2023-12-28 05:05:00 +0100]
 ```
 
 ## Unsupported features
 
-- DOW (Day of Week) - always require *
-- Named DOW and months (SUN-SAT, JAN-DEC)
 - Joining characters , - /
 - Predefined definitions (@yearly, @monthly, @weekly, @daily, @midnight, @hourly)
 

data/cron_calc.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.email = ['jakubmizinski@gmail.com']
 
   spec.summary = 'Calculates cron job occurrences'
-  spec.description = 'Calculates cron job occurrences within a specified period \n
+  spec.description = 'Calculates cron job occurrences within a specified period
                       or determines next/last "n" occurrences based on a specified time.'
   spec.homepage = 'https://github.com/mizinsky/cron_calc'
   spec.license = 'MIT'

data/lib/cron_calc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CronCalc
-  VERSION = '0.2.0'
+  VERSION = '0.4.0'
 end

data/lib/cron_calc.rb

@@ -21,7 +21,19 @@ module CronCalc
       minutes: 0..59,
       hours: 0..23,
       days: 1..31,
-      months: 1..12
+      months: 1..12,
+      wdays: 0..6
+    }.freeze
+
+    WDAYS = {
+      'SUN' => '0', 'MON' => '1', 'TUE' => '2', 'WED' => '3',
+      'THU' => '4', 'FRI' => '5', 'SAT' => '6'
+    }.freeze
+
+    MONTHS = {
+      'JAN' => '1', 'FEB' => '2', 'MAR' => '3', 'APR' => '4',
+      'MAY' => '5', 'JUN' => '6', 'JUL' => '7', 'AUG' => '8',
+      'SEP' => '9', 'OCT' => '10', 'NOV' => '11', 'DEC' => '12'
     }.freeze
 
     def initialize(cron_string)
@@ -41,24 +53,24 @@ module CronCalc
 
     # Calculates the next 'n' occurrences of the cron job from a given start time.
     # @param count [Integer] The number of occurrences to calculate.
-    # @param period_start [Time] The start time from which to calculate occurrences.
+    # @param after [Time] The start time from which to calculate occurrences.
     # @param max_years [Integer] The maximum number of years to consider for the period.
     # @return [Array<Time>] An array of the next 'n' occurrences.
-    def next(count = 1, period_start = Time.now, max_years = 5)
+    def next(count = 1, after: Time.now, max_years: 5)
       occurrences(
-        period_start..(period_start + (60 * 60 * 24 * 365 * max_years)),
+        after..(after + (60 * 60 * 24 * 365 * max_years)),
         count
       )
     end
 
     # Calculates the last 'n' occurrences of the cron job until a given end time.
     # @param count [Integer] The number of past occurrences to calculate.
-    # @param period_end [Time] The end time until which to calculate occurrences.
+    # @param before [Time] The end time until which to calculate occurrences.
     # @param max_years [Integer] The maximum number of years to consider for the period.
     # @return [Array<Time>] An array of the last 'n' occurrences.
-    def last(count = 1, period_end = Time.now, max_years = 5)
+    def last(count = 1, before: Time.now, max_years: 5)
       occurrences(
-        (period_end - (60 * 60 * 24 * 365 * max_years))..period_end,
+        (before - (60 * 60 * 24 * 365 * max_years))..before,
         count,
         reverse: true
       )
@@ -68,12 +80,13 @@ module CronCalc
 
     def occurrences(period, count = nil, reverse: false)
       time_combinations = generate_time_combinations(period, reverse).lazy
+      wdays = parse_cron_part(:wdays)
 
       time_combinations.each_with_object([]) do |(year, month, day, hour, minute), occ|
         break occ if count && occ.length == count
 
         time = Time.new(year, month, day, hour, minute)
-        occ << time if Date.valid_date?(year, month, day) && period.include?(time)
+        occ << time if Date.valid_date?(year, month, day) && period.include?(time) && wdays.include?(time.wday)
       end
     end
 
@@ -92,7 +105,8 @@ module CronCalc
         minutes: splitted[0],
         hours: splitted[1],
         days: splitted[2],
-        months: splitted[3]
+        months: normalize_with(splitted[3], MONTHS),
+        wdays: normalize_with(splitted[4], WDAYS)
       }
     end
 
@@ -120,9 +134,13 @@ module CronCalc
     end
     # rubocop:enable Metrics
 
+    def normalize_with(string, mapping)
+      mapping.inject(string) { |str, (k, v)| str.gsub(k, v) }
+    end
+
     def cron_string_valid?
       # rubocop:disable Layout/LineLength
-      regex = %r{\A(\*|([0-5]?\d)(,([0-5]?\d))*|(\*/\d+)|(\d+-\d+)) (\*|([01]?\d|2[0-3])(,([01]?\d|2[0-3]))*|(\*/\d+)|(\d+-\d+)) (\*|([12]?\d|3[01])(,([12]?\d|3[01]))*|(\*/\d+)|(\d+-\d+)) (\*|([1-9]|1[0-2])(,([1-9]|1[0-2]))*|(\*/\d+)|(\d+-\d+)) \*\z}
+      regex = %r{\A(\*|([0-5]?\d)(,([0-5]?\d))*|(\*/\d+)|(\d+-\d+)) (\*|([01]?\d|2[0-3])(,([01]?\d|2[0-3]))*|(\*/\d+)|(\d+-\d+)) (\*|([12]?\d|3[01])(,([12]?\d|3[01]))*|(\*/\d+)|(\d+-\d+)) (\*|(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC|[1-9]|1[0-2])(,(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC|[1-9]|1[0-2])|-(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC))*|(\*/\d+)|(\d+-\d+)) (\*|(SUN|MON|TUE|WED|THU|FRI|SAT|[0-6])(,(SUN|MON|TUE|WED|THU|FRI|SAT|[0-6])|-(SUN|MON|TUE|WED|THU|FRI|SAT))*|(\*/[0-6]+)|([0-6]-[0-6]))\z}
       # rubocop:enable Layout/LineLength
       cron_string.match?(regex)
     end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: cron_calc
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Jakub Miziński
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-12-19 00:00:00.000000000 Z
+date: 2023-12-22 00:00:00.000000000 Z
 dependencies: []
 description: |-
-  Calculates cron job occurrences within a specified period \n
+  Calculates cron job occurrences within a specified period
                         or determines next/last "n" occurrences based on a specified time.
 email:
 - jakubmizinski@gmail.com