Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
== Rails Spec Integration Plugin The Spec Integration plugin brings together RSpec on Rails and Rails integration testing, while also adding a number of very useful new matchers and some more integration testing DSL methods. === Installation script/plugin install git://github.com/aiwilliams/spec_integration.git === Quick Start It's easy to get started. Create a directory named 'integration' in your spec directory, right alongside your controllers, models, and views spec directories. In your spec_helper: require 'spec/integration' A simple integration spec looks like this: # in spec/integration/signup_spec.rb require File.dirname(__FILE__) + "/../spec_helper" describe "Logging in" do dataset :single_person it "should send a user to the home page after login" do # get the login page get "/login" response.should be_success # post the login and follow through to the home page post "/login", :username => people(:jamis).username, :password => people(:jamis).password follow_redirect! response.should be_success path.should == "/home" end end This is taken straight from integration.rb, the Rails integration test documentation. Of course, it's been modified to specify instead of assert! === Integration DSL Spec Integration adds some great tools to make you even more productive. An example explains some of these features best. # in spec/integration/signup_spec.rb require File.dirname(__FILE__) + "/../spec_helper" describe "Logging in" do dataset :single_person before do navigate_to login_path end it "should send a user to the home page after login" do submit_form :username => people(:jamis).username, :password => people(:jamis).password response.should be_showing(home_path) end end The dataset method is provided by another plugin, Dataset(1). It's a great alternative to fixtures. navigate_to, submit_form, and be_showing are a few of the DSL methods provided by the Spec Integration plugin. navigate_to does a get, as in the prior test, but it also follows redirects and generally ensures that navigating worked - the document isn't missing, the template rendered, etc. submit_form posts the parameters (actually, it uses the method defined in the rendered form's action attribute), follows any redirects, and ensures that all that was successful. In fact, it does even more. Check out spec/integration/dsl/form.rb to learn more. be_showing returns a matcher that ensures the response has the expected path. === More Information (1) http://github.com/aiwilliams/dataset == Credits Written by [Adam Williams](http://github.com/aiwilliams). Contributors: - [John Long](http://github.com/jlong) - [Steve Iannopollo](http://github.com/siannopollo) - [Austin Taylor](http://github.com/dotjerky) --- Spec Integration is released under the MIT-License and is Copyright (c)2007-2009 Adam Williams.