Class: ActiveRecord::Migrator

Inherits:
Object
  • Object
show all
Defined in:
lib/active_record/migration.rb

Overview

:nodoc:

Class Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(direction, migrations, target_version = nil) ⇒ Migrator

Returns a new instance of Migrator.

Raises:

  • (StandardError) 


866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
 
# File 'lib/active_record/migration.rb', line 866

def initialize(direction, migrations, target_version = nil)
  raise StandardError.new("This database does not yet support migrations") unless Base.connection.supports_migrations?

  @direction         = direction
  @target_version    = target_version
  @migrated_versions = nil

  if Array(migrations).grep(String).empty?
    @migrations = migrations
  else
    ActiveSupport::Deprecation.warn "instantiate this class with a list of migrations"
    @migrations = self.class.migrations(migrations)
  end

  validate(@migrations)

  Base.connection.initialize_schema_migrations_table
end

Class Attribute Details

.migrations_paths ⇒ Object 



824
825
826
827
828
 
# File 'lib/active_record/migration.rb', line 824

def migrations_paths
  @migrations_paths ||= ['db/migrate']
  # just to not break things if someone uses: migration_path = some_string
  Array(@migrations_paths)
end

Class Method Details

.current_version ⇒ Object 



794
795
796
797
798
799
800
801
 
# File 'lib/active_record/migration.rb', line 794

def current_version
  sm_table = schema_migrations_table_name
  if Base.connection.table_exists?(sm_table)
    get_all_versions.max || 0
  else
    0
  end
end

.down(migrations_paths, target_version = nil, &block) ⇒ Object 



771
772
773
774
775
776
 
# File 'lib/active_record/migration.rb', line 771

def down(migrations_paths, target_version = nil, &block)
  migrations = migrations(migrations_paths)
  migrations.select! { |m| yield m } if block_given?

  self.new(:down, migrations, target_version).migrate
end

.forward(migrations_paths, steps = 1) ⇒ Object 



760
761
762
 
# File 'lib/active_record/migration.rb', line 760

def forward(migrations_paths, steps=1)
  move(:up, migrations_paths, steps)
end

.get_all_versions ⇒ Object 



790
791
792
 
# File 'lib/active_record/migration.rb', line 790

def get_all_versions
  SchemaMigration.all.map { |x| x.version.to_i }.sort
end

.last_migration ⇒ Object

:nodoc:



811
812
813
 
# File 'lib/active_record/migration.rb', line 811

def last_migration #:nodoc:
  migrations(migrations_paths).last || NullMigration.new
end

.last_version ⇒ Object 



807
808
809
 
# File 'lib/active_record/migration.rb', line 807

def last_version
  last_migration.version
end

.migrate(migrations_paths, target_version = nil, &block) ⇒ Object 



743
744
745
746
747
748
749
750
751
752
753
754
 
# File 'lib/active_record/migration.rb', line 743

def migrate(migrations_paths, target_version = nil, &block)
  case
  when target_version.nil?
    up(migrations_paths, target_version, &block)
  when current_version == 0 && target_version == 0
    []
  when current_version > target_version
    down(migrations_paths, target_version, &block)
  else
    up(migrations_paths, target_version, &block)
  end
end

.migrations(paths) ⇒ Object 



834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
 
# File 'lib/active_record/migration.rb', line 834

def migrations(paths)
  paths = Array(paths)

  files = Dir[*paths.map { |p| "#{p}/**/[0-9]*_*.rb" }]

  migrations = files.map do |file|
    version, name, scope = file.scan(/([0-9]+)_([_a-z0-9]*)\.?([_a-z0-9]*)?\.rb\z/).first

    raise IllegalMigrationNameError.new(file) unless version
    version = version.to_i
    name = name.camelize

    MigrationProxy.new(name, version, file, scope)
  end

  migrations.sort_by(&:version)
end

.migrations_path ⇒ Object 



830
831
832
 
# File 'lib/active_record/migration.rb', line 830

def migrations_path
  migrations_paths.first
end

.needs_migration? ⇒ Boolean

Returns:

  • (Boolean) 


803
804
805
 
# File 'lib/active_record/migration.rb', line 803

def needs_migration?
  current_version < last_version
end

.open(migrations_paths) ⇒ Object 



782
783
784
 
# File 'lib/active_record/migration.rb', line 782

def open(migrations_paths)
  self.new(:up, migrations(migrations_paths), nil)
end

.proper_table_name(name) ⇒ Object 



815
816
817
818
819
820
821
822
 
# File 'lib/active_record/migration.rb', line 815

def proper_table_name(name)
  # Use the Active Record objects own table_name, or pre/suffix from ActiveRecord::Base if name is a symbol/string
  if name.respond_to? :table_name
    name.table_name
  else
    "#{ActiveRecord::Base.table_name_prefix}#{name}#{ActiveRecord::Base.table_name_suffix}"
  end
end

.rollback(migrations_paths, steps = 1) ⇒ Object 



756
757
758
 
# File 'lib/active_record/migration.rb', line 756

def rollback(migrations_paths, steps=1)
  move(:down, migrations_paths, steps)
end

.run(direction, migrations_paths, target_version) ⇒ Object 



778
779
780
 
# File 'lib/active_record/migration.rb', line 778

def run(direction, migrations_paths, target_version)
  self.new(direction, migrations(migrations_paths), target_version).run
end

.schema_migrations_table_name ⇒ Object 



786
787
788
 
# File 'lib/active_record/migration.rb', line 786

def schema_migrations_table_name
  SchemaMigration.table_name
end

.up(migrations_paths, target_version = nil) ⇒ Object 



764
765
766
767
768
769
 
# File 'lib/active_record/migration.rb', line 764

def up(migrations_paths, target_version = nil)
  migrations = migrations(migrations_paths)
  migrations.select! { |m| yield m } if block_given?

  self.new(:up, migrations, target_version).migrate
end

Instance Method Details

#current_migration ⇒ Object Also known as: current 



889
890
891
 
# File 'lib/active_record/migration.rb', line 889

def current_migration
  migrations.detect { |m| m.version == current_version }
end

#current_version ⇒ Object 



885
886
887
 
# File 'lib/active_record/migration.rb', line 885

def current_version
  migrated.max || 0
end

#migrate ⇒ Object 



907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
 
# File 'lib/active_record/migration.rb', line 907

def migrate
  if !target && @target_version && @target_version > 0
    raise UnknownMigrationVersionError.new(@target_version)
  end

  running = runnable

  if block_given?
    message = "block argument to migrate is deprecated, please filter migrations before constructing the migrator"
    ActiveSupport::Deprecation.warn message
    running.select! { |m| yield m }
  end

  running.each do |migration|
    Base.logger.info "Migrating to #{migration.name} (#{migration.version})" if Base.logger

    begin
      execute_migration_in_transaction(migration, @direction)
    rescue => e
      canceled_msg = use_transaction?(migration) ? "this and " : ""
      raise StandardError, "An error has occurred, #{canceled_msg}all later migrations canceled:\n\n#{e}", e.backtrace
    end
  end
end

#migrated ⇒ Object 



952
953
954
 
# File 'lib/active_record/migration.rb', line 952

def migrated
  @migrated_versions ||= Set.new(self.class.get_all_versions)
end

#migrations ⇒ Object 



943
944
945
 
# File 'lib/active_record/migration.rb', line 943

def migrations
  down? ? @migrations.reverse : @migrations.sort_by(&:version)
end

#pending_migrations ⇒ Object 



947
948
949
950
 
# File 'lib/active_record/migration.rb', line 947

def pending_migrations
  already_migrated = migrated
  migrations.reject { |m| already_migrated.include?(m.version) }
end

#run ⇒ Object

Raises:



894
895
896
897
898
899
900
901
902
903
904
905
 
# File 'lib/active_record/migration.rb', line 894

def run
  migration = migrations.detect { |m| m.version == @target_version }
  raise UnknownMigrationVersionError.new(@target_version) if migration.nil?
  unless (up? && migrated.include?(migration.version.to_i)) || (down? && !migrated.include?(migration.version.to_i))
    begin
      execute_migration_in_transaction(migration, @direction)
    rescue => e
      canceled_msg = use_transaction?(migration) ? ", this migration was canceled" : ""
      raise StandardError, "An error has occurred#{canceled_msg}:\n\n#{e}", e.backtrace
    end
  end
end

#runnable ⇒ Object 



932
933
934
935
936
937
938
939
940
941
 
# File 'lib/active_record/migration.rb', line 932

def runnable
  runnable = migrations[start..finish]
  if up?
    runnable.reject { |m| ran?(m) }
  else
    # skip the last migration if we're headed down, but not ALL the way down
    runnable.pop if target
    runnable.find_all { |m| ran?(m) }
  end
end