Webrat - Ruby Acceptance Testing for Web applications
Go to file
Álvaro Gil fa881a88c8 build querystring with all form elements and then parse to get query params
* Basically Field#to_param was replaced for Field#to_query_string and
some methods related to build params were moved to Form class.

Before this commit the params hash was made by parsing each element
querystring to param and then merge, now we build the whole querystring
first and then parse it to get params with Rack or Rails depending of
the configure mode.
2010-04-03 12:07:16 -03:00
lib build querystring with all form elements and then parse to get query params 2010-04-03 12:07:16 -03:00
spec build querystring with all form elements and then parse to get query params 2010-04-03 12:07:16 -03:00
vendor Replaced selenium standalone jar to fix Snow Leopard + Firefox 3.5 issue 2010-01-17 20:30:55 -05:00
.document Adding .document RDoc config file 2008-11-25 01:04:26 -05:00
.gitignore Use Bundler for managing dependencies needed to run the tests 2009-11-13 17:41:33 -05:00
Gemfile Use simple Thor tasks for release management instead of Jeweler 2009-11-15 15:49:38 -05:00
History.txt New webrat configuration option selenium_firefox_profile which is passed to selenium server 2010-02-26 15:54:31 -05:00
install.rb Adding gemspec. Hopfully gem will build on GitHub now 2008-11-24 20:34:10 -05:00
MIT-LICENSE.txt Add hoe for gem support 2008-03-02 19:35:46 -05:00
Rakefile Use simple Thor tasks for release management instead of Jeweler 2009-11-15 15:49:38 -05:00
README.rdoc updated from master 2008-12-27 17:22:51 -06:00
Thorfile Added missing dependency "rack-test" to gemspec (LH #339) 2010-01-17 20:42:37 -05:00
webrat.gemspec Bumping version to prerelease until next official release 2010-01-17 20:48:23 -05:00

= Webrat - Ruby Acceptance Testing for Web applications

- http://gitrdoc.com/brynary/webrat
- http://groups.google.com/group/webrat
- http://webrat.lighthouseapp.com/
- http://github.com/brynary/webrat
- #webrat on Freenode

== Description

Webrat lets you quickly write expressive and robust acceptance tests for a Ruby
web application. 

== Features

* Browser Simulator for expressive, high level acceptance testing without the
  performance hit and browser dependency of Selenium or Watir (See Webrat::Session)
* Use the same API for Browser Simulator and real Selenium tests using
  Webrat::Selenium when necessary (eg. for testing AJAX interactions)
* Supports multiple Ruby web frameworks: Rails, Merb and Sinatra
* Supports popular test frameworks: RSpec, Cucumber, Test::Unit and Shoulda
* Webrat::Matchers API for verifying rendered HTML using CSS, XPath, etc.

== Example

  class SignupTest < ActionController::IntegrationTest
  
    def test_trial_account_sign_up
      visit home_path
      click_link "Sign up"
      fill_in "Email", :with => "good@example.com"
      select "Free account"
      click_button "Register"
    end
    
  end
  
Behind the scenes, Webrat will ensure:

* If a link, form field or button is missing, the test will fail.
* If a URL is invalid, the test will fail.
* If a page load or form submission is unsuccessful, the test will fail.

== Installing Nokogiri

Users of Debian Linux (e.g. Ubuntu) need to run:

  sudo apt-get install libxslt1-dev libxml2-dev.

Otherwise the Nokogiri gem, which Webrat depends on, won't install properly.

== Install for Rails

To install the latest release as a gem:

  sudo gem install webrat
  
To install the latest code as a plugin: (_Note:_ This may be less stable than using a released version)

  script/plugin install git://github.com/brynary/webrat.git

In your test_helper.rb or env.rb (for Cucumber) add:

  require "webrat"
  
  Webrat.configure do |config|
    config.mode = :rails
  end
  
== Install with Merb

Merb 1.0 has built-in, seamless Webrat support. Just start using
methods from Webrat::Session in your specs.

== Authors

- Maintained by {Bryan Helmkamp}[mailto:bryan@brynary.com]
- Original code written by {Seth Fitzsimmons}[mailto:seth@mojodna.net]
- Initial development was sponsored by EastMedia[http://www.eastmedia.com]
- Many other contributors. See attributions in History.txt

== License

Copyright (c) 2007-2008 Bryan Helmkamp, Seth Fitzsimmons.
See MIT-LICENSE.txt in this directory.