test_spec_on_rails 1.1.0

data/.gitignore

@@ -0,0 +1,5 @@
+.svn
+<<<<<<< HEAD:.gitignore
+=======
+.svn/*
+>>>>>>> b5e4da7269801960e95c60b3aa6e3b95d4f3dd77:.gitignore

data/CHANGELOG

@@ -0,0 +1,21 @@
+12/03/09 - Is now a gem [Matthew Bass]
+
+07/01/08 - should.render now takes optional response code [Matthew Bass]
+
+06/28/08 - Added should.render for testing template rendering [Matthew Bass]
+
+05/15/08 - First pass at overriding generators to produce specs [Matthew Bass]
+
+03/18/08 - it_should_validate_presence_of helper added [Matthew Bass]
+
+03/12/08 - layout.should.be nil is now supported [Rob Sanheim]
+
+03/11/08 - Added content_type attr to dummy response for Rails 2.0 [Jason Rudolph]
+
+03/06/08 - Added should.differ(:method).by wrapper for assert_difference [Matthew Bass]
+
+02/18/08 - Added Rakefile, began adding tests [Matthew Bass]
+
+02/08/08 - Added support for route checking (i.e. assert_generates) [Jason Rudolph]
+
+01/10/08 - Added CHANGELOG and LICENSE [Matthew Bass]

data/README.markdown

@@ -0,0 +1,247 @@
+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
+
+
+Dependencies
+------------
+
+If you want to run the plugin's tests, you'll need these gems:
+
+ * multi_rails
+ * mocha
+
+Then run "rake test:multi_rails:all" from the root of the project. The tests will be
+executed against each version of Rails you have installed on your system.
+
+
+Source
+------
+
+  test/spec/rails uses Git for source control. If you're running edge Rails you can install with:
+
+      script/plugin install git://github.com/pelargir/test_spec_on_rails.git
+
+  Otherwise just clone the project directly:
+
+      git clone git://github.com/pelargir/test_spec_on_rails.git vendor/plugins/test_spec_on_rails
+
+
+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">
+      # you can also do:
+      page.should.have "form#user_form"
+      page.should.contain "form#user_form"
+      
+      page.should.select "form#user_form" do |form|
+        # the user_form must include a <input type="submit">
+        form.should.select "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 # => you can also do use_controller :foo
+    
+        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
+
+
+Convenience and Shortcut methods
+--------------------------------
+
+Typing in should.not.be.nil all the time can be tiresome and overwhelming, here are some shortcuts that you can use.
+
+    INSTEAD OF:
+    
+      assigns(:var).should.not.be.nil
+    
+    DO:
+  
+      has(:var) # => assigns(:var).should.not.be.nil
+    
+    OR pass multiple variables to test:
+    
+      has :var, :page_title # => assigns(:var).should.not.be.nil
+                            # => assigns(:page_title).should.not.be.nil
+
+Likewise you can test for the non existence of the variable using cant_have :
+
+   INSTEAD OF:
+   
+      assigns(:var).should.be.nil
+      
+   DO:    
+   
+      cant_have :var
+      
+   OR pass multiple variables to test:
+  
+      cant_have :var, :page_title
+  
+Shortcuts for checking on flash values:
+
+   INSTEAD OF:
+    
+      flash[:notice].should.not.be.nil
+      
+   DO: 
+    
+      has_flash :notice
+
+Sometimes you might want to set the HTTP_REFERER variable when testing response.should.redirect, here's
+an easy way to do it:
+
+    set_redirect_back "/your/path"
+    
+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>

data/Rakefile

@@ -0,0 +1,40 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'load_multi_rails_rake_tasks'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the test_spec_on_rails plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the test_spec_on_rails plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ResponseVisualizer'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "test_spec_on_rails"
+    gemspec.summary = "Provides helpers to test your Rails app using test/spec."
+    gemspec.description = "Provides helpers to test your Rails app using test/spec."
+    gemspec.email = "pelargir@gmail.com"
+    gemspec.homepage = "http://github.com/pelargir/test_spec_on_rails"
+    gemspec.authors = ["Matthew Bass"]
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/VERSION

@@ -0,0 +1 @@
+1.1.0

data/lib/generators/controller/USAGE

@@ -0,0 +1,29 @@
+Description:
+    Stubs out a new controller and its views. Pass the controller name, either
+    CamelCased or under_scored, and a list of views as arguments.
+
+    To create a controller within a module, specify the controller name as a
+    path like 'parent_module/controller_name'.
+
+    This generates a controller class in app/controllers, view templates in
+    app/views/controller_name, a helper class in app/helpers, and a functional
+    test suite in test/functional.
+
+Example:
+    `./script/generate controller CreditCard open debit credit close`
+
+    Credit card controller with URLs like /credit_card/debit.
+        Controller: app/controllers/credit_card_controller.rb
+        Views:      app/views/credit_card/debit.html.erb [...]
+        Helper:     app/helpers/credit_card_helper.rb
+        Test:       test/functional/credit_card_controller_test.rb
+
+Modules Example:
+    `./script/generate controller 'admin/credit_card' suspend late_fee`
+
+    Credit card admin controller with URLs /admin/credit_card/suspend.
+        Controller: app/controllers/admin/credit_card_controller.rb
+        Views:      app/views/admin/credit_card/debit.html.erb [...]
+        Helper:     app/helpers/admin/credit_card_helper.rb
+        Test:       test/functional/admin/credit_card_controller_test.rb
+

data/lib/generators/controller/controller_generator.rb

@@ -0,0 +1,37 @@
+class ControllerGenerator < Rails::Generator::NamedBase
+  def manifest
+    record do |m|
+      # Check for class naming collisions.
+      m.class_collisions class_path, "#{class_name}Controller", "#{class_name}ControllerTest", "#{class_name}Helper"
+
+      # Controller, helper, views, and test directories.
+      m.directory File.join('app/controllers', class_path)
+      m.directory File.join('app/helpers', class_path)
+      m.directory File.join('app/views', class_path, file_name)
+      m.directory File.join('test/functional', class_path)
+
+      # Controller class, functional test, and helper class.
+      m.template 'controller.rb',
+                  File.join('app/controllers',
+                            class_path,
+                            "#{file_name}_controller.rb")
+
+      m.template 'functional_test.rb',
+                  File.join('test/functional',
+                            class_path,
+                            "#{file_name}_controller_test.rb")
+
+      m.template 'helper.rb',
+                  File.join('app/helpers',
+                            class_path,
+                            "#{file_name}_helper.rb")
+
+      # View template for each action.
+      actions.each do |action|
+        path = File.join('app/views', class_path, file_name, "#{action}.html.erb")
+        m.template 'view.html.erb', path,
+          :assigns => { :action => action, :path => path }
+      end
+    end
+  end
+end

data/lib/generators/controller/templates/controller.rb

@@ -0,0 +1,10 @@
+class <%= class_name %>Controller < ApplicationController
+<% if options[:scaffold] -%>
+  scaffold :<%= singular_name %>
+<% end -%>
+<% for action in actions -%>
+
+  def <%= action %>
+  end
+<% end -%>
+end

data/lib/generators/controller/templates/functional_test.rb

@@ -0,0 +1,8 @@
+require File.dirname(__FILE__) + '<%= '/..' * class_nesting_depth %>/../test_helper'
+
+describe "<%= class_name %>Controller", ActionController::TestCase do
+  # Replace this with your real tests.
+  it "should be true" do
+    assert true
+  end
+end

data/lib/generators/controller/templates/helper.rb

@@ -0,0 +1,2 @@
+module <%= class_name %>Helper
+end

data/lib/generators/controller/templates/view.html.erb

@@ -0,0 +1,2 @@
+<h1><%= class_name %>#<%= action %></h1>
+<p>Find me in <%= path %></p>

data/lib/generators/model/USAGE

@@ -0,0 +1,27 @@
+Description:
+    Stubs out a new model. Pass the model name, either CamelCased or
+    under_scored, and an optional list of attribute pairs as arguments.
+
+    Attribute pairs are column_name:sql_type arguments specifying the
+    model's attributes. Timestamps are added by default, so you don't have to
+    specify them by hand as 'created_at:datetime updated_at:datetime'.
+
+    You don't have to think up every attribute up front, but it helps to
+    sketch out a few so you can start working with the model immediately.
+
+    This generates a model class in app/models, a unit test in test/unit,
+    a test fixture in test/fixtures/singular_name.yml, and a migration in
+    db/migrate.
+
+Examples:
+    `./script/generate model account`
+
+        creates an Account model, test, fixture, and migration:
+            Model:      app/models/account.rb
+            Test:       test/unit/account_test.rb
+            Fixtures:   test/fixtures/accounts.yml
+            Migration:  db/migrate/XXX_add_accounts.rb
+
+    `./script/generate model post title:string body:text published:boolean`
+
+        creates a Post model with a string title, text body, and published flag.

data/lib/generators/model/model_generator.rb

@@ -0,0 +1,45 @@
+class ModelGenerator < Rails::Generator::NamedBase
+  default_options :skip_timestamps => false, :skip_migration => false, :skip_fixture => false
+
+  def manifest
+    record do |m|
+      # Check for class naming collisions.
+      m.class_collisions class_path, class_name, "#{class_name}Test"
+
+      # Model, test, and fixture directories.
+      m.directory File.join('app/models', class_path)
+      m.directory File.join('test/unit', class_path)
+      m.directory File.join('test/fixtures', class_path)
+
+      # Model class, unit test, and fixtures.
+      m.template 'model.rb',      File.join('app/models', class_path, "#{file_name}.rb")
+      m.template 'unit_test.rb',  File.join('test/unit', class_path, "#{file_name}_test.rb")
+
+      unless options[:skip_fixture] 
+       	m.template 'fixtures.yml',  File.join('test/fixtures', "#{table_name}.yml")
+      end
+
+      unless options[:skip_migration]
+        m.migration_template 'migration.rb', 'db/migrate', :assigns => {
+          :migration_name => "Create#{class_name.pluralize.gsub(/::/, '')}"
+        }, :migration_file_name => "create_#{file_path.gsub(/\//, '_').pluralize}"
+      end
+    end
+  end
+
+  protected
+    def banner
+      "Usage: #{$0} #{spec.name} ModelName [field:type, field:type]"
+    end
+
+    def add_options!(opt)
+      opt.separator ''
+      opt.separator 'Options:'
+      opt.on("--skip-timestamps",
+             "Don't add timestamps to the migration file for this model") { |v| options[:skip_timestamps] = v }
+      opt.on("--skip-migration", 
+             "Don't generate a migration file for this model") { |v| options[:skip_migration] = v }
+      opt.on("--skip-fixture",
+             "Don't generation a fixture file for this model") { |v| options[:skip_fixture] = v}
+    end
+end

data/lib/generators/model/templates/fixtures.yml

@@ -0,0 +1,19 @@
+# Read about fixtures at http://ar.rubyonrails.org/classes/Fixtures.html
+
+<% unless attributes.empty? -%>
+one:
+<% for attribute in attributes -%>
+  <%= attribute.name %>: <%= attribute.default %>
+<% end -%>
+
+two:
+<% for attribute in attributes -%>
+  <%= attribute.name %>: <%= attribute.default %>
+<% end -%>
+<% else -%>
+# one:
+#   column: value
+#
+# two:
+#   column: value
+<% end -%>

data/lib/generators/model/templates/migration.rb

@@ -0,0 +1,16 @@
+class <%= migration_name %> < ActiveRecord::Migration
+  def self.up
+    create_table :<%= table_name %> do |t|
+<% for attribute in attributes -%>
+      t.<%= attribute.type %> :<%= attribute.name %>
+<% end -%>
+<% unless options[:skip_timestamps] %>
+      t.timestamps
+<% end -%>
+    end
+  end
+
+  def self.down
+    drop_table :<%= table_name %>
+  end
+end

data/lib/generators/model/templates/model.rb

@@ -0,0 +1,2 @@
+class <%= class_name %> < ActiveRecord::Base
+end

data/lib/generators/model/templates/unit_test.rb

@@ -0,0 +1,8 @@
+require File.dirname(__FILE__) + '<%= '/..' * class_nesting_depth %>/../test_helper'
+
+describe "<%= class_name %>", ActiveSupport::TestCase do
+  # Replace this with your real tests.
+  it "should be true" do
+    assert true
+  end
+end

data/lib/test/spec/rails.rb

@@ -0,0 +1,30 @@
+require 'test/spec'
+
+module Test::Spec::Rails
+  VERSION = "0.1"
+end
+
+%w(
+  test_spec_ext
+  test_unit_ext
+  
+  test_dummy
+  dummy_response
+  test_status
+  test_template
+  test_layout
+  
+  should_redirect
+  should_render
+  should_route
+  should_select
+  should_validate
+  should_validate_presence_of
+  
+  use_controller
+  
+  convenience
+  
+).each do |file|
+  require "test/spec/rails/#{file}"
+end

data/lib/test/spec/rails/convenience.rb

@@ -0,0 +1,38 @@
+module Convenience
+  # convenience helpers, these methods are basically shortcuts to the should methods
+  
+  # shortcut for should.not.be.nil
+  # has :page_title => assigns(:page_title).should.not.be.nil
+  # OR you can also pass an array of values 
+  # has :page_title, :user # => assigns(:page_title).should.not.be.nil
+                           # => assigns(:user).should.not.be.nil 
+  def has(*var)
+    return assigns(var).should.not.be.nil if var.length == 1
+    var.each { |v| assigns(v).should.not.be.nil }
+  end
+
+  # shortcut for should.be.nil
+  # cant_have :page_title => assigns(:page_title).should.be.nil
+  # OR you can pass an array of values
+  # cant_have :page_title, :user # => assigns(:page_title).should.be.nil
+                                 # => assigns(:user).should.be.nil
+  def cant_have(*var)
+    return assigns(var).should.be.nil if var.length == 1
+    var.each { |v| assigns(v).should.be.nil }
+  end
+  
+  # shortcut for flash[:type].should.not.be.nil
+  # has_flash :notice => assigns(flash[:notice]).should.not.be.nil
+  def has_flash(flash_type)
+    flash[flash_type].should.not.be.nil
+  end
+  
+  # shortcut for setting the HTTP_REFERER variable
+  # set_redirect_back '/users'
+  def set_redirect_back(path="/back/to/path")
+     @request.env["HTTP_REFERER"] = path
+  end
+  
+end
+
+Test::Unit::TestCase.send(:include, Convenience)

data/lib/test/spec/rails/dummy_response.rb

@@ -0,0 +1,21 @@
+module Test::Spec::Rails
+  class DummyResponse < TestDummy
+
+    attr_reader :body, :headers, :content_type
+
+    def initialize(body, headers=nil)
+      if headers.nil?
+        response = body.instance_variable_get('@response')
+        @body, @headers = response.body, response.headers
+      else
+        @body, @headers = body, headers
+      end
+      @response = self
+    end
+    
+    def html_document
+      @html_document ||= HTML::Document.new(@body)
+    end
+    
+  end
+end

data/lib/test/spec/rails/should_redirect.rb

@@ -0,0 +1,33 @@
+module Test::Spec::Rails::ShouldRedirect
+  # Test that we were redirected somewhere:
+  #   request.should.redirect
+  #
+  # Test that we were redirected to a specific url:
+  #   request.should.redirect :controller => 'foo', :action => 'bar'
+  # or:
+  #   request.should.be.redirected foo_url(@foo)
+  #
+  def redirect(options = {})
+    if options.empty?
+      @object.assert_response :redirect
+    else
+      @object.assert_redirected_to options
+    end
+  end
+  alias :redirect_to   :redirect
+  alias :redirected    :redirect
+  alias :redirected_to :redirect
+end
+
+module Test::Spec::Rails::ShouldNotRedirect
+  # Test that we weren't redirected
+  def redirect(options = {})
+    @object.assert_response :success
+  end
+  alias :redirect_to   :redirect
+  alias :redirected    :redirect
+  alias :redirected_to :redirect
+end
+
+Test::Spec::Should.send(:include, Test::Spec::Rails::ShouldRedirect)
+Test::Spec::ShouldNot.send(:include, Test::Spec::Rails::ShouldNotRedirect)

data/lib/test/spec/rails/should_render.rb

@@ -0,0 +1,25 @@
+module Test::Spec::Rails::ShouldRender
+  # Test that something was rendered:
+  #   request.should.render
+  #
+  # Test that a specific template was rendered:
+  #   request.should.render 'foo'
+  #
+  # Test that a template was rendered with a specific response code:
+  #   request.should.render 'foo', :error
+  #
+  def render(template = '', response = :success)
+    @object.assert_response response
+    @object.assert_template template unless template.blank?
+  end
+end
+
+module Test::Spec::Rails::ShouldNotRender
+  # Test that we didn't render
+  def render(template = '', response = :success)
+    @object.assert_response :redirect
+  end
+end
+
+Test::Spec::Should.send(:include, Test::Spec::Rails::ShouldRender)
+Test::Spec::ShouldNot.send(:include, Test::Spec::Rails::ShouldNotRender)

data/lib/test/spec/rails/should_route.rb

@@ -0,0 +1,34 @@
+module Test::Spec::Rails::ShouldRoute
+  # Specify that a set of url options route to a path.
+  # This translates directly to assert_generates 
+  # Example:
+  #     {:controller => "items", :action => "show", :id =>"1"}.should.route_to "/items/1"  
+  # 
+  # See also http://api.rubyonrails.org/classes/ActionController/Assertions/RoutingAssertions.html#M000367
+  def route_to(options)
+    assert_generates(options, @object)
+  end
+
+  # Specify that a path should be routable from a set of url options.
+  # This translates directly to assert_recognizes 
+  # Examples:
+  #     {:path => "/items/1", :method => :get}.should.route_from :controller => "items", :action => "show", :id =>"1"
+  #     {:path => "/items/1?print=true", :method => :get}.should.route_from({:controller => "items", :action => "show", :id =>"1"}, {:print => true})
+  #
+  # See also http://api.rubyonrails.org/classes/ActionController/Assertions/RoutingAssertions.html#M000366
+  def route_from(options, extras={})
+    assert_recognizes(options, @object, extras)
+  end
+  
+  # Specify that a path should be routable from a set of url options and vice versa.
+  # This translates directly to assert_routing 
+  # Examples:
+  #     "/items/1".should.route :controller => "items", :action => "show", :id =>"1"
+  #
+  # See also http://api.rubyonrails.org/classes/ActionController/Assertions/RoutingAssertions.html#M000368
+  def route(options)
+    assert_routing(@object, options)
+  end
+end
+
+Test::Spec::Should.send(:include, Test::Spec::Rails::ShouldRoute)

data/lib/test/spec/rails/should_select.rb

@@ -0,0 +1,53 @@
+module Test::Spec::Rails::ShouldSelect
+  # Wrapper for +assert_select+. Examples:
+  #
+  # Test that the previous request has a login form:
+  #   page.should.select "form#login"
+  #
+  # Test that a specific form has a field pre-filled (this is specific test/spec/rails):
+  #   page.should.select "form#login" do |form|
+  #     form.should.select "input[name=user_nick]", :text => @user.nick
+  #   end
+  # 
+  #  OR you can use contain
+  #   page.should.contain "form#login"
+  # 
+  #   page.should.contain "form#login" do |form|
+  #     form.should.contain "input[name=user_nick]", :text => @user.nick
+  #   end
+  #
+  # See the Rails API documentation for assert_select for more information
+  def select(selector, equality=true, message=nil, &block)
+    @@response_stack ||= []
+    
+    if @object.is_a?(Test::Unit::TestCase)
+      @@response_stack.push(Test::Spec::Rails::DummyResponse.new(@object))
+      
+    elsif @object.is_a?(Array) && @object.first.is_a?(HTML::Tag)
+      @@response_stack.push(Test::Spec::Rails::DummyResponse.new(
+        @object.first.to_s, @@response_stack.last.headers
+      ))
+    else
+      @@response_stack.push(Test::Spec::Rails::DummyResponse.new(@object.to_s,
+        (@@response_stack.last.headers rescue 'Content-Type: text/html; charset=utf8')
+      ))
+    end
+    
+    @@response_stack.last.assert_select(selector, equality, message, &block)
+    @@response_stack.pop
+  end
+  
+  # because contain sounds better imo
+  alias :contain :select
+  alias :have :select
+end
+
+module Test::Spec::Rails::ShouldNotSelect
+  include Test::Spec::Rails::ShouldSelect
+  def select(selector, message=nil, &block)
+    super(selector, false, message, &block)
+  end
+end
+
+Test::Spec::Should.send(:include, Test::Spec::Rails::ShouldSelect)
+Test::Spec::ShouldNot.send(:include, Test::Spec::Rails::ShouldNotSelect)

data/lib/test/spec/rails/should_validate.rb

@@ -0,0 +1,16 @@
+module Test::Spec::Rails::ShouldValidate
+  def validate
+    assert @object.valid?
+  end
+  alias :validated :validate
+end
+
+module Test::Spec::Rails::ShouldNotValidate
+  def validate
+    assert !@object.valid?
+  end
+  alias :validated :validate
+end
+
+Test::Spec::Should.send(:include, Test::Spec::Rails::ShouldValidate)
+Test::Spec::ShouldNot.send(:include, Test::Spec::Rails::ShouldNotValidate)

data/lib/test/spec/rails/should_validate_presence_of.rb

@@ -0,0 +1,27 @@
+module Test::Spec::Rails::ShouldValidatePresenceOf
+  def it_should_validate_presence_of(*one_or_more_fields)
+    model_name = self.model_class_under_test
+    options = one_or_more_fields.last.is_a?(Hash) ? one_or_more_fields.pop : {}
+  
+    one_or_more_fields.each do |field|
+      it "should validate presence of #{field.to_s.humanize.downcase}" do
+        validations = model_name.reflect_on_all_validations
+        validations = validations.select { |e| e.macro == :validates_presence_of }
+        validations = validations.inject({}) { |h,v| h[v.name] = v; h }
+      
+        validation = validations[field]
+        assert_not_nil validation, "Expected validates_presence_of to be called on :#{field}, but it wasn't"
+        options.each_pair do |k,v|
+          assert_equal v, validation.options[k],
+            "Expected validates_presence_of to set :#{k} => :#{v} as an option, but it didn't"
+        end
+      end
+    end
+  end
+  
+  def model_class_under_test
+    name.constantize
+  end
+end
+
+Test::Unit::TestCase.send(:extend, Test::Spec::Rails::ShouldValidatePresenceOf)

data/lib/test/spec/rails/test_dummy.rb

@@ -0,0 +1,46 @@
+# Base class for testcase/response/request/controller mocks
+class Test::Spec::Rails::TestDummy
+  include Test::Unit::Assertions
+  
+  if defined?(ActionController::TestCase::Assertions)
+    include ActionController::TestCase::Assertions
+  end
+  
+  # Rails > 2 moved Assertions module to the ActionController class
+  if defined?(ActionController::Assertions)
+    include ActionController::Assertions
+  end
+
+  def initialize(testcase)
+    @controller = testcase.instance_variable_get('@controller')
+    @request    = testcase.instance_variable_get('@request')
+    @response   = testcase.instance_variable_get('@response')
+  end
+  
+  def inspect
+    "<#{self.class}:#{self.to_s}>"
+  end
+    
+  def method_missing(method, *args, &block)
+    if real_response.respond_to?(method)
+      real_response.send(method, *args, &block)
+    elsif real_request.respond_to?(method)
+      real_request.send(method, *args, &block)
+    elsif real_controller.respond_to?(method)
+      real_controller.send(method, *args, &block)
+    else
+      super
+    end
+  end
+
+  def real_response
+    @response unless @response == self
+  end
+  def real_request
+    @request unless @request == self
+  end
+  def real_controller
+    @controller unless @controller == self
+  end
+
+end

data/lib/test/spec/rails/test_layout.rb

@@ -0,0 +1,15 @@
+module Test::Spec::Rails
+  class TestLayout < TestDummy
+
+    def should_equal(expected, message=nil)
+      layout = @response.layout.gsub(/layouts\//, '') if @response.layout
+      assert_equal expected, layout, message
+    end
+    alias :should_be :should_equal
+    
+    def to_s
+      @response.rendered_file
+    end
+    
+  end
+end

data/lib/test/spec/rails/test_spec_ext.rb

@@ -0,0 +1,48 @@
+class Test::Spec::Should
+  include Test::Unit::Assertions
+  
+  if defined?(ActionController::TestCase::Assertions)
+    include ActionController::TestCase::Assertions
+  end
+  
+  alias :_old_equal :equal
+  def equal(*args)
+    @object.respond_to?(:should_equal) ? @object.should_equal(*args) : _old_equal(*args)
+  end
+
+  alias :_old_be :be
+  def be(*args)
+    @object.respond_to?(:should_equal) ? @object.should_equal(*args) : _old_be(*args)
+  end
+  
+  alias :have :be
+  
+  def differ(method)
+    @initial_value = @object.send(@method = method)
+    self
+  end
+
+  def by(value)
+    yield
+    # TODO: this should use should_equal if available
+    assert_equal @initial_value + value, @object.send(@method)
+  end
+end
+
+class Test::Spec::ShouldNot
+  include Test::Unit::Assertions
+  
+  if defined?(ActionController::TestCase::Assertions)
+    include ActionController::TestCase::Assertions
+  end
+  
+  alias :_old_equal :equal
+  def equal(*args,&block)
+    @object.respond_to?(:should_not_equal) ? @object.should_not_equal(*args,&block) : _old_equal(*args,&block)
+  end
+
+  alias :_old_be :be
+  def be(*args,&block)
+    @object.respond_to?(:should_not_equal) ? @object.should_not_equal(*args,&block) : _old_be(*args,&block)
+  end
+end

data/lib/test/spec/rails/test_status.rb

@@ -0,0 +1,15 @@
+module Test::Spec::Rails
+  class TestStatus < TestDummy
+
+    def should_equal(status, message=nil)
+      assert_response status, message
+    end
+    alias :should_be :should_equal
+    
+    def to_s
+      @response.response_code.to_s
+    end
+
+  end
+end
+

data/lib/test/spec/rails/test_template.rb

@@ -0,0 +1,14 @@
+module Test::Spec::Rails
+  class TestTemplate < TestDummy
+
+    def should_equal(template, message=nil)
+      assert_template template, message
+    end
+    alias :should_be :should_equal
+    
+    def to_s
+      @response.rendered_file
+    end
+    
+  end
+end

data/lib/test/spec/rails/test_unit_ext.rb

@@ -0,0 +1,32 @@
+class Test::Unit::TestCase
+  def page #:nodoc:
+    self
+  end
+  alias :response :page
+  alias :request  :page
+  alias :view     :page
+  
+  def output
+    @response.body
+  end
+  alias :to_s  :output
+  alias :body  :output
+  alias :html  :output
+  alias :xhtml :output
+  
+  def url
+    Test::Spec::Rails::TestUrl.new(self)
+  end
+  
+  def status
+    Test::Spec::Rails::TestStatus.new(self)
+  end
+  
+  def template
+    Test::Spec::Rails::TestTemplate.new(self)
+  end
+  
+  def layout
+    Test::Spec::Rails::TestLayout.new(self)
+  end  
+end

data/lib/test/spec/rails/test_url.rb

@@ -0,0 +1,25 @@
+module Test::Spec::Rails
+  class TestUrl < TestDummy
+
+    def initialize(testcase)
+      super(testcase)
+      @params = @request.symbolized_path_parameters
+      @path   = @request.path
+    end
+
+    def should_equal(wanted, defaults={}, extras={}, message=nil)
+      if wanted.is_a?(Hash)
+        assert_recognizes(wanted, @path, defaults, message)
+      else
+        assert_generates(wanted, @params, defaults, extras, message)
+      end
+    end
+    alias :should_be :should_equal
+    
+    def to_s
+      @path
+    end
+
+  end
+end
+

data/lib/test/spec/rails/use_controller.rb

@@ -0,0 +1,51 @@
+module Test::Spec::Rails::UseController
+  module InstanceMethod
+    # Setup controller for tests.
+    # For example:
+    #   context "Tuxie" do
+    #     setup do 
+    #       use_controller UsersController
+    #       login_as users(:tuxie)
+    #     end
+    #     specify "should be able to see his profile" { ... }
+    #   end
+    
+    # OR
+    # to save some keystrokes you can use a symbolized version of the controller name
+    # without the 'Controller' suffix
+    # For example:
+    #   context "Tuxie" do
+    #     setup do 
+    #       use_controller :users
+    #       login_as :tuxie
+    #     end
+    #     specify "should be able to see his profile" { ... }
+    #   end
+
+    def use_controller(controller)
+      controller = eval("#{controller.to_s.camelize}Controller") if controller.is_a? Symbol
+      controller.class_eval { def rescue_action(e); raise e; end }
+      @controller = controller.new
+      @request    = ActionController::TestRequest.new
+      @response   = ActionController::TestResponse.new
+    end
+  end
+
+  module ClassMethod
+    # Setup context for controller testing. For example:
+    #   context "If not logged in" do
+    #     use_controller SessionsController
+    #     specify "one should see the login box" do
+    #       get :new
+    #       page.should.select "form#login"
+    #     end
+    #   end
+    def use_controller(controller)
+      setups << lambda { use_controller(controller) }
+    end
+  end
+end
+
+
+Test::Spec::TestCase::ClassMethods.send(:include, Test::Spec::Rails::UseController::ClassMethod)
+Test::Unit::TestCase.send(:include, Test::Spec::Rails::UseController::InstanceMethod)

data/tasks/spec.rake

@@ -0,0 +1,15 @@
+desc "Show specs when testing"
+task :spec do
+  ENV['TESTOPTS'] = '--runner=s'
+  Rake::Task[:test].invoke
+end
+
+%w(functionals units integration).each do |type|
+  namespace :spec do
+    desc "Show specs when testing #{type}"
+    task type do
+      ENV['TESTOPTS'] = '--runner=s'
+      Rake::Task["test:#{type}"].invoke
+    end
+  end
+end

data/test/test/spec/rails/test_status_test.rb

@@ -0,0 +1,22 @@
+require File.dirname(__FILE__) + '/../../../test_helper'
+
+describe "TestStatus" do
+  it "should call assert_response" do
+    status = Test::Spec::Rails::TestStatus.new(stub_everything)
+    status.expects(:assert_response).with(:success, nil)
+    status.should_equal :success
+  end
+  
+  it "should call assert_response with message" do
+    status = Test::Spec::Rails::TestStatus.new(stub_everything)
+    status.expects(:assert_response).with(:success, "Response should be successful")
+    status.should_equal :success, "Response should be successful"
+  end
+  
+  it "should return response code" do
+    status = Test::Spec::Rails::TestStatus.new(stub_everything)
+    status.class.class_eval { attr_accessor :response }
+    status.response.expects(:response_code).returns("200")
+    status.to_s.should == "200"
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,6 @@
+require 'rubygems'
+require 'multi_rails_init'
+
+$LOAD_PATH << File.dirname(__FILE__) + '/../lib'
+require 'test/spec/rails'
+require 'mocha'

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: test_spec_on_rails
+version: !ruby/object:Gem::Version 
+  version: 1.1.0
+platform: ruby
+authors: 
+- Matthew Bass
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-03 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Provides helpers to test your Rails app using test/spec.
+email: pelargir@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- .gitignore
+- CHANGELOG
+- README.markdown
+- Rakefile
+- VERSION
+- lib/generators/controller/USAGE
+- lib/generators/controller/controller_generator.rb
+- lib/generators/controller/templates/controller.rb
+- lib/generators/controller/templates/functional_test.rb
+- lib/generators/controller/templates/helper.rb
+- lib/generators/controller/templates/view.html.erb
+- lib/generators/model/USAGE
+- lib/generators/model/model_generator.rb
+- lib/generators/model/templates/fixtures.yml
+- lib/generators/model/templates/migration.rb
+- lib/generators/model/templates/model.rb
+- lib/generators/model/templates/unit_test.rb
+- lib/test/spec/rails.rb
+- lib/test/spec/rails/convenience.rb
+- lib/test/spec/rails/dummy_response.rb
+- lib/test/spec/rails/should_redirect.rb
+- lib/test/spec/rails/should_render.rb
+- lib/test/spec/rails/should_route.rb
+- lib/test/spec/rails/should_select.rb
+- lib/test/spec/rails/should_validate.rb
+- lib/test/spec/rails/should_validate_presence_of.rb
+- lib/test/spec/rails/test_dummy.rb
+- lib/test/spec/rails/test_layout.rb
+- lib/test/spec/rails/test_spec_ext.rb
+- lib/test/spec/rails/test_status.rb
+- lib/test/spec/rails/test_template.rb
+- lib/test/spec/rails/test_unit_ext.rb
+- lib/test/spec/rails/test_url.rb
+- lib/test/spec/rails/use_controller.rb
+- tasks/spec.rake
+- test/test/spec/rails/test_status_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/pelargir/test_spec_on_rails
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Provides helpers to test your Rails app using test/spec.
+test_files: 
+- test/test/spec/rails/test_status_test.rb
+- test/test_helper.rb