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



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

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



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

def applied_migrations
  @applied_migrations
end

#migration_tuples ⇒ Object (readonly)

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



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

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.



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

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) 


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

def is_current?
  migration_tuples.empty?
end

#run ⇒ Object

Apply all migration tuples on the database



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

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.



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

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