Instant Cucumber BDD How-to

Feature: Write blog
As a blog owner 
I can write new blog post
 Scenario: Write blog
   Given I am on the blog homepage
   When I click "New Post" link
   And I fill "My first blog" as Title
   And I fill "Test content" as content
   And I click "Post" button
   Then I should see the blog I just posted

cucumber features/write_post.feature:

$ rails generate scaffold Post title content:textpost_time:datetime

$ rakedb:migrate
$ RAILS_ENV=test rake db:migrate

Given /^I am on the blog homepage$/ do
 visit("/posts")
end

When /^I click "New Post" link$/ do
 click_on "New Post"
end

When /^I fill "(.*?)" as Title$/ do |title|
 @title = title
 fill_in "Title", :with => title
end

When /^I fill "(.*?)" as content$/ do |content|
 fill_in "Content", :with => content
end

When /^I click "(.*?)" button$/ do |btn|
 click_button btn
end

Then /^I should see the blog I just posted$/ do
 page.should have_content(@title)
end

Feature: Show blog list
As a blog visitor 
I can see list of posted blogs

 Scenario: Show blog list
   Given there are already 4 posts
And I am on the blog homepage
   Then I can see list of 4 posted blogs

Given /^I am on the blog homepage$/ do
  visit("/posts")
end

And /^there are already (\d) posts$/ do |count|
  count.to_i.times do |n|
    Post.create!({ :title => "Title #{n}", :content => "Content #{n}", :post_time => Time.now })
  end
end

Then /^I can see list of (\d) posted blogs$/ do |count|page.should have_selector("table#posts-list>tr:eq(#{count})")end

<h1>Listing posts</h1>

  <table id="posts-list">
    <tr>
      <th>Title</th>
      <th>Content</th>
      <th>Post time</th>
      <th></th>
      <th></th>
      <th></th>
    </tr>

    <% @posts.each do |post| %>
    <tr>
      <td><%= post.title %></td>
      <td><%= post.content %></td>
      <td><%= post.post_time %></td>
      <td><%= link_to 'Show', post %></td>
      <td><%= link_to 'Edit', edit_post_path(post) %></td>
      <td><%= link_to 'Destroy', post, method: :delete, data: { confirm: 'Are you sure?' } %></td>
    </tr>
    <% end %>
  </table>

  <br />

  <%= link_to 'New Post', new_post_path %>

Feature: Edit blog
As a blog owner
I can edit my blog posts

 Scenario: Edit blog 
   Given there is a post with title "Dummy post" and content "Dummy content"
   And I am on the blog homepage
   When I edit this post
   And I update title to "Updated title" and content to "Updated content"
   Then I can see it has been updated

Given /^there is a post with title "(.*?)" and content "(.*?)"$/ do |title, content|
  @post = Post.create!({ :title => title, :content => content, :post_time => Time.now })
end

When /^I edit this post$/ do
 visit(edit_post_url @post)
end

When /^I update title to "(.*?)" and content to "(.*?)"$/ do |title, content|
  @updated_title = title
  @updated_content = content
  @post.update_attributes!({ :title => @updated_title, :content => @updated_content })
end

Then /^I can see it has been updated$/ do
  step %{I am on the blog homepage}
  find("table#posts-list>tr:eq(2) >td:eq(1)").should have_content(@updated_title)
  find("table#posts-list>tr:eq(2) >td:eq(2)").should have_content(@updated_content)
end

Feature: Input comment
As a blog visitor
I can input comment onto blog

 Scenario: Input comment
   Given there is a post titled with "Dummy post" and content with "Dummy content"
   And I am on the post page
   When I add a comment with the following information
     | Name    | Email             | Content         |
     | Wayne   | admin@wayneye.com | Test comment    | 
   Then I can see the comment has been added onto the post

Given /^I am on the post page$/ do
 visit(post_path @post)
end

When /^I add a comment with the following information$/ do |table|
 # table is a Cucumber::Ast::Table
 table.hashes.each do |comment_data|
   @commenter = comment_data[:name]
   @email = comment_data[:email]
   @content = comment_data[:content]
   @post.comments.create!({ :name => @commenter, :email => @email, :content => @content })
 end
end

Then /^I can see the comment has been added onto the post$/ do
 comments_list = find("div#comments-list")
 comments_list.should have_content(@commenter)
 comments_list.should have_content(@email)
 comments_list.should have_content(@content)
end

$ rails generate scaffold Comment post:references name email content

$ rakedb:migrate && RAILS_ENV=test bundle exec rake db:migrate

resources :blogs do
 resources :comments
end

has_many :comments

def create
 @comment = Comment.new(params[:comment])
 @comment.post = Post.find_by_id(params[:post_id])

 respond_to do |format|
   if @comment.save
     format.html { redirect_to @comment.post, notice: 'Comment was successfully created.' }else
     format.html { render action: "new" }
     format.json { render json: @comment.errors, status: :unprocessable_entity }
   end
 end
end

<h2>&darr;Comments&darr;</h2>
<div id="comments-list">
  <% @post.comments.each_with_index do |c,idx| %>
  <p><span>#<%= idx + 1 %>: <%= c.name %></span>: <%= c.content %></p>
  <% end %>

  <hr />

  <%= form_for([@post, @post.comments.build]) do |f| %>
  <div class="field">
    <%= f.label :name %><br />
    <%= f.text_field :name %>
  </div>
  <div class="field">
    <%= f.label :email %><br />
    <%= f.text_field :email %>
  </div>
  <div class="field">
    <%= f.label :content %><br />
    <%= f.text_area :content %>
  </div>
  <div class="actions">
    <%= f.submit %>
  </div>
  <% end %>
</div>

Feature: Delete comment
As a blog owner
I can delete comment

 Scenario: Delete comment
   Given there is a post titled with "Dummy post" and content with "Dummy content"
   And there is a comment on this post
   When I am on the post page
   And I click "Delete Comment" 
   Then the comment should be deleted

Given /^there is a comment on this post$/ do
  @post.comments.create!({ :name => "Wayne", :email => "admin@wayneye.com", :content => "Test deleting comment" })
end

When /^I click "Delete Comment"$/ do
  click_on "Delete Comment"
end

Then /^the comment should be deleted$/ do
  find("#comments-list").should have_no_content("Wayne") 
end

<% @post.comments.each_with_index do |c,idx| %>
 <p>
   <span>#<%= idx + 1 %>: <%= c.name %></span>: <%= c.content %> 
   <%= link_to "Delete Comment", post_comment_path(@post, c), :method => :delete, :confirm => "Are you sure you want to delete this comment?" %>
 </p>
<% end %>

Feature: Github account management
In order to manage my profile, repositories and my SSH Keys
As a registered developer
I Should be able to log into system and manage my account
 Scenario: Change my avatar
   Given I logged into Github with account "Wayne Ye"
   When I click my avatar to go to the "Your Profile" page
   Then I can change my avatar with "Wayne.png"

 Scenario: View my repositories
   Given I logged into Github with account "Wayne Ye"
   When I click my avatar to go to the "Your Profile" page
   And I click on "Repositories" hyperlink
   Then I should be able to see all my repositories

 Scenario: Add a SSH KeyGiven I logged into Github with account "Wayne Ye"
   When I click my avatar to go to the "Your Profile" page
   And I click on "SSH Keys" hyperlink
   Then I add a new SSH key

Feature: Github account management
In order to manage my profile, repositories and my SSH Keys
As a registered developerI Should be able to log into system and manage my account

 Background:
   Given I logged into Github with account "Wayne Ye"
   When I click my avatar goto the "Your Profile" page

 Scenario: Change my avatar
   Then I can change my avatar with "Wayne.png"

 Scenario: View my repositories
   And I click on "Repositories" hyperlink
   Then I should be able to see all my repositories

 Scenario: Add a SSH Key
   And I click on "SSH Keys" hyperlink
   Then I add a new SSH key

Feature: User registration
In order to shop in ABC online shop
As a userI should be able to register an account through registration page

 Scenario: register with valid information
   When I am on the registration page of ABC online shop
   And I fill the "Full Name" form with "Wayne Ye"
   And I fill the "Address" form with "123 Main Street"
   And I fill the "Email" form with "admin@wayenye.com"
   And I fill the "Password" form with "asdf"
   Then I should be redirected to registration success page

Feature: User registration
In order to shop in ABC online shop
As a userI should be able to register an account through registration page

 Scenario: register with valid information
   When I am on the registration page of ABC online shop
   And I fill the form with the following value
     | Full Name| Address     | Email          | Password |
     | Wayne Ye | No 12 Pt Street| admin@wayenye.com |asdf|
   Then I should be redirected to registration success page

Scenario: instance messenger online 
 When I log into ABC social website
 And I open up the IM tab
 Then I should see my online friends
   | Mark   |
   | Sean   |
   | Shelly |
   | Wendy  |

Background:
 When I am on the registration page

Scenario: user registration
 When I fill "email" field with ""
 And I press "Register" button
 Then I should see error message "Email cannot be blank"
 When I fill "email" field with "wayne"
 And I press "Register" button
 Then I should see error message "Please input valid Email address"
 And I fill "password" field with ""
 And I press "Register" button
 Then I should see error message "Password cannot be blank"
 And I fill "password" field with "asdf"
 And I press "Register" button
 Then I should see error message "Password is too short"

Scenario Outline: user registration
 When I fill "<field_name>" field with "<value>"
 And I press "Register" button
 Then I should see error message "<error_message>"

Examples:
 |field_name| value     | error_message          |
 | Email    |           | Email cannot be blank  |
 | Email    | wayne     | Please input valid Email address |
 | Email    |admin@wayne.com| Email has already been taken     |
 | Password |          | Password cannot be blank     |
 | Password | asdf     | Password is too short        |

Scenario: User registration
 When the user clicks "Register"
 Then an Email should be sent out with content:
"""
Dear customer,
Thank you for registering at ABC website!
Please click the following link to activate your account!
http://foo-web.com/user/wayne/activation
"""

Then /^an Email should be sent out with content:$/ do |string|p string.class # Cucumber::Ast::DocString
 p string
 # "Dear customer,\nThank you for registering at ABC website!\nPlease click the following link to activate your account!\nhttp://foo-web.com/user/wayne/activation"
end

When the user has 1 gift
...
When the user has 5 gifts
...

When /^the user has (\d+) gifts?$/ do |num|
 p num.to_i
end

When there is 1 person in the meeting room
When there are 8 people in the meeting room

When /^there (?:is|are) (\d+) (?:person|people) in the meeting room$/ do |num|
 p num.to_i
end

Transform /^(-?\d+)$/ do |num|
 num.to_i
end

Given this Qatar billionaire has 39 billion
And his wealth consists of the following major parts
 | Domain      | Worth |
 | Oil         | 21    |
 | Real Estate | 8     |
 | Financial   | 6     |
 | Cargo       | 4     |

Transform /^table:domain,worth/ do |table|
  table.map_headers! { |header| header.downcase.to_sym }
  table.map_column!(:domain) { |domain| Domain.parse(domain) }
  table.map_column!(:worth) { |worth| "$#{worth}" }
 table
end

def current_user
 # Code to mock a current user object
end

module CapybaraHeadersHelper
 def add_headers(headers)
   headers.each do |name, value|
     page.driver.browser.header(name, value)
   end
 end
end
World(CapybaraHeadersHelper)

Feature: Login with 3rd party account
As a website user
I can login with 3rd party account
So that I don't have to register a new account

 Scenario: Login with Facebook account
   Given user landed at login page
   And he choose login with FacebookThen he should see the Facebook authorization window

 Scenario: Login with Google account
   Given user landed at login page
   And he choose login with Google
   Then he should see the Google authorization window

 Scenario: Login with OpenID account
   Given user landed at login page
   And he choose login with OpenID
   Then he should see the OpenID login window

Given /^he choose login with (.*)$/ do |account_provider|
 step %{user clicks on the #{account_provider} logo}
 step %{login with #{account_provider}}
end

Given /^user clicks on the (.*) logo$/ do |account_provider|
 # DOM operation to trigger clicking on the related logo
end
Given /^login with (.*)$/ do |account_provider|
 # Implement OAuth login per given 3rd party account
end

Given /^user landed at login page$/ do
end

Then /^wait (\d+) seconds?/ do |seconds|
 sleep(seconds.to_i)
end

When I wait 5 seconds after the certificate has been downloaded 
When I wait 4 seconds until the loading animation finished

FactoryGirl.define do
 factory :post do
   title 'Test title'
   content 'Test content'
   post_time Time.now
 end
end

Given /^there is a post titled with "(.*?)" and content with "(.*?)"$/ do |title, content|
  FactoryGirl.create(:post, title: title, content: content)
end

FactoryGirl.define do
  factory :post do
    title 'Test title'
    content 'Test content'
    post_time Time.now

    factory :post_with_comments do
      ignore do
        comments_count 5
      end

      after(:create) do |post, evaluator|
        FactoryGirl.create_list(:comment, evaluator.comments_count, post: post)
      end
    end
  end

  factory :comment do
    name "Wayne"
    email "admin@wayneye.com"
    content "Test comment content"
  end
end

Given there is a post with 1 comment

Given /^there is a post with (\d) comment$/ do |comments_count|
  @post = FactoryGirl .create(:post_with_comments, comments_count: comments_count.to_i)
end

$ rails generate pickle --path

Given there is a post titled with "Dummy post" and content with "Dummy content"

Given a post exists with title: "Dummy post", content: "Dummy content"

When I am on the post's page

edit_blog_steps.rb:
When /^I am on the post's page$/ do
  visit(path_to "the edit page for post")
end
paths.rb:
when /^the edit page for #{capture_model}$/
  polymorphic_path(model!($1), :action => "edit")

Feature: OAuth with Github
In order to provide easy registration and login
As a web application
I want submit OAuth request to Github and acquire user's authorization

 Scenario: User accept to authorize
   Given the user landing on homepage
   When the user clicks "Github" icon within "Registration" area
   Then the user should see GithubOAuth page
   When the user enter user email and password correctly
   And the user clicks "Authorize App"
   Then the user should be on registration success pageAnd I can get user's name on Github
   And I can get the user's repositories on Github

stub_request(:POST, "https://github.com/login/oauth/access_token").with("client_id={client_id}&client_secret={secret}&code={code}").to_return("access_token={token}&token_type=bearer")stub_request(:GET, "https://api.github.com/users/wayneye").with(:headers => 'Authorization: token {fake_token}').and_return('"name": "Wayne Ye", "public_repos": 9, "company": "ThoughtWorks"')

# A sample Guardfile
# More info at https://github.com/guard/guard#readme

guard 'spork', :cucumber_env => { 'RAILS_ENV' => 'test' }, :rspec_env => { 'RAILS_ENV' => 'test' }, :rspec => false,:cucumber => true, :test_unit => false do
  watch('config/application.rb')
  watch('config/environment.rb')
  watch('config/environments/test.rb')
  watch(%r{^config/initializers/.+\.rb$})
  watch('Gemfile')
  watch('Gemfile.lock')
  watch('spec/spec_helper.rb') { :rspec }
  watch('test/test_helper.rb') { :test_unit }
  watch(%r{features/support/}) { :cucumber }
end

guard 'cucumber', :cli => '-c --drb' do
  watch(%r{^features/.+\.feature$})
  watch(%r{^features/support/.+$})          { 'features' }
  watch(%r{^features/step_definitions/(.+)_steps\.rb$}) { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'features' }
end