Hookup

Hookup takes care of Rails tedium like bundling and migrating through Git hooks. It fires after events like

  • pulling in upstream changes
  • switching branches
  • stepping through a bisect
  • conflict in schema

Usage

gem install hookup
cd yourproject
hookup install

Bundling

Each time your current HEAD changes, hookup checks to see if your Gemfile, Gemfile.lock, or gem spec has changed. If so, it runs bundle check, and if that indicates any dependencies are unsatisfied, it runs bundle install.

Migrating

Each time your current HEAD changes, hookup checks to see if any migrations have been added, deleted, or modified. Deleted and modified migrations are given the rake db:migrate:down treatment, then rake db:migrate is invoked to bring everything else up to date.

Hookup provides a -C option to change to a specified directory prior to running bundle or rake. This should be used if your Gemfile and Rakefile are in a non-standard location.

To use a non-standard db directory (where schema.rb and migrate/ live), add --schema-dir="database/path" to the hookup post-checkout line in .git/hooks/post-checkout.

To force reloading the database if migrating fails, add --load-schema="rake db:reset" to the hookup post-checkout line in .git/hooks/post-checkout.

Schema Resolving

Each time there's a conflict in db/schema.rb on the Rails::Schema.define line, hookup resolves it in favor of the newer of the two versions.

Skip Hookup

Set the SKIP_HOOKUP environment variable to skip hookup.

SKIP_HOOKUP=1 git checkout master

ChangeLog

See it on the wiki

License

Copyright (c) Tim Pope. MIT License.