Coursemology/coursemology2

View on GitHub
app/services/course/duplication/object_duplication_service.rb

Summary

Maintainability
A
35 mins
Test Coverage
# frozen_string_literal: true

# Service to provide duplication of objects from source_course, to destination_course.
class Course::Duplication::ObjectDuplicationService < Course::Duplication::BaseService
  class << self
    # Constructor for the object duplication service.
    #
    # @param [Course] source_course Course to duplicate from.
    # @param [Course] destination_course Course to duplicate to.
    # @param [Object|Array] objects The object(s) to duplicate.
    # @param [Hash] options The options to be sent to the Duplicator object.
    # @option options [User] :current_user (+User.system+) The user triggering the duplication.
    # @return [Object|Array] The duplicated object(s).
    def duplicate_objects(source_course, destination_course, objects, options = {})
      options[:time_shift] = time_shift(source_course, destination_course)
      options[:source_course] = source_course
      options[:destination_course] = destination_course
      options.reverse_merge!(DEFAULT_OBJECT_DUPLICATION_OPTIONS)
      service = new(options)
      service.duplicate_objects(objects)
    end

    # Calculates the time difference between the +start_at+ of the current and target course.
    #
    # @param [Course] source_course
    # @param [Course] destination_course
    # @return [Float] Time difference between the +start_at+ of both courses.
    def time_shift(source_course, destination_course)
      shift = destination_course.start_at - source_course.start_at
      shift >= 0 ? shift : 0
    end
  end

  DEFAULT_OBJECT_DUPLICATION_OPTIONS =
    { mode: :object, unpublish_all: true, current_user: User.system }.freeze

  # Duplicate the objects with the duplicator.
  #
  # @param [Object|Array] objects An object or an array of objects to duplicate.
  # @return [Object] The duplicated object, if `objects` is a single object.
  # @return [Array] Array of duplicated objects, if `objects` is an array.
  def duplicate_objects(objects)
    # TODO: Email the user when the duplication is complete.
    Course.transaction do
      duplicated = duplicator.duplicate(objects)
      before_save(objects, duplicated)
      save_success = duplicated.respond_to?(:save) ? duplicated.save : duplicated.all?(&:save)
      after_save_success = save_success && after_save(objects, duplicated)
      raise ActiveRecord::Rollback unless after_save_success

      duplicated
    end
  end

  private

  # Executes callbacks meant to be invoked after all items have been duplicated, but before they have
  # been saved. This is useful for actions that make invalid items valid so they can be saved successfully,
  # that can only be executed after all items have been re-parented.
  #
  # Models may implement `before_duplicate_save(duplicator)` if they have code to be executed during this
  # window.
  #
  # @param [Object|Array] _objects The source object(s)
  # @param [Object|Array] duplicated The duplicated object(s)
  def before_save(_objects, duplicates)
    duplicates_array = duplicates.respond_to?(:to_ary) ? duplicates : [duplicates]
    duplicates_array.each do |duplicate|
      duplicate.before_duplicate_save(duplicator) if duplicate.respond_to?(:before_duplicate_save)
    end
  end

  # Executes callbacks meant to be invoked after duplicated objects have been saved.
  #
  # Models may implement `after_duplicate_save(duplicator)` if they have code to be executed after
  # all duplicates have been saved. The method should return `true` if the execution is successful
  # and false otherwise.
  #
  # @param [Object|Array] _objects The source object(s)
  # @param [Object|Array] duplicated The duplicated object(s)
  # @return [Boolean] true if all callbacks are executed successfully
  def after_save(_objects, duplicates)
    duplicates_array = duplicates.respond_to?(:to_ary) ? duplicates : [duplicates]
    duplicates_array.all? do |object|
      object.respond_to?(:after_duplicate_save) ? object.reload.after_duplicate_save(duplicator) : true
    end
  end

  # Initializes a new duplication object with the given options to perform the duplication.
  #
  # @return [Duplicator]
  def initialize_duplicator(options)
    Duplicator.new([], options)
  end
end