Outside In Development With Cucumber

With

Ben Mabey

Outside-In Development

Saturday, March 14, 2009

Who’s myaudience?



Scenario: planning meetingGiven I am a Software DeveloperWhen I am given a feature requestThen I should...


What is the mostCRITICAL

word to keep in mind?


WSaturday, March 14, 2009

Scenario: planning meetingGiven I am a Software DeveloperWhen I am given a feature requestThen I should ask why.


_why


Why?Saturday, March 14, 2009

Feature Request:Print Reports

Story from Thoughtworks:

http://www.theregister.co.uk/2007/06/25/


http://www.theregister.co.uk/2007/06/25/thoughtworks_req_manage/







Protect Revenue

Increase Revenue

Manage Cost


Feature: title

In order to [Business Value]As a [Role]I want to [Some Action] (feature)

* not executed* documentation value* variant of contextra* business value up front


There is no template.What is important to have in narrative:

* business value * stakeholder role * user role * action to be taken by user


Scenario: titleGiven [Context]When I do [Action]Then I should see [Outcome]


Scenario: titleGiven [Context]And [More Context]When I do [Action]And [Other Action]Then I should see [Outcome]But I should not see [Outcome]


project_root/| `-- features


project_root/| `-- features |-- awesomeness.feature |-- greatest_ever.feature


project_root/| `-- features |-- awesomeness.feature |-- greatest_ever.feature `-- support |-- env.rb `-- other_helpers.rb


project_root/| `-- features |-- awesomeness.feature |-- greatest_ever.feature `-- support |-- env.rb `-- other_helpers.rb |-- step_definitions | |-- domain_concept_A.rb | `-- domain_concept_B.rb


Step

Given a widget


Step

Given a widgetGiven /â widget$/ do #codes go hereend

Definition


Step


Definition

Step Mother


Step


Definition

Step Mother


Outside-In




Write Scenarios


Steps are pending


Write Step Definition


Go Down A Gear


RSpec


RSpec

We ain’t gotno RSPEC!


RSpec, TestUnit, etc


Write Code Example(Unit Test)


Make Example Pass


REFACTOR!!


Where Are we?


Continue until...


REFACTORand

REPEAT


features/manage_my_wishes.feature

Feature: manage my wishes

In order to get more stuff As a greedy person I want to manage my wish list for my family members to view

Scenario: add wish Given I am logged in When I make a "New car" wish Then "New car" should appear on my wish list



Line # of scenario



I can has backtraze?Given I am logged in #features/manage_my_wishes.feature:8



features/i_can_has_wishez_plz.feature

OH HAI: I CAN HAS WISHEZ PLZ

SO DAT I CAN HAS HUGS TIEM AN PLAY TIEM AN SLEEP TIEM AN NOM TIEM AS NICE GREEDEE KITTEH I CAN PLZ MANEGE TEH WISHEZ

MISHUN: MAK NEW WISH GIVN I AM LOGGD IN WEN I MAK "CHEEZBURGER" WISH DEN I C "CHEEZBURGER" ON ME WISHEZ LIT




cucumber some.feature --language en-lol


cucumber some.feature --language en-lol




features/step_definitions/user_steps.rb

Given /Î am logged in$/ do @current_user = create_user(:email_confirmed => true)

end




end

Test Data Builder / Object Mother




end

spec/fixjour_builders.rb

Fixjour do define_builder(User) do |klass, overrides| klass.new( :email => "user#{counter(:user)}@email.com", :password => 'password', :password_confirmation => 'password' ) endend

Fixture Replacement, Fixjour, Factory Girl, etc




end




visit new_session_path fill_in "Email", :with => @current_user.email fill_in "Password", :with => valid_user_attributes["password"] click_buttonend





Webrat / Awesomeness










features/support/env.rb

require 'webrat'

Webrat.configure do |config| config.mode = :railsend






features/support/env.rb

require 'webrat'

Webrat.configure do |config| config.mode = :railsend

Adapter






features/step_definitions/webrat_steps.rb

When /Î press "(.*)"$/ do |button| click_button(button)end

When /Î follow "(.*)"$/ do |link| click_link(link)end

When /Î fill in "(.*)" with "(.*)"$/ do |field, value| fill_in(field, :with => value) end

When /Î select "(.*)" from "(.*)"$/ do |value, field| select(value, :from => field) end

# Use this step in conjunction with Rail's datetime_select helper. For example:# When I select "December 25, 2008 10:00" as the date and time When /Î select "(.*)" as the date and time$/ do |time| select_datetime(time)end

# Use this step when using multiple datetime_select helpers on a page or # you want to specify which datetime to select. Given the following view:# <%= f.label :preferred %><br /># <%= f.datetime_select :preferred %># <%= f.label :alternative %><br /># <%= f.datetime_select :alternative %># The following steps would fill out the form:# When I select "November 23, 2004 11:20" as the "Preferred" data and time# And I select "November 25, 2004 10:30" as the "Alternative" data and timeWhen /Î select "(.*)" as the "(.*)" date and time$/ do |datetime, datetime_label| select_datetime(datetime, :from => datetime_label)end

# Use this step in conjunction with Rail's time_select helper. For example:# When I select "2:20PM" as the time# Note: Rail's default time helper provides 24-hour time-- not 12 hour time. Webrat# will convert the 2:20PM to 14:20 and then select it. When /Î select "(.*)" as the time$/ do |time| select_time(time)end

# Use this step when using multiple time_select helpers on a page or you want to# specify the name of the time on the form. For example:# When I select "7:30AM" as the "Gym" timeWhen /Î select "(.*)" as the "(.*)" time$/ do |time, time_label| select_time(time, :from => time_label)end

# Use this step in conjunction with Rail's date_select helper. For example:# When I select "February 20, 1981" as the dateWhen /Î select "(.*)" as the date$/ do |date| select_date(date)end

# Use this step when using multiple date_select helpers on one page or# you want to specify the name of the date on the form. For example:# When I select "April 26, 1982" as the "Date of Birth" dateWhen /Î select "(.*)" as the "(.*)" date$/ do |date, date_label| select_date(date, :from => date_label)end

When /Î check "(.*)"$/ do |field| check(field) end

When /Î uncheck "(.*)"$/ do |field| uncheck(field) end

When /Î choose "(.*)"$/ do |field| choose(field)end

When /Î attach the file at "(.*)" to "(.*)" $/ do |path, field| attach_file(field, path)end

Then /Î should see "(.*)"$/ do |text| response.should contain(text)end

Then /Î should not see "(.*)"$/ do |text| response.should_not contain(text)end

Then /^the "(.*)" checkbox should be checked$/ do |label| field_labeled(label).should be_checkedend


19 Steps Out-of-box







visit new_session_path fill_in "Email", :with => @current_user.email fill_in "Password", :with => valid_user_attributes["password"] click_button

end


Given /Î am logged in$/ do

# make sure we have actually logged in- so we fail fast if not session[:user_id].should == @current_user.idend




# make sure we have actually logged in- so we fail fast if not controller.current_user.should == @current_userend


visit new_session_path fill_in "Email", :with => @current_user.email fill_in "Password", :with => valid_user_attributes["password"] click_button session[:user_id].should == @current_user.id



visit new_session_path fill_in "Email", :with => @current_user.email fill_in "Password", :with => valid_user_attributes["password"] click_button



# make sure we have actually logged in- so we fail fast if not session[:user_id].should == @current_user.id controller.current_user.should == @current_user response.should contain("Signed in successfully")end

Specify outcome, not implementation.




visit new_session_path fill_in "Email", :with => @current_user.email fill_in "Password", :with => valid_user_attributes["password"] click_button # make sure we have actually logged in- so we fail fast if not response.should contain("Signed in successfully")end



No route matches “/sessions/create” with{:method=>:post} (ActionController::RoutingError)


I’m going to cheat...


I’m going to cheat...$ gem install thoughtbot-clearance$ ./script generate clearance$ ./script generate clearance_features



features/step_definitions/wish_steps.rb

When /Î make a "(.+)" wish$/ do |wish| end

Then /^(.+) should appear on my wish list$/ do |wish| end



When /Î make a "(.+)" wish$/ do |wish| end


Regexp Capture -> Yielded Variable



When /Î make a "(.+)" wish$/ do |wish| visit "/wishes" click_link "Make a wish" fill_in "Wish", :with => wish click_buttonend




Then /^(.+) should appear on my wish list$/ do |wish| response.should contain("Your wish has been added!") response.should contain(wish)end





Then /^(.+) should appear on my wish list$/ do |wish| response.should contain("Your wish has been added!") response.should contain(wish)end

No route matches “/wishes” with{:method=>:get} (ActionController::RoutingError)


config/routes.rb

ActionController::Routing::Routes.draw do |map| map.resources :wishes


config/routes.rb


When I make a “New car” wishuninitialized constant WishesController (NameError)


config/routes.rb


$./script generate rspec_controller new create


config/routes.rb


When I make a “New car” wishCould not find link with text or title orid “Make a wish” (Webrat::NotFoundError)


app/views/wishes/index.html.erb

<%= link_to "Make a wish", new_wish_path %>



<%= link_to "Make a wish", new_wish_path %>

When I make a “New car” wish Could not find field: “Wish” (Webrat::NotFoundError)







app/views/wishes/new.html.erb

<% form_for :wish do |f| %> <%= f.label :name, "Wish" %> <%= f.text_field :name %> <%= submit_tag "Make the wish!" %><% end %>


fill_in "Wish", :with => wish

<%= f.label :name, "Wish" %> <%= f.text_field :name %>



app/views/wishes/new.html.erb

<% form_for :wish do |f| %> <%= submit_tag "Make the wish!" %><% end %>

Location Strategy FTW!


View

Controller


spec/controllers/wishes_controller_spec.rb

describe WishesController do describe "POST / (#create)" do

endend



describe WishesController do describe "POST / (#create)" do it "should create a new wish for the user with the params" do user = mock_model(User, :wishes => mock("wishes association")) controller.stub!(:current_user).and_return(user) user.wishes.should_receive(:create).with(wish_params)

post :create, 'wish' => {'name' => 'Dog'} end endend


app/controllers/wishes_controller.rb

class WishesController < ApplicationController

def create current_user.wishes.create(params['wish']) end

end



it "should redirect the user to their wish list" do do_post response.should redirect_to(wishes_path) end


describe WishesController do describe "POST / (#create)" do before(:each) do .....

endend



def create current_user.wishes.create(params['wish']) redirect_to :action => :index end


View

Controller

Model




When I make a “New car” wishundefined method `wishes` for #<User:0x268e898> (NoMethodError)




$./script generate rspec_model wish name:string user_id:integer


app/models/wish.rb

class Wish < ActiveRecord::Base belongs_to :userend

app/models/user.rb

class User < ActiveRecord::Base include Clearance::App::Models::User has_many :wishesend


app/models/wish.rb

class Wish < ActiveRecord::Base belongs_to :userend

app/models/user.rb

class User < ActiveRecord::Base include Clearance::App::Models::User has_many :wishesend

When I make a “New car” wishThen “New car” should appear on my wishexpected the following element’s content to include “Your wish has been added!”



it "should notify the user of creation via the flash" do do_post flash[:success].should == "Your wish has been added!"end



def create flash[:success] = "Your wish has been added!" end



current_user.wishes.create(params['wish']) redirect_to :action => :index


current_user.wishes.create(params['wish']) redirect_to :action => :index


def create flash[:success] = "Your wish has been added!" end



Then “New car” should appear on my wishexpected the following element’s content to include “New car”



<ul><% @wishes.each do |wish| %> <li><%= wish.name %></li><% end %></ul>



describe "GET / (#index)" do def do_get get :index end

it "should assign the user's wishes to the view" do do_get assigns[:wishes].should == @current_user.wishes end

end



def index @wishes = current_user.wishes end




Scenario: view members list Given the following wishes exist | Wish | Family Member | | Laptop | Thomas | | Nintendo Wii | Candace | | CHEEZBURGER | FuzzBuzz | When I view the wish list for "Candace"

Then I should see the following wishes | Wish | | Nintendo Wii |


Given the following wishes exist | Wish | Family Member | | Laptop | Thomas | | Nintendo Wii | Candace | | CHEEZBURGER | FuzzBuzz |


Given /^the following wishes exist$/ do |table|

endend


| Wish | Family Member | features/step_definitions/wish_steps.rb

Given /^the following wishes exist$/ do |table| table.hashes.each do |row| member = User.find_by_name(row["Family Member"]) || create_user(:name => row["Family Member"])

member.wishes.create!(:name => row["Wish"]) endend

Given the following wishes exist | Wish | Family Member | | Laptop | Thomas | | Nintendo Wii | Candace | | CHEEZBURGER | FuzzBuzz |


Feature: Addition In order to avoid silly mistakes As a math idiot I want to be told the sum of two numbers

Scenario Outline: Add two numbers Given I have entered <input_1> into the calculator And I have entered <input_2> into the calculator When I press <button> Then the result should be <output> on the screen

Examples: | input_1 | input_2 | button | output | | 20 | 30 | add | 50 | | 2 | 5 | add | 7 | | 0 | 40 | add | 40 |





<input_1> <input_2> <button> <output>

| input_1 | input_2 | button | output |






| 20 | 30 | add | 50 |






| 2 | 5 | add | 7 |






| 0 | 40 | add | 40 |


When /Î view the wish list for "(.+)"$/ do |user_name| Given "I am logged in" visit "/wishes/#{user_name}"end

Steps Within Steps


When /Î view the wish list for "(.+)"$/ do |user_name| visit "/wishes/#{user_name}"end

Steps Within Steps Given "I am logged in"


When /Î view the wish list for "(.+)"$/ do |user_name| login_as(create_user) visit "/wishes/#{user_name}"end

Helpers - Ruby FTW


When /Î view the wish list for "(.+)"$/ do |user_name| visit "/wishes/#{user_name}"end

Helpers - Ruby FTW login_as(create_user)







def login_as(user) visit new_session_path fill_in "Email", :with => user.email fill_in "Password", :with => valid_user_attributes["password"] click_button # make sure we have actually logged in- so we fail fast if not response.should contain("Signed in successfully") end Given /Î am logged in$/ do @current_user = create_user(:email_confirmed => true) login_as(@current_user)end







“Every time you monkeypatch Object, a kitten dies.”

http://seanohalpin.github.com/unobtrusive-metaprogramming/unobtrusive-metaprogramming.html





module UserHelpers def login_as(user) visit new_session_path fill_in "Email", :with => user.email fill_in "Password", :with => valid_user_attributes["password"] click_button # make sure we have actually logged in- so we fail fast if not response.should contain("Signed in successfully") endend






World { |world| world.extend UserHelpers }


World { |world| world.extend UserHelpers }


I can skp teh unit testz?


Acceptance Tests

Application LevelFor CustomersSlowGood confidencePrevent against regression

Unit Tests

Object Level- Isolated!For developersFAST! (should be at least)- Tighter Feedback LoopMore about design!!!!!!!!!!!!

Will need both gears! Some things are easier to test at the application level and vice-versa.


SRSLY?Model specs,Controller Specs,and view specs!?





WSaturday, March 14, 2009

MSaturday, March 14, 2009

More tests == More Maintenance


Test Value =Design +

Documentation +Defence (regression)


if test.value > test.cost Suite.add(test)end


KTHXBYE!BenMabey.com

github.com/bmabey

Twitter: bmabeyIRC: mabes


Outside In Development With Cucumber

Documents