canvas_sync 0.17.0.beta14 → 0.17.3.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28f1b87e0b26bf68a13a9a1558d8c78746a4058d2fa8a822dc62c5b3b7ad92ea
-  data.tar.gz: 0bbc9ec37d31e848a8ec4997dc91391720deb826b2a93b52528661193788ebe4
+  metadata.gz: a67693c73d6b2bd34ffd9cf6ac17038c4d226eab30e1795ebbbd6a40d03e1bff
+  data.tar.gz: 2d42669d68de6ef9242e3d956ff15c82bb18fc07ee5d9e94c5eb1ac283928599
 SHA512:
-  metadata.gz: 1cf0b4e64133d94b2841e77399a0dc3a94de42e17832587af14144d9ed28fb1df9953df3486590473abbe9745a8b919c4f910155ff71abe8eb8cc373d0d2704a
-  data.tar.gz: 166edeb5b97e5879b70eebbdf9a3f9848bc91de5a71c5cb6066860b4a6001a272faec24ddf78661d9a5322b3234d1dc69a214bf1e8e8d2c7c16cec6336f01e7a
+  metadata.gz: 8d820e38c40e77e5199ef07af41a475ad7a35d36198ee315cb552324b1159592e329d6401779ad218ed7a7c30abdbe7df2995ad26b132a1da8c33f0dea83a516
+  data.tar.gz: 035e631264ef58221f1163e60e4e8b4167a1930800c4e54bf143f148a0e56a2447d81fa0d8150f6d2ade81a9dfb5eebec07f826413cae0fd958543fb68fe9e0f

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.rb

@@ -42,6 +42,22 @@ module CanvasSync
     xlist
   ].freeze
 
+  SUPPORTED_TERM_SCOPE_MODELS = %w[
+    assignments
+    submissions
+    assignment_groups
+    context_modules
+    context_module_items
+  ].freeze
+
+  DEFAULT_TERM_SCOPE_MODELS = %w[
+    assignments
+    submissions
+    assignment_groups
+    context_modules
+    context_module_items
+  ].freeze
+
   SUPPORTED_LIVE_EVENTS = %w[
     course
     enrollment
@@ -109,6 +125,7 @@ module CanvasSync
     def default_provisioning_report_chain(
       models,
       term_scope: nil,
+      term_scoped_models: DEFAULT_TERM_SCOPE_MODELS,
       legacy_support: false,
       account_id: nil,
       updated_after: nil,
@@ -165,6 +182,10 @@ module CanvasSync
       try_add_model_job.call('roles')
       try_add_model_job.call('admins')
 
+      (SUPPORTED_TERM_SCOPE_MODELS - term_scoped_models).each do |mdl|
+        try_add_model_job.call(mdl)
+      end
+
       ###############################
       # Per-term provisioning jobs
       ###############################
@@ -174,11 +195,9 @@ module CanvasSync
       current_chain << per_term_chain
       current_chain = per_term_chain
 
-      try_add_model_job.call('assignments')
-      try_add_model_job.call('submissions')
-      try_add_model_job.call('assignment_groups')
-      try_add_model_job.call('context_modules')
-      try_add_model_job.call('context_module_items')
+      term_scoped_models.each do |mdl|
+        try_add_model_job.call(mdl)
+      end
 
       current_chain.insert(
         generate_provisioning_jobs(models, options, only_split: ['users'])

data/lib/canvas_sync/importers/bulk_importer.rb

@@ -64,13 +64,12 @@ module CanvasSync
         columns = columns.dup
 
         update_conditions = {
-          condition: condition_sql(klass, columns),
+          condition: condition_sql(klass, columns, import_args[:sync_start_time]),
           columns: columns
         }
         update_conditions[:conflict_target] = conflict_target if conflict_target
 
         options = { validate: false, on_duplicate_key_update: update_conditions }.merge(import_args)
-
         options.delete(:on_duplicate_key_update) if options.key?(:on_duplicate_key_ignore)
         klass.import(columns, rows, options)
       end
@@ -85,10 +84,14 @@ module CanvasSync
       # started_at = Time.now
       # run_the_users_sync!
       # changed = User.where("updated_at >= ?", started_at)
-      def self.condition_sql(klass, columns)
+      def self.condition_sql(klass, columns, report_start)
         columns_str = columns.map { |c| "#{klass.quoted_table_name}.#{c}" }.join(", ")
         excluded_str = columns.map { |c| "EXCLUDED.#{c}" }.join(", ")
-        "(#{columns_str}) IS DISTINCT FROM (#{excluded_str})"
+        condition_sql = "(#{columns_str}) IS DISTINCT FROM (#{excluded_str})"
+        if klass.column_names.include?("updated_at") && report_start
+          condition_sql += " AND #{klass.quoted_table_name}.updated_at < '#{report_start}'"
+        end
+        condition_sql
       end
 
       def self.batch_size

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"
 
@@ -17,24 +20,9 @@ require_relative "./chain_builder"
 module CanvasSync
   module JobBatches
     class Batch
-      class NoBlockGivenError < StandardError; 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
+      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 +35,15 @@ 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)
@@ -122,6 +109,8 @@ module CanvasSync
           @context&.save!
 
           @initialized = true
+        else
+          assert_batch_is_open
         end
 
         job_queue = @ready_to_queue = []
@@ -143,6 +132,7 @@ module CanvasSync
         if @ready_to_queue
           @ready_to_queue << jid
         else
+          assert_batch_is_open
           append_jobs([jid])
         end
       end
@@ -170,52 +160,41 @@ 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
-
-      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
+      # 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 read_bid_attr(attribute)
-        redis do |r|
-          r.hget(@bidkey, attribute)
-        end
+      protected
+
+      def redis_key
+        @bidkey
       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, 'closed') == '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)
         redis do |r|
           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.expire(@bidkey, BID_EXPIRE_TTL)
 
             if jids.size > 0
@@ -242,17 +221,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
@@ -285,7 +253,7 @@ 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|
             r.multi do
               r.srem("BID-#{bid}-failed", jid)
 
@@ -294,7 +262,6 @@ 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)
@@ -310,17 +277,34 @@ module CanvasSync
           end
         end
 
+        def possibly_enqueue_callbacks(bid, types: [:complete, :success])
+          pending_jobs, failed_jobs, total_batches, completed_batches, successful_batches = redis do |r|
+            r.multi do
+
+            end
+          end
+
+          if (types.include?(:complete)) && (pending_jobs.to_i == failed_jobs.to_i && total_batches.to_i == completed_batches.to_i)
+            enqueue_callbacks(:complete, bid)
+          end
+          if (types.include?(:success)) && (pending_jobs.to_i.zero? && total_batches.to_i == successful_batches.to_i)
+            enqueue_callbacks(:success, bid)
+          end
+        end
+
         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, "closed", true)
               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 +312,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,38 +320,32 @@ 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)
+            with_batch(parent_bid) do
+              cb_batch = self.new
+              cb_batch.callback_params = {
+                for_bid: bid,
+                event: event,
+              }
+              opts['callback_bid'] = cb_batch.bid
 
-            return
+              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)
@@ -381,6 +360,7 @@ module CanvasSync
               "BID-#{bid}-batches-success",
               "BID-#{bid}-batches-complete",
               "BID-#{bid}-batches-failed",
+              "BID-#{bid}-bids",
               "BID-#{bid}-jids",
             )
           end
@@ -397,7 +377,7 @@ module CanvasSync
         private
 
         def push_callbacks(args, queue)
-          Batch::Callback::Worker.enqueue_all(args, queue)
+          Batch::Callback::worker_class.enqueue_all(args, queue)
         end
       end
     end