Cucumber: How I Slice It

Cucumber: How I Slice It Jonathan Linowes Parkerhill Technology Group NH Ruby Group, January 15, 2009 Executable plain-text documentation

Intro
See http://www.slideshare.net/bkeepers/behavior-driven-development-with-cucumber-presentation
Home http://wiki.github.com/aslakhellesoy/cucumber

Uses
Collaboration, brainstorming with customer
Specification, refinement of requirements
Behavior driven development
View specs
Integration testing
Regression testing

How I actually use it
Talking to myself (planning)
Keep track of what I'm working on (outlining)
Automate my manual testing (scripting)
Regression testing (confidence)

When I use it
written first, in true BDD tao
written simultaneously with code and specs
written after the code is working
run as regression
run on deploy (cap deploy:features)
run with debugger

Directories and files
Rails app root/
features/
[feature set]/
[feature].feature files
poetry_contest/
simple_clicking.feature
submitter_submits_new_submission.feature
step_definitions/
browser_steps.rb
account_steps.rb
project_steps.rb
poetry_contest_steps.rb
other [steps].rb files
support/
env.rb

Demo – simple clicking
Feature: simple clicking
As someone interested in the Poetry Contest
I visit the project and view some pages
So I can learn more about the contest
Scenario: Anonymous user clicks submit
Given a Poetry Submissions setup
When I browse to the project "home" page
Then I should see a "Submit" link
And the page html should be valid
When I click the "Submit" link
Then I should see the "Poem Submission Form" page
And (show me)

Given
Given /^a Poetry (.*) setup$/ do |setup|
@account ||= create_account( 'test' )
@project ||= create_project( 'poetry contest', @account )
case setup.downcase
when 'submissions':
poetry_submissions_setup
when 'submissions and reviews': poetry_submissions_and_reviews_setup
else puts "UNKNOWN POETRY SETUP"
end
end
Using instance variables for 'state'
My own 'factory' (create) methods
High level setup methods

When
Using regexp conventions in matcher
Using quotes for named things
String#normalize: downcase, strip, _, etc
Assume current state (@project)
Webrat for requests
When /^I browse to the project "(.*)" page$/ do |page|
# browse refers to the url
page = '' if page == 'home'
visit "/#{@project.to_param}/#{page.normalize}"
end
When /^I click the "(.*)" link$/ do |link|
click_link link
end

Then
Using webrat for asserts
Matches keywords like 'link$/' or 'page$/'
Natural language conveniences
Then I should see a “Foo” link
And a “Bar” link
App-specific conventions (h1 for page title)
Then /^(I should see a|a) "(.*)" link$/ do |see, link|
response.should have_tag("a", link)
end
Then /^(I should see the|the) "(.*)" page$/ do |see, h1_contents|
response.should have_tag("h1", h1_contents)
end

Utilities
See http://www.vaporbase.com/postings/Show_me_the_response
Then /^the page html should be valid$/ do
# using ruby_tidy
assert_tidy
end
Then /^(show me)$/ do
show_me
#save_and_open_page
end
# support/env.rb
def show_me
name = response.request.request_uri.gsub(/[/#?]/,'-')
File.open(RAILS_ROOT + "/public/cucumber/#{name}.html", "w"){ |f| f.puts response.body }
system "open -a Firefox.app http://localhost:3000/cucumber/#{name}.html"
end

Demo – scenario outline membership/invite_reviewer.feature:41 (29)
Runs once for each example
mail
Scenario Outline: invite existing users
Given I am logged in as a Manager member
And there is a <status> user with email "invitee@example.com"
When I invite the user to be a Reviewer
Then there should be a user with that email
And he should be Invited as a Reviewer member
And he should be sent a Invitation email
And I should see the "Memberships" resource table
And a Notice saying "User successfully invited"
Examples:
| status |
| Passive |
| Pending |
| Active |

mailer_setup
# env.rb
def mailer_setup
ActionMailer::Base.delivery_method = :test
ActionMailer::Base.perform_deliveries = true
ActionMailer::Base.deliveries = []
end
def last_email_sent(index=-1)
ActionMailer::Base.deliveries[index]
end
# step
Then /^(.*) should be sent (a|an) (.*) email$/ do |who, a, dispatch|
(...)
case dispatch.downcase
when 'invitation'
last_email_sent.subject.should include("You're Invited")
last_email_sent.to.should include(user.email)
(...)

Demo – a view spec page_builder/toolbox_nav_page.feature:151
high level given's and when's, then the then's
asserts flash, tabs, fields, buttons, links, icons, etc
Scenario: Controls for edit a download
Given I can edit an existing page in an existing project
When I go add content to the page
And I click the "File download" button
#And (show me)
Then I should see a Notice saying "Content added"
And the toolbox should be on the "Edit selected" tab
And the compose-view area should have a "File" file input for the Download
And the compose-view area should have a "Upload File" button posting to "page/component/update"
And the compose-view area should have a "No file now, Upload later" link to "page/components/new"
And the toolbox area should have a "Title" text input for the Download
And the toolbox area should have a "Description" textarea input for the Download
And the toolbox area should have a "Save Changes" button posting to "page/component/update"
And the toolbox area should have a "Back to compose page" link to "page/components/new"
And the toolbox area should have a "Delete" icon to "page/component/nuke"
And the toolbox area should have an "Up" icon to "page/component/higher"

Demo – an epic story poetry_contest/submitter_adds_attachment.feature:88
Scenario: There are multiple submitters, with multiple submissions, with multiple attachments
Given a Poetry Submissions setup
And project has a two file upload fields
# ------
And there is a user with email "shira@linowes.com"
And the user is a Submitter member who has been Approved
And I log in as "shira@linowes.com"
And I click the "Submit" link
And I fill out and submit the Submission form with:
| field | value |
| poem | Mary had a little lamb |
| file upload | shira-poem.txt |
| image upload | shira.jpg |
Then a Poetry submission for me should be created
And the file "shira-poem.txt" should be uploaded
And the file "shira.jpg" should be uploaded
When I click the "Submit" link
| field | value |
| poem | Mary had a little lamb 2222|
| file upload | shira-poem2.doc |
| image upload | snow.jpg |
Then a Poetry submission for me should be created
And the file "shira-poem2.doc" should be uploaded
And the file "snow.jpg" should be uploaded
When I log out
# ------
Given a user with email "steven@linowes.com"
And the user is a Submitter member who has been Approved
And I log in as "steven@linowes.com"
And I click the "Submit" link
complex setup
testing uploads
using step tables
45 steps!

Closing Thoughts
requires time and thought about natural language and conventions
haven't integrated with browsers yet – selenium, etc
especially for javascript (unobtrusive, ftw!)
cap deploy:features -- ftw!

http://nhruby.org	18
http://www.slideshare.net	18
http://www.vaporbase.com	3
http://static.slideshare.net	1

Cucumber: How I Slice It

by linoj on Jan 16, 2009

Accessibility

Categories

Tags

Upload Details

Usage Rights

4 Embeds 40

Statistics

Cucumber: How I Slice It — Presentation Transcript