This page is incomplete

At the moment, it only represents a first pass at sections 4-13.

Once complete, this page is intended to shows changes in Rails 3.0 that affect the sample code in Agile Web Development with Rails, Edition 3. As page numbers in the paper and PDF copies differ, this information is organized first by section number, then it lists both page numbers, paper copy first.

Meanwhile, a live status of an updated Edition 3 scenario (as well as a developing Edition 4 scenario) under various versions of Rails and Ruby is available. Note that page is based on pulling Rails from git (and for 1.8.8 and 1.9.2, Ruby from svn) so it will often reflect failures that will not ever make it in beta or RC form.

Global changes

The names of scripts have changed:

Rails 2.2	Rails 3.0
ruby script/about	rake about
ruby script/console	rails console
ruby script/dbconsole	rails dbconsole
ruby script/destroy	rails destroy
ruby script/performance/benchmarker	rails benchmarker
ruby script/performance/profiler	rails profiler
ruby script/generate	rails generate
ruby script/plugin	rails plugin
ruby script/runner	rails runner
ruby script/server	rails server

3.0 Installing Rails

• Page 21/32 : Rails now requires Ruby 1.8.7 or later. This particularly affects Windows users as both InstantRails and RubyInstaller bundle Ruby 1.8.6. RubyInstall RC2 development is underway, but for now we can use Cygwin .

4.1 Creating a New Application

• Page 36/45 : After cd demo and before rails server (was: ruby script/server), edit config/routes.rb, and uncomment the following line:
  • match ':controller(/:action(/:id(.:format)))'

6.1 Getting Something Running

• Page 63/71 : options must now come after the app path, so you would specify mysql as the database as follows:
  • rails depot --database=mysql

6.3 Adding a Missing Column

• Page 73/81: the h’s are no longer present in the template.
• Page 74/82: instead of editing new.html.erb and edit.html.erb files, edit _form.html.erb. Instead of a <p> tag, you will see <div class="field">
• Page 75/83: the h’s are no longer present in the template.
• Page 76/84: instead of deleting the h, add the word raw.

7.1 Creating the Catalog Listing

• Page 87/95 : Edit config/routes.rb, and uncomment the following line, and then restart the server:
  • match ':controller(/:action(/:id(.:format)))'
• Page 89/97 : remove the h before product.title, add raw before product.description

8.1 Sessions

• Page 99/107: the line to uncomment in environment.rb now looks as follows:
  • ActionController::Base.session_store = :active_record_store
• Page 100/107: The setup is now done in config/initializers/session_store.rb
• Page 100/108: there no longer is a need to uncomment out the :secret parameter in application.rb (which is now named application_controller.rb)

9.2 Iteration D2: Creating an Ajax-Based Car

• Page 123/130: change line containing form_remote_tag :url=>... to:
  • <% form_tag({:action=>'add_to_cart', :id=>product}, :remote=>true) do %>

11.1 Iteration F1: Adding Users

• Page 158/164: The preferred way to order the users returned in the index is now:
  • @users = User.order(:name)
• Page 159/165: Instead of a separate line assigning flash[:notice], there now is a :notice parameter on the format.html call.
• Page 160/166: The form can now be found in app/views/users/_form.html.erb

11.3 Iteration F3: Limiting Access

• Page 166/172: application.rb is now application_controller.rb

11.4 Iteration F4: A Sidebar, More Administration

• Page 168/174: application.rb is now application_controller.rb

13.1 Iteration I1: Enabling Translation

• Page 187/193: omit the setting of LOCALES_DIRECTORY (alternately, use Rails.root instead of RAILS_ROOT).
• Page 190/196: application.rb is now application_controller.rb
• Page 199/205: es.activerecord.errors.template becomes es.errors.template:
  • Insert line ” errors:” before ” activerecord:”
  • Move 5 lines starting with “template:” through “other:” before “activerecord:”, unindenting by two characters
• Page 200/205: error messages are double escaped. Bug 2409

14.2 Unit Testing of Models

• Page 209/214: lines of the form product.errors.invalid?(:title) need to be changed to product.errors[:title].any?

14.3 Functional Testing of Controllers

• Page 221/226: application.rb is now application_controller.rb

16.2 Enumerations and Arrays

• Page 273/277: :skip_last_comma has been deprecated. Use :last_word_connector instead.

16.9 Unicode support

• Page 283/287: name.chars.reverse is now name.mb_chars.reverse
• Page 284/288: person.name.chars is now person.name.mb_chars (twice on this page)

21.2 Routing Requests

• Page 424/428: add the following as the first action after starting script/console:
  • ActionController::Base.session_store = nil
• Page 431/436: some of these examples return /blog/show_date?... instead

21.4 Testing Routing

• Page 455/459: the excerpt in the book doesn’t show it, but if you download routing_conditions_test.rb and wish to execute it, you will need to add require "config/routes_with_conditions.rb" to the beginning of config/routes.rb. After this is done, you can remove the setup method entirely from RoutingTest as it is unnecessary.

23.3 Helpers for Formatting, Linking, and Pagination

• Page 518/521: A new version of the will_paginate gem is required, and the installation instructions have changed:
  • add gem 'will_paginate', '>= 3.0.pre' to Gemfile
  • execute bundler install

23.11 Adding New Templating Systems

• Page 557/560: Updated rdoc_template that works with Rails 3.0.
• Page 558/560: application.rb is now application_controller.rb
• Page 558/561: you will also need to add gem 'rdoc' to your Gemfile
• Page 559/563: Updated eval_template that works with Rails 3.0.

25.1 Sending E-mail

• Page 611/613 : confirm.erb can now be found in confirm.text.erb
• Page 612/614 :
  • order_mailer.rb can now be found in the app/mailer directory (this change also applies to the next page)
  • _line_item.erb should now be named _line_item.text.erb
• Page 614/616 :
  • sent.erb should now be named sent.html.erb. Additionally, remove the sent.text.erb that was generated.
  • change render(:partial => "html_line_item") to render(:partial => "line_item")

25.3 Testing E-mail

• Page 621/623: replace the following files:
  • test/unit/order_mailer_test.rb (to be placed in the test/functional directory)
  • test/fixtures/order_mailer/sent
  • test/fixtures/order_mailer/confirm

26.2 Show Me the Code!

• Page 626/628 : After cd depot_client, edit config/routes.rb, and uncomment the following line:
  • match ':controller(/:action(/:id(.:format)))'
• Page 628/630: application.rb is now application_controller.rb

26.3 Relationships and Collections

• Page 630/632: the config/routes.rb line now needs to look like this:
  • resources(:orders) { resources :line_items }