The document provides an overview of building a web application from start to launch using Ruby on Rails. It covers installing Rails, setting up models and database tables, creating views with ERB templates, writing controller code, and testing the application with Cucumber features and RSpec tests. The document concludes with instructions for deploying the application to Heroku.

1. slideshare.net/matschaffer/wwc-start-launched
bit.ly/wwc-code
From Start to Launched with
Ruby on Rails
Wharton Web Conference

2. Mat Schaffer
mat@mashion.net
@matschaffer
matschaffer.com

4. • Chapter 1: Overview and Installation
• Chapter 2: Data and Views
• Chapter 3: User Stories and Testing
• Chapter 4: Deploy It!

5. Chapter 1: Overview
• Why Rails?
• Rails overview
• Dealing with Data
• Live Console and Testing

6. Why Rails?

7. Rails Overview

8. • Developed for BaseCamp by 37 signals
• DSL for web applications

9. Controller

10. Controller

11. Controller
Model

12. Controller
Model

13. Controller
Model View

14. Controller
Model View

15. Convention over
Configuration

16. GET /comments
CommentsController#index
views/comments/index.html.erb

17. GET /comments/4
CommentsController#show
views/comments/show.html.erb

18. GET /comments/4.js
CommentsController#show
views/comments/show.js.erb

19. Data

20. More Convention over
Configuration

21. Super simple
•C reate
•R etreive
•U pdate
•D elete

22. Comment.create(:author => "mat")
INSERT INTO comments
(author) VALUES('mat');

23. Comment.find_by_author("mat")
SELECT * FROM comments
WHERE author = 'mat';

24. c = Comment.find(1)
c.update_attribute(:author, "mat")
SELECT * FROM comments WHERE id = 1;
UPDATE comments SET author = 'mat' WHERE
id = 1;

25. c = Comment.find(1)
c.destroy
SELECT * FROM comments WHERE id = 1;
DELETE FROM comments WHERE id = 1;

26. more data hotness
• Schema management
• Works the same across databases

27. rails console
• Try out code live
• Inspect your data using code

28. testing
• Built into rails
• Strong testing culture built into ruby

29. services
github.com
heroku.com
engineyard.com
RailsHotline.com

30. Installation

31. • Mac needs XCode first
http://developer.apple.com/xcode/
• Linux or Mac, use RVM bootstrap
http://bit.ly/unixrails
• Windows
http://railsinstaller.org
• Ubuntu on VirtualBox is fun too

32. Test your install
rails new kickballapp
cd kickballapp
rails server
(open a browser to http://localhost:3000)

34. Our project:
A League Manager

35. Chapter 2:
Data
Views

36. Data

37. class Team
• name
• (id, created_at, updated_at)

38. class Location
• name
• address
• (id, created_at, updated_at)

39. class Game
• starts_at
• ends_at
• location
• home_team
• away_team
• (id, created_at, updated_at)

40. class Game
• starts_at
• ends_at class Location
• location
• home_team
• away_team
• (id, created_at, updated_at)

41. class Game
• starts_at
• ends_at class Location
• location
• home_team class Team
• away_team
• (id, created_at, updated_at)

42. CODE!
(generating teams)

43. Database Migrations
• live in db/migrate
• ordered
• Abstracted SQL column types
• includes id and timestamps by default

44. MORE CODE!
(location, game,
migrating)

45. RESTful Routes
• GET /locations (show all locations)
• GET /locations/3 (show one location)
• POST /locations (make a location)
• PUT /locations/3 (update one location)

46. Can also be nested
• GET /locations/3/games (show games for
one location)

47. ‘public’ folder
• For all static files
• Rails looks here first
• Offers caching options

48. Views

49. ERB
• Like JSP/ASP/PHP but in ruby
• lots of helper functions for forms, etc.
• layout → view → partials

50. VIEW CODE!
(fixing the teams)

51. ActiveRecord
Associations
• 1 to 1 (belongs_to - has_one)
• 1 to many (belongs_to - has_many)
• many to many (has_many :through)

52. Controllers

53. Chapter 3:
User Stories
Testing

54. User Stories

55. In order to [value]
As a [actor]
I want [feature]

56. Team roster / player list
feature?

57. In order to know who is on a team
As a league manager
I want to see a list of players on
the team page

58. Feature: Player listings
In order to know who is on a team
As a league manager
I want to see a list of players on the team page
Scenario: listing on a team page
Given I am on the teams page
When I follow "Ballshevicks"
Then I should see "Trotter"

59. Cucumber
Feature: Player listings
In order to know who is on a team
As a league manager
I want to see a list of players on the team page
Scenario: listing on a team page
Given I am on the teams page
When I follow "Ballshevicks"
Then I should see "Trotter"

60. User Stories
as Integration Tests

61. Setting up Cucumber
1. Add `group :development, :test` to Gemfile
2. Add ‘cucumber-rails’, ‘capybara’ and
‘database_cleaner’ in that group
3. Run `bundle`
4. Run `rails generate cucumber:install`
5. `$EDITOR features/players.feature`

62. CODE
(setting it up)

63. Running a scenario
1. Put `@wip` above the scenario
2. Run `rake cucumber:wip`

64. CODE
(running it)

65. Debugging
`Then show me the page`
requires ‘launchy’ gem
`Then debug` (debugger;1)
requires ‘ruby-debug’ or ‘ruby-debug19’

66. CODE
(debugging it)

67. Building data

68. `$EDITOR features/support/fixtures.rb`
Before do
Team.create(:name => "Ballshevicks")
end

69. • Any features/support/*.rb gets loaded
• `Before` gets run before each Scenario

70. Other Data Options
• Load test/fixtures/*.yml
• Use the ‘fabrication’ object factory gem

71. CODE
(giving it data)

72. Defining Steps
When I follow "Show" in the row with "Ballshevicks"
When /^I follow "([^"]*)" in the row with "([^"]*)"$/ do |link, text|
When %Q|I follow "#{link}" within "tr:contains('#{text}')"|
end
features/step_definitions/table_steps.rb

73. Defining Steps
When I follow "Show" in the row with "Ballshevicks"
Regular Expression
When /^I follow "([^"]*)" in the row with "([^"]*)"$/ do |link, text|
When %Q|I follow "#{link}" within "tr:contains('#{text}')"|
end
features/step_definitions/table_steps.rb

74. Defining Steps
When I follow "Show" in the row with "Ballshevicks"
Regular Expression
Capturing groups
When /^I follow "([^"]*)" in the row with "([^"]*)"$/ do |link, text|
When %Q|I follow "#{link}" within "tr:contains('#{text}')"|
end
features/step_definitions/table_steps.rb

75. Defining Steps
When I follow "Show" in the row with "Ballshevicks"
Regular Expression
Capturing groups
When /^I follow "([^"]*)" in the row with "([^"]*)"$/ do |link, text|
When %Q|I follow "#{link}" within "tr:contains('#{text}')"|
end
features/step_definitions/table_steps.rb
Definition in ruby code

76. web_steps.rb
Given I am on the (rake routes) page
When I press “button” / follow “link”
When I fill in “field” with “value”
When I select “option” from “field”
When I check “field”
Then I should see “text” (within “section”)

77. CODE
(assigning teams?)

78. Unit testing

79. Use for direct testing of
• Models (test/unit/*.rb)
• Helpers (test/unit/helpers/*.rb)
• Controllers (test/functional/*.rb)

80. Example:
Player#last_name
class PlayerTest < ActiveSupport::TestCase
test "parses out last name" do
trotter = Player.new(:name => "Trotter Cashion")
assert_equal "Cashion", trotter.last_name
end
end
(Test First! At least try.)

81. CODE
(run and fix it)

82. Chapter 4:
Deploy It!

83. (PaaS)
Heroku

84. (PaaS)
Engine Yard

85. (DIY)
Phusion Passenger

86. (DIY)
LB + Mongrel/Thin

87. (DIY)
Tomcat + JRuby

88. Heroku
https://api.heroku.com/signup

89. http://devcenter.heroku.com/articles/quickstart
$ heroku create
Enter your Heroku credentials.
Email: joe@example.com
Password:
Uploading ssh public key /Users/joe/.ssh/id_rsa.pub
Created http://high-sunrise-58.heroku.com/ |
git@heroku.com:high-sunrise-58.git
Git remote heroku added
$ git push heroku master
...
$ heroku rake db:migrate

90. Heroku demo

91. Thanks!
Some resources
• http://ruby5.envylabs.com/
• http://railscasts.com/
• http://guides.rubyonrails.org/
• http://pragprog.com/book/rails4
• http://www.manning.com/black2/