canvas_sync 0.17.2 → 0.17.5.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7e920904fe92285bd67cbf48a88e8aa6c03761dbb543eb9ee477058f3086c2a
-  data.tar.gz: d2221d37737fde81de62a0f9d6d304cf059c30cc78f3be814c01849365257680
+  metadata.gz: 5291764ad05bd9687d1e6b4533dfa883be3a394934aba61707e0e1fd77076c35
+  data.tar.gz: 191f1e112916749fbc81797c5af3826ebf65eac94d293584bab424cefd12506d
 SHA512:
-  metadata.gz: 3a988e7678bc3f0e6e33325171f7665cc016cf30d07aa299c69268339587433e69d7c11036d797358c4f563d21956b74a48bb7bd5cc656d86ba01edde5d85a3f
-  data.tar.gz: 74f9f9ba4a6a6a59e1a7dbb2dba351cee464d12d74ef526784fa63d81e319656163ccb52fbca1f71a7af664148f6712e77513bbf4346e432bc9394fede53ed3f
+  metadata.gz: eb42503d2afe8ec5a0b6f667c056fb038e3999580ca82c52ff0cac8d410e981f5f6a5c9be4bcee6ad9878d54b4a54cc15eafca0e5c202dadea0315bfe9e2b824
+  data.tar.gz: 4e912435b6110c8b552570112db9b4f3fce4fc34e851907e09326290e1988ca11333ee0c619ad2dab8b5d077cd275727bd603f8d1438962cea88937a1076d4e9

data/README.md

@@ -246,6 +246,64 @@ A batch can be created using `Sidekiq::Batch` or `CanvasSync::JobBatching::Batch
 
 Also see `canvas_sync/jobs/begin_sync_chain_job`, `canvas_sync/Job_batches/jobs/serial_batch_job`, or `canvas_sync/Job_batches/jobs/concurrent_batch_job` for example usage.
 
+Example:
+```ruby
+batch = CanvasSync::JobBatches::Batch.new
+batch.description = "Some Batch" # Optional, but can be useful for debugging
+
+batch.on(:complete, "SomeClass.on_complete", kw_param: 1)
+batch.on(:success, "SomeClass.on_success", some_param: 'foo')
+
+# Add context to the batch. Can be accessed as batch_context on any jobs within the batch.
+# Nested Batches will have their contexts merged
+batch.context = {
+  some_value: 'blah',
+}
+
+batch.jobs do
+  # Enqueue jobs like normal
+end
+```
+
+#### Job Pools
+A job pool is like a custom Sidekiq Queue. You can add jobs to it and it will empty itself out into one of the actual queues.
+However, it adds some options for tweaking the logic:
+- `concurrency` (default: `nil`) - Define how many jobs from the pool can run at once.
+- `order` (default: `fifo`) - Define how the pool will empty itself
+  - `fifo` - First-In First-Out, a traditional queue
+  - `lifo` - Last-In First-Out
+  - `random` - Pluck and run jobs in random order
+  - `priority` - Execute jobs in a priority order (NB: Due to Redis, this priority-random, meaning that items with the same priority will be run in random order, not fifo)
+- `clean_when_empty` (default: `true`) - Automatically clean the pool when it is empty
+- `on_failed_job` (default `:wait`) - If a Job fails, should the pool `:continue` and still enqueue the next job or `:wait` for the job to succeed
+
+Example:
+```ruby
+pool = CanvasSync::JobBatches::Pool.new(concurrency: 4, order: :priority, clean_when_empty: false)
+pool_id = pool.pid
+
+# Add a job to the pool
+pool << {
+  job: SomeJob, # The Class of a ActiveJob Job or Sidekiq Worker
+  parameters: [1, 2, 3], # Array of params to pass th e Job
+  priority: 100, # Only effective if order=:priority, higher is higher
+}
+
+# Add many jobs to the pool
+pool.add_jobs([
+  {
+    job: SomeJob, # The Class of a ActiveJob Job or Sidekiq Worker
+    parameters: [1, 2, 3], # Array of params to pass th e Job
+    priority: 100, # Only effective if order=:priority, higher is higher
+  },
+  # ...
+])
+
+# ...Later
+CanvasSync::JobBatches::Pool.from_pid(pool_id).cleanup_redis
+
+```
+
 ## Legacy Support
 
 ### Legacy Mappings

data/lib/canvas_sync/job_batches/batch.rb

@@ -4,10 +4,13 @@ begin
 rescue LoadError
 end
 
+require_relative './redis_model'
+require_relative './redis_script'
 require_relative './batch_aware_job'
 require_relative "./callback"
 require_relative "./context_hash"
 require_relative "./status"
+require_relative "./pool"
 Dir[File.dirname(__FILE__) + "/jobs/*.rb"].each { |file| require file }
 require_relative "./chain_builder"
 
@@ -16,25 +19,12 @@ require_relative "./chain_builder"
 
 module CanvasSync
   module JobBatches
-    class Batch
-      class NoBlockGivenError < StandardError; end
+    class SuccessfulFailure < RuntimeError; end
 
-      def self.batch_attr(key, read_only: true)
-        class_eval <<-RUBY, __FILE__, __LINE__ + 1
-          def #{key}=(value)
-            raise "#{key} is read-only once the batch has been started" if #{read_only.to_s} && (@initialized || @existing)
-            @#{key} = value
-            persist_bid_attr('#{key}', value)
-          end
+    class Batch
+      include RedisModel
 
-          def #{key}
-            return @#{key} if defined?(@#{key})
-            if (@initialized || @existing)
-              @#{key} = read_bid_attr('#{key}')
-            end
-          end
-        RUBY
-      end
+      class NoBlockGivenError < StandardError; end
 
       delegate :redis, to: :class
 
@@ -47,16 +37,14 @@ module CanvasSync
         @existing = !(!existing_bid || existing_bid.empty?)  # Basically existing_bid.present?
         @initialized = false
         @bidkey = "BID-" + @bid.to_s
-        @pending_attrs = {}
-        @ready_to_queue = nil
         self.created_at = Time.now.utc.to_f unless @existing
       end
 
-      batch_attr :description
-      batch_attr :created_at
-      batch_attr :callback_queue, read_only: false
-      batch_attr :callback_batch, read_only: false
-      batch_attr :allow_context_changes
+      redis_attr :description
+      redis_attr :created_at
+      redis_attr :callback_queue, read_only: false
+      redis_attr :callback_params, :json
+      redis_attr :allow_context_changes
 
       def context
         return @context if defined?(@context)
@@ -113,7 +101,7 @@ module CanvasSync
               if parent_bid
                 r.hincrby("BID-#{parent_bid}", "children", 1)
                 r.expire("BID-#{parent_bid}", BID_EXPIRE_TTL)
-                r.sadd("BID-#{parent_bid}-bids", bid)
+                r.zadd("BID-#{parent_bid}-bids", created_at, bid)
               end
             end
           end
@@ -122,29 +110,24 @@ module CanvasSync
           @context&.save!
 
           @initialized = true
+        else
+          assert_batch_is_open
         end
 
-        job_queue = @ready_to_queue = []
-
         begin
           parent = Thread.current[:batch]
           Thread.current[:batch] = self
           yield
         ensure
-          @ready_to_queue = nil
-          append_jobs(job_queue, parent_bid)
           Thread.current[:batch] = parent
         end
 
-        job_queue
+        nil
       end
 
       def increment_job_queue(jid)
-        if @ready_to_queue
-          @ready_to_queue << jid
-        else
-          append_jobs([jid])
-        end
+        assert_batch_is_open
+        append_jobs([jid])
       end
 
       def invalidate_all
@@ -170,58 +153,56 @@ module CanvasSync
         batch.parent ? valid && valid?(batch.parent) : valid
       end
 
-      # Any Batches or Jobs created in the given block won't be assocaiated to the current batch
-      def self.without_batch
+      def self.with_batch(batch)
+        batch = self.new(batch) if batch.is_a?(String)
         parent = Thread.current[:batch]
-        Thread.current[:batch] = nil
+        Thread.current[:batch] = batch
         yield
       ensure
         Thread.current[:batch] = parent
       end
 
-      private
+      # Any Batches or Jobs created in the given block won't be assocaiated to the current batch
+      def self.without_batch(&blk)
+        with_batch(nil, &blk)
+      end
 
-      def persist_bid_attr(attribute, value)
-        if @initialized || @existing
-          redis do |r|
-            r.multi do
-              r.hset(@bidkey, attribute, value)
-              r.expire(@bidkey, BID_EXPIRE_TTL)
-            end
-          end
-        else
-          @pending_attrs[attribute] = value
-        end
+      protected
+
+      def redis_key
+        @bidkey
       end
 
-      def read_bid_attr(attribute)
+      def flush_pending_attrs
+        super
         redis do |r|
-          r.hget(@bidkey, attribute)
+          r.zadd("batches", created_at, bid)
         end
       end
 
-      def flush_pending_attrs
-        redis do |r|
-          r.mapped_hmset(@bidkey, @pending_attrs)
+      private
+
+      def assert_batch_is_open
+        unless defined?(@closed)
+          redis do |r|
+            @closed = r.hget(@bidkey, 'success') == 'true'
+          end
         end
-        @pending_attrs = {}
+        raise "Cannot add jobs to Batch #{} bid - it has already entered the callback-stage" if @closed
       end
 
-      def append_jobs(jids, parent_bid = self.parent_bid)
+      def append_jobs(jids)
+        jids = jids.uniq
+        return unless jids.size > 0
+
         redis do |r|
+          tme = Time.now.utc.to_f
+          added = r.zadd(@bidkey + "-jids", jids.map{|jid| [tme, jid] }, nx: true)
           r.multi do
-            if parent_bid
-              r.hincrby("BID-#{parent_bid}", "total", jids.size)
-            end
-
-            r.hincrby(@bidkey, "pending", jids.size)
-            r.hincrby(@bidkey, "total", jids.size)
+            r.hincrby(@bidkey, "pending", added)
+            r.hincrby(@bidkey, "job_count", added)
             r.expire(@bidkey, BID_EXPIRE_TTL)
-
-            if jids.size > 0
-              r.sadd(@bidkey + "-jids", jids)
-              r.expire(@bidkey + "-jids", BID_EXPIRE_TTL)
-            end
+            r.expire(@bidkey + "-jids", BID_EXPIRE_TTL)
           end
         end
       end
@@ -229,6 +210,8 @@ module CanvasSync
       class << self
         def process_failed_job(bid, jid)
           _, pending, failed, children, complete, parent_bid = redis do |r|
+            return unless r.exists?("BID-#{bid}")
+
             r.multi do
               r.sadd("BID-#{bid}-failed", jid)
 
@@ -242,17 +225,6 @@ module CanvasSync
             end
           end
 
-          # if the batch failed, and has a parent, update the parent to show one pending and failed job
-          if parent_bid
-            redis do |r|
-              r.multi do
-                r.hincrby("BID-#{parent_bid}", "pending", 1)
-                r.sadd("BID-#{parent_bid}-failed", jid)
-                r.expire("BID-#{parent_bid}-failed", BID_EXPIRE_TTL)
-              end
-            end
-          end
-
           if pending.to_i == failed.to_i && children == complete
             enqueue_callbacks(:complete, bid)
           end
@@ -260,6 +232,8 @@ module CanvasSync
 
         def process_dead_job(bid, jid)
           _, failed, children, complete, parent_bid = redis do |r|
+            return unless r.exists?("BID-#{bid}")
+
             r.multi do
               r.sadd("BID-#{bid}-dead", jid)
 
@@ -285,7 +259,9 @@ module CanvasSync
         end
 
         def process_successful_job(bid, jid)
-          _, failed, pending, children, complete, success, total, parent_bid = redis do |r|
+          _, failed, pending, children, complete, success, parent_bid = redis do |r|
+            return unless r.exists?("BID-#{bid}")
+
             r.multi do
               r.srem("BID-#{bid}-failed", jid)
 
@@ -294,10 +270,10 @@ module CanvasSync
               r.hincrby("BID-#{bid}", "children", 0)
               r.scard("BID-#{bid}-batches-complete")
               r.scard("BID-#{bid}-batches-success")
-              r.hget("BID-#{bid}", "total")
               r.hget("BID-#{bid}", "parent_bid")
 
-              r.srem("BID-#{bid}-jids", jid)
+              r.hincrby("BID-#{bid}", "successful-jobs", 1)
+              r.zrem("BID-#{bid}-jids", jid)
               r.expire("BID-#{bid}", BID_EXPIRE_TTL)
             end
           end
@@ -313,14 +289,15 @@ module CanvasSync
         def enqueue_callbacks(event, bid)
           batch_key = "BID-#{bid}"
           callback_key = "#{batch_key}-callbacks-#{event}"
-          already_processed, _, callbacks, queue, parent_bid, callback_batch = redis do |r|
+          already_processed, _, callbacks, queue, parent_bid, callback_params = redis do |r|
+            return unless r.exists?(batch_key)
             r.multi do
               r.hget(batch_key, event)
               r.hset(batch_key, event, true)
               r.smembers(callback_key)
               r.hget(batch_key, "callback_queue")
               r.hget(batch_key, "parent_bid")
-              r.hget(batch_key, "callback_batch")
+              r.hget(batch_key, "callback_params")
             end
           end
 
@@ -328,6 +305,7 @@ module CanvasSync
 
           queue ||= "default"
           parent_bid = !parent_bid || parent_bid.empty? ? nil : parent_bid    # Basically parent_bid.blank?
+          callback_params = JSON.parse(callback_params) if callback_params.present?
           callback_args = callbacks.reduce([]) do |memo, jcb|
             cb = JSON.load(jcb)
             memo << [cb['callback'], event.to_s, cb['opts'], bid, parent_bid]
@@ -335,44 +313,44 @@ module CanvasSync
 
           opts = {"bid" => bid, "event" => event}
 
-          # Run callback batch finalize synchronously
-          if callback_batch
-            # Extract opts from cb_args or use current
-            # Pass in stored event as callback finalize is processed on complete event
-            cb_opts = callback_args.first&.at(2) || opts
+          if callback_args.present? && !callback_params.present?
+            logger.debug {"Enqueue callback bid: #{bid} event: #{event} args: #{callback_args.inspect}"}
 
-            logger.debug {"Run callback batch bid: #{bid} event: #{event} args: #{callback_args.inspect}"}
-            # Finalize now
-            finalizer = Batch::Callback::Finalize.new
-            status = Status.new bid
-            finalizer.dispatch(status, cb_opts)
+            redis do |r|
+              r.sadd("#{batch_key}-pending_callbacks", event)
+              r.expire("#{batch_key}-pending_callbacks", BID_EXPIRE_TTL)
+            end
 
-            return
+            with_batch(parent_bid) do
+              cb_batch = self.new
+              cb_batch.callback_params = {
+                for_bid: bid,
+                event: event,
+              }
+              opts['callback_bid'] = cb_batch.bid
+
+              logger.debug {"Adding callback batch: #{cb_batch.bid} for batch: #{bid}"}
+              cb_batch.jobs do
+                push_callbacks callback_args, queue
+              end
+            end
           end
 
-          logger.debug {"Enqueue callback bid: #{bid} event: #{event} args: #{callback_args.inspect}"}
-
-          if callback_args.empty?
-            # Finalize now
-            finalizer = Batch::Callback::Finalize.new
-            status = Status.new bid
-            finalizer.dispatch(status, opts)
-          else
-            # Otherwise finalize in sub batch complete callback
-            cb_batch = self.new
-            cb_batch.callback_batch = true
-            logger.debug {"Adding callback batch: #{cb_batch.bid} for batch: #{bid}"}
-            cb_batch.on(:complete, "#{Batch::Callback::Finalize.to_s}#dispatch", opts)
-            cb_batch.jobs do
-              push_callbacks callback_args, queue
-            end
+          if callback_params.present?
+            opts['origin'] = callback_params
           end
+
+          logger.debug {"Run batch finalizer bid: #{bid} event: #{event} args: #{callback_args.inspect}"}
+          finalizer = Batch::Callback::Finalize.new
+          status = Status.new bid
+          finalizer.dispatch(status, opts)
         end
 
         def cleanup_redis(bid)
           logger.debug {"Cleaning redis of batch #{bid}"}
           redis do |r|
-            r.del(
+            r.zrem("batches", bid)
+            r.unlink(
               "BID-#{bid}",
               "BID-#{bid}-callbacks-complete",
               "BID-#{bid}-callbacks-success",
@@ -381,11 +359,23 @@ module CanvasSync
               "BID-#{bid}-batches-success",
               "BID-#{bid}-batches-complete",
               "BID-#{bid}-batches-failed",
+              "BID-#{bid}-bids",
               "BID-#{bid}-jids",
+              "BID-#{bid}-pending_callbacks",
             )
           end
         end
 
+        def delete_prematurely!(bid)
+          child_bids = redis do |r|
+            r.zrange("BID-#{bid}-bids", 0, -1)
+          end
+          child_bids.each do |cbid|
+            delete_prematurely!(cbid)
+          end
+          cleanup_redis(bid)
+        end
+
         def redis(*args, &blk)
           defined?(::Sidekiq) ? ::Sidekiq.redis(*args, &blk) : nil # TODO
         end
@@ -394,10 +384,8 @@ module CanvasSync
           defined?(::Sidekiq) ? ::Sidekiq.logger : Rails.logger
         end
 
-        private
-
         def push_callbacks(args, queue)
-          Batch::Callback::Worker.enqueue_all(args, queue)
+          Batch::Callback::worker_class.enqueue_all(args, queue)
         end
       end
     end