Migration Assistant

Assists in handling migrations, including generating migration files from a Thor Generator The Migration Assistant includes specialized functionality for operating with Active Record migrations.

Install

gem install migration_assist

Usage

First you have to tell the gem where your Rails root directory is located so it can calculate the migrations dir from that for its operation.

Example:


  RailsAssist::Migration.rails_root_dir = Rails.root

A common use case for using this gem, is when you are creating code Generators that create Active Record migrations. In this case you would add this Helper to your generator sth. like this


require 'migration_assist'
require 'rails_assist'

class MigrationGenerator < Rails::Generators::NamedBase 
  include RailsAssist::Migration    
  ...
end

In the above example we also included the migration helper from the rails3_assist gem, which adds some migration CRUD functionality to the mix.

Class methods:

  • migrations_list(dirname=nil)*

list of migrations

first_migration_file: (name, dir=nil) - alias: *migration_exists?

Get the first migration file matching a given name

latest_migration_file: (dirname, file_name)

Get the latest migration file matching a given name

current_migration_number(dirname=nil)

Return the highest migration number of the current migration files

next_migration_number(dirname=nil)

Often used to generate the number to prefix a new generated migration file

Instance methods

migration (name)

Generate a new named migration using a template [name].erb to be found in a template source path (thor)

reverse_migration! (migration_path=nil)

Reverse a given migration, by switching the up and down methods and changing the migration name, fx from Add to Remove or Create to Drop.

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

Copyright (c) 2010 Kristian Mandrup. See LICENSE for details.