rufus-scheduler 3.9.0 → 3.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec5b405be33c70ef390f2d8c47be112c7cf05c32eda58a0a764bbf42fae1b5d6
-  data.tar.gz: c03f4dc830c7041a530d899d69d91f7409ba481bbd12241152543b0eae20fc23
+  metadata.gz: 256656e17e60670dad5d075427c1b3b4326f6f5dac5f232107520c12ea5f32c7
+  data.tar.gz: 6d04177caae292158791d02e095b184bf6f2f888157ef6de1345f5841ed4a94f
 SHA512:
-  metadata.gz: e5d992e7ad0a23530320731348c3c890b90d0184851d7faf807a36e4c6dd5d879579a478478055beab569e14603f129a7ad15022f2bf6b297a3e9f27cb31fb4c
-  data.tar.gz: 85be36f54b76add7704907a3a7d43339a392d49fc05e03b62dc28e20a88eeb03cd132f64e1f3a1378f2e6e3128d57fb7fa4fe6f6ccd89fdd8b1d24fe93312583
+  metadata.gz: a8ebf970f2b6bc1d08202a8aa889fa00825ca086d8fb94d696b56703451af5591ac84111a512c9ede9ac54132f4ea73b59480746b005b093371de3284f82df0c
+  data.tar.gz: 0f811b3323c837bbe07f59d6988c92a911e0dfc1c8bd93da877a432ede76abbe5a0da724fd67ed3279ebba480d34a7e2b01b904d7946c8a5375e1929b65a2f35

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 # CHANGELOG.md
 
 
+### rufus-scheduler 3.9.2 - released 2024-09-04
+
+* For fugit >= 1.11.1
+
+
+### 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,8 @@
 
 ## Contributors
 
+* Geremia Taglialatela, https://github.com/tagliala, mfa opt-in gh-347
+* 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 +74,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

@@ -72,17 +72,22 @@ It does not persist your schedules. When the process is gone and the scheduler i
 
 A rufus-scheduler instance will go on scheduling while it is present among the objects in a Ruby process. To make it stop scheduling you have to call its [`#shutdown` method](#schedulershutdown).
 
+Please note: rufus-scheduler is not a cron replacement.
 
-## related and similar gems
 
-* [Whenever](https://github.com/javan/whenever) - let cron call back your Ruby code, trusted and reliable cron drives your schedule
+## related gems
+
 * [ruby-clock](https://github.com/jjb/ruby-clock) - a clock process / job scheduler for Ruby
+* [Puma-Rufus-Scheduler](https://github.com/javierav/puma-rufus-scheduler) - Puma plugin to run Rufus-Scheduler
+
+
+## similar gems
+
+* [Whenever](https://github.com/javan/whenever) - let cron call back your Ruby code, trusted and reliable cron drives your schedule
 * [Clockwork](https://github.com/Rykian/clockwork) - rufus-scheduler inspired gem
 * [Crono](https://github.com/plashchynski/crono) - an in-Rails cron scheduler
 * [PerfectSched](https://github.com/treasure-data/perfectsched) - highly available distributed cron built on [Sequel](https://sequel.jeremyevans.net) and more
 
-(please note: rufus-scheduler is not a cron replacement)
-
 
 ## note about the 3.0 line
 
@@ -515,6 +520,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.
@@ -1449,7 +1466,7 @@ The #confirm_lock method is called right before a job triggers (if it is provide
 
 (introduced in rufus-scheduler 3.0.9).
 
-Another way of prodiving `#lock`, `#unlock` and `#confirm_lock` to a rufus-scheduler is by using the `:scheduler_lock` and `:trigger_lock` options.
+Another way of providing `#lock`, `#unlock` and `#confirm_lock` to a rufus-scheduler is by using the `:scheduler_lock` and `:trigger_lock` options.
 
 See [:trigger_lock](#trigger_lock) and [:scheduler_lock](#scheduler_lock).
 
@@ -1646,6 +1663,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?
 
@@ -1747,7 +1784,7 @@ If, anyway, you need something like `rails server -d`, why not try `bundle exec
 
 ### executor / reloader
 
-You might benefit from wraping your scheduled code in the executor or reloader. Read more here: https://guides.rubyonrails.org/threading_and_code_execution.html
+You might benefit from wrapping your scheduled code in the executor or reloader. Read more here: https://guides.rubyonrails.org/threading_and_code_execution.html
 
 ## support
 

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.2'
 
   EoTime = ::EtOrbi::EoTime
 

data/rufus-scheduler.gemspec

@@ -26,12 +26,12 @@ Job scheduler for Ruby (at, cron, in and every jobs). Not a replacement for cron
     #'wiki_uri' => s.homepage + '/flor/wiki',
     #'documentation_uri' => s.homepage + '/tree/master/doc',
     #'mailing_list_uri' => 'https://groups.google.com/forum/#!forum/floraison',
+    'rubygems_mfa_required' => 'true',
   }
 
   #s.files = `git ls-files`.split("\n")
   s.files = Dir[
-    'README.{md,txt}',
-    'CHANGELOG.{md,txt}', 'CREDITS.{md,txt}', 'LICENSE.{md,txt}',
+    '{README,CHANGELOG,CREDITS,LICENSE}.{md,txt}',
     'Makefile',
     'lib/**/*.rb', #'spec/**/*.rb', 'test/**/*.rb',
     "#{s.name}.gemspec",
@@ -39,7 +39,7 @@ Job scheduler for Ruby (at, cron, in and every jobs). Not a replacement for cron
 
   s.required_ruby_version = '>= 1.9'
 
-  s.add_runtime_dependency 'fugit', '~> 1.1', '>= 1.1.6'
+  s.add_runtime_dependency 'fugit', '~> 1.1', '>= 1.11.1'
 
   s.add_development_dependency 'rspec', '~> 3.7'
   s.add_development_dependency 'chronic', '~> 0.10'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rufus-scheduler
 version: !ruby/object:Gem::Version
-  version: 3.9.0
+  version: 3.9.2
 platform: ruby
 authors:
 - John Mettraux
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-02 00:00:00.000000000 Z
+date: 2024-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fugit
@@ -19,7 +19,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.6
+        version: 1.11.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.6
+        version: 1.11.1
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -88,6 +88,7 @@ metadata:
   bug_tracker_uri: https://github.com/jmettraux/rufus-scheduler/issues
   homepage_uri: https://github.com/jmettraux/rufus-scheduler
   source_code_uri: https://github.com/jmettraux/rufus-scheduler
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -103,7 +104,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: job scheduler for Ruby (at, cron, in and every jobs)