ruby-clock 2.0.0.beta1 → 2.0.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 567b66555b094f4c722a3340b9cc5ca99abab18918033ed972dc8c65ce242b18
-  data.tar.gz: 2c9a42194dcd969623b04b1bfc21eb327cdd225322703a488f87fa1819a9302c
+  metadata.gz: 9fdfa3656f0ffbdf60b162a594809e29e9f0579cf3f5f52e98ffd857a811c348
+  data.tar.gz: f63dd579f2cd258f89f17666338ec9d433a63e2b93d0a400975ee6c1e61886fa
 SHA512:
-  metadata.gz: 0cdd8a85ec8f8de256486f027639c9d4c341131eb7dc88d519baf249733c7c655f72af923b8c8914b51d405f09a24cd9aa17efc4fc96cf807dcacdd74b024878
-  data.tar.gz: e655dce4688f88154bac50957fb321f11e07dc7d40ee5fc679a25d0e0a8feff097016ac7df128e77f4eaccae5e3fa817caa76d5a300bee364e48999bd4c0ea50
+  metadata.gz: 938ec658ba3837be8a90c49fdd8d2d6a050b1b6a19486bc2b10479e81370ed3fe5c0e4501293b02a2c8efcfe82d67974e887c2069270986f3398b89762c04707
+  data.tar.gz: c3376b79456a66c2b3c1eb5492b9a0429e69ece7b5207a73d2792c8830c33355c14dc622c2a37e8b6b8e2b9b27cdaaa4d0c83449e6e9c8aca3ae2538e2a90af0

data/CHANGELOG.md

@@ -1,16 +1,25 @@
-## 2.0.0.beta1
+## 2.0.0 beta
 
 * The way the [rails app reloader](https://guides.rubyonrails.org/threading_and_code_execution.html)
   is implemented is now compatible with both rails 6 and 7
 * The setup for rails is now less complicated
+* RUBY_CLOCK_SHUTDOWN_WAIT_SECONDS value is logged when starting
+* Code reorganization so there are no unnecessary methods in top-level Kernel namespace
+* DSL methods are now at the top-level namespace (`schedule.every` → `every`, `schedule.cron` → `cron`)
+* error handler definition is now at the top-level namespace (`def schedule.on_error` → `on_error do`)
 
 ### Migrating from ruby-clock version 1 to version 2
 
 * There is no longer a need to have a binstub in rails. You can delete bin/clock from your app.
 * The invocations (in Procfile, or wherever else you start ruby-clock) should change from
+
       bundle exec rails runner bin/clock
   to
+
       bundle exec clock
+* Your existing Clockfile will still work, but you now have the option to use
+  `every`, `cron`, and `on_error` at the top-level, without referencing `schedule`.
+  See the readme for examples.
 
 ## 1.0.0
 

data/README.md

@@ -1,3 +1,7 @@
+THESE ARE THE DOCS FOR VERSION 2.0.0.beta2
+
+See version 1 docs here: https://github.com/jjb/ruby-clock/tree/v1.0.0
+
 # ruby-clock
 
 ruby-clock is a [job scheduler](https://en.wikipedia.org/wiki/Job_scheduler),
@@ -24,6 +28,8 @@ You can change this number with `RUBY_CLOCK_SHUTDOWN_WAIT_SECONDS` in the enviro
 
 ## Installation
 
+ruby >= 2.7 is required.
+
 Add these lines to your application's Gemfile:
 
 ```ruby
@@ -41,17 +47,15 @@ Or install it yourself as:
 ## Usage
 
 Create a file named Clockfile. This will hold your job definitions.
-The DSL and capabilities
-are the same as those of [rufus-scheduler](https://github.com/jmettraux/rufus-scheduler/).
-Read the rufus-scheduler documentation to see what you can do.
+Define jobs like this:
 
 ```ruby
-schedule.every('5 minutes') do
+every('5 minutes') do
   UserDataReports.generate
 end
 
 # do something every day, five minutes after midnight
-schedule.cron '5 0 * * *' do
+cron '5 0 * * *' do
   DailyActivitySummary.generate_and_send
 end
 ```
@@ -99,7 +103,7 @@ Require your app's code at the top of Clockfile:
 
 ```ruby
 require_relative './lib/app.rb'
-schedule.every('5 minutes') do
+every('5 minutes') do
 ...
 ```
 
@@ -141,7 +145,7 @@ You can catch and report errors raised in your jobs by defining an error catcher
 the top of your Clockfile like this:
 
 ```ruby
-def schedule.on_error(job, error)
+on_error do |job, error|
   ErrorReporter.track_exception(error)
 end
 ```
@@ -157,7 +161,7 @@ to learn how to do this. Where the documentation references `s`, you should use
 You can run shell commands in your jobs.
 
 ```ruby
-schedule.every '1 day' do
+every '1 day' do
   shell('sh scripts/process_stuff.sh')
 end
 ```
@@ -172,7 +176,7 @@ If you want to use other terrapin features, you can skip the `shell` command
 and use terrapin directly:
 
 ```ruby
-schedule.every '1 day' do
+every '1 day' do
   line = Terrapin::CommandLine.new('optimize_png', ":file")
   Organization.with_new_logos.find_each do |o|
     line.run(file: o.logo_file_path)
@@ -203,7 +207,7 @@ You can run tasks from within the persistent runtime of ruby-clock, without
 needing to shell out and start another process.
 
 ```ruby
-schedule.every '1 day' do
+every '1 day' do
   rake('reports:daily')
 end
 ```
@@ -222,12 +226,12 @@ fallback is the line number of the job in Clockfile.
 Some examples of jobs and their identifiers:
 
 ```ruby
-schedule.every '1 second', name: 'my job' do
+every '1 second', name: 'my job' do
   Foo.bar
 end
 # => my job
 
-schedule.every '1 day' do
+every '1 day' do
   daily_things = Foo.setup_daily
   daily_things.process
   # TODO: figure out best time of day
@@ -235,7 +239,7 @@ end
 # => daily_things.process
 
 # n.b. ruby-clock isn't yet smart enough to remove trailing comments
-schedule.every '1 week' do
+every '1 week' do
   weekly_things = Foo.setup_weekly
   weekly_things.process # does this work???!1~
 end
@@ -253,7 +257,7 @@ def schedule.on_post_trigger(job, trigger_time)
   StatsTracker.increment('Clock: Job Executions')
 end
 
-schedule.every '10 seconds', name: 'thread stats' do
+every '10 seconds', name: 'thread stats' do
   thread_usage = Hash.new(0)
   schedule.work_threads(:active).each do |t|
     thread_usage[t[:rufus_scheduler_job].identifier] += 1
@@ -268,14 +272,17 @@ schedule.every '10 seconds', name: 'thread stats' do
 end
 ```
 
-### other rufus-scheduler Options
+### Other rufus-scheduler Options
 
-All rufus-scheduler options are set to defaults. The `schedule` variable
-available in your Clockfile is an instance of `Rufus::Scheduler`,
-so anything you can do on this instance, you can do in your Clockfile.
+All [rufus-scheduler](https://github.com/jmettraux/rufus-scheduler/) options are set to defaults.
+There is a `schedule` variable available in your Clockfile, which is the singleton instance of `Rufus::Scheduler`.
+ruby-clock methods such as `every` and `cron` are convenience methods which invoke `schedule.every`
+and `schedule.cron`.
+Anything you can do on this instance, you can do in your Clockfile.
+See the rufus-scheduler documentation to see what you can do.
 
-Perhaps in the future ruby-clock will add some easier specific configuration
-capabilities for some things. Let me know if you have a request!
+If you have ideas for rufus-scheduler features that can be brought in as
+more abstract or default ruby-clock behavior, let me know!
 
 ## Syntax highlighting for Clockfile
 

data/example-app/Clockfile

@@ -1,11 +1,15 @@
-def schedule.on_error(job, error)
+on_error do |job, error|
   raise error
 end
 
-schedule.every('2 seconds') do
+every('2 seconds') do
   puts "hello from a ruby-clock job"
 end
 
-schedule.every('2 seconds') do
+every('2 seconds') do
   shell 'say hello'
 end
+
+cron('*/10 * * * * *') do
+  puts "cron running on every 10th second #{Time.now}"
+end

data/example-rails-app/Clockfile

@@ -1,19 +1,23 @@
-def schedule.on_error(job, error)
+on_error do |job, error|
   puts "An error has occurred: #{error.class}: #{error.message}"
 end
 
-schedule.every('2 seconds') do
+every('2 seconds') do
   puts "hello from a ruby-clock job"
 end
 
-schedule.every('2 seconds') do
+every('2 seconds') do
   shell 'say hello'
 end
 
-schedule.every('2 seconds') do
+every('2 seconds') do
   puts Example.count
 end
 
-schedule.every('2 seconds') do
+every('2 seconds') do
   raise "An error."
 end
+
+cron('*/10 * * * * *') do
+  puts "cron running on every 10th second #{Time.now}"
+end

data/exe/clock

@@ -23,11 +23,37 @@ class Rufus::Scheduler::Job
   end
 end
 
-include RubyClock
+RubyClock.instance.listen_to_signals
+RubyClock.instance.prepare_rake
+RubyClock.instance.schedule.pause
+
+
+
+## Add methods to top-level namespace
+def schedule
+  RubyClock.instance.schedule
+end
+
+def on_error(&on_error_block)
+  RubyClock.instance.on_error = on_error_block
+  def schedule.on_error(job, error)
+    RubyClock.instance.on_error.call(job, error)
+  end
+end
+
+def cron(...)
+  RubyClock.instance.schedule.cron(...)
+end
+
+def every(...)
+  RubyClock.instance.schedule.every(...)
+end
+
+def shell(string)
+  RubyClock.instance.shell(string)
+end
+#####################################
 
-listen_to_signals
-prepare_rake
-schedule.pause
 
 load ARGV[0] || 'Clockfile'
 
@@ -42,4 +68,4 @@ if defined?(::Rails)
   end
 end
 
-run_jobs
+RubyClock.instance.run_jobs

data/lib/ruby-clock/version.rb

@@ -1,3 +1,3 @@
-module RubyClock
-  VERSION = "2.0.0.beta1"
+class RubyClock
+  VERSION = "2.0.0.beta2"
 end

data/lib/ruby-clock.rb

@@ -1,9 +1,18 @@
 require "ruby-clock/version"
 require 'rufus-scheduler'
+require 'singleton'
+
+class RubyClock
+
+  include Singleton
+
+  attr_accessor :on_error
+
+  def wait_seconds
+    ENV['RUBY_CLOCK_SHUTDOWN_WAIT_SECONDS']&.to_i || 29
+  end
 
-module RubyClock
   def shutdown
-    wait_seconds = ENV['RUBY_CLOCK_SHUTDOWN_WAIT_SECONDS']&.to_i || 29
     puts "Shutting down ruby-clock. Waiting #{wait_seconds} seconds for jobs to finish..."
     schedule.shutdown(wait: wait_seconds)
     puts "...done 🐈️ 👋"
@@ -21,6 +30,7 @@ module RubyClock
         end
       end
     end
+    puts "RUBY_CLOCK_SHUTDOWN_WAIT_SECONDS is set to #{wait_seconds}"
   end
 
   def schedule

data/ruby-clock.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   # spec.description   = %q{TODO: Write a longer description or delete this line.}
   spec.homepage      = "https://github.com/jjb/ruby-clock"
   spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.0")
 
   # spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-clock
 version: !ruby/object:Gem::Version
-  version: 2.0.0.beta1
+  version: 2.0.0.beta2
 platform: ruby
 authors:
 - John Bachir
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-10-01 00:00:00.000000000 Z
+date: 2022-10-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rufus-scheduler
@@ -159,7 +159,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"