class ActiveRecord::Migration::CommandRecorder

  • rename_table
    * rename_index
    * rename_column
    * remove_timestamps
    * remove_reference
    * remove_index
    * remove_check_constraint
    * remove_foreign_key (must supply a second table)
    * remove_columns (must specify at least one column name or more)
    * remove_column (must supply a type)
    * enable_extension
    * drop_table (must supply a block)
    * drop_join_table
    * disable_extension
    * create_table
    * create_join_table
    * change_table_comment (must supply a :from and :to option)
    * change_column_comment (must supply a :from and :to option)
    * change_column_null
    * change_column_default (must supply a :from and :to option)
    * change_column
    * add_timestamps
    * add_reference
    * add_index
    * add_check_constraint
    * add_foreign_key
    * add_column
    knows how to invert the following commands:
    a migration and knows how to reverse those commands. The CommandRecorder
    ActiveRecord::Migration::CommandRecorder records commands done during

def change_table(table_name, **options) # :nodoc:

:nodoc:
def change_table(table_name, **options) # :nodoc:
  yield delegate.update_table_definition(table_name, self)
end

def initialize(delegate = nil)

def initialize(delegate = nil)
  @commands = []
  @delegate = delegate
  @reverting = false
end

def inverse_of(command, args, &block)

invert the +command+.
This method will raise an +IrreversibleMigration+ exception if it cannot

# => [[:add_column, :some_table, :foo, :string], [:add_column, :some_table, :bar, :string]]
recorder.inverse_of(:remove_columns, [:some_table, :foo, :bar, type: :string])

If the inverse of a command requires several commands, returns array of commands.

# => [:rename_table, [:new, :old]]
recorder.inverse_of(:rename_table, [:old, :new])

Returns the inverse of the given command. For example:
def inverse_of(command, args, &block)
  method = :"invert_#{command}"
  raise IrreversibleMigration, <<~MSG unless respond_to?(method, true)
    This migration uses #{command}, which is not automatically reversible.
    To make the migration reversible you can either:
    1. Define #up and #down methods in place of the #change method.
    2. Use the #reversible method to define reversible behavior.
  MSG
  send(method, args, &block)
end

def invert_change_column_comment(args)

def invert_change_column_comment(args)
  table, column, options = args
  unless options.is_a?(Hash) && options.has_key?(:from) && options.has_key?(:to)
    raise ActiveRecord::IrreversibleMigration, "change_column_comment is only reversible if given a :from and :to option."
  end
  [:change_column_comment, [table, column, from: options[:to], to: options[:from]]]
end

def invert_change_column_default(args)

def invert_change_column_default(args)
  table, column, options = args
  unless options.is_a?(Hash) && options.has_key?(:from) && options.has_key?(:to)
    raise ActiveRecord::IrreversibleMigration, "change_column_default is only reversible if given a :from and :to option."
  end
  [:change_column_default, [table, column, from: options[:to], to: options[:from]]]
end

def invert_change_column_null(args)

def invert_change_column_null(args)
  args[2] = !args[2]
  [:change_column_null, args]
end

def invert_change_table_comment(args)

def invert_change_table_comment(args)
  table, options = args
  unless options.is_a?(Hash) && options.has_key?(:from) && options.has_key?(:to)
    raise ActiveRecord::IrreversibleMigration, "change_table_comment is only reversible if given a :from and :to option."
  end
  [:change_table_comment, [table, from: options[:to], to: options[:from]]]
end

def invert_drop_table(args, &block)

def invert_drop_table(args, &block)
  if args.size == 1 && block == nil
    raise ActiveRecord::IrreversibleMigration, "To avoid mistakes, drop_table is only reversible if given options or a block (can be empty)."
  end
  super
end

def invert_remove_check_constraint(args)

def invert_remove_check_constraint(args)
  raise ActiveRecord::IrreversibleMigration, "remove_check_constraint is only reversible if given an expression." if args.size < 2
  super
end

def invert_remove_column(args)

def invert_remove_column(args)
  raise ActiveRecord::IrreversibleMigration, "remove_column is only reversible if given a type." if args.size <= 2
  super
end

def invert_remove_columns(args)

def invert_remove_columns(args)
  unless args[-1].is_a?(Hash) && args[-1].has_key?(:type)
    raise ActiveRecord::IrreversibleMigration, "remove_columns is only reversible if given a type."
  end
  [:add_columns, args]
end

def invert_remove_foreign_key(args)

def invert_remove_foreign_key(args)
  options = args.extract_options!
  from_table, to_table = args
  to_table ||= options.delete(:to_table)
  raise ActiveRecord::IrreversibleMigration, "remove_foreign_key is only reversible if given a second table" if to_table.nil?
  reversed_args = [from_table, to_table]
  reversed_args << options unless options.empty?
  [:add_foreign_key, reversed_args]
end

def invert_remove_index(args)

def invert_remove_index(args)
  options = args.extract_options!
  table, columns = args
  columns ||= options.delete(:column)
  unless columns
    raise ActiveRecord::IrreversibleMigration, "remove_index is only reversible if given a :column option."
  end
  options.delete(:if_exists)
  args = [table, columns]
  args << options unless options.empty?
  [:add_index, args]
end

def invert_rename_column(args)

def invert_rename_column(args)
  table_name, old_name, new_name = args
  [:rename_column, [table_name, new_name, old_name]]
end

def invert_rename_index(args)

def invert_rename_index(args)
  table_name, old_name, new_name = args
  [:rename_index, [table_name, new_name, old_name]]
end

def invert_rename_table(args)

def invert_rename_table(args)
  [:rename_table, args.reverse]
end

def invert_transaction(args, &block)

def invert_transaction(args, &block)
  sub_recorder = CommandRecorder.new(delegate)
  sub_recorder.revert(&block)
  invertions_proc = proc {
    sub_recorder.replay(self)
  }
  [:transaction, args, invertions_proc]
end

def method_missing(method, *args, &block)

Forwards any missing method call to the \target.
def method_missing(method, *args, &block)
  if delegate.respond_to?(method)
    delegate.public_send(method, *args, &block)
  else
    super
  end
end

def record(*command, &block)

recorder.record(:method_name, [:arg1, :arg2])

For example:
Record +command+. +command+ should be a method name and arguments.
def record(*command, &block)
  if @reverting
    @commands << inverse_of(*command, &block)
  else
    @commands << (command << block)
  end
end

def replay(migration)

def replay(migration)
  commands.each do |cmd, args, block|
    migration.send(cmd, *args, &block)
  end
end

def respond_to_missing?(method, _)

def respond_to_missing?(method, _)
  super || delegate.respond_to?(method)
end

def revert

# same effect as recorder.record(:rename_table, [:new, :old])
recorder.revert{ recorder.record(:rename_table, [:old, :new]) }

For example:
and in reverse order.
All commands recorded will end up being recorded reverted
While executing the given block, the recorded will be in reverting mode.
def revert
  @reverting = !@reverting
  previous = @commands
  @commands = []
  yield
ensure
  @commands = previous.concat(@commands.reverse)
  @reverting = !@reverting
end