cucumber-rails 0.1.1.rc2 → 0.1.1.rc3

data/History.txt

@@ -0,0 +1,9 @@
+== In Git
+
+=== New features
+* New #tableish method to extract table-like data from a HTML page. Pure Nokogiri/CSS3/XPath. (Aslak Hellesøy)
+
+=== Bugfixes
+* Webrat step "Then I should be on" should use request_uri instead of path for missing query string parameters (ZhangJinzhu)
+* Added MIME type parameter to attach file step definition (Felix Flores)
+* Added check when including ActiveSupport::Testing::SetupAndTeardown for older Rails versions (Jeremy Durham)

data/Rakefile

@@ -6,10 +6,10 @@ begin
     gemspec.description = "Cucumber Generators and Runtime for Rails"
     gemspec.email = "cukes@googlegroups.com"
     gemspec.homepage = "http://cukes.info"
-    gemspec.authors = ["Dennis Blöte", "Aslak Hellesøy"]
+    gemspec.authors = ["Dennis Blöte", "Aslak Hellesøy", "Rob Holland"]
     gemspec.homepage = "http://github.com/dbloete/cucumber-rails"
 
-    gemspec.add_dependency 'cucumber', '0.4.3'
+    gemspec.add_dependency 'cucumber', '>= 0.4.5.rc1'
   end
   Jeweler::GemcutterTasks.new
 rescue LoadError

data/VERSION

@@ -1 +1 @@
-0.1.1.rc2
+0.1.1.rc3

data/cucumber-rails.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{cucumber-rails}
-  s.version = "0.1.1.rc2"
+  s.version = "0.1.1.rc3"
 
   s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Dennis Bl\303\266te", "Aslak Helles\303\270y"]
-  s.date = %q{2009-11-11}
+  s.authors = ["Dennis Bl\303\266te", "Aslak Helles\303\270y", "Rob Holland"]
+  s.date = %q{2009-12-07}
   s.description = %q{Cucumber Generators and Runtime for Rails}
   s.email = %q{cukes@googlegroups.com}
   s.extra_rdoc_files = [
@@ -17,12 +17,14 @@ Gem::Specification.new do |s|
   ]
   s.files = [
     ".gitignore",
+     "History.txt",
      "README.rdoc",
      "Rakefile",
      "VERSION",
      "cucumber-rails.gemspec",
      "generators/cucumber/USAGE",
      "generators/cucumber/cucumber_generator.rb",
+     "generators/cucumber/templates/capybara_env.rb",
      "generators/cucumber/templates/cucumber",
      "generators/cucumber/templates/cucumber.rake",
      "generators/cucumber/templates/cucumber_environment.rb",
@@ -30,36 +32,47 @@ Gem::Specification.new do |s|
      "generators/cucumber/templates/paths.rb",
      "generators/cucumber/templates/spork_env.rb",
      "generators/cucumber/templates/version_check.rb",
-     "generators/cucumber/templates/webrat_steps/webrat_steps_de.rb",
-     "generators/cucumber/templates/webrat_steps/webrat_steps_en.rb",
+     "generators/cucumber/templates/web_steps/capybara_steps.rb",
+     "generators/cucumber/templates/web_steps/web_steps_de.rb",
+     "generators/cucumber/templates/web_steps/web_steps_no.rb",
+     "generators/cucumber/templates/web_steps/web_steps_pt-BR.rb",
+     "generators/cucumber/templates/web_steps/webrat_steps.rb",
+     "generators/cucumber/templates/webrat_env.rb",
      "generators/feature/USAGE",
      "generators/feature/feature_generator.rb",
      "generators/feature/templates/feature.erb",
      "generators/feature/templates/steps.erb",
-     "lib/cucumber-rails.rb",
      "lib/cucumber/rails/action_controller.rb",
      "lib/cucumber/rails/active_record.rb",
      "lib/cucumber/rails/rspec.rb",
      "lib/cucumber/rails/test_unit.rb",
-     "lib/cucumber/rails/world.rb"
+     "lib/cucumber/rails/world.rb",
+     "lib/cucumber/web/tableish.rb",
+     "spec/cucumber/web/tableish_spec.rb",
+     "spec/spec_helper.rb",
+     "tasks/rspec.rake"
   ]
   s.homepage = %q{http://github.com/dbloete/cucumber-rails}
   s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
   s.rubygems_version = %q{1.3.5}
   s.summary = %q{Cucumber Generators and Runtime for Rails}
+  s.test_files = [
+    "spec/cucumber/web/tableish_spec.rb",
+     "spec/spec_helper.rb"
+  ]
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<cucumber>, ["= 0.4.3"])
+      s.add_runtime_dependency(%q<cucumber>, [">= 0.4.5.rc1"])
     else
-      s.add_dependency(%q<cucumber>, ["= 0.4.3"])
+      s.add_dependency(%q<cucumber>, [">= 0.4.5.rc1"])
     end
   else
-    s.add_dependency(%q<cucumber>, ["= 0.4.3"])
+    s.add_dependency(%q<cucumber>, [">= 0.4.5.rc1"])
   end
 end
 

data/generators/cucumber/cucumber_generator.rb

@@ -6,6 +6,7 @@ class CucumberGenerator < Rails::Generator::Base
   DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'],
                               Config::CONFIG['ruby_install_name'])
 
+  attr_accessor :driver
   attr_accessor :framework
   attr_reader :language
   
@@ -18,8 +19,11 @@ class CucumberGenerator < Rails::Generator::Base
     record do |m|
       m.directory 'features/step_definitions'
       
-      m.template "webrat_steps/webrat_steps_#{language}.rb", 'features/step_definitions/webrat_steps.rb'
-      m.template'cucumber_environment.rb', 'config/environments/cucumber.rb',
+      m.template "web_steps/#{driver}_steps.rb", 'features/step_definitions/web_steps.rb'
+      if language != 'en'
+        m.template "web_steps/web_steps_#{language}.rb", "features/step_definitions/web_steps_#{language}.rb"
+      end
+      m.template 'cucumber_environment.rb', 'config/environments/cucumber.rb',
         :assigns => { :cucumber_version => ::Cucumber::VERSION }
 
       m.gsub_file 'config/database.yml', /test:.*\n/, "test: &TEST\n"
@@ -32,6 +36,7 @@ class CucumberGenerator < Rails::Generator::Base
         m.template'spork_env.rb', 'features/support/env.rb'
       else
         m.template 'env.rb', 'features/support/env.rb'
+        m.template "#{driver}_env.rb", "features/support/#{driver}.rb"
       end
       m.template 'paths.rb', 'features/support/paths.rb'
       m.template 'version_check.rb', 'features/support/version_check.rb'
@@ -49,35 +54,49 @@ class CucumberGenerator < Rails::Generator::Base
     options[:framework] ||= detect_default_framework!
   end
 
+  def driver
+    options[:driver] ||= detect_current_driver! || detect_default_driver!
+  end
+
   def spork?
     options[:spork]
   end
 
-protected
+private
 
-  def detect_default_framework!
+  def first_loadable(libraries)
     require 'rubygems'
-    rspec! || testunit!
-    raise "I don't know what test framework you want. Use --rspec or --testunit, or gem install rspec or test-unit." unless @default_framework
-    @default_framework
+    libraries.each do |library|
+      begin
+        require library[0]
+        return library[1]
+      rescue LoadError => e
+        puts e.inspect
+      end
+    end
+    return nil
   end
 
-  def rspec!
-    begin
-      require 'spec'
-      @default_framework = :rspec
-    rescue LoadError
-      false
+  def detect_current_driver!
+    drivers = [['capybara', :capybara], ['webrat', :webrat ]]
+    drivers.each do |driver|
+      @current_driver = driver[1] if File.exists?("features/support/#{driver[0]}.rb")
+      return @current_driver if @current_driver
     end
+    return nil
   end
 
-  def testunit!
-    begin
-      require 'test/unit'
-      @default_framework = :testunit
-    rescue LoadError
-      false
-    end
+  def detect_default_driver!
+    drivers = [['capybara', :capybara], ['webrat', :webrat ]]
+    @default_driver = first_loadable(drivers)
+    raise "I don't know which driver you want. Use --capybara or --webrat, or gem install capybara or webrat." unless @default_driver
+    @default_driver
+  end
+
+  def detect_default_framework!
+    @default_framework = first_loadable([['spec', :rspec], ['test/unit', :testunit]])
+    raise "I don't know what test framework you want. Use --rspec or --testunit, or gem install rspec or test-unit." unless @default_framework
+    @default_framework
   end
 
   def banner
@@ -88,6 +107,22 @@ protected
     require 'cucumber/formatter/ansicolor'
     extend Cucumber::Formatter::ANSIColor
 
+    if @default_driver
+      puts <<-WARNING
+
+#{yellow_cukes(15)} 
+
+              #{yellow_cukes(1)}   D R I V E R   A L E R T    #{yellow_cukes(1)}
+
+You didn't explicitly generate with --capybara or --webrat, so I looked at
+your gems and saw that you had #{green(@default_driver.to_s)} installed, so I went with that. 
+If you want something else, be specific about it. Otherwise, relax.
+
+#{yellow_cukes(15)} 
+
+WARNING
+    end
+
     if @default_framework
       puts <<-WARNING
 
@@ -108,6 +143,14 @@ WARNING
   def add_options!(opt)
     opt.separator ''
     opt.separator 'Options:'
+    opt.on('--webrat', 'Setup cucumber for use with webrat') do |value|
+      options[:driver] = :webrat
+    end
+
+    opt.on('--capybara', 'Setup cucumber for use with capybara') do |value|
+      options[:driver] = :capybara
+    end
+
     opt.on('--rspec', "Setup cucumber for use with RSpec") do |value|
       options[:framework] = :rspec
     end

data/generators/cucumber/templates/capybara_env.rb

@@ -0,0 +1,24 @@
+require 'capybara/rails'
+require 'capybara/cucumber'
+require 'cucumber/web/tableish'
+World(Cucumber::Tableish)
+
+# If you set this to true, each scenario will run in a database transaction.
+# You can still turn off transactions on a per-scenario basis, simply tagging
+# a feature or scenario with the @no-txn tag. 
+#
+# If you set this to false, transactions will be off for all scenarios,
+# regardless of whether you use @no-txn or not.
+#
+# Beware that turning transactions off will leave data in your database after
+# each scenario, which can lead to hard-to-debug failures in subsequent
+# scenarios. If you do this, we recommend you create a Before block that will
+# explicitly put your database in a known state.
+#
+Cucumber::Rails::World.use_transactional_fixtures = true
+
+# Capybara defaults to XPATH selectors rather than Webrat's default of CSS. In
+# order to ease the transition to Capybara we set the default here. If you'd
+# prefer to use XPATH just remove this line and adjust any selectors in your
+# steps to use the XPATH syntax.
+Capybara.default_selector = :css

data/generators/cucumber/templates/cucumber_environment.rb

@@ -2,7 +2,10 @@
 # Edit at your own peril - it's recommended to regenerate this file
 # in the future when you upgrade to a newer version of Cucumber.
 
-config.cache_classes = true # This must be true for Cucumber to operate correctly!
+# IMPORTANT: Setting config.cache_classes to false is known to
+# break Cucumber's use_transactional_fixtures method.
+# For more information see https://rspec.lighthouseapp.com/projects/16211/tickets/165
+config.cache_classes = true
 
 # Log error messages when you accidentally call methods on nil.
 config.whiny_nils = true
@@ -20,7 +23,11 @@ config.action_controller.allow_forgery_protection    = false
 config.action_mailer.delivery_method = :test
 
 config.gem 'cucumber',    :lib => false, :version => '>=<%= cucumber_version %>' unless File.directory?(File.join(Rails.root, 'vendor/plugins/cucumber'))
+<% if driver == :capybara -%>
+config.gem 'capybara',    :lib => false, :version => '>=0.1.3' unless File.directory?(File.join(Rails.root, 'vendor/plugins/capybara'))
+<% else -%>
 config.gem 'webrat',      :lib => false, :version => '>=0.5.3' unless File.directory?(File.join(Rails.root, 'vendor/plugins/webrat'))
+<% end -%>
 <% if framework == :rspec -%>
 config.gem 'rspec',       :lib => false, :version => '>=1.2.9' unless File.directory?(File.join(Rails.root, 'vendor/plugins/rspec'))
 config.gem 'rspec-rails', :lib => false, :version => '>=1.2.9' unless File.directory?(File.join(Rails.root, 'vendor/plugins/rspec-rails'))

data/generators/cucumber/templates/env.rb

@@ -8,19 +8,6 @@ ENV["RAILS_ENV"] ||= "cucumber"
 require File.expand_path(File.dirname(__FILE__) + '/../../config/environment')
 require 'cucumber/rails/world'
 
-# If you set this to true, each scenario will run in a database transaction.
-# You can still turn off transactions on a per-scenario basis, simply tagging 
-# a feature or scenario with the @no-txn tag. 
-#
-# If you set this to false, transactions will be off for all scenarios,
-# regardless of whether you use @no-txn or not.
-#
-# Beware that turning transactions off will leave data in your database 
-# after each scenario, which can lead to hard-to-debug failures in 
-# subsequent scenarios. If you do this, we recommend you create a Before
-# block that will explicitly put your database in a known state.
-Cucumber::Rails::World.use_transactional_fixtures = true
-
 # If you set this to false, any error raised from within your app will bubble 
 # up to your step definition and out to cucumber unless you catch it somewhere
 # on the way. You can make Rails rescue errors and render error pages on a
@@ -35,15 +22,6 @@ ActionController::Base.allow_rescue = false
 require 'cucumber'
 # Comment out the next line if you don't want Cucumber Unicode support
 require 'cucumber/formatter/unicode'
-require 'cucumber/webrat/element_locator' # Lets you do table.diff!(element_at('#my_table_or_dl_or_ul_or_ol').to_table)
 <% if framework == :rspec -%>
 require 'cucumber/rails/rspec'
 <% end -%>
-
-require 'webrat'
-require 'webrat/core/matchers' 
-Webrat.configure do |config|
-  config.mode = :rails
-  config.open_error_files = false # Set to true if you want error pages to pop up in the browser
-end
-

data/generators/cucumber/templates/web_steps/capybara_steps.rb

@@ -0,0 +1,247 @@
+# IMPORTANT: This file was generated.
+# Edit at your own peril - it's recommended to regenerate this file
+# in the future when you upgrade to a newer version of Cucumber.
+# Consider adding your own code to a new file instead of editing this one.
+
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "support", "paths"))
+
+module WithinHelpers
+  def with_scope(locator)
+    within(locator || 'html') { yield }
+  end
+end
+World(WithinHelpers)
+
+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 )press "([^\"]*)"(?: within "([^\"]*)")?$/ do |button, selector|
+  with_scope(selector) do
+    click_button(button)
+  end
+end
+
+When /^(?:|I )follow "([^\"]*)"(?: within "([^\"]*)")?$/ do |link, selector|
+  with_scope(selector) do
+    click_link(link)
+  end
+end
+
+When /^(?:|I )fill in "([^\"]*)" with "([^\"]*)"(?: within "([^\"]*)")?$/ do |field, value, selector|
+  with_scope(selector) do
+    fill_in(field, :with => value)
+  end
+end
+
+When /^(?:|I )fill in "([^\"]*)" for "([^\"]*)"(?: within "([^\"]*)")?$/ do |value, field, selector|
+  with_scope(selector) do
+    fill_in(field, :with => value)
+  end
+end
+
+# 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?   |            |
+#
+# TODO: Add support for checkbox, select og option
+# based on naming conventions.
+#
+When /^(?:|I )fill in the following(?: within "([^\"]*)"|)?:$/ do |fields, selector|
+  with_scope(selector) do
+    fields.rows_hash.each do |name, value|
+      When %{I fill in "#{name}" with "#{value}"}
+    end
+  end
+end
+
+When /^(?:|I )select "([^\"]*)" from "([^\"]*)"(?: within "([^\"]*)")?$/ do |value, field, selector|
+  with_scope(selector) do
+    select(value, :from => field)
+  end
+end
+
+# Use this step in conjunction with Rail's datetime_select helper. For example:
+# When I select "December 25, 2008 10:00" as the date and time
+When /^(?:|I )select "([^\"]*)" as the date and time(?: within "([^\"]*)")?$/ do |time, selector|
+  with_scope(selector) do
+    select_datetime(time)
+  end
+end
+
+# Use this step when using multiple datetime_select helpers on a page or
+# you want to specify which datetime to select. Given the following view:
+#   <%%= f.label :preferred %><br />
+#   <%%= f.datetime_select :preferred %>
+#   <%%= f.label :alternative %><br />
+#   <%%= f.datetime_select :alternative %>
+# The following steps would fill out the form:
+# When I select "November 23, 2004 11:20" as the "Preferred" date and time
+# And I select "November 25, 2004 10:30" as the "Alternative" date and time
+When /^(?:|I )select "([^\"]*)" as the "([^\"]*)" date and time(?: within "([^\"]*)")?$/ do |datetime, datetime_label, selector|
+  with_scope(selector) do
+    select_datetime(datetime, :from => datetime_label)
+  end
+end
+
+# Use this step in conjunction with Rail's time_select helper. For example:
+# When I select "2:20PM" as the time
+# Note: Rail's default time helper provides 24-hour time-- not 12 hour time. Webrat
+# will convert the 2:20PM to 14:20 and then select it.
+When /^(?:|I )select "([^\"]*)" as the time(?: within "([^\"]*)")?$/ do |time, selector|
+  with_scope(selector) do
+    select_time(time)
+  end
+end
+
+# Use this step when using multiple time_select helpers on a page or you want to
+# specify the name of the time on the form.  For example:
+# When I select "7:30AM" as the "Gym" time
+When /^(?:|I )select "([^\"]*)" as the "([^\"]*)" time(?: within "([^\"]*)")?$/ do |time, time_label, selector|
+  with_scope(selector) do
+    select_time(time, :from => time_label)
+  end
+end
+
+# Use this step in conjunction with Rail's date_select helper.  For example:
+# When I select "February 20, 1981" as the date
+When /^(?:|I )select "([^\"]*)" as the date(?: within "([^\"]*)")?$/ do |date, selector|
+  with_scope(selector) do
+    select_date(date)
+  end
+end
+
+# Use this step when using multiple date_select helpers on one page or
+# you want to specify the name of the date on the form. For example:
+# When I select "April 26, 1982" as the "Date of Birth" date
+When /^(?:|I )select "([^\"]*)" as the "([^\"]*)" date(?: within "([^\"]*)")?$/ do |date, date_label, selector|
+  with_scope(selector) do
+    select_date(date, :from => date_label)
+  end
+end
+
+When /^(?:|I )check "([^\"]*)"(?: within "([^\"]*)")?$/ do |field, selector|
+  with_scope(selector) do
+    check(field)
+  end
+end
+
+When /^(?:|I )uncheck "([^\"]*)"(?: within "([^\"]*)")?$/ do |field, selector|
+  with_scope(selector) do
+    uncheck(field)
+  end
+end
+
+When /^(?:|I )choose "([^\"]*)"(?: within "([^\"]*)")?$/ do |field, selector|
+  with_scope(selector) do
+    choose(field)
+  end
+end
+
+When /^(?:|I )attach the file at "([^\"]*)" to "([^\"]*)"(?: within "([^\"]*)")?$/ do |path, field, selector|
+  with_scope(selector) do
+    attach_file(field, path)
+  end
+end
+
+Then /^(?:|I )should see "([^\"]*)"(?: within "([^\"]*)")?$/ do |text, selector|
+  with_scope(selector) do
+    if defined?(Spec::Rails::Matchers)
+      has_content?(text).should be_true
+    else
+      assert has_content?(text)
+    end
+  end
+end
+
+Then /^(?:|I )should see \/([^\/]*)\/(?: within "([^\"]*)")?$/ do |regexp, selector|
+  regexp = Regexp.new(regexp)
+  with_scope(selector) do
+    if defined?(Spec::Rails::Matchers)
+      has_xpath?('//*', :text => regexp).should be_true
+    else
+      assert has_xpath('//*', :text => regexp)
+    end
+  end
+end
+
+Then /^(?:|I )should not see "([^\"]*)"(?: within "([^\"]*)")?$/ do |text, selector|
+  with_scope(selector) do
+    if defined?(Spec::Rails::Matchers)
+      has_content?(text).should be_false
+    else
+      assert_not has_content?(text)
+    end
+  end
+end
+
+Then /^(?:|I )should not see \/([^\/]*)\/(?: within "([^\"]*)")?$/ do |regexp, selector|
+  regexp = Regexp.new(regexp)
+  with_scope(selector) do
+    if defined?(Spec::Rails::Matchers)
+      has_xpath?('//*', :text => regexp).should be_false
+    else
+      assert_not has_xpath?('//*', :text => regexp)
+    end
+  end
+end
+
+Then /^the "([^\"]*)" field(?: within "([^\"]*)")? should contain "([^\"]*)"$/ do |field, selector, value|
+  with_scope(selector) do
+    if defined?(Spec::Rails::Matchers)
+      field_labeled(field).value.should =~ /#{value}/
+    else
+      assert_match(/#{value}/, field_labeled(field).value)
+    end
+  end
+end
+
+Then /^the "([^\"]*)" field(?: within "([^\"]*)")? should not contain "([^\"]*)"$/ do |field, selector, value|
+  with_scope(selector) do
+    if defined?(Spec::Rails::Matchers)
+      find_field(field).value.should_not =~ /#{value}/
+    else
+      assert_no_match(/#{value}/, find_field(field).value)
+    end
+  end
+end
+
+Then /^the "([^\"]*)" checkbox(?: within "([^\"]*)")? should be checked$/ do |label, selector|
+  with_scope(selector) do
+    if defined?(Spec::Rails::Matchers)
+      field_labeled(label)['checked'].should == 'checked'
+    else
+      assert field_labeled(label)['checked'] == 'checked'
+    end
+  end
+end
+
+Then /^the "([^\"]*)" checkbox(?: within "([^\"]*)")? should not be checked$/ do |label, selector|
+  with_scope(selector) do
+    if defined?(Spec::Rails::Matchers)
+      field_labeled(label)['checked'].should_not == 'checked'
+    else
+      assert field_labeled(label)['checked'] != 'checked'
+    end
+  end
+end
+
+Then /^(?:|I )should be on (.+)$/ do |page_name|
+  if defined?(Spec::Rails::Matchers)
+    URI.parse(current_url).path.should == path_to(page_name)
+  else
+    assert_equal path_to(page_name), URI.parse(current_url).path
+  end
+end
+
+Then /^show me the page$/ do
+  save_and_open_page
+end