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!

Cucumber: How I Slice It

0 comments

Notes on slide 1

4 Favorites

Cucumber: How I Slice It - Presentation Transcript

More by user

More info about this document

Categories

Tags

Cucumber: How I Slice It

0 comments

Notes on slide 1

4 Favorites

Cucumber: How I Slice It - Presentation Transcript

Related Presentations

More by user

More info about this document

Categories

Tags