Unit Testing Your Web Site


You want to create a suite of automated tests that test the functionality of your Rails application.


Rails can write your test code any more than it can write your views and controllers for you, but it does make it easy to organize and run your automated tests.

When you use the ./script/generate command to create controllers and models, not only do you save time, but you also get a generated framework for unit and functional tests. You can get pretty good test coverage by filling in the framework with tests for the functionality you write.

So far, all the examples in this chapter have run against a Rails applications development database, so you only needed to make sure that the development section of your config/database.yml file was set up correctly. Unit test code runs on your applications test database, so now you need to set up your test section as well. Your mywebapp_test database doesn have to have any tables in it, but it must exist and be accessible to Rails.

When you generate a model with the generate script, Rails also generates a unit test script for the model in the test directory. It also creates a fixture, a YAML file containing test data to be loaded into the mywebapp_test database. This is the data against which your unit tests will run:

	./script/generate model User
	 exists app/models/
	 exists test/unit/
	 exists test/fixtures/
 	 create app/models/user.rb
	 create test/unit/user_test.rb
	 create test/fixtures/users.yml
	 create db/migrate
	 create db/migrate/001_create_users.rb

When you generate a controller with generate, Rails creates a functional test script for the controller:

	./script/generate users list
	 exists app/controllers/
	 exists app/helpers/
	 create app/views/users
	 exists test/functional/
	 create app/controllers/users_controller.rb
	 create test/functional/users_controller_test.rb
	 create app/helpers/users_helper.rb
	 create app/views/users/list.rhtml

As you write code in the model and controller classes, youll write corresponding tests in these files.

To run the unit and functional tests, invoke the rake command in your home directory. The default Rake task runs all of your tests. If you run it immediately after generating your test files, itll look something like this:

	$ rake
	(in /home/lucas/mywebapp)
	/usr/bin/ruby1.8 "test/unit/user_test.rb"
	Finished in 0.048702 seconds.
	1 tests, 1 assertions, 0 failures, 0 errors
	/usr/bin/ruby1.8 "test/functional/users_controller_test.rb"
	Finished in 0.024615 seconds.

	1 tests, 1 assertions, 0 failures, 0 errors


All the lessons for writing unit tests in other languages and in other Ruby programs (see Recipe 17.7) apply to Rails. Rails does some accounting for you, and it defines some useful new assertions (see below), but you still have to do the work. The rewards are the same, too: you can modify and refactor your code with confidence, knowing that if something breaks, your tests will break. Youll hear about the problem immediately and youll be able to fix it more quickly.

Lets see what Rails has generated for us. Heres a generated test/unit/user_test.rb:

	require File.dirname(__FILE__) + /../test_helper

	class UserTest < Test::Unit::TestCase
	 fixtures :users

	 # Replace this with your real tests.
	 def test_truth
	 assert true

A good start, but test_truth is kind of tautological. Heres a slightly more realistic test:

	class UserTest
	 def test_first
	 assert_kind_of User, users(:first)

This code fetches the first element from the users table, and asserts that ActiveRecord turns it into a User object. This isn testing our User code (we haven written any) so much as its testing Rails and ActiveRecord, but it shows you the kind of assertion that makes for good unit tests.

But how does users(:first) return anything? The test suite runs against the mywebapp_test database, and we didn even put any tables in it, much less sample data.

We didn , but Rails did. When you run the test suite, Rails copies the schema of the development database to the test database. Instead of running every test against whatever data happens to exist in the development database, Rails loads special test data from YAML files called fixtures. The fixture files contain whatever database data you need to test: objects that only exist to be deleted by a test, strange relationships between rows in different tables, or anything else you need.

In the example above, the fixture for the users table was loaded by the line fixtures :users. Heres the generated fixture for the User model, in test/fixtures/users.yml:

	 id: 1
	 id: 2

Before running the unit tests, Rails reads this file, creates two rows in the users table, and defines aliases for them (:first and :another) so you can refer to them in your unit tests. It then defines the users method (like so much else, this method name is based on the name of the model). In test_first, the call to users(:first) retrieves the User object corresponding to :first in the fixture: the object with ID 1.

Heres another unit test:

	class UserTest
	 def test_another
	 assert_kind_of User, users(:another)
	 assert_equal 2, users(:another).id
	 assert_not_equal users(:first), users(:another)

Rails adds the following Rails-specific assertions to Rubys Test::Unit:

  • assert_dom_equal
  • assert_dom_not_equal
  • assert_generates
  • assert_no_tag
  • assert_recognizes
  • assert_redirected_to
  • assert_response
  • assert_routing
  • assert_tag
  • assert_template
  • assert_valid

See Also

  • "Testing the Rails" is a guide to unit and functional testing in Rails (http://manuals.rubyonrails.com/read/book/5)
  • Rails 1.1 supports integration testing as well, for testing the interactions between controllers and actions; see http://rubyonrails.com/rails/classes/ActionController/IntegrationTest.html and http://jamis.jamisbuck.org/articles/2006/03/09/integration-testing-in-rails-1-1
  • The ZenTest library inclues Test::Rails, which lets you write separate tests for your views and controllers (http://rubyforge.org/projects/zentest/)
  • Read about fixtures at http://ar.rubyonrails.org/classes/Fixtures.html
  • Read about the assertions that Rails adds to Test::Unit at http://rails.rubyonrails.com/classes/Test/Unit/Assertions.html
  • Recipe 15.6, "Integrating a Database with Your Rails Application"
  • Recipe 17.7, "Writing Unit Tests"
  • Chapter 19



Date and Time



Files and Directories

Code Blocks and Iteration

Objects and Classes8

Modules and Namespaces

Reflection and Metaprogramming


Graphics and Other File Formats

Databases and Persistence

Internet Services

Web Development Ruby on Rails

Web Services and Distributed Programming

Testing, Debugging, Optimizing, and Documenting

Packaging and Distributing Software

Automating Tasks with Rake

Multitasking and Multithreading

User Interface

Extending Ruby with Other Languages

System Administration

Ruby Cookbook
Ruby Cookbook (Cookbooks (OReilly))
ISBN: 0596523696
EAN: 2147483647
Year: N/A
Pages: 399

Flylib.com © 2008-2020.
If you may any questions please contact us: flylib@qtcs.net