cucumber-websteps 0.9.0

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc
+.yardoc/
+doc/

data/.travis.yml

@@ -0,0 +1,4 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - ree

data/.yardopts

@@ -0,0 +1,3 @@
+--readme README.md
+--files features/CHANGELOG.md
+--markup rdoc

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in cucumber-websteps.gemspec
+gemspec

data/README.md

@@ -0,0 +1,23 @@
+Cucumber web steps [![Build Status](http://travis-ci.org/kucaahbe/cucumber-websteps.png)](http://travis-ci.org/kucaahbe/cucumber-websteps)
+==========================================================================================================================================
+
+Description
+-----------
+
+[Capybara](http://github.com/jnicklas/capybara) powered common cucumber web steps for any web application (blackjack and hookers included).
+
+<strong>Because!</strong>
+
+* Here collected [all "web steps"](http://github.com/cucumber/cucumber-rails/blob/master/lib/generators/cucumber/install/templates/step_definitions/web_steps.rb.erb) you need and even more([<b>-=INCLUDED STEPS DOCUMENTATION LINK=-</b>](http://relishapp.com/kucaahbe/cucumber-websteps))
+* Support your favorite testing framework (test/unit, minitest, rspec-1, rspec-2) <b>Note:</b> not yet tested with rspec-1, coming soon
+* work with both :rack\_test and :selenium drivers
+* all in one place, DRY.
+* [launchy](http://rubygems.org/gems/launchy) included :)
+* blackjack and hookers  ;)
+
+[Install](http://relishapp.com/kucaahbe/cucumber-websteps)
+----------------------------------------------------------
+
+and enjoy!
+
+![Steps:)](http://github.com/kucaahbe/cucumber-websteps/raw/master/steps.jpg)

data/Rakefile

@@ -0,0 +1,16 @@
+require 'bundler'
+require 'cucumber'
+require 'cucumber/rake/task'
+Bundler::GemHelper.install_tasks
+
+task :default => ['examples:rack_test']
+#task :default => ['examples:rack_test','examples:selenium']
+
+namespace :examples do
+  Cucumber::Rake::Task.new(:selenium) do |t|
+    t.profile='selenium'
+  end
+  Cucumber::Rake::Task.new(:rack_test) do |t|
+    t.profile='rack_test'
+  end
+end

data/cucumber-websteps.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "cucumber/websteps/version"
+
+Gem::Specification.new do |s|
+  s.name        = "cucumber-websteps"
+  s.version     = Cucumber::Websteps::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["kucaahbe"]
+  s.email       = ["kucaahbe@ukr.net"]
+  s.homepage    = "http://relishapp.com/kucaahbe/cucumber-websteps"
+  s.summary     = %q{Capybara powered common cucumber web steps for any web application (blackjack and hookers included).}
+  s.description = %q{Here cucumber web steps collected during BDD practice in different projects, all steps are tested to work with :rack_test and :selenium drivers. Test framework agnostic (you can use them with rspec-1, rspec-2, test/unit and minitest).}
+
+  s.rubyforge_project = "cucumber-websteps"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'capybara'
+  s.add_dependency 'cucumber'
+  s.add_dependency 'launchy'
+
+  s.add_development_dependency 'sinatra'
+end

data/cucumber.yml

@@ -0,0 +1,3 @@
+<% %w(selenium rack_test).each do |config| %>
+<%= config %>: -r features/setup/<%= config %>.rb -r features/support -r features/step_definitions features
+<% end %>

data/features/CHANGELOG.md

@@ -0,0 +1,38 @@
+0.9.1
+-----
+
+* TODO: added 'about disabled form fields'
+* TODO: handle disabled form fields
+
+0.9.0
+-----
+
+* added and improved standard cucumber websteps:
+  * 'I fill in "field"...' :
+
+	    When I fill in "TextArea" with:
+	    """
+	    some
+	    bla
+	    bla
+	    """
+
+  * 'I fill in the following' now can handle selects, checkboxes and radiobuttons:
+
+	    When I fill in the following:
+	      | Name                            | my name    |
+	      | Sex                  (select)   | Male       |
+	      | Accept user agrement (checkbox) | check      |
+	      | Send me letters      (checkbox) | uncheck    |
+	      | radio 1              (radio)    | choose     |
+	      | Avatar               (file)     | avatar.png |
+  * 'I attach file' step will raise exception if file not found and will search file in features/support/attachments
+  * improved 'I should see //...' step to add options to regexp
+* added 'I should be redirected to' step(but not finished)
+* added 'I select following values'
+* added 'I unselect following values'
+* added 'the select "select" should have following options'
+* added 'the following values should be selected'
+* added 'the following values should not be selected'
+* added 'I should see 2 elements kind of ...'
+* added 'I should not see elements kind of ...'

data/features/README.md

@@ -0,0 +1,47 @@
+Cucumber web steps [![Build Status](http://travis-ci.org/kucaahbe/cucumber-websteps.png)](http://travis-ci.org/kucaahbe/cucumber-websteps)
+==========================================================================================================================================
+
+Description
+-----------
+
+[Capybara](http://github.com/jnicklas/capybara) powered common cucumber web steps for any web application (blackjack and hookers included).
+
+<strong>Because!</strong>
+
+* Here collected [all "web steps"](http://github.com/cucumber/cucumber-rails/blob/master/lib/generators/cucumber/install/templates/step_definitions/web_steps.rb.erb) you need and even more([<b>-=INCLUDED STEPS DOCUMENTATION LINK=-</b>](http://relishapp.com/kucaahbe/cucumber-websteps))
+* Support your favorite testing framework (test/unit, minitest, rspec-1, rspec-2) <b>Note:</b> not yet tested with rspec-1, coming soon
+* work with both :rack\_test and :selenium drivers
+* all in one place, DRY.
+* [launchy](http://rubygems.org/gems/launchy) included :)
+* blackjack and hookers  ;)
+
+Install
+-------
+
+### install gem
+
+run in console:
+
+    [sudo] gem install cucumber-websteps
+
+or add to Gemfile:
+
+    gem 'cucumber-websteps'
+
+### setup in application
+
+if you are using rails, then you already <b>have (and know about)</b> following files:
+
+<b>features/support/paths.rb</b>
+
+<b>features/support/selectors.rb</b>
+
+they should be as they is, if you do not have these files or don't know what they are then just add them with [this content](http://gist.github.com/993837)
+<script src="https://gist.github.com/993837.js?file=paths.rb"></script>
+<script src="https://gist.github.com/993837.js?file=selectors.rb"></script>
+and replace (or add) <b>features/step_definitions/web_steps.rb</b> with [this content](http://gist.github.com/993837#file_web_steps.rb)
+<script src="https://gist.github.com/993837.js?file=web_steps.rb"></script>
+
+3. run your features!
+
+TODO: add footer

data/features/defined_steps/forms_steps.feature

@@ -0,0 +1,76 @@
+Feature: Forms steps
+
+  Steps for various forms interaction
+
+  Scenario: Simple form steps
+    Given I am on the form page
+    When I fill in "Name" with "my name"
+    And I fill in "Describe yourself" with:
+    """
+    this usefull
+    for textareas
+    """
+    Then the select "Sex" should have following options:
+      |        |
+      | Female |
+      | Male   |
+    When I select "Male" from "Sex"
+    And I check "Accept user agrement"
+    And I uncheck "Send me letters"
+    And I choose "radio 1"
+    And I attach the file "avatar.png" to "Avatar"
+    Then the select "Your favorite colors" should have following options:
+      | black  |
+      | white  |
+      | red    |
+      | green  |
+      | yellow |
+      | blue  |
+    When I select following values from "Your favorite colors":
+      | red   |
+      | blue  |
+      | green |
+    And I unselect following values from "Your favorite colors":
+      | green |
+    Then the "Name" field should contain "my name"
+    And the "Describe yourself" field should contain "this usefull\nfor textareas"
+    #And the "Name" field should not contain "not my name" --> failing in 1.9.2
+    And the "Accept user agrement" checkbox should be checked
+    And the "Do not touch me" checkbox should not be checked
+    #And the radio should be selected
+    And the following values should be selected in "Your favorite colors":
+      | red   |
+      | blue  |
+    And the following values should not be selected in "Your favorite colors":
+      | black  |
+      | white  |
+      | green  |
+      | yellow |
+    When I press "Submit"
+    Then I should see "Form submited!"
+    And I should see "Name: my name"
+    And I should see "About me: this usefull for textareas"
+    And I should see "Sex: Male"
+    And I should see "Accepted user agrement: Yes"
+    And I should see "Like spam? No"
+    And I should see "radio: radio 1"
+    And I should see "Your favorite colors: red,blue"
+    #And I should see "TODO something with avatar"
+
+  Scenario: Massive form filling
+    Given I am on the form page
+    When I fill in the following:
+      | Name                            | my name    |
+      | Sex                  (select)   | Male       |
+      | Accept user agrement (checkbox) | check      |
+      | Send me letters      (checkbox) | uncheck    |
+      | radio 1              (radio)    | choose     |
+      | Avatar               (file)     | avatar.png |
+    Then the "Name" field should contain "my name"
+    #And the "Name" field should not contain "not my name" --> failing in 1.9.2
+    And the "Accept user agrement" checkbox should be checked
+    And the "Do not touch me" checkbox should not be checked
+    #And the radio should be selected
+    #And selectbox should contain
+    When I press "Submit"
+    Then I should see "Form submited!"

data/features/defined_steps/simple_steps.feature

@@ -0,0 +1,27 @@
+Feature: Simple browsing steps
+
+  With this steps you can:
+
+  * open pages
+  * click links
+  * match page contet
+  * match redirections
+
+  Scenario: Simple browsing steps copy-pasted (and maybe improved) from cucumber-rails generator
+    Given I am on the home page
+    When  I follow "some link"
+    Then  I should be on the congratulations page
+    And   I should see "Great, you can click links!"
+    And   I should not see "some bla-bla"
+    And   I should see /great/i
+    And   I should not see /bla-bla/
+
+    When  I go to the home page
+    Then  I should see 2 elements kind of table's header
+    And   I should see 6 elements kind of "table tr"
+    And   I should not see elements kind of paragraphs
+    And   I should not see elements kind of "div.some_class"
+
+    When  I go to the other page
+    Then  I should be redirected to the congratulations page
+    And   I should see "You was really redirected!"

data/features/setup/rack_test.rb

@@ -0,0 +1,5 @@
+Capybara.current_driver = :rack_test
+
+After do
+  Capybara.reset_sessions!
+end

data/features/setup/selenium.rb

@@ -0,0 +1,12 @@
+Capybara.configure do |config|
+  config.app_host = 'http://localhost:9887'
+  config.server_port = 9887
+end
+
+Before do
+  Capybara.current_driver = :selenium
+end
+
+After do
+  Capybara.reset_sessions!
+end

data/features/step_definitions/web_steps.rb

@@ -0,0 +1 @@
+require 'cucumber/websteps'

data/features/support/env.rb

@@ -0,0 +1,18 @@
+ENV['RACK_ENV']='test'
+$LOAD_PATH.insert(0,File.dirname(__FILE__))
+require 'test_app'
+
+require 'capybara'
+require 'capybara/dsl'
+World(Capybara)
+
+Capybara.app = TestApp
+Capybara.default_selector = :css
+
+begin
+  require 'minitest/unit'
+  World(MiniTest::Assertions)
+rescue LoadError
+  require 'test/unit'
+  World(Test::Unit::Assertions)
+end

data/features/support/paths.rb

@@ -0,0 +1,39 @@
+module NavigationHelpers
+  # Maps a name to a path. Used by the
+  #
+  #   When /^I go to (.+)$/ do |page_name|
+  #
+  # step definition in web_steps.rb
+  #
+  def path_to(page_name)
+    case page_name
+
+    when /^the home\s?page$/
+      '/'
+    when /^the congratulations page$/
+      '/congratulations'
+    when /^the other page$/
+      '/other/page'
+    when /^the form page$/
+      '/form/page'
+
+    # Add more mappings here.
+    # Here is an example that pulls values out of the Regexp:
+    #
+    #   when /^(.*)'s profile page$/i
+    #     user_profile_path(User.find_by_login($1))
+
+    else
+      begin
+        page_name =~ /^the (.*) page$/
+        path_components = $1.split(/\s+/)
+        self.send(path_components.push('path').join('_').to_sym)
+      rescue NoMethodError, ArgumentError
+        raise "Can't find mapping from \"#{page_name}\" to a path.\n" +
+          "Now, go and add a mapping in #{__FILE__}"
+      end
+    end
+  end
+end
+
+World(NavigationHelpers)

data/features/support/selectors.rb

@@ -0,0 +1,43 @@
+module HtmlSelectorsHelpers
+  # Maps a name to a selector. Used primarily by the
+  #
+  #   When /^(.+) within (.+)$/ do |step, scope|
+  #
+  # step definitions in web_steps.rb
+  #
+  def selector_for(locator)
+    case locator
+
+    when "the page"
+      "html > body"
+    when "table's header"
+      "table > tr th"
+    when /^paragraphs?$/
+      "p"
+
+    # Add more mappings here.
+    # Here is an example that pulls values out of the Regexp:
+    #
+    #  when /^the (notice|error|info) flash$/
+    #    ".flash.#{$1}"
+
+    # You can also return an array to use a different selector
+    # type, like:
+    #
+    #  when /the header/
+    #    [:xpath, "//header"]
+
+    # This allows you to provide a quoted selector as the scope
+    # for "within" steps as was previously the default for the
+    # web steps:
+    when /^"(.+)"$/
+      $1
+
+    else
+      raise "Can't find mapping from \"#{locator}\" to a selector.\n" +
+        "Now, go and add a mapping in #{__FILE__}"
+    end
+  end
+end
+
+World(HtmlSelectorsHelpers)

data/features/support/test_app.rb

@@ -0,0 +1,29 @@
+require 'sinatra/base'
+class TestApp < Sinatra::Base
+
+  set :views, File.dirname(__FILE__) + '/test_app_views'
+
+  get '/' do
+    erb :home
+  end
+
+  get '/congratulations' do
+    @redirected = params.has_key?("redirected")
+    erb :congratulations
+  end
+
+  get '/other/page' do
+    redirect to('/congratulations?redirected=true')
+  end
+
+  get '/form/page' do
+    erb :form
+  end
+
+  get '/form/submit' do
+    erb :form_result
+  end
+
+end
+
+TestApp.run! unless defined?(Cucumber)

data/features/support/test_app_views/congratulations.erb

@@ -0,0 +1,4 @@
+<% if @redirected %>
+  <h1>You was really redirected!</h1>
+<% end %>
+<h1>Great, you can click links!</h1>

data/features/support/test_app_views/form.erb

@@ -0,0 +1,69 @@
+<form action="/form/submit" method="get" accept-charset="utf-8">
+
+  <p>
+  <label for="text_input">Name:</label>
+  <input type="text" name="name" id="text_input"/>
+  </p>
+
+  <p>
+  <label for="text_area">Describe yourself:</label>
+  <textarea name="description" id="text_area"></textarea>
+  </p>
+
+  <p>
+  <label for="select_1">Sex:</label>
+  <select id="select_1" name="sex">
+    <option value=""></option>
+    <option value="Female">Female</option>
+    <option value="Male">Male</option>
+  </select>
+  </p>
+
+  <p>
+  <label for="select_2">Your favorite colors:</label>
+  <select id="select_2" name="colors[]"  multiple="multiple">
+    <option value="black">black</option>
+    <option value="white">white</option>
+    <option value="red">red</option>
+    <option value="green">green</option>
+    <option value="yellow">yellow</option>
+    <option value="blue">blue</option>
+  </select>
+  </p>
+
+  <p>
+  <input type="checkbox" name="do_not_touch" id="unchecked_checkbox" value="1"/>
+  <label for="unchecked_checkbox">Do not touch me</label>
+  </p>
+
+  <p>
+  <input type="checkbox" name="agrement" id="checkbox_1" value="1"/>
+  <label for="checkbox_1">Accept user agrement</label>
+  </p>
+
+  <p>
+  <input type="checkbox" name="spam" id="checkbox_2" value="1" checked="checked"/>
+  <label for="checkbox_2">Send me letters</label>
+  </p>
+
+  <p>
+  <label for="radio_true">
+    <input id="radio_true" name="radio" type="radio" value="radio 1" />radio 1
+  </label>
+  </p>
+
+  <p>
+  <label for="radio_false">
+    <input id="radio_false" name="radio" type="radio" value="radio 2" />radio 2
+  </label>
+  </p>
+
+  <p>
+  <label for="file">Avatar:</label>
+  <input type="file" name="file" id="file"/>
+  </p>
+
+  <p>
+  <input type="submit" value="Submit"/>
+  </p>
+</form>

data/features/support/test_app_views/form_result.erb

@@ -0,0 +1,29 @@
+<h1>Form submited!</h1>
+
+<p>
+<strong>Name:</strong> <%= params[:name] %>
+</p>
+
+<p>
+<strong>About me:</strong> <%= params[:description] %>
+</p>
+
+<p>
+<strong>Sex:</strong> <%= params[:sex] %>
+</p>
+
+<p>
+<strong>Accepted user agrement:</strong> <%= params[:agrement]=="1" ? 'Yes' : 'No' %>
+</p>
+
+<p>
+<strong>Like spam?</strong> <%= params[:spam]=="1" ? 'Yes' : 'No' %>
+</p>
+
+<p>
+<strong>radio:</strong> <%= params[:radio] %>
+</p>
+
+<p>
+<strong>Your favorite colors:</strong> <%= (params[:colors]||[]).join(',') %>
+</p>

data/features/support/test_app_views/home.erb

@@ -0,0 +1,33 @@
+<a href="/congratulations">some link</a>
+
+<table border="1">
+  <tr>
+    <th>header 1</th>
+    <th>header 2</th>
+  </tr>
+
+  <tr>
+    <td>bla</td>
+    <td>bla</td>
+  </tr>
+
+  <tr>
+    <td>bla</td>
+    <td>bla</td>
+  </tr>
+
+  <tr>
+    <td>bla</td>
+    <td>bla</td>
+  </tr>
+
+  <tr>
+    <td>bla</td>
+    <td>bla</td>
+  </tr>
+
+  <tr>
+    <td>bla</td>
+    <td>bla</td>
+  </tr>
+</table>

data/features/support/test_app_views/layout.erb

@@ -0,0 +1,9 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>test app</title>
+</head>
+<body>
+  <%= yield %>
+</body>
+</html>

data/lib/_unsorted.rb

@@ -0,0 +1,38 @@
+# TL;DR: YOU SHOULD DELETE THIS FILE
+#
+# This file was generated by Cucumber-Rails and is only here to get you a head start
+# These step definitions are thin wrappers around the Capybara/Webrat API that lets you
+# visit pages, interact with widgets and make assertions about page content.
+#
+# If you use these step definitions as basis for your features you will quickly end up
+# with features that are:
+#
+# * Hard to maintain
+# * Verbose to read
+#
+# A much better approach is to write your own higher level step definitions, following
+# the advice in the following blog posts:
+#
+# * http://benmabey.com/2008/05/19/imperative-vs-declarative-scenarios-in-user-stories.html
+# * http://dannorth.net/2011/01/31/whose-domain-is-it-anyway/
+# * http://elabs.se/blog/15-you-re-cuking-it-wrong
+#
+
+
+#When /^(?:|I )fill in "([^"]*)" for "([^"]*)"$/ do |value, field|
+  #fill_in(field, :with => value)
+#end
+
+
+Then /^(?:|I )should have the following query string:$/ do |expected_pairs|
+  query = URI.parse(current_url).query
+  actual_params = query ? CGI.parse(query) : {}
+  expected_params = {}
+  expected_pairs.rows_hash.each_pair{|k,v| expected_params[k] = v.split(',')}
+
+  if actual_params.respond_to? :should
+    actual_params.should == expected_params
+  else
+    assert_equal expected_params, actual_params
+  end
+end

data/lib/cucumber/websteps.rb

@@ -0,0 +1,23 @@
+require 'uri'
+require 'cgi'
+
+unless defined?(SUPPORT_DIR)
+  features_dir = caller.select { |path| path =~ /features/ }.first.split('/')
+  2.times { features_dir.pop }
+  SUPPORT_DIR = File.join(features_dir,'support')
+end
+
+require File.join(SUPPORT_DIR,'paths.rb')
+require File.join(SUPPORT_DIR,'selectors.rb')
+
+module WithinHelpers
+  def with_scope(locator)
+    locator ? within(*selector_for(locator)) { yield } : yield
+  end
+end
+World(WithinHelpers)
+
+require 'cucumber/websteps/step_scoper'
+require 'cucumber/websteps/browsing_steps'
+require 'cucumber/websteps/form_steps'
+require 'cucumber/websteps/debug_steps'

data/lib/cucumber/websteps/browsing_steps.rb

@@ -0,0 +1,82 @@
+Given /^(?:|I )am on (.+)$/ do |page_name|
+  visit path_to(page_name)
+end
+
+When /^(?:|I )go to (.+)$/ do |page_name|
+  visit path_to(page_name)
+end
+
+When /^(?:|I )follow "([^"]*)"$/ do |link|
+  click_link(link)
+end
+
+Then /^I should be redirected to (.+)$/ do |page|
+  puts 'TODO: make this done'
+  Then "I should be on #{page}"
+end
+
+Then /^(?:|I )should see "([^"]*)"$/ do |text|
+  if page.respond_to? :should
+    page.should have_content(text)
+  else
+    assert page.has_content?(text)
+  end
+end
+
+Then /^(?:|I )should not see "([^"]*)"$/ do |text|
+  if page.respond_to? :should
+    page.should have_no_content(text)
+  else
+    assert page.has_no_content?(text)
+  end
+end
+
+Then /^(?:|I )should see \/([^\/]*)\/([imxo])?$/ do |regexp,flags|
+  regexp_opts = [regexp,flags].compact
+  regexp = Regexp.new(*regexp_opts)
+
+  if page.respond_to? :should
+    page.should have_xpath('//*', :text => regexp)
+  else
+    assert page.has_xpath?('//*', :text => regexp)
+  end
+end
+
+Then /^(?:|I )should not see \/([^\/]*)\/([imxo])?$/ do |regexp,flags|
+  regexp_opts = [regexp,flags].compact
+  regexp = Regexp.new(*regexp_opts)
+
+  if page.respond_to? :should
+    page.should have_no_xpath('//*', :text => regexp)
+  else
+    assert page.has_no_xpath?('//*', :text => regexp)
+  end
+end
+
+Then /^(?:|I )should be on (.+)$/ do |page_name|
+  current_path = URI.parse(current_url).path
+  if current_path.respond_to? :should
+    current_path.should == path_to(page_name)
+  else
+    assert_equal path_to(page_name), current_path
+  end
+end
+
+Then /^I should see (\d+) elements? kind of (.+)$/ do |count, locator|
+  actual_count = all(selector_for(locator)).count
+  count = count.to_i
+
+  if actual_count.respond_to?(:should)
+    actual_count.should eq(count)
+  else
+    assert_equal count, actual_count
+  end
+end
+
+Then /^I should not see elements? kind of (.+)$/ do |locator|
+  if defined?(RSpec)
+    page.should_not have_css(selector_for(locator))
+  else
+    assert page.has_no_css?(selector_for(locator))
+  end
+end

data/lib/cucumber/websteps/debug_steps.rb

@@ -0,0 +1,3 @@
+Then /^show me the page$/ do
+  save_and_open_page
+end

data/lib/cucumber/websteps/form_steps.rb

@@ -0,0 +1,210 @@
+# Use this to fill in an entire form with data from a table. Example:
+#
+#   When I fill in the following:
+#     | Account Number                  | 5002       |
+#     | Expiry date                     | 2009-11-01 |
+#     | Note                            | Nice guy   |
+#     | Wants Email?                    |            |
+#     | Sex                  (select)   | Male       |
+#     | Accept user agrement (checkbox) | check      |
+#     | Send me letters      (checkbox) | uncheck    |
+#     | radio 1              (radio)    | choose     |
+#     | Avatar               (file)     | avatar.png |
+#
+When /^(?:|I )fill in the following:$/ do |fields|
+
+  select_tag    = /^(.+\S+)\s*(?:\(select\))$/
+  check_box_tag = /^(.+\S+)\s*(?:\(checkbox\))$/
+  radio_button  = /^(.+\S+)\s*(?:\(radio\))$/
+  file_field    = /^(.+\S+)\s*(?:\(file\))$/
+
+  fields.rows_hash.each do |name, value|
+    case name
+    when select_tag
+      When %(I select "#{value}" from "#{$1}")
+    when check_box_tag
+      case value
+      when 'check'
+	When %(I check "#{$1}")
+      when 'uncheck'
+	When %(I uncheck "#{$1}")
+      else
+	raise 'checkbox values: check|uncheck!'
+      end
+    when radio_button
+      When %{I choose "#{$1}"}
+    when file_field
+      When %{I attach the file "#{value}" to "#{$1}"}
+    else
+      When %{I fill in "#{name}" with "#{value}"}
+    end
+  end
+end
+
+When /^(?:|I )fill in "([^"]*)" with "([^"]*)"$/ do |field, value|
+  fill_in(field, :with => value)
+end
+
+When /^(?:|I )fill in "([^"]*)" with:$/ do |field, value|
+  fill_in(field, :with => value)
+end
+
+When /^(?:|I )select "([^"]*)" from "([^"]*)"$/ do |value, field|
+  select(value, :from => field)
+end
+
+When /^(?:|I )check "([^"]*)"$/ do |field|
+  check(field)
+end
+
+When /^(?:|I )uncheck "([^"]*)"$/ do |field|
+  uncheck(field)
+end
+
+When /^(?:|I )choose "([^"]*)"$/ do |field|
+  choose(field)
+end
+
+When /^(?:|I )attach the file "([^"]*)" to "([^"]*)"$/ do |file, field|
+  path = File.expand_path(File.join(SUPPORT_DIR,"attachments/#{file}"))
+  raise RuntimeError, "file '#{path}' does not exists" unless File.exists?(path)
+
+  attach_file(field, path)
+end
+
+Then /^the "([^"]*)" field(?: within (.*))? should contain "([^"]*)"$/ do |field, parent, value|
+  with_scope(parent) do
+    field = find_field(field)
+    field_value = (field.tag_name == 'textarea') ? field.text : field.value
+    if field_value.respond_to? :should
+      field_value.should =~ /#{value}/
+    else
+      assert_match(/#{value}/, field_value)
+    end
+  end
+end
+
+Then /^the "([^"]*)" field(?: within (.*))? should not contain "([^"]*)"$/ do |field, parent, value|
+  with_scope(parent) do
+    field = find_field(field)
+    field_value = (field.tag_name == 'textarea') ? field.text : field.value
+    if field_value.respond_to? :should_not
+      field_value.should_not =~ /#{value}/
+    else
+      assert_no_match(/#{value}/, field_value)
+    end
+  end
+end
+
+Then /^the "([^"]*)" checkbox(?: within (.*))? should be checked$/ do |label, parent|
+  with_scope(parent) do
+    field_checked = find_field(label)['checked']
+    if field_checked.respond_to? :should
+      field_checked.should be_true
+    else
+      assert field_checked
+    end
+  end
+end
+
+Then /^the "([^"]*)" checkbox(?: within (.*))? should not be checked$/ do |label, parent|
+  with_scope(parent) do
+    field_checked = find_field(label)['checked']
+    if field_checked.respond_to? :should
+      field_checked.should be_false
+    else
+      assert !field_checked
+    end
+  end
+end
+
+When /^(?:|I )press "([^"]*)"$/ do |button|
+  click_button(button)
+end
+
+Then /^the select "([^"]*)" should have following options:$/ do |field, options|
+  options = options.transpose.raw
+  if options.size > 1
+    raise 'table should have only one column in this step!'
+  else
+    options = options.first
+  end
+
+  actual_options = find_field(field).all('option').map { |option| option.text }
+
+  if options.respond_to?(:should)
+    options.should eq(actual_options)
+  else
+    assert_equal options, actual_options
+  end
+end
+
+When /^(?:I|i) select following values from "([^"]*)":$/ do |field, values|
+  values = values.transpose.raw
+  if values.size > 1
+    raise 'table should have only one column in this step!'
+  else
+    values = values.first
+  end
+
+  values.each do |value|
+    select(value, :from => field)
+  end
+end
+
+When /^(?:I|i) unselect following values from "([^"]*)":$/ do |field, values|
+  values = values.transpose.raw
+  if values.size > 1
+    raise 'table should have only one column in this step!'
+  else
+    values = values.first
+  end
+
+  values.each do |value|
+    unselect(value, :from => field)
+  end
+end
+
+Then /^the following values should be selected in "([^"]*)":$/ do |select_box, values|
+  values = values.transpose.raw
+  if values.size > 1
+    raise 'table should have only one column in this step!'
+  else
+    values = values.first
+  end
+
+  select_box=find_field(select_box)
+  unless select_box['multiple']
+    raise "this is not multiple select box!"
+  else
+    values.each do |value|
+      if select_box.respond_to?(:should)
+	select_box.value.should include(value)
+      else
+	assert select_box.value.include?(value)
+      end
+    end
+  end
+end
+
+Then /^the following values should not be selected in "([^"]*)":$/ do |select_box, values|
+  values = values.transpose.raw
+  if values.size > 1
+    raise 'table should have only one column in this step!'
+  else
+    values = values.first
+  end
+
+  select_box=find_field(select_box)
+  unless select_box['multiple']
+    raise "this is not multiple select box!"
+  else
+    values.each do |value|
+      if select_box.respond_to?(:should)
+	select_box.value.should_not include(value)
+      else
+	assert !select_box.value.include?(value)
+      end
+    end
+  end
+end

data/lib/cucumber/websteps/step_scoper.rb

@@ -0,0 +1,9 @@
+# Single-line step scoper
+When /^(.*) within ([^:]+)$/ do |step, parent|
+  with_scope(parent) { When step }
+end
+
+# Multi-line step scoper
+When /^(.*) within ([^:]+):$/ do |step, parent, table_or_string|
+  with_scope(parent) { When "#{step}:", table_or_string }
+end

data/lib/cucumber/websteps/version.rb

@@ -0,0 +1,5 @@
+module Cucumber
+  module Websteps
+    VERSION = "0.9.0"
+  end
+end

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification 
+name: cucumber-websteps
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.9.0
+platform: ruby
+authors: 
+- kucaahbe
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-26 00:00:00 +03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: capybara
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: launchy
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id004
+description: Here cucumber web steps collected during BDD practice in different projects, all steps are tested to work with :rack_test and :selenium drivers. Test framework agnostic (you can use them with rspec-1, rspec-2, test/unit and minitest).
+email: 
+- kucaahbe@ukr.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .travis.yml
+- .yardopts
+- Gemfile
+- README.md
+- Rakefile
+- cucumber-websteps.gemspec
+- cucumber.yml
+- features/CHANGELOG.md
+- features/README.md
+- features/defined_steps/forms_steps.feature
+- features/defined_steps/simple_steps.feature
+- features/setup/rack_test.rb
+- features/setup/selenium.rb
+- features/step_definitions/web_steps.rb
+- features/support/attachments/avatar.png
+- features/support/env.rb
+- features/support/paths.rb
+- features/support/selectors.rb
+- features/support/test_app.rb
+- features/support/test_app_views/congratulations.erb
+- features/support/test_app_views/form.erb
+- features/support/test_app_views/form_result.erb
+- features/support/test_app_views/home.erb
+- features/support/test_app_views/layout.erb
+- lib/_unsorted.rb
+- lib/cucumber/websteps.rb
+- lib/cucumber/websteps/browsing_steps.rb
+- lib/cucumber/websteps/debug_steps.rb
+- lib/cucumber/websteps/form_steps.rb
+- lib/cucumber/websteps/step_scoper.rb
+- lib/cucumber/websteps/version.rb
+- steps.jpg
+has_rdoc: true
+homepage: http://relishapp.com/kucaahbe/cucumber-websteps
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: cucumber-websteps
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Capybara powered common cucumber web steps for any web application (blackjack and hookers included).
+test_files: []
+