- Allow ability to use deletion as a javascript database strategy (#185 Thijs de Vries)
- Support custom JS strategies (#184 Michael Pabst)
- 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)
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.
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.
- Fix deprecation warnings (#169, #170 Micah Geisel)
- Deprecate #tableish. The Capybara::Node::Finders API has obsoleted the need for it. (#145 Aslak Hellesøy)
- No = dependencies in gemspec, since rubies with old YAML (sych) can't read them. (Aslak Hellesøy)
- Active_record hook prevents features that access multiple database from running correctly (#152 winnipegtransit)
- 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)
- 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)
- 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 testto look at/try app with data from test. (Aslak Hellesøy) - History file is now in Markdown format. (Aslak Hellesøy)
- Upgraded Cucumber dependency to 1.0.0. (Aslak Hellesøy)
- 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)
- 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)
- 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
- 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.
- 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
- 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)
- 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)
- 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.
-
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)