unit_controller 0.1.0

data/README

@@ -0,0 +1,30 @@
+= UnitController
+
+UnitController stubs view rendering to help with unit testing controller.
+
+Loading UnitController:
+
+  gem "unit_controller"
+  require "unit_controller"
+  
+In the setup method for your test case:
+  
+  def setup
+    @controller = SampleController.new
+    @request = ActionController::TestRequest.new
+    @response = ActionController::TestResponse.new
+    @controller.do_not_render_view
+  end
+  
+
+== Development
+
+Active development occurs on the GitHub.[http://github.com/dan-manges/unit-controller] Changes are pushed to the Rubyforge git repository.
+
+== Contributors
+
+* Dan Manges
+* David Vollbracht
+
+== License
+Released under Ruby's license.[http://www.ruby-lang.org/en/LICENSE.txt]

data/Rakefile

@@ -0,0 +1,76 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rake/contrib/sshpublisher'
+
+desc "Default: run tests"
+task :default => :test
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc "Generate documentation"
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = "doc"
+  rdoc.title    = "UnitController"
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README')
+end
+
+desc "Upload RDoc to RubyForge"
+task :publish_rdoc => [:rerdoc] do
+  Rake::SshDirPublisher.new("dcmanges@rubyforge.org", "/var/www/gforge-projects/unit-controller", "doc").upload
+end
+
+require "date"
+Gem.manage_gems
+gem_spec = Gem::Specification.new do |s|
+	s.name   = "unit_controller"
+  s.summary = "UnitController assists with unit testing controllers by stubbing view rendering."
+	s.version = "0.1.0"
+	s.author = "Dan Manges"
+	s.description = s.summary
+	s.email = "daniel.manges@gmail.com"
+  s.homepage = "http://unit-controller.rubyforge.org"
+  s.rubyforge_project = "unit-controller"
+
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['README']
+  s.rdoc_options << '--title' << "UnitController" << '--main' << 'README' << '--line-numbers'
+
+  s.files = FileList['{lib,test}/**/*.rb', 'README', 'Rakefile'].to_a
+end
+Rake::GemPackageTask.new(gem_spec) do |package|
+  package.need_zip = false
+  package.need_tar = false
+end
+
+Rake::Task["gem"].prerequisites.unshift "test:multi"
+
+namespace :gemspec do
+  desc "generates unit_controller.gemspec"
+  task :generate do
+    File.open("unit_controller.gemspec", "w") do |f|
+      f.puts "# this file is generated by rake gemspec:generate for github"
+      f.write gem_spec.to_ruby
+    end
+  end
+end
+
+RAILS_VERSIONS = %w[1.2.6 2.0.2]
+
+namespace :test do
+  desc "test with multiple versions of rails"
+  task :multi do
+    RAILS_VERSIONS.each do |rails_version|
+      sh "RAILS_VERSION='#{rails_version}' rake test > /dev/null 2>&1"
+    end
+  end
+end
+
+desc "pre-commit task"
+task :pc => %w[test:multi gemspec:generate]

data/lib/unit_controller.rb

@@ -0,0 +1,5 @@
+require "unit_controller/capture_render"
+require "unit_controller/test_case_extension"
+
+ActionController::Base.send :include, UnitController::CaptureRender
+Test::Unit::TestCase.send :include, UnitController::TestCaseExtension

data/lib/unit_controller/capture_render.rb

@@ -0,0 +1,30 @@
+module UnitController
+  module CaptureRender
+    attr_reader :rendered
+    
+    def do_not_render_view
+      @render_view = false
+    end
+    
+    def render_view?
+      instance_variables.include?("@render_view") ? @render_view : true
+    end
+
+    def render_with_unit_controller(*args, &block)
+      @rendered = args.first
+      if render_view?
+        render_without_unit_controller *args, &block
+      else
+        raise ActionController::DoubleRenderError, "Can only render or redirect once per action" if performed?
+        @performed_render = true
+        response.headers["Status"] = ActionController::Base::DEFAULT_RENDER_STATUS_CODE
+      end
+    end
+    
+    def self.included(klass)
+      klass.class_eval do
+        alias_method_chain :render, :unit_controller
+      end
+    end
+  end
+end

data/lib/unit_controller/test_case_extension.rb

@@ -0,0 +1,7 @@
+module UnitController
+  module TestCaseExtension
+    def assert_rendered(options = nil, message = nil)
+      assert_equal options, @controller.rendered, message
+    end
+  end
+end

data/test/sample_controller.rb

@@ -0,0 +1,35 @@
+class SampleController < ActionController::Base
+  def double_render
+    render :text => "once"
+    render :text => "twice"
+  end
+  
+  def implicit_template
+  end
+  
+  def raise_inline
+    render :inline => "<% raise 'raise in template' %>"
+  end
+  
+  def render_then_redirect
+    render :text => "hi"
+    redirect_to :action => :text_foo
+  end
+  
+  def redirect_then_render
+    redirect_to :action => :text_foo
+    render :text => "hi"
+  end
+
+  def text_foo
+    render :text => "foo"
+  end
+end
+
+# Re-raise errors caught by the controller.
+class SampleController; def rescue_action(e) raise e end; end
+
+SampleController.instance_methods(false).each do |action|
+  ActionController::Routing::Routes.add_route \
+    "/sample/#{action}", :controller => "sample", :action => action
+end

data/test/test_case_test.rb

@@ -0,0 +1,23 @@
+require File.dirname(__FILE__) + "/test_helper"
+
+TestHelper.define_test_case do
+  test "assert_rendered" do
+    get :text_foo
+    assert_passes do
+      assert_rendered :text => "foo"
+    end
+    assert_fails do
+      assert_rendered :text => "bar"
+    end
+  end
+  
+  test "assert_rendered on implicit_template" do
+    get :implicit_template
+    assert_passes do
+      assert_rendered
+    end
+    assert_fails do
+      assert_rendered :something_that_it_didnt_render
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,62 @@
+require "rubygems"
+gem "rails", ENV["RAILS_VERSION"] || ">= 2.0.2"
+require "rails/version"
+require "action_controller"
+require "action_controller/test_process"
+
+if Rails::VERSION::MAJOR >= 2
+  require "action_controller/test_case"
+end
+
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../lib')
+require "unit_controller"
+
+require "test/unit"
+gem "dust", "0.1.6"
+require "dust"
+
+require File.dirname(__FILE__) + "/sample_controller"
+
+Test::Unit::TestCase.class_eval do
+  def assert_fails(&block)
+    assert_raises Test::Unit::AssertionFailedError, &block
+  end
+
+  def assert_passes
+    yield
+  end
+end
+
+module TestHelper
+  def self.define_test_case(&block)
+    klass = Rails::VERSION::MAJOR >= 2 ? rails2_test_case : rails1_test_case
+    klass.class_eval &block
+    klass
+  end
+  
+  def self.rails2_test_case
+    klass = Class.new(ActionController::TestCase)
+    klass.class_eval do
+      tests SampleController
+
+      def setup
+        super
+        @controller.do_not_render_view
+      end
+    end
+    klass
+  end
+  
+  def self.rails1_test_case
+    klass = Class.new(Test::Unit::TestCase)
+    klass.class_eval do
+      def setup
+        @controller = SampleController.new
+        @request = ActionController::TestRequest.new
+        @response = ActionController::TestResponse.new
+        @controller.do_not_render_view
+      end
+    end
+    klass
+  end
+end

data/test/unit_controller_test.rb

@@ -0,0 +1,47 @@
+require File.dirname(__FILE__) + "/test_helper"
+
+TestHelper.define_test_case do
+  test "action that has view that raises" do
+    assert_nothing_raised do
+      get :raise_inline
+    end
+  end
+  
+  test "assert_response :success works" do
+    get :implicit_template
+    assert_response :success
+  end
+  
+  test "raise on double render" do
+    assert_raises(ActionController::DoubleRenderError) do
+      get :double_render
+    end
+  end
+
+  test "raise on render then redirect" do
+    assert_raises(ActionController::DoubleRenderError) do
+      get :render_then_redirect
+    end
+  end
+
+  test "raise on redirect then render" do
+    assert_raises(ActionController::DoubleRenderError) do
+      get :redirect_then_render
+    end
+  end
+  
+  test "controller remembers what it renders even if rendering view" do
+    @controller = @controller.class.new
+    assert_equal true, @controller.render_view?
+    get :text_foo
+    assert_rendered :text => "foo"
+    assert_equal "foo", @response.body
+  end
+  
+  test "render_view?" do
+    @controller = @controller.class.new
+    assert_equal true, @controller.render_view?
+    @controller.do_not_render_view
+    assert_equal false, @controller.render_view?
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: unit_controller
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Dan Manges
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-05-31 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: UnitController assists with unit testing controllers by stubbing view rendering.
+email: daniel.manges@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- lib/unit_controller/capture_render.rb
+- lib/unit_controller/test_case_extension.rb
+- lib/unit_controller.rb
+- test/sample_controller.rb
+- test/test_case_test.rb
+- test/test_helper.rb
+- test/unit_controller_test.rb
+- README
+- Rakefile
+has_rdoc: true
+homepage: http://unit-controller.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --title
+- UnitController
+- --main
+- README
+- --line-numbers
+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: unit-controller
+rubygems_version: 1.1.1
+signing_key: 
+specification_version: 2
+summary: UnitController assists with unit testing controllers by stubbing view rendering.
+test_files: []
+