=Mosquito, for Bug-Free Camping

A testing helper for those times when you go Camping.
Apply on the face, neck, and any exposed areas such as your
Models and Controllers. Scrub gently, observe the results.

== Usage

Make a few files and directories like this:

public/
blog.rb
test/
test_blog.rb
fixtures/
blog_comments.yml
blog_posts.yml
blog_users.yml

Setup <b>test_blog.rb</b> like this:

require 'rubygems'
require 'mosquito'
require File.dirname(__FILE__) + "/../public/blog"

Blog.create
include Blog::Models

class TestBlog < Camping::WebTest

fixtures :blog_posts, :blog_users, :blog_comments

def setup
super
# Do other stuff here
end

test "should get index" do
get
assert_response :success
assert_match_body %r!>blog<!
end

test "should get view" do
get '/view/1'
assert_response :success
assert_kind_of Article, @assigns[:article]
assert_match_body %r!The quick fox jumped over the lazy dog!
end

test "should change profile" do
@request['SERVER_NAME'] = 'jonh.blogs.net'
post '/change-profile', :new_photo => upload("picture.jpg")
assert_response :success
assert_match_body %r!The pic has been uploaded!
end
end

# A unit test
class TestPost < Camping::ModelTest

fixtures :blog_posts, :blog_users, :blog_comments

test "should create" do
post = Post.create( :user_id => 1,
:title => "Title",
:body => "Body")
assert post.valid?
end

test "should be associated with User" do
post = Post.find :first
assert_kind_of User, post.user
assert_equal 1, post.user.id
end

end

You can also use old-school methods like <tt>def test_create</tt>, but we think this way is much more natural.

Mosquito includes Jay Fields' <tt>dust</tt> gem for the nice <tt>test</tt> method which allows more descriptive test names and has the added benefit of detecting those times when you try to write two tests with the same name. Ruby will otherwise silently overwrite duplicate test names without warning, which can give a false sense of security.

== Details

Inherit from Camping::WebTest or Camping::ModelTest. If you define <tt>setup</tt>,
be sure to call <tt>super</tt> so the parent class can do its thing.

You should also call the <tt>MyApp.create</tt> method if you have one, <b>yourself</b>. You will also
need to <tt>include MyApp::Models</tt> at the top of your test file if you want to use
Models in your assertions directly (without going through MyApp::Models::SomeModel).

Make fixtures in <b>test/fixtures</b>. Remember that Camping models use the name of
the mount plus the model name: <b>blog_posts</b> for the <b>Post</b> model.

See <b>blog_test.rb</b> for an example of both Web and Model tests.

Mosquito is one file, just like your app (right?), so feel free to ship it included with the app itself
to simplify testing.

== Warning: You are Camping, not Rail-riding

These directives are highly recommended when using Mosquito:

* Test files start with <b>test_</b> (test_blog.rb). Test classes start with <b>Test</b> (TestBlog).
* Model and Controller test classes can both go in the same file.
* The popular automated test runner <tt>autotest</tt> ships with a handler for Mosquito. Install the ZenTest gem and run the <tt>autotest</tt> command in the same folder as the <tt>public</tt> and <tt>test</tt> directories.
* A Sqlite3 :memory: database is automatically used for tests that require a database.

You can run your tests by executing the test file with Ruby or by running the autotest command with no arguments (from the ZenTest gem).

ruby test/test_blog.rb

or

autotest

== RSpec

Do you prefer RSpec syntax? You can get halfway there by putting this include in your test file:

require 'spec/test_case_adapter'

Then you can use <tt>should</tt> and <tt>should_not</tt> on objects inside your tests.

== Authors

Geoffrey Grosenbach http://topfunky.com, with a supporting act
from the little fairy http://julik.nl and the evil multipart generator
conceived by http://maxidoors.ru.