This presentation was the kick-off for the brown-bag series of learning sessions that AgilityFeat.com is hosting for their software development teams.

1. presents
RELEASE THE GHERKIN!
©2012 AgilityFeat Inc

2. © 2012 AgilityFeat, Inc.

3. What it is
• Straight-forward language
• Common Language
• Communication Tool
• Concrete Examples
• Describes behavior
© 2012 AgilityFeat, Inc.

4. #protip
“make readability your main goal.
Otherwise, a reader can easily feel more
like they’re a reading computer program
than a specification document”
- Aslak Hellesøy (creator of Cucumber)
© 2012 AgilityFeat, Inc.

5. Cucumber’s Natural Habitat
© 2012 AgilityFeat, Inc.

6. Features Plain text
Filename ends in .feature
Describes behavior of system
Lives in features directory
Step Ruby code
Definitions Filename ends in.rb
Does regex match of text from feature files
Lives in features/step_definition directory
Ruby Magic Your preferred gems go here
Referenced in features/support/env.rb
Application We will be testing a web-page
Under Test
© 2012 AgilityFeat, Inc.

7. Example
Feature: Brown Bag Demo
Scenario: Google Search
Given I am on “http://www.google.com”
When I search for “Hello World”
Then I should see results containing the search phrase
© 2012 AgilityFeat, Inc.

8. Solution
Given /^I am on “(*^”+*)”$/ do |arg1|
visit(arg1)
end
When /^I search for “(*^”+*)”$/ do |arg1|
@search_phrase = arg1
within(:css, “#gbqfqw”) do
fill_in ‘q’, :with => @search_phrase
end
end
Then /^I should see results containing the search phrase$/ do
page.should have_content(@search_phrase)
end
© 2012 AgilityFeat, Inc.

9. Feature: Class Demonstration
Scenario: Show a Hello World
Given I want to say “Hello World!”
When I execute the application
Then I should see the message
© 2012 AgilityFeat, Inc.

10. Feature: Class Demonstration
Scenario: Show a Hello World
Given I want to say “Hello World!”
When I execute the application
Then I should see the message
And it should be italic
But it should not be bold
© 2012 AgilityFeat, Inc.

11. Feature: Class Demonstration
Scenario: Show a Hello World
* I want to say “Hello World!”
* I execute the application
* I should see the message
* it should be italic
* it should not be bold
© 2012 AgilityFeat, Inc.

12. Feature: Class Demonstration
Scenario: Show a Hello World
Given I want to say “Hello World!”
When I execute the application
Then I should see the message
And it should be italic
But it should not be bold
© 2012 AgilityFeat, Inc.

13. Feature: Class Demonstration
In order to expose you to new ideas
As an instructor
I want to show you an end-to-end example
Scenario: Show a Hello World
Given I want to say “Hello World!”
When I execute the application
Then I should see the message
And it should be italic
But it should not be bold
© 2012 AgilityFeat, Inc.

14. Feature: Class Demonstration
As an instructor
I would like to show an end-to-end example
So that I can expose you to new ideas
Background:
Given I want to say “Hello World!”
When I execute the application
Then I should see the message
Scenario: Show an italicized Hello World
And it should be italic
Scenario: Show a bold Hello World
But it should not be2012 AgilityFeat, Inc.
©
bold

15. Feature: International Display
Scenario: Display Hello World in English
Given I want to say “Hello World!”
When I execute the application
And I specify English as the language
Then the output should be “Hello World!”
Scenario: Display Hello World in Spanish
Given I want to say “Hello World!”
When I execute the application
And I specify Spanish as the language
Then the output should be “¡Hola, mundo!”
Scenario: Display Hello World in German
Given I want to say “Hello World!”
When I execute the application
And I specify German as the language
Then the output should © 2012 AgilityFeat, Inc.
be “Hallo Welt!”

16. Feature: Internationalize Hello World
Scenario Outline: Display in multiple languages
Given I want to say “Hello World!”
When I execute the application
And I specify “<language>” as the language
Then the output should be “<output>”
Examples:
| language | output |
| English | Hello World! |
| Spanish | ¡Hola, mundo! |
| German | Hallo Welt! |
© 2012 AgilityFeat, Inc.

17. Feature: Travel The World
Scenario: Keep Track Of Visits
Given a list like this:
| Location | Times visited |
| Costa Rica | 0 |
| Germany | 0 |
When I travel to Costa Rica
Then the list should look like this:
| Location | Times visited |
| Costa Rica | 1 |
| Germany | 0 |
© 2012 AgilityFeat, Inc.

18. Doc strings
Scenario: Look up hostel reservation e-mail
When I search for “Alexander House”
Then I should see the following message:
"""
Welcome Mr. Haeffner.
You’ll be staying in the bunk house this visit.
Please refrain from stealing our towels (again).
""”
© 2012 AgilityFeat, Inc.

19. Recap -- Features
• Plain text files that end in .feature
• They live in the root of the features directory
• Given, When, Then, And, But are trigger words
• They matter most for readability
• Descriptive text can go at the top
• There are several approaches to abstract features
and make them more readable
• Usage depends on intent & team understanding
© 2012 AgilityFeat, Inc.

20. Recap -- Step Definitions
• Ruby files that live in features/step_definitions
• Matches plain text from feature files
• Stores it into a variable
• You can set this to a class level variable for use
across your test scenario
• Use a gem to get where you need to go (e.g.
Capybara for web testing)
© 2012 AgilityFeat, Inc.

21. Recap -- System Setup
• Gems you want to use can be added to env.rb
• It lives in the features/support directory
• If/when you create helper methods, create a ruby
file and place them in this directory
• If you add something to your test harness and
execution order is important, place it in env.rb – it
loads before everything else
© 2012 AgilityFeat, Inc.