Webrat - Ruby Acceptance Testing for Web applications
Go to file
Noah Davis ccaf41160c Save and open page storage directory now defaults to "tmp" under current directory if exists, otherwise current directory 2010-01-17 18:29:35 -05:00
lib Save and open page storage directory now defaults to "tmp" under current directory if exists, otherwise current directory 2010-01-17 18:29:35 -05:00
spec Save and open page storage directory now defaults to "tmp" under current directory if exists, otherwise current directory 2010-01-17 18:29:35 -05:00
vendor Update Selenium RC Server to version 1.0.1 2009-07-06 13:43:31 -04: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 Removed save_and_open_page's rewriting of static asset paths before saving (was not actually working) 2010-01-16 19:28:29 -05:00
MIT-LICENSE.txt Add hoe for gem support 2008-03-02 19:35:46 -05:00
README.rdoc updated from master 2008-12-27 17:22:51 -06:00
Rakefile Use simple Thor tasks for release management instead of Jeweler 2009-11-15 15:49:38 -05:00
Thorfile Use simple Thor tasks for release management instead of Jeweler 2009-11-15 15:49:38 -05:00
install.rb Adding gemspec. Hopfully gem will build on GitHub now 2008-11-24 20:34:10 -05:00
webrat.gemspec Bump VERSION to prerelease 2009-11-28 00:24:47 -05:00

README.rdoc

= 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.