ruby-clock 2.0.0.beta7 → 2.0.0.beta9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a64343fae81372c459f3ea52c8358f2b9425c16fdb354ba29eeff18cc836927
-  data.tar.gz: cd17b15fcc7dcbdccc6e83dedab43316036a1b2a3a3cc143add9d7523586f4d2
+  metadata.gz: cc7625ea594c3028d9503ad7c1013b7888c776a51bf5853ada639cef1b9d754c
+  data.tar.gz: 6c3d8841a45cd336a108c334b94e35441200885b2329ac6dbf39751dd32b8451
 SHA512:
-  metadata.gz: 9e07fe25a8ee147c0dfca4fb90904b5a2c4a79d4c0e59953a616466080a626d95a457a8efd1844e92bed7a130fd0ad15480beb4be9155ab3d7a3f903decf5024
-  data.tar.gz: d8d40783de5f21398e1170f6bbfd9212fae1ba90a879aaec68002d433a9499455f6e506c968e8e040cce81f99e74991bba8c35a29e6ff94dd34b3dcd763f3c5d
+  metadata.gz: f8067434425e00d84371aa7242d78ebf9a24f355e2f13ec1cba79e7140301d2902b4bf2902237023b277ebfd876c88761b4cdc15de33df8225837ab074bb1781
+  data.tar.gz: 93eb07e47f6a8ec2cad4f7916090bb2f310657cca5bae3adef090e7a08f2de7d9b4af62f9e6649e1ab35eb5b2fc81d4a2063971bea6b37e3759473cd722ea47a

data/CHANGELOG.md

@@ -5,29 +5,32 @@
   is implemented is now compatible with both rails 6 and 7
 * RUBY_CLOCK_SHUTDOWN_WAIT_SECONDS value is logged when starting
 * 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`)
 * Around callbacks now have a top-level namespace method. `def schedule.around_trigger` → `around_action do`
 * Multiple around callbacks can be consecutively assigned - no need to put all behavior into one method
+* Error handler definition is now at the top-level namespace (`def schedule.on_error` → `on_error do`)
 * Errors encountered when loading Clockfile (such as incorrect cron syntax)
   will be reported to the error handler
 * The automatic identifier generator will now ignore `}` and `end` lines
-* posix-spawn is no longer used. In ruby 3, native `Process.spawn` is more performant. See
+* posix-spawn is no longer used. In ruby ~3~ 2.2, native `Process.spawn` is more performant. See
   [posix-spawn#90](https://github.com/rtomayko/posix-spawn/issues/90)
   and
   [terrapin#19](https://github.com/thoughtbot/terrapin/pull/19)
   for more info.
+* ability to load multiple clockfiles with one invocation
+* job slugs based on job identifier, e.g. "Widget Co. Weekly Reports" -> "widget-co-weekly-reports"
+* `--check-slug-uniqueness`
+* `--environment-and-syntax-check`
 
 ### Anti-Features
 * ruby 3.0 is now the minimum version
 
 ### Code Improvements
 * The code which implements the rails reloader/executor is now less complicated
-* Code reorganization so there are no unnecessary methods in top-level Kernel namespace
+* Code reorganization so there are no unnecessary methods in top-level `Kernel` namespace
 * top-level DSL methods are now implemented with refinements, so they don't polute other code
 
 
 ### Migrating from ruby-clock version 1 to version 2
-
 * The minimum ruby version is 3.0
 * The top of every Clockfile must begin with `using RubyClock::DSL`
 * If you have an existing `def schedule.around_trigger`, you will need to change it to use the new
@@ -36,6 +39,7 @@
   `every`, `cron`, and `on_error` at the top-level, without referencing `schedule`.
 * You now have the option of catching and reporting errors encountered when parsing the Clockfile.
 * There is no longer a need to have a binstub in rails. You can delete bin/clock from your app.
+* remove the `posix-spawn` gem from your project
 * The invocations (in Procfile, or wherever else you start ruby-clock) should change from
 
       bundle exec rails runner bin/clock

data/README.md

@@ -33,7 +33,7 @@ ruby >= 3.0 is required.
 Add these lines to your application's Gemfile:
 
 ```ruby
-gem 'ruby-clock'
+gem 'ruby-clock', '2.0.0.beta9'
 ```
 
 And then execute:
@@ -71,6 +71,11 @@ This will ignore Clockfile and only read jobs from clocks/MyClockfile:
 
     bundle exec clock clocks/MyClockfile
 
+You can also load multiple files with one invocation
+(although a better approach might be to load your subfiles within a top-level Clockfile):
+
+    bundle exec clock clocks/daily.rb clocks/weekly.rb
+
 ### Rails
 
 To run your clock process in your app's environment:
@@ -139,6 +144,27 @@ to another process or file. To change this behavior and have logs flush immediat
 add `$stdout.sync = true` to the top of your Clockfile.
 
 
+#### Testing
+
+You can use the `--environment-and-syntax-check` flag to load the app environment and check
+Clockfile syntax without actually running jobs. This can be used to check if cron syntax
+is valid during dev, or in automate tests.
+
+```ruby
+# system returns true/false depending on 0/1 exit status of process
+assert(system("bundle exec --environment-and-syntax-check clock/my_clockfile.rb"))
+```
+
+You can use `--check-slug-uniqueness` to check if all the auto-generated slugs are unique. If you have
+multiple files with jobs, you need to pass them all in with one invocation in order to check global uniqueness.
+
+```ruby
+# system returns true/false depending on 0/1 exit status of process
+assert(system("bundle exec --check-slug-uniqueness")) # loads Clockfile
+assert(system("bundle exec --check-slug-uniqueness clock/weekly.rb clock/daily.rb")) # load specific files
+```
+
+
 ## More Config and Capabilities
 
 ### Error Handling
@@ -151,7 +177,7 @@ error reports about problems while loading the Clockfile:
 on_error do |job, error|
   case job
   when String # this means there was a problem parsing the Clockfile while starting
-    ErrorReporter.track_exception(error, tag: 'clock', severity: 'high')
+    ErrorReporter.track_exception(StandardError.new(error), tag: 'clock', severity: 'high')
   else
     ErrorReporter.track_exception(error, tag: 'clock', custom_attribute: {job_name: job.identifier})
   end
@@ -286,7 +312,7 @@ There are also `rake_execute` and `rake_async`.
 See [the code](https://github.com/jjb/ruby-clock/blob/main/lib/ruby-clock/rake.rb)
 and [this article](https://code.jjb.cc/running-rake-tasks-from-within-ruby-on-rails-code) for more info.
 
-### Job Identifier
+### Job Identifier & Slug
 
 ruby-clock adds the `identifier` method to `Rufus::Scheduler::Job`. This method will return the job's
 [name](https://github.com/jmettraux/rufus-scheduler/#name--string) if one was given.
@@ -294,30 +320,35 @@ If a name is not given, the last non-comment code line in the job's block
 will be used instead. If for some reason an error is encountered while calculating this, the next
 fallback is the line number of the job in Clockfile.
 
-Some examples of jobs and their identifiers:
+There is also the `slug` method, which produces a slug using
+[ActiveSupport parameterize](https://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-parameterize),
+and with underscores changed to hyphens.
+If the `activesupport` gem is not in your Gemfile and you attempt to use `slug`, it will fail.
+
+Some examples of identifiers and slugs:
 
 ```ruby
 every '1 second', name: 'my job' do
   Foo.bar
 end
-# => my job
+# my job, my-job
 
 every '1 day' do
   daily_things = Foo.setup_daily
   daily_things.process
   # TODO: figure out best time of day
 end
-# => daily_things.process
+# daily_things.process, daily-things-process
 
 # n.b. ruby-clock isn't yet smart enough to remove trailing comments
 every '1 week' do
   weekly_things = Foo.setup_weekly
   weekly_things.process # does this work???!1~
 end
-# => weekly_things.process # does this work???!1~
+# weekly_things.process # does this work???!1~, weekly-things-process-does-this-work-1
 ```
 
-This can be used for keeping track of job behavior in logs or a
+The identifier can be used for keeping track of job behavior in logs or a
 stats tracker. For example:
 
 ```ruby
@@ -345,6 +376,18 @@ every '10 seconds', name: 'thread stats' do
 end
 ```
 
+The slug can be used for similar purposes where a slug-style string is needed. Here you can report
+your job to a scheduled job monitor:
+
+```ruby
+# TODO proper example for healthcheks
+around_action do |job_proc, job_info|
+  Net::HTTP.get("https://mymonitor.example.com/APIKEY/start/#{job_info.slug}")
+  job_proc.call
+  Net::HTTP.get("https://mymonitor.example.com/APIKEY/stop/#{job_info.slug}")
+end
+```
+
 ### Other rufus-scheduler Options
 
 All [rufus-scheduler](https://github.com/jmettraux/rufus-scheduler/) options are set to defaults.

data/example-app/Clockfile

@@ -14,7 +14,7 @@ end
 # end
 
 around_action do |job_proc, job_info|
-  puts "before1 #{job_info.class} #{job_info.identifier}"
+  puts "before1 #{job_info.class} #{job_info.identifier} #{job_info.slug}"
   job_proc.call
   puts "after1"
 end

data/example-app/Gemfile

@@ -5,4 +5,5 @@ source "https://rubygems.org"
 ruby '>= 3.0'
 
 gem 'ruby-clock', path: '../'
+gem 'activesupport'
 # gem 'terrapin'

data/exe/clock

@@ -9,16 +9,64 @@ RubyClock.instance.prepare_rake
 RubyClock.instance.schedule.pause
 RubyClock.instance.add_rails_executor_to_around_actions
 
-begin
-  load ARGV[0] || 'Clockfile'
-rescue => clockfile_error
-  if RubyClock.instance.on_error
-    RubyClock.instance.on_error.call("An error has occured while parsing the clockfile", clockfile_error)
+check_syntax = false
+check_slug_uniqueness = false
+if '--' == ARGV[0][0..1]
+  case ARGV[0]
+  when '--environment-and-syntax-check'
+    check_syntax = true
+  when '--check-slug-uniqueness'
+    check_slug_uniqueness = true
+  else
+    raise 'unknown option'
   end
+  if ARGV[1]
+    clockfiles = ARGV[1..]
+  else
+    clockfiles = ['Clockfile']
+  end
+else
+  if ARGV[0]
+    clockfiles = ARGV[0..]
+  else
+    clockfiles = ['Clockfile']
+  end
+end
 
-  raise
+clockfiles.each do |clockfile|
+  begin
+    load clockfile
+  rescue => clockfile_error
+    if RubyClock.instance.on_error
+      RubyClock.instance.on_error.call("An error has occured while parsing the clockfile #{clockfile}", clockfile_error)
+    end
+
+    raise
+  end
 end
 
 RubyClock.instance.ensure_around_trigger_has_not_been_redefined
 RubyClock.instance.freeze_around_actions
-RubyClock.instance.run_jobs
+
+if check_syntax
+  puts "✨ Environment & Syntax OK ✨"
+elsif check_slug_uniqueness
+  slugs = {}
+  RubyClock.instance.schedule.jobs.each do |j|
+    if slugs[j.slug]
+      slugs[j.slug] +=1
+    else
+      slugs[j.slug] = 1
+    end
+  end
+  slugs_with_duplicates = []
+  slugs.each{|s,count| slugs_with_duplicates << s if count > 1 }
+  if slugs_with_duplicates.any?
+    puts "The following slugs have duplicates: #{slugs_with_duplicates}"
+    exit(false)
+  else
+    puts "✨ All Slugs Are Unique ✨"
+  end
+else
+  RubyClock.instance.run_jobs
+end

data/lib/ruby-clock/version.rb

@@ -1,3 +1,3 @@
 class RubyClock
-  VERSION = "2.0.0.beta7"
+  VERSION = "2.0.0.beta9"
 end

data/lib/rufus_monkeypatch.rb

@@ -1,6 +1,8 @@
 require 'method_source'
+
 class Rufus::Scheduler::Job
   UNDESIRED_ELEMENTS = ['', '}', 'end']
+
   def identifier
     @identifier ||= begin
       return name if name
@@ -18,4 +20,9 @@ class Rufus::Scheduler::Job
       end
     end
   end
+
+  def slug
+    require 'active_support/inflector'
+    identifier.gsub('_', '-').parameterize
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-clock
 version: !ruby/object:Gem::Version
-  version: 2.0.0.beta7
+  version: 2.0.0.beta9
 platform: ruby
 authors:
 - John Bachir
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-04-06 00:00:00.000000000 Z
+date: 2023-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rufus-scheduler