Upgrading to Rails 3 - assets.en.oreilly.comassets.en.oreilly.com/1/event/45/Upgrading to Rails 3 Presentation.pdfOSCON 2010 Jeremy McAnallyÕs Rails Upgrade Handbook bit.ly/railsupgrade

OSCON 2010

Upgrading to

Rails 3Thursday, July 22, 2010

OSCON 2010

Michael Bleigh@mbleigh

Thursday, July 22, 2010


OSCON 2010

Jeremy McAnally’sRails Upgrade Handbook

bit.ly/railsupgrade


http://bit.ly/railsupgrade

http://bit.ly/railsupgrade

OSCON 2010

Rails 3 isDifferent


OSCON 2010

Rails 3 is aBig #ange


OSCON 2010

Why the hell should I bother?


OSCON 2010

Modularity


OSCON 2010

Rails 2.3 StackActiveRecord

ActiveSupport

ActiveResource

ActionPack

Test::Unit


OSCON 2010

Rails 3 Ecosystem

ActiveSupport

ActiveResource

ActionPack

ActiveModel

ActiveRecordDataMapper

MongoMapper

RSpecTest::Unit

Bacon


OSCON 2010

Rails 2.3 Controller

ActionController::Base

ApplicationController

YourController


OSCON 2010

Rails 3 Controller

ActionController::Base

ApplicationController

YourController

AbstractController::Base

ActionController::Metal


OSCON 2010

Less Monkeypatching


OSCON 2010

Security

darwinbell via Flickr


OSCON 2010

small change,

big impact


OSCON 2010

HTML is escapedby default.


<div class='comment'> <%= comment.body %></div>

<div class="comment"> <%= comment.body.html_safe %></div>

<div class="comment"> <%=raw comment.body %></div>


OSCON 2010

It’s a good thing.TM


OSCON 2010

New Apis


OSCON 2010

$e Router


OSCON 2010

Rack Everywhere!


OSCON 2010

Fancy New DSL


OSCON 2010

More Powerful


# Rails 2.3map.connect '/help', :controller => 'pages', :action => 'help'

# Rails 3match '/help', :to => 'pages#help'

# Rails 2.3map.resources :users do |users| users.resources :commentsend

# Rails 3resources :users do resources :commentsend


# Rails 2.3with_options :path_prefix => 'admin', :name_prefix => 'admin' do |admin| admin.resources :users admin.resources :postsend

# Rails 3namespace :admin resources :users resources :postsend


# Rails 3

constraints(:subdomain => 'api') do resources :statuses resources :friendsend

match '/hello', :to => lambda{ |env| [200, {'Content-Type' => 'text/plain'}, 'Hello World']}

match '/other-site', :to => redirect('http://url.com')


http://somewhere-else.com

http://somewhere-else.com

OSCON 2010

A%ionMailer


OSCON 2010

It’s (mostly) justa controller.


class Notifier < ActionMailer::Base default :from => "[email protected]"

def welcome_email(user) @name = user.name attachments['terms.pdf'] = File.read( Rails.root.join('docs/terms.pdf') ) mail(:to => user.email, :subject => "G’day Mate!") endend


mailto:[email protected]

mailto:[email protected]

class UsersController < ApplicationController respond_to :html def create @user = User.new(params[:user])

Notifier.welcome_email(@user).deliver if @user.save respond_with @user endend


OSCON 2010

Bundler


OSCON 2010

Caution: Entering Controversy


# Rails 2.3

# environment.rbconfig.gem 'acts-as-taggable-on'config.gem 'ruby-openid', :lib => false

# test.rbconfig.gem 'rspec'config.gem 'cucumber'

# Rails 3

# Gemfilegem 'acts-as-taggable-on'gem 'ruby-openid', :require => false

group :test do gem 'rspec' gem 'cucumber'end


OSCON 2010

Dependency Resolver


OSCON 2010

A%iveRelation


OSCON 2010

Like named scopes, only more so.


# Rails 2.3

Book.all( :conditions => {:author => "Chuck Palahniuk"}, :order => "published_at DESC", :limit => 10)

# Rails 3

Book.where(:author => "Chuck Palahniuk") .order("published_at DESC").limit(10)


Inherently Chainable


# Rails 3

def index @books = Book.where(:author => params[:author]) if params[:author] @books = @books.order(:title) if params[:sort] == 'title' respond_with @booksend


# Rails 2.3

class Book named_scope :written_by {|a| {:conditions => {:author => a}}} named_scope :after {|d| {:conditions => ["published_on > ?", d]}}# Rails 3

class Book class << self def written_by(name) where(:author => name) end def after(date) where(["published_on > ?", date]) end endend


OSCON 2010

Be&er H'ks


OSCON 2010

Generators


config.generators do |g| g.orm :mongomapper g.test_framework :rspec g.integration_tool :rspecend

rails g model my_model


OSCON 2010

Engines


#lib/your_plugin/engine.rbrequire "your_plugin"require "rails"

module YourPlugin class Engine < Rails::Engine engine_name :your_plugin endend


OSCON 2010

Lots more...railsdispatch.com

edgeguides.rubyonrails.org


http://railsdispatch.com

http://railsdispatch.com

http://edgeguides.rubyonrails.org

http://edgeguides.rubyonrails.org

OSCON 2010

But we’re already on Rails 2.3!


OSCON 2010

How do we cope?


OSCON 2010

Ignore it alland cheat.github.com/rails/

rails_upgrade


http://github.com/rails/rails_upgrade




OSCON 2010

Finds Key Blockers:

Routes, Bundler, application.rb


OSCON 2010

3 Step Process


OSCON 2010

Analyze Your Apprake rails:upgrade:check


OSCON 2010

Backup 2.3 Filesrake rails:upgrade:backup


OSCON 2010

Run Upgradesrake rails:upgrade:routesrake rails:upgrade:gemsrake rails:upgrade:configuration


OSCON 2010

Takeaways


Tests help. Unfortunately, they

may not run.


Don’t be afraid to re-generate.


Just take it one problem at a time.


OSCON 2010

(estions?@mbleigh @intridea

github.com/mbleigh/upgrade-to-rails3


http://github.com/mbleigh/upgrade-to-rails3

http://github.com/mbleigh/upgrade-to-rails3

Documents

Upgrading to Rails 3 - assets.en.oreilly.comassets.en.oreilly.com/1/event/45/Upgrading to Rails 3 Presentation.pdfOSCON 2010 Jeremy McAnallyÕs Rails Upgrade Handbook bit.ly/railsupgrade