Class: Sequel::TimestampMigrator

Inherits:
Migrator show all
Defined in:
lib/sequel/extensions/migration.rb

Overview

The migrator used if any migration file version is greater than 20000101. Stores filenames of migration files, and can figure out which migrations have not been applied and apply them, even if earlier migrations are added after later migrations. If you plan to do that, the responsibility is on you to make sure the migrations don’t conflict. Part of the migration extension.

Constant Summary collapse

Error = 
Migrator::Error

Constants inherited from Migrator

Migrator::MIGRATION_FILE_PATTERN, Migrator::MUTEX

Instance Attribute Summary collapse

Attributes inherited from Migrator

#column, #db, #directory, #ds, #files, #table, #target

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Migrator

apply, check_current, is_current?, migrator_class, run

Constructor Details

#initialize(db, directory, opts = OPTS) ⇒ TimestampMigrator

Set up all state for the migrator instance



701
702
703
704
705
706
 
# File 'lib/sequel/extensions/migration.rb', line 701

def initialize(db, directory, opts=OPTS)
  super
  @target = opts[:target]
  @applied_migrations = get_applied_migrations
  @migration_tuples = get_migration_tuples
end

Instance Attribute Details

#applied_migrations ⇒ Object (readonly)

Array of strings of applied migration filenames



695
696
697
 
# File 'lib/sequel/extensions/migration.rb', line 695

def applied_migrations
  @applied_migrations
end

#migration_tuples ⇒ Object (readonly)

Get tuples of migrations, filenames, and actions for each migration



698
699
700
 
# File 'lib/sequel/extensions/migration.rb', line 698

def migration_tuples
  @migration_tuples
end

Class Method Details

.run_single(db, path, opts = OPTS) ⇒ Object

Apply the migration in the given file path. See Migrator.run for the available options. Additionally, this method supports the :direction option for whether to run the migration up (default) or down.



711
712
713
 
# File 'lib/sequel/extensions/migration.rb', line 711

def self.run_single(db, path, opts=OPTS)
  new(db, File.dirname(path), opts).run_single(path, opts[:direction] || :up)
end

Instance Method Details

#is_current? ⇒ Boolean

The timestamp migrator is current if there are no migrations to apply in either direction.

Returns:

  • (Boolean) 


717
718
719
 
# File 'lib/sequel/extensions/migration.rb', line 717

def is_current?
  migration_tuples.empty?
end

#run ⇒ Object

Apply all migration tuples on the database



722
723
724
725
726
727
 
# File 'lib/sequel/extensions/migration.rb', line 722

def run
  migration_tuples.each do |m, f, direction|
    apply_migration(m, f, direction)
  end
  nil
end

#run_single(path, direction) ⇒ Object

Apply single migration tuple at the given path with the given direction on the database.



731
732
733
734
735
736
737
738
739
740
 
# File 'lib/sequel/extensions/migration.rb', line 731

def run_single(path, direction)
  migration = load_migration_file(path)
  file_name = File.basename(path)
  already_applied = applied_migrations.include?(file_name.downcase)

  return if direction == :up ? already_applied : !already_applied

  apply_migration(migration, file_name, direction)
  nil
end