brynary / webrat

Source
Commits
Network (312)
Wiki (10)
Graphs
Branch: master

Webrat - Ruby Acceptance Testing for Web applications — Read more

http://gitrdoc.com/brynary/webrat/tree/master/

This URL has Read+Write access

Prep for 0.7.2.beta.1 release

brynary (author)

Sun Jul 25 17:30:23 -0700 2010

commit dcd17ac39f00e62104ff
tree d9f5c768f10427f7822d
parent caa6870cdefeffcf8e19

webrat /

name	age	history message
.document	Mon Nov 24 22:04:26 -0800 2008	Adding .document RDoc config file [brynary]
.gitignore	Fri Nov 13 14:41:33 -0800 2009	Use Bundler for managing dependencies needed to... [brynary]
Gemfile	Fri Apr 23 09:15:30 -0700 2010	Update Gemfile to the newest Bundler. [djanowski]
History.txt	Mon Apr 26 19:10:16 -0700 2010	Releasing v0.7.1 [brynary]
MIT-LICENSE.txt	Sun Mar 02 16:35:46 -0800 2008	Add hoe for gem support [brynary]
README.rdoc	Sat Dec 27 15:22:51 -0800 2008	updated from master [gaffo]
Rakefile	Mon Apr 12 19:30:56 -0700 2010	Some explicit requires of RubyGems are necessar... [djanowski]
Thorfile	Sun Jan 17 17:42:37 -0800 2010	Added missing dependency "rack-test" to gemspec... [noahd1]
install.rb	Mon Nov 24 17:34:10 -0800 2008	Adding gemspec. Hopfully gem will build on GitH... [brynary]
lib/	Sun Jul 25 17:30:23 -0700 2010	Prep for 0.7.2.beta.1 release [brynary]
spec/	Wed Jul 07 20:36:52 -0700 2010	Consider whether inner text matches when select... [Luke Melia]
vendor/	Sat Jul 24 10:31:56 -0700 2010	Bump vendored Selenium RC server to 1.0.3 [brynary]
webrat.gemspec	Sun Jul 25 17:30:23 -0700 2010	Prep for 0.7.2.beta.1 release [brynary]

README.rdoc

Webrat - Ruby Acceptance Testing for Web applications

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
Original code written by Seth Fitzsimmons
Initial development was sponsored by EastMedia
Many other contributors. See attributions in History.txt