I apologize for not getting another Rails 3 upgrade post up this weekend, but I spent this weekend working on a few things. First, I contributed a few little pieces to the Rails 3 release notes, which should be showing up on the Rails blog soon (edit: or view them here right now), but most of my time was devoted to a bigger project.

My little gem rails-upgrade is now rails_upgrade , an officially blessed upgrade tool that will be maintained by myself and the Rails team. You can get it from here: http://github.com/rails/rails_upgrade.

To use it now, simply install the plugin:

script/plugin install git://github.com/rails/rails_upgrade.git

The plugin adds the following tasks:

rake rails:upgrade:check # Runs a battery of checks on your Rails 2.x app # and generates a report on required upgrades for Rails 3 rake rails:upgrade:gems # Generates a Gemfile for your Rails 3 app out of your config.gem directives rake rails:upgrade:routes # Create a new, upgraded route file from your current routes.rb

Simply run those tasks in the same way you ran the commands with the rails-upgrade gem. In the near future, I plan on expanding the checks for deprecated pieces to handle some of the less obvious changes, adding some generators for other changes (like config/application.rb ), and adding some extra tools (ideas/suggestions certainly welcome).

Anyhow, I’m really looking forward to seeing this project become a dependable upgrade tool. If you have any ideas or find any bugs, please contact me via e-mail or Twitter or, even better, fork it and handle it yourself!

permalink