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 CommandRecorderActiveRecord::Migration::CommandRecorder
records commands done during
def change_table(table_name, **options) # :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)
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)
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)
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
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