Agile Web Development

test/spec/rails

This plugin contain some helpers to test your Rails app using test/spec.

Installation

 * Install test/spec: gem install test-spec
 * Install test/spec/rails
 * require 'test/spec/rails' in your test_helper.rb

Source

  test/spec/rails uses Git for source control. The clone URL is:

    git://github.com/pelargir/test_spec_on_rails.git

Model validation

  @user.should.validate
  @user.should.not.validate
  or:
  @user.should.be.validated
  @user.should.not.be.validated

Redirection

  response.should.be.redirected           # assert_response :redirect
  response.should.redirect foo_url(@foo)  # assert_redirected_to foo_url(@foo)
  should.redirect_to :action => 'show'    # because "response" is optional

  It's aliased as redirect, redirect_to, redirected and redirected_to

Output verification

  Wrapper for assert_select:

  get :show
  page.should.select "form#user_form"             # require the output to have a <form id="user_form">

  page.should.select "form#user_form" do |form|
    form.should.select "input[type=submit]"       # the user_form must include a <input type="submit">
  end

HTTP Status

  Wrapper for assert_response:

  status.should.be :success
  status.should.be 200

Which template was rendered?

  Wrapper for assert_template:

  template.should.be "foo/show.rhtml"

Which layout used?

  Wrapper for asserting that a certain layout is used:

  layout.should.be "foo"

URL testing

  get :show, :user_id => 1
  url.should.be "/users/1"
  url.should.be :controller => "users", :action => "show", :user_id => 1

Difference

  Wrapper for assert_difference:

  Article.should.differ(:count).by(2) { blah }

Routing to set of url options from a given path (i.e., #assert_generates)

  assert_generates "/users/1", :controller => "users", :action => "show", :id  => "1"

    becomes

  {:controller => "users", :action => "show", :id  => "1"}.should.route_to "/users/1"

Routing from a set of url options to an expected path (i.e., #assert_recognizes)

  assert_recognizes({:controller => "users", :action => "show", :id => "1"}, {:path => "/users/1", :method => :get})

    becomes

  {:path => "/users/1", :method => :get}.should.route_from :controller => "users", :action => "show", :id =>"1"

Setup controller for testing + example usage

  context "A guest" do
    use_controller FooController

    specify "isn't allowed to foo" do
      post :create, :foo => 'bar'
      flash[:error].should.not.be.blank
      response.should.redirect :controller => 'front', :action => 'show'
      assigns(:foo).errors.on(:bar).should.not.be.blank
      assigns(:foo).should.not.validate
      follow_redirect
      page.should.select "#errors", :text => /#{flash[:error]}/
    end
  end

  context "Tuxie" do
    setup do
      use_controller FooController
      login_as :tuxie
    end

    specify "may foo" do
      post :create, :foo => 'bar'
      flash[:notice].should.not.be.blank
      assigns(:foo).errors.should.be.empty
      assigns(:foo).should.validate
      should.redirect_to :action => 'show'
      follow_redirect
      page.should.select "#notice", :text => /#{flash[:notice]}/
    end
  end

Misc

  page, response and request are just aliases for self (the TestCase) so the following
  are functionally identical:

  page.should.redirect
  response.should.redirect
  request.should.redirect

  output, body, html and xhtml return @response.body so the following lines are identical:

  output.should.match /foo/
  html.should.match /foo/
  xhtml.should.match /foo/
  body.should.match /foo/

  If an object respond to #should_equal, that method will be used instead of assert_equal
  when using foo.should.equal(bar) or foo.should.be(bar)
  foo.should.not.equal and foo.should.not.be look for #should_not_equal

Credit

 * Created by Per "Tuxie" Wigren <per.wigren@gmail.com>
 * Enhanced by Rick Olson <technoweenie@gmail.com>
 * Currently maintained by Matthew Bass <pelargir@gmail.com>

Owner: Per "Tuxie" Wigren

Repository: git://github.com/pelargir/test_spec_on_rails.git

License: Rails' (MIT)

Category: Testing