rufus-scheduler 3.9.0 → 3.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec5b405be33c70ef390f2d8c47be112c7cf05c32eda58a0a764bbf42fae1b5d6
-  data.tar.gz: c03f4dc830c7041a530d899d69d91f7409ba481bbd12241152543b0eae20fc23
+  metadata.gz: a9db2ffb7b6d057285e7e5fe94a8d984931d59dcad6c73ddb4375888d23f67ce
+  data.tar.gz: 30a77e6df03c57cbebb532490f7c4162bc46a071f12eb55cab1d4e4a2a6f6f46
 SHA512:
-  metadata.gz: e5d992e7ad0a23530320731348c3c890b90d0184851d7faf807a36e4c6dd5d879579a478478055beab569e14603f129a7ad15022f2bf6b297a3e9f27cb31fb4c
-  data.tar.gz: 85be36f54b76add7704907a3a7d43339a392d49fc05e03b62dc28e20a88eeb03cd132f64e1f3a1378f2e6e3128d57fb7fa4fe6f6ccd89fdd8b1d24fe93312583
+  metadata.gz: 8a70f7d30cc73d68ad64ad2d774dc2422fc74487aa655ec8f1c97b465db07e243592015ff3d62f01354b5541fe611b3a505a5e90529048226305de7f800bba98
+  data.tar.gz: 6d5df01c2f1f0da7502fb82f81ec25d17f90c8c04eaf6f15fc389d9471145ba9ef30da50e2377744c7bb367fb5d4aeda469e8b8548b45894abd72a4ccb65d857

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 # CHANGELOG.md
 
 
+### rufus-scheduler 3.9.1 - released 2023-06-09
+
+* Introduce :first_at_no_error option, austinarbor gh-342
+
+
 ### rufus-scheduler 3.9.0 - released 2023-06-02
 
 * Add note about Chronic and "Wed at 2pm", gh-340

data/CREDITS.md

@@ -4,6 +4,7 @@
 
 ## Contributors
 
+* Austin Arbor https://github.com/austinarbor gh-342 first_at_error
 * Bence Monus https://github.com/cromega gh-337 on_error and friends
 * Talia Wong https://github.com/blowfishpro gh-335 on_error and friends
 * Konstantin https://github.com/fa11enangel gh-334 nodejitsu link
@@ -72,6 +73,7 @@
 
 ## Feedback
 
+* jasonwbarnett (https://github.com/jaswonwbarnett) past time jobs, gh-339
 * aphel (https://github.com/itsaphel) #shutdown vs current thread, gh-304
 * aesyondu (https://github.com/aesyondu) Rails console 4.2.x, gh-186
 * Sasha Hoellger (https://github.com/mitnal) parse_cron and readme, gh-270

data/README.md

@@ -515,6 +515,18 @@ that'll output something like:
 ...
 ```
 
+### :first_at_no_error
+
+In some heavy-duty configurations, the `:first_at` setting might be set on a point of time before the actual scheduling/triggering occurs and will result in an error `"cannot set first[_at|_in] in the past..."`. To prevent that, the `:first_at_no_error` option may be set to true.
+
+```ruby
+scheduler.every '10h', first_at: Time.now + 10, first_at_no_error: true do
+  # ...
+end
+```
+
+As introduced in [gh-342](https://github.com/jmettraux/rufus-scheduler/pull/342).
+
 ### :last_at, :last_in, :last
 
 This option is for repeat jobs (cron / every) only.
@@ -1646,6 +1658,26 @@ require 'tzinfo/data'
 require 'rufus-scheduler'
 ```
 
+### Timezone in the schedule thread
+
+Currently (3.9.x), rufus-scheduler strives to trigger at the right time. The trigger thread might not yield a `Time.now` in the scheduled timezone.
+
+```ruby
+ENV['TZ'] = 'Asia/Tokyo'
+
+require 'rufus-scheduler'
+
+s = Rufus::Scheduler.new
+
+s.cron('*/5 * * * * * Europe/Rome') do
+  p Time.now # ==> the representation will indicate the time is UTC+0900...
+end
+
+s.join
+```
+
+In the wake of [gh-341](https://github.com/jmettraux/rufus-scheduler/issues/341).
+
 
 ## so Rails?
 

data/lib/rufus/scheduler/jobs_repeat.rb

@@ -15,6 +15,8 @@ class Rufus::Scheduler::RepeatJob < Rufus::Scheduler::Job
 
     @times = opts[:times]
 
+    @first_at_no_error = opts[:first_at_no_error] || false
+
     fail ArgumentError.new(
       "cannot accept :times => #{@times.inspect}, not nil or an int"
     ) unless @times == nil || @times.is_a?(Integer)
@@ -43,6 +45,7 @@ class Rufus::Scheduler::RepeatJob < Rufus::Scheduler::Job
 
     @first_at = (fdur && (EoTime.now + fdur)) || EoTime.make(first)
     @first_at = n1 if @first_at >= n0 && @first_at < n1
+    @first_at = n0 if @first_at < n0 && @first_at_no_error
 
     fail ArgumentError.new(
       "cannot set first[_at|_in] in the past: " +
@@ -319,4 +322,3 @@ class Rufus::Scheduler::CronJob < Rufus::Scheduler::RepeatJob
       end
   end
 end
-

data/lib/rufus/scheduler.rb

@@ -9,7 +9,7 @@ module Rufus; end
 
 class Rufus::Scheduler
 
-  VERSION = '3.9.0'
+  VERSION = '3.9.1'
 
   EoTime = ::EtOrbi::EoTime
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rufus-scheduler
 version: !ruby/object:Gem::Version
-  version: 3.9.0
+  version: 3.9.1
 platform: ruby
 authors:
 - John Mettraux
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-02 00:00:00.000000000 Z
+date: 2023-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fugit