Fetching contributors…
Cannot retrieve contributors at this time
executable file 235 lines (176 sloc) 12.5 KB



  • Active_record hook prevents features that access multiple database from running correctly (#152 winnipegtransit)





  • Removed the dependency on rack-test, since it is not used directly. v1.0.1 was incompatible with Rails 3.0.9. (Aslak Hellesøy)


New Features

  • Added a @no-database-cleaner tag you can add if you don't want to run DatabaseCleaner. Useful for debugging if you want to leave data in the database. Typical use case is to run rails server --environment test to look at/try app with data from test. (Aslak Hellesøy)
  • History file is now in Markdown format. (Aslak Hellesøy)


New Features

  • Upgraded Cucumber dependency to 1.0.0. (Aslak Hellesøy)


New Features

  • Upgraded to Capybara 1.0.0.rc1 (Aslak Hellesøy)
  • Add stats to generator (#144 Aslak Hellesøy)



  • Mixed DB access feature for @javascript drivers (#142 Alexander Mankuta)
  • cucumber:feature and integers. not creating feature correctly (#30 John Ivanoff, Aslak Hellesøy)
  • New project can't find capybara's "visit" (#143 Aslak Hellesøy)
  • rails generate cucumber:install attempts double run (#140 Aslak Hellesøy)



  • undefined method `add_assertion' for nil:NilClass (#96, #97, #98 Aslak Hellesøy)
  • Capybara name error from env.rb (#125 Aslak Hellesøy)
  • Fixed date-localization bug (#138 Michael Opitz)


Removed features

  • Dropped support for Rails 2 (Aslak Hellesøy)
  • Dropped support for Webrat (Aslak Hellesøy)
  • Removed database cleaner strategy overrides (#134 Daniel Morrison, Daniel Duvall)


  • Upgrade to Capybara 1.0.0.beta1 or newer (#129, #130 Simon Menke, Klaus Hartl, Aslak Hellesøy)
  • Generated paths.rb cleanup (#133 Tim Pope)
  • Allow css pseudo-classes in scopers (#122 twalpole)



  • Fixed incorrect warning in generated files. (#115 Emanuele Vicentini)
  • Fixed incorrect hooks for DatabaseCleaner (#113 Markus Bengts)
  • Throw an error if the user forgot to add DatabaseCleaner to the Gemfile, allowing them to decide whether or not to use it. (#36 Aslak Hellesøy, Ryan Bigg)


New Features

  • Add selectors helper (#63 Bodaniel Jeanes)
  • Capybara date stepdefs (#66 Rob Holland)
  • The World now includes Rack::Test::Methods, allowing get, post, put delete (Aslak Hellesøy)


  • Allow setting rails root (#102, #103, Fabio Kreusch)
  • Fix Date selection steps and helpers (#93, #99, #100, #101, #109 James Herdman, John Ferlito, twalpole, Geoff Drake, Ricky Robinson, Michael Fleet)
  • Can not run cucumber-rails (0.4.0.beta.1) with cucumber (0.10.0) (#89 Aslak Hellesøy)
  • Installing cucumber-rails without a database.yml fails (#61 Aslak Hellesøy)
  • Fix #click_link compatibility with Capybara 0.4. (#54, #77, #78, #80 Aslak Hellesøy)
  • Support for projects using other ORMs than ActiveRecord (or nothing at all). (#18, #22, #46, #85, #86, #87, #90 Aslak Hellesøy)
  • @allow-rescue not working in rails 3 (#31 Joe Ferris, Aslak Hellesøy)
  • Gem dependency on Nokogiri (for #tableish). (#53 Aslak Hellesøy)

Removed Features

  • Automatic detection of RSpec, Capybara and Webrat for install generator. Set gems explicitly in your Gemfile (Rails3) or environment.rb (Rails2)
  • Then /^(?:|I )should see JSON:$/. Use #get and #last_response instead. See features/rails3.feature. (Aslak Hellesøy)
  • Cucumber::Rails::World.use_transactional_fixtures. TODO: Explain what to do instead. No more Cucumber::Rails::World.use_transactional_fixtures = false. Use DatabaseCleaner.strategy = :none instead


  • web_steps.rb uses "([^"])" instead of "([^"])" (Aslak Hellesøy)
  • Renamed cucumber:skeleton to cucumber:install (Rails 3 generator). (Aslak Hellesøy)
  • Upgraded to be compatible with rspec 2.0.0.beta.10 (#35 Gabor Ratky, Pete Yandell)


This release has a lot of bugfixes! The test suite (based on Aruba) verifies that Cucumber-Rails now works with various combinations of:

  • Cucumber 0.6.x/0.7.2
  • Rails2/Rails3
  • RSpec1/RSpec2/Test-Unit/Mini-Uint
  • Webrat/CapyBara
  • MRI 1.8.6/1.8.7/1.9.1

This one requires a special mention: The handy (but error prone) rerun functionality has moved to a separate rerun profile, so all rerun.txt related issues should now be gone.

  • New Capybara Step Definitions for Dates. (Rob Holland)
  • Steps now recognise "Given I am on the users page" etc. (Solomon White)
  • Relegate rerun to its own profile and rake task (Mike Sassak)
  • Added new Then /^(?:|I )should see JSON:$/ step definition to Capybara - useful for REST. (Aslak Hellesøy)
  • The #tableish method now understands tables with colspan and rowspan
  • Support RSpec 2 (Johan Kiviniemi, Aslak Hellesøy, Rolf Bjaanes)
  • Added @no-js-emulation, which turns off javascript emulation for delete links when not using browser testing. (Rob Holland, Aslak Hellesøy)
  • Korean translation (Shim Taewon)


  • No longer need to install the test-unit gem on 1.9.1 (Aslak Hellesøy)
  • capybara rack-test field should contain step support for textarea (#28 Nicholas Rutherford)
  • "Rspec is not missing constant Matchers!" error. (#27 David Chelimsky, Aslak Hellesøy)
  • @culerity tag breaks Rails 3 RESTful helpers (#17 Aslak Hellesøy)


This is a major release since we're now supporting both Rails 3 and RSpec 2. Older versions (Rails 2 and RSpec 1) are still supported.

New Features

  • Support for both Rails-2.x and Rails-3.x (#10 Kristian Mandrup, Aleksey Gureiev, Ashley Moran, Aslak Hellesøy)
  • Support for both RSpec-1.x and RSpec-2.x (Louis Rose, Aslak Hellesøy)
  • Features will default to Javascript emulation unless you turn it off with @culerity, (Aslak Hellesøy)
  • Japanese translation. (MOROHASHI Kyosuke)


  • Support projects that don't use ActiveRecord (#14 Aslak Hellesøy)
  • Running test/unit tests when creating a skeleton (#12 Aleksey Gureiev)
  • Inform that config/database.yml is overwritten, be smarter about it and inform the user that it is forced. (#15 Aslak Hellesøy)
  • Reverts changes from issue #5 where verification of query string params was added to the step for being on a page. Adds step discussed in issue #11 for verification of query string. (#5, #11 Eric Milford)
  • Fixed typos in Capybara's web steps (has_not_xpath? => has_no_xpath?) (Thorbjørn Hermansen, Carlos Antonio da Silva)

New Features

  • Added Danish translation (Kristian Mandrup)
  • Using Gemfile for Rails 3. Tidies it up and adds cucumber gems only if not already present! (Kristian Mandrup)
  • Added Generators wrapper module for Rails 3 generators so they are now all in Cucumber::Generators (Kristian Mandrup)


  • Started to work on solutions for generating suitable support files depending on Rails version
    • see skeleton_base.rb#create_feature_support and templates/support


New Features

  • Added Spanish translation (Gabriel)


  • Fixed some broken Webrat/Test::Unit step definitions. (Aslak Hellesøy)
  • Better Javascript emulation with Capybara (#7 Thorbjørn Hermansen)
  • Removed stray quote in i18n web_steps.rb (Gabriel)
  • Update hooks to new boolean logic (#6 Jon Larkowski, Michael MacDonald)
  • Fixed incompatibility with Rails 3 (Mutwin Kraus)
  • Fixed broken "fill in the following" step for Capybara web_steps (Lenny Marks)
  • Capybara web_steps.rb with_scope didn't work in nested steps (Lenny Marks)
  • Fixed "should not see" steps in web_steps.rb to use the correct selector (Toni Tuominen)


New Features

  • The #tableish Proc can return Strings as well as Nokogiri nodes now. (Aslak Hellesøy)


  • Handle all types of URIs in "I should be on ..." steps. (#5 Andrew D. Smith)



  • Fix bad link in gemspec. (Aslak Hellesøy)
  • Unified file attaching step names. (Jiří Zajpt)
  • Fix typos in variable names in several step definitions. (Jiří Zajpt)
  • cucumber.rake finds the wrong vendored cucumber when a plugin name starts with "cucumber" (#4 James Herdman, Paco Benavent, Aslak Hellesøy)

New features

  • Czech translations. (Jiří Zajpt)


Small bugfix release


  • Made sure database_cleaner is always set up as a dependency in config/environments/cucumber.rb. (Aslak Hellesøy)

This is the first release of cucumber-rails, which was factored out of cucumber. We're calling it 0.2.0 just because we did some prereleases in the 0.1 series, and to celebrate that cucumber-rails now supports Capybara as an alternative to Webrat.


  1. Remove your features/support/version_check.rb

  2. Remove your features/step_definitions/webrat_steps.rb If you have added your own custom step definitions to this file, put them in a different file under features/step_definitions

  3. run "ruby script/generate cucumber --help" to see what options you have.

  4. run "ruby script/generate cucumber" - plus whatever options you think fit for you. Answer "n" (no) when asked to overwrite paths.rb. Answer "y" (yes) when asked to overwrite other files, but do "d" (diff) first. If you have edits in some of these files that you want to keep, store the diff in a temporary file and reapply after you have overwritten the file. ALso consider adding your custom code to another file that won't be overwritten the next time you upgrade.

    Many people have edits in their env.rb file. This is something you should try to avoid in the future. Instead, keep your custom setup in a different file under features/support - Cucumber loads all files under features/**/*.rb anyway.

    If you have a Spork setup, see the end of this thread:

New features

  • Added an @emulate_rails_javascript tag that will emulate onclick with Capybara (Aslak Hellesøy, Rob Holland)
  • Added a smart config/cucumber.yml file that will rerun previously failing scenarios (Aslak Hellesøy)
  • Support for Capybara. Run "script/generate --capybara" if you want that. (Rob Holland, Aslak Hellesøy)
  • New #tableish method to extract table-like data from a HTML page. Pure Nokogiri/CSS3/XPath. (Aslak Hellesøy)


  • 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)