Please see CONTRIBUTING.md on how to contribute to Cucumber.
master (Not yet released)
There are currently no unreleased changes.
v1.6.0 (2018-04-23)
- Renamed History.md to CHANGELOG.md, added contributing note, and this line in accordance with cucumber/cucumber #251 (#345 jaysonesmith)
- Update .travis.yml with ruby versions (#341 Jun Aruga)
- Removed support for Ruby <= 2.1, to keep in line with cucumber-ruby (#360 xtrasimplicity).
- Updated syntax to support both new and deprecated forms of tag negation. (#348 mirelon, #359 xtrasimplicity)
- Dependencies: Allowed
Ammeter
versions greater than 1.1.3. (#368 mvz) - Switched to Ruby 1.9 hash syntax. (#371 mvz)
- Added support to handle rerun files with multiple lines. (#c6d3d7e mvz)
- Added support for Rails 5.2 and Capybara 3. (#378 gobijan, radar, xtrasimplicity)
- Fix typo (#343 Olle Jonsson)
- History.md: Fixed markdown formatting (#344 Kosmas)
- Fixed tag deprecation warnings. (#373 mvz)
v1.5.0 (2017-05-12)
- Drop rails 3 support (#334 Matijs van Zuijlen)
- Add rals 5.1 support (#337 Matijs van Zuijlen - Rafael Reggiani Manzo)
v1.4.5 (2016-09-27)
- Add support for Cucumber 3+ (Steve Tooke)
v1.4.4 (2016-08-05)
- Ensure support for Rails 5
v1.4.3 (2016-01-21)
- Added gem version badge (Kosmas Chatzimichalis)
- Fix a failing test due to rails date selectors only showing 5 years into the past by default (#293 Thomas Walpole)
- Allow cucumber 2 (#293 Thomas Walpole)
- Add rails 4.2 to test matrix (#293 Thomas Walpole)
- Depend on railties instead of rails (#294 Alexander Lang)
- Fix failing Travis CI tests (#305 Matijs van Zuijlen)
- Allow any cucumber < 3 (#306 Matijs van Zuijlen)
- Add annotations configuration in generator (#292 Bob Showalter)
- Expand support to include mime-types 3 (#304 Austin Ziegler)
- Replace badges with SVG versions (#307 Kevin Goslar)
- Add new line to end of generated database.yml (#302 Kevin Carmody)
v1.4.2 (2014-10-09)
- Updated appraisal dependencies to rspec-rails 3.1.0, gemspec dependency to rspec <= 3.1, and removed turn from rails_4_1 appraisal (Kosmas Chatzimichalis)
- Update mime-types dependency to >= 1.16, < 3 (#289 Erik Michaels-Ober)
- Upgrade to RSpec 3 (#290 Tamir Duberstein)
v1.4.1 (2014-05-10)
- Added MIT licence in gemspec (#261 Benjamin Fleischer)
- Ensure dependency on DatabaseCleaner is not required (#276 Matthew O'Riordan)
- Added Rails 4.1 support (#287 Felix Bünemann)
- Modified appraisal instructions in README.md (Kosmas Chatzimichalis)
- Added Gemnasium support (Kosmas Chatzimichalis)
- Various code enhancements based on PullReview suggestions (Kosmas Chatzimichalis)
- Mongo step definition (#263 Aslak Hellesøy)
- Prevent MiniTest running
at_exit
when running cucumber (#253 Steve Tooke) bundle exec rake
runs minitest with cucumber options and raises exception (#252 Peter Bollenbeck)- Various bundler related fixes (#264 Erik Michaels-Ober)
- Additional gemspec cleanup (#265 Erik Michaels-Ober)
- Added mime-types runtime dependency to fix bundle install issue (#273 Kosmas Chatzimichalis)
- Removed mongoid gem from Appraisal (#274 Kosmas Chatzimichalis)
- Amend typo in select_dates_and_times.rb comments (#268 Erik Eide)
- Keep empty step_definitions directories (#249 Iain D Broadfoot)
- Remove obsolete link for config.cache_classes to false (#271 Andrew Premdas)
v1.4.0 (2013-08-23)
- New test raising_errors.feature to test raising routing errors that replaced the earlier routing.feature
- Added recommendation in README.md for running install scripts after upgrading (Joost Baaij)
- Describe configuration option 'autorun_database_cleaner' in README (#255 Martin Eismann)
- Gemspec in 1.3.1 doesn't allow usage with rails 4 (#244 Fabian Schwahn)
- routing.feature code was actually testing the raising of errors so it was renamed to raising_errors.feature and slightly changed to deal with rails 4 changes in public folder
- multiple_databases.feature was removed as it was actually testing DatabaseCleaner behaviour
- pre_bundler.feature was removed as it is no longer relevant
- mongodb feature was removed as is there is no mongodb code in cucumber-rails codebase
- Fixed tests so they pass in Rails 4 and updated gemspec (#247 Dave Brace)
- Allow use with Rails 4 (#254 Marnen Laibow-Koser)
- (dumb) Fix for Rails4 (#256 Jon Rowe)
- Revert "Merge pull request #256 from JonRowe/dumb_fix_for_rails4_test_he... (#258 Kosmas Chatzimichalis)
v1.3.1 (2013-03-15)
- Multiple-gemfile testing and travis configuration (#240 Simon Coffey)
- Fix a typo in a template (#228 Robin Dupret)
- Depend upon the generic test:prepare task (#230 Graeme Mathieson)
- Allow users to disable database_cleaner hooks (#232 Simon Coffey)
- Rails 4.0.0-beta ActionController::Integration depreciation fix (#234 Daniel Bruns)
v1.3.0 (2012-02-19)
v1.2.1 (2011-12-04)
- Allow ability to use deletion as a javascript database strategy (#185 Thijs de Vries)
- Support custom JS strategies (#184 Michael Pabst)
v1.2.0 (2011-11-03)
- The (deprecated) tableish method has been removed. See https://gist.github.com/1299371 for an alternative. (Aslak Hellesøy)
- Non-threadsafe database connections shared between threads (#166 Matt Wynne)
v1.1.1 (2011-10-03)
The cucumber:feature
generator has been removed. The reasoning behind this is the same as for
removing web_steps.rb
, paths.rb
and selectors.rb
in v1.1.0.
v1.1.0 (2011-09-28)
The following files will no longer be generated if you are running rails generate cucumber:install
:
- features/step_definitions/web_steps.rb
- features/support/paths.rb
- features/support/selectors.rb
The reason behind this is that the steps defined in web_steps.rb
leads people to write scenarios of a
very imperative nature that are hard to read and hard to maintain. Cucumber scenarios should not be a series
of steps that describe what a user clicks. Instead, they should express what a user does. Example:
Given I have signed up as "[email protected]"
with a Step Definition that perhaps looks like this:
Given /^I have signed up as "([^"]*)"$/ do |email|
visit(signup_path)
fill_in('Email', with: email)
fill_in('Password', with: 's3cr3t')
fill_in('Password Confirmation', with: 's3cr3t')
click_button('Sign up')
end
Moving user interface details from the scenarios and down to the step definitions makes scenarios much easier to read. If you change the user interface you only have to change a step definition or two instead of a lot of scenarios that explicitly describe how to sign up.
You can learn more about the reasoning behind this change at the following links:
- Cucumber mailing list: Removing web_steps.rb in Cucumber 1.1.0
- Cucumber-Rails issue #174: Remove web_steps.rb since it encourages people to write poor tests.
- Refuctoring your Cukes by Matt Wynne
- Imperative vs Declarative Scenarios in User Stories by Ben Mabey
- Whose domain is it anyway? by Dan North
- You're Cuking it Wrong by Jonas Nicklas
You can learn more about what Capybara has to offer in Capybara's README.
v1.0.6 (2011-09-25)
- Fix deprecation warnings (#169, #170 Micah Geisel)
- Deprecate #tableish. The Capybara::Node::Finders API has obsoleted the need for it. (#145 Aslak Hellesøy)
v1.0.5 (2011-09-14)
- No = dependencies in gemspec, since rubies with old YAML (sych) can't read them. (Aslak Hellesøy)
v1.0.4 (2011-09-12)
- Active_record hook prevents features that access multiple database from running correctly (#152 winnipegtransit)
v1.0.3 (2011-09-11)
- sqlite3-ruby is now sqlite3 (#158 Trung Le)
- Broken link in the USAGE file of the features generator (#156 Pablo Alonso García)
- Rails destroy cucumber:feature deletes the steps folder, even though it's not empty. (#154, #111 mblake)
- Adjust select_date, select_time xpaths so they work when scoped in the document (#151 Thomas Walpole)
- Extend javascript emulation to handle rails CSRF protection (#164 Jonathon M. Abbott)
- Add steps for finding fields with errors (#162 Mike Burns)
v1.0.2 (2011-06-26)
- 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)
v1.0.1 (2011-06-25)
- 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)
v1.0.0 (2011-06-20)
- Upgraded Cucumber dependency to 1.0.0. (Aslak Hellesøy)
v0.5.2 (2011-06-07)
- Upgraded to Capybara 1.0.0.rc1 (Aslak Hellesøy)
- Add stats to generator (#144 Aslak Hellesøy)
v0.5.1 (2011-05-25)
- 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)
v0.5.0 (2011-05-17)
- 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)
v0.5.0.beta1 (2011-05-09)
- 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)
v0.4.1 (2011-04-05)
- 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)
v0.4.0 (2011-03-20)
- 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)
- 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
v0.3.2 (2010-06-06) The rails-2.3.x
support branch branches off from here.
- 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)
v0.3.1 (2010-05-04)
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)
v0.3.0 (2010-02-26)
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.
- 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)
- 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
v0.2.4 (2010-01-18)
- 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)
v0.2.3 (2010-01-03)
- 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)
v0.2.2 (2009-12-21)
- 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)
- Czech translations. (Jiří Zajpt)
v0.2.1 (2009-12-16)
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.
-
Remove your features/support/version_check.rb
-
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
-
run "ruby script/generate cucumber --help" to see what options you have.
-
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: http://groups.google.com/group/cukes/browse_thread/thread/475385cc26377215
- 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)