Sinatra::Tests

A Sinatra extension and repository of common RSpec helpers when testing your Sinatra apps/gems.

Installation

#  Add Gemcutter to your RubyGems sources 
$  gem sources -a http://gemcutter.com

$  (sudo)? gem install sinatra-tests

Dependencies

This Gem depends upon the following:

• sinatra ( >= 0.10.1 )
• rspec (>= 1.3.0 )
• rack-test (>= 0.5.3)
• rspec_hpricot_matchers (>= 0.1.0)

Getting Started

Step 1

In your spec/spec_helper.rb file add the following:

require 'sinatra/tests'

By just requiring that gem, you essentially get all of this:

require 'sinatra/base'
require 'test/unit'
require 'rack/test'
require 'spec'
require 'spec/interop/test'
require 'rspec_hpricot_matchers'

and a few other goodies.

Step 2

Declare the following Spec block:

Spec::Runner.configure do |config|
config.include RspecHpricotMatchers
config.include Sinatra::Tests::TestCase
config.include Sinatra::Tests::RSpec::SharedSpecs
end

Step 3

In your TestApp block, register the Sinatra::Tests extension, by adding the following:

class MyTestApp < Sinatra::Base 

register(Sinatra::Tests)

<snip...>
end

Step 4

And finally define the TestCase block like this:

class Test::Unit::TestCase 
Sinatra::Base.set :environment, :test
end

That's all. Now onto the niceties this provides you.

USAGE

RSpec Matchers

:be_even

A simple matcher that tests for an even number

1.should_not be_even
2.should be_even

:have_a_page_title(:title_text)

A simple matcher that tests for a with a