symphony-metronome 0.2.2 → 0.3.0

metadata

@@ -1,95 +1,169 @@
 --- !ruby/object:Gem::Specification
 name: symphony-metronome
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
-- Mahlon E. Smith <mahlon@martini.nu>
+- Mahlon E. Smith
 autorequire: 
 bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIDbDCCAlSgAwIBAgIBATANBgkqhkiG9w0BAQUFADA+MQ8wDQYDVQQDDAZtYWhs
-  b24xFzAVBgoJkiaJk/IsZAEZFgdtYXJ0aW5pMRIwEAYKCZImiZPyLGQBGRYCbnUw
-  HhcNMTcxMTIyMjIyMTAyWhcNMTgxMTIyMjIyMTAyWjA+MQ8wDQYDVQQDDAZtYWhs
-  b24xFzAVBgoJkiaJk/IsZAEZFgdtYXJ0aW5pMRIwEAYKCZImiZPyLGQBGRYCbnUw
-  ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDpXGN0YbMVpYv4EoiCxpQw
-  sxKdyhlkvpvENUkpEhbpnEuMKXgUfRHO4T/vBZf0h8eYgwnrHCRhAeIqesFKfoj9
-  mpEJk5JUuADOAz18aT+v24UqAtJdiwBJLuqhslSNB6CFXZv3OOMny9bjoJegz0hI
-  Fht9ppCuNmxJNd+L3zAX8lD01RUWNRC+8L5QLCjViJtjFDDCFfh9NCirs+XnTCzo
-  AJgFbsZIzFJtSiXUtFgscKr4Ik8ruhRbPbYbmx9rf6W74aTMPxggq/d3gj0Eh32y
-  WsXsQ5giVnmkbsRkBNu3QyZ8Xr5+7mvy5AWyqXKOrcW7lnYaob6Z9x/MGXGNeD6j
-  AgMBAAGjdTBzMAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBRY8ea6
-  +6kAaW7ukKph2/4MTAD8/TAcBgNVHREEFTATgRFtYWhsb25AbWFydGluaS5udTAc
-  BgNVHRIEFTATgRFtYWhsb25AbWFydGluaS5udTANBgkqhkiG9w0BAQUFAAOCAQEA
-  00FljTeSNaYUqJ59yLRA+i43wVNiO4ETQQu6fYQCPns12Sm90spOJb3SmTDkJ7CY
-  dixOQg5A3Et1LVS+Z/YfH1TAbb50oTWbZbTW2JknHS0hohq3UF1pvbkk1niZ26er
-  skJ352MUfcyaUkQyMmCjL/BpkDutYH5OCGh+FmK8+mH7SoC9Nr48WwH2prVdHs3y
-  OMWFgB33sXdj1XqOd2Rw1WPgAeMeDqWeIrRMpUhNZOwroaA1MAr60f9NIYxua/vx
-  n0YyneERGuHPSRZFgo72tGOqLpAlWnhPxRNqnayZmsg3hPPI87B6MTUI2UQ7VUdh
-  UrSf3b+cPoC8PNfjp8zsdw==
+  MIIENDCCApygAwIBAgIBATANBgkqhkiG9w0BAQsFADAiMSAwHgYDVQQDDBdtYWhs
+  b24vREM9bWFydGluaS9EQz1udTAeFw0yMTAxMTcwMDQzMDZaFw0zMTAxMTUwMDQz
+  MDZaMCIxIDAeBgNVBAMMF21haGxvbi9EQz1tYXJ0aW5pL0RDPW51MIIBojANBgkq
+  hkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAsRZyNGaL3I8T2AkQsHKyixW10CY6T715
+  uOztbmZImekhmgE9Uj5xZCnUP4xG5ToJffgkxcbepyJwIHCjEQg7viL9EsA+rMNb
+  UX8dsa9jpvVD6nHAdoW8G0ee7SRBXhCfyNma8FtkDJfw2bwdKhxUKiHsULCSQ0Pd
+  p+4d5NnldgfB8cf4Hz9Ai/8FHacWnZVEiHa4Ngb5Fe42OUs+4XDQdpcgA7wCY633
+  q9rRVGK7MW9BzMv+hhQfElQMn1eDMgQVpO543viDT8JatwhhcYmKdzwTIIPAIybf
+  8MfJaimsh20OAqs3FAXNKjDVFbcXFfKUXXgVgMjUoEK5+Lp+pKPZXU4bIi5oYZqB
+  OttGPMD5rOWlAooWNQ7xbdHByUVqJmALSWHqPHdvVmAVsW8tNoB1qGbM+C6o80Ie
+  9H0389ja3TW4JK/0w/gFUmrVvYKRll44HaxS9nXNpiYBipbJmlR/R9qoe54ImQje
+  Z4vsWrWiDrK/oVYlUXOy7SE/jUAQF9UzAgMBAAGjdTBzMAkGA1UdEwQCMAAwCwYD
+  VR0PBAQDAgSwMB0GA1UdDgQWBBSx8TRqCmTPOARICKiZ3c66sIG3pTAcBgNVHREE
+  FTATgRFtYWhsb25AbWFydGluaS5udTAcBgNVHRIEFTATgRFtYWhsb25AbWFydGlu
+  aS5udTANBgkqhkiG9w0BAQsFAAOCAYEAHbiAZTe46/kp1Tkm4s6D30VBaYaAdaYG
+  bZIaAaHtJO9MbUNS0FA01fxQpptjpOQT3cNNf8CX8UHPTaSuPFMfgVWj1xiX7Byb
+  hqhUcUTENOuUxxWGDCa4orCFctc3yihojTKGtbhODHVSHf9DRDyalRcvmyWzxMFT
+  XtBS05OUXc9O1bKqzNaRc9nMGw6Y+V79hIex4mZlMBkhTeVKxeeweCXfELXOQRmB
+  FgPgUyQn0AaSpplx0YoWdy/99fEkXSMvgeEoiR1ApR6aUuTlvIr1yUgzVBpWU4mE
+  XC+Ig+3jhqufGyE/Do+1M7n5QLpgGfpy3QmoOiKeYt3XzR5Z7XoxCAaKHNRxVEga
+  ojmVnDNlLQkkZZkbFNGPHjCIBs7h+6eoIYvy/eQ82c4vd6w9rR4v9bKUL8NNkcSz
+  49pOzX5KHZLTS9DKeaP/xcGPz6C8MiwQdYrZarr2SHRASX1zFa79rkItO8kE6RDr
+  b6WDF79UvZ55ajtE00TiwqjQL/ZPEtbd
   -----END CERTIFICATE-----
-date: 2018-01-23 00:00:00.000000000 Z
+date: 2023-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: symphony
+  name: sequel
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '5.66'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '5.66'
 - !ruby/object:Gem::Dependency
-  name: sequel
+  name: sorted_set
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: symphony
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: yajl-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: rake-deveiate
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.3'
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rdoc-generator-sixfish
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.3'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: timecop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -103,45 +177,49 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.9'
 - !ruby/object:Gem::Dependency
-  name: timecop
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
-description: "\t\tMetronome is a scheduler and task runner.  It can be used locally
-  as a\n\t\tcron replacement, or as a network-wide job executor.  Events are stored\n\t\tvia
-  simple database rows, and optionally managed via AMQP events.\n\t\tInterval/time
-  values are expressed with reasonably intuitive English\n\t\tphrases, ie.: 'at 2pm',
-  or 'Starting in 20 minutes, run every 10 seconds\n\t\tand then finish in 2 days'.\n"
-email: mahlon@martini.nu
-executables:
-- metronome-exp
+        version: '0.14'
+description: |
+  Metronome is a scheduler and task runner.  It can be used locally as a
+  cron replacement, or as a network-wide job executor.  Events are stored
+  via simple database rows, and optionally managed via AMQP events.
+  Interval/time values are expressed with reasonably intuitive English
+  phrases, ie.: 'at 2pm', or 'Starting in 20 minutes, run every 10 seconds
+  and then finish in 2 days'.
+email:
+- mahlon@martini.nu
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- README.rdoc
-- bin/metronome-exp
+- History.md
+- README.md
 - data/symphony-metronome/migrations/20140419_initial.rb
 - data/symphony-metronome/migrations/20141028_lastrun.rb
 - lib/symphony/metronome.rb
 - lib/symphony/metronome/intervalexpression.rb
-- lib/symphony/metronome/intervalexpression.rl
 - lib/symphony/metronome/mixins.rb
 - lib/symphony/metronome/scheduledevent.rb
 - lib/symphony/metronome/scheduler.rb
 - lib/symphony/tasks/scheduletask.rb
-homepage: http://projects.martini.nu/ruby-modules
+homepage: https://code.martini.nu/fossil/symphony-metronome
 licenses:
-- BSD
-metadata: {}
+- BSD-3-Clause
+metadata:
+  homepage_uri: https://code.martini.nu/fossil/symphony-metronome
+  documentation_uri: https://martini.nu/docs/symphony-metronome
+  changelog_uri: https://martini.nu/docs/symphony-metronome/History_md.html
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -150,16 +228,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.3
+      version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 3.4.1
 signing_key: 
 specification_version: 4
-summary: A natural language scheduling and task runner.
+summary: A natural language scheduling and task runner for Symphony.
 test_files: []

data/README.rdoc

@@ -1,207 +0,0 @@
-
-= metronome
-
-== Description
-
-Metronome is an interval scheduler and task runner.  It can be used
-locally as a cron replacement, or as a network-wide job executor.
-
-Events are stored via simple database rows, and optionally managed
-via AMQP events.  Interval/time values are expressed with intuitive
-English phrases, ie.: 'at 2pm', or 'Starting in 20 minutes, run every 10
-seconds and then finish in 2 days', or 'execute 12 times during the next
-minute'.
-
-It includes an executable under bin/:
-
-metronome-exp::
-  A simple tester for trying out interval expression parsing.
-
-
-== Synopsis
-
-Here's an example of a cron clone:
-
-	require 'symphony/metronome'
-
-	Symphony.load_config
-
-	Symphony::Metronome.run do |opts, id|
-		Thread.new do
-			pid = fork { exec opts.delete('command') }
-			Process.waitpid( pid )
-		end
-	end
-
-
-And here's a simplistic AMQP message broadcaster, using existing
-Symphony connection information:
-
-	require 'symphony/metronome'
-
-	Symphony.load_config
-
-	Symphony::Metronome.run do |opts, id|
-		key = opts.delete( :routing_key ) or next
-		exchange = Symphony::Queue.amqp_exchange
-		exchange.publish( 'hi from Metronome!', routing_key: key )
-	end
-
-
-== Adding Actions
-
-There are two primary components to Metronome -- getting schedules into
-its database, and performing some task with those actions when the time
-is appropriate.
-
-By default, Metronome will start up an AMQP listener, attached to your
-Symphony exchange, and wait for new scheduling messages.  There are two
-events it will take action on:
-
-metronome.create::
-  Create a new scheduled event.  The payload should be a hash.  An
-  'expression' key is required, that provides the interval description.
-  Anything additional is serialized to 'options', that are passed to the
-  block when the interval fires.  You can populate it with anything
-  your task requires to execute.
-
-metronome.delete::
-  The payload is the row ID of the action.  Metronome removes it from
-  the database.
-
-
-If you'd prefer not to use the AMQP listener, you can put actions into
-Metronome using any database methodology you please.  When the daemon
-starts up or receives a HUP signal, it will re-read and schedule out
-upcoming work.
-
-
-== Performing Work
-
-Calling 'run' on the Metronome class is a blocking call, waking up upon
-a scheduled event.  The run method expects a ruby block, and it receives
-the payload and the database ID of the scheduled event.  Metronome is
-unopinioned, what you do within this block is entirely up to you.  See
-the Synopsis section above for some examples.
-
-
-== Options
-
-Metronome uses
-Configurability[https://rubygems.org/gems/configurability] to determine
-behavior.  The configuration is a YAML[http://www.yaml.org/] file.  It
-shares AMQP configuration with Symphony, and adds metronome specific
-controls in the 'metronome' key.
-
-	metronome:
-		splay: 0
-		listen: true
-		db: sqlite:///tmp/metronome.db
-
-
-=== splay
-
-Randomize all start times for actions by this many seconds on either
-side of the original execution time.  Defaults to none.
-
-=== listen
-
-Start up an AMQP listener using Symphony configuration, for remote
-administration of schedule events.  Defaults to true.
-
-=== db
-
-A {Sequel}[https://rubygems.org/gems/sequel] connection URI.  Currently,
-Metronome is tested under SQLite and PostgreSQL.  Defaults to a SQLite
-file at /tmp/metronome.db.
-
-
-== Scheduling Examples
-
-Note that Metronome is designed as an interval scheduler, not a
-calendaring app.  It doesn't have any concepts around phrases like "next
-tuesday", or "the 3rd sunday after christmas".  If that's what you're
-after, check out the {chronic}[http://rubygems.org/gems/chronic]
-library instead.
-
-Here are a small set of example expressions.  Feel free to use the
-+metronome-exp+ utility to get a feel for what Metronome anticipates.
-
-  in 30.5 minutes
-  once an hour
-  every 15 minutes for 2 days
-  at 2014-05-01
-  at 2014-04-01 14:00:25
-  at 2pm
-  starting at 2pm once a day
-  start in 1 hour from now run every 5 seconds end at 11:15pm
-  every other hour
-  run every 7th minute for a day
-  once a day ending in 1 week
-  run once a minute for an hour starting in 6 days
-  10 times a minute for 2 days
-  run 45 times every hour
-  30 times per day
-  start at 2010-01-02 run 12 times and end on 2010-01-03
-  starting in an hour from now run 6 times a minute for 2 hours
-  beginning a day from now, run 30 times per minute and finish in 2 weeks
-  execute 12 times during the next 2 minutes
-  once a minute beginning in 5 minutes
-
-In general, you can use reasonably intuitive phrasings.  Capitalization,
-whitespace, and punctuation doesn't matter.  When describing numbers,
-use digit/integer form instead of words, ie: '1 hour' instead of 'one
-hour'.
-
-
-== Installation
-
-    gem install symphony-metronome
-
-
-== Contributing
-
-You can check out the current development source with Mercurial via its
-{project page}[http://bitbucket.org/mahlon/symphony-metronome]. 
-
-After checking out the source, run:
-
-    $ rake
-
-This task will run the tests/specs and generate the API documentation.
-
-If you use {rvm}[http://rvm.io/], entering the project directory will
-install any required development dependencies.
-
-
-== License
-
-Copyright (c) 2015, Mahlon E. Smith
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-* Redistributions of source code must retain the above copyright notice,
-  this list of conditions and the following disclaimer.
-
-* Redistributions in binary form must reproduce the above copyright notice,
-  this list of conditions and the following disclaimer in the documentation
-  and/or other materials provided with the distribution.
-
-* Neither the name of the author/s, nor the names of the project's
-  contributors may be used to endorse or promote products derived from this
-  software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-

data/bin/metronome-exp

@@ -1,33 +0,0 @@
-#!/usr/bin/env ruby
-# vim: set nosta noet ts=4 sw=4:
-#
-# Simplistic interval expression tester.
-#
-
-require 'symphony/metronome'
-
-loop do
-	begin
-		exp = gets.chomp
-		next if exp.empty?
-
-		begin
-			parsed = Symphony::Metronome::IntervalExpression.parse( exp )
-			puts "OK:"
-			puts "\tvalid     | %s" % [ parsed.valid ]
-			puts "\trecurring | %s" % [ parsed.recurring ]
-			puts "\tstarting  | %s" % [ parsed.starting ]
-			puts "\tinterval  | %s" % [ parsed.recurring ? parsed.interval : '-' ]
-			puts "\tending    | %s" %
-				[ parsed.ending ? parsed.ending : (parsed.recurring ? 'never' : '-') ]
-
-		rescue => err
-			puts "NOPE: (%s) %s" % [ exp, err.message ]
-		end
-
-		puts
-
-	rescue Interrupt
-		exit 0
-	end
-end