shoulda-matchers 1.0.0.beta1

data/CONTRIBUTION_GUIDELINES.rdoc

@@ -0,0 +1,10 @@
+We're using GitHub[http://github.com/thoughtbot/shoulda/tree/master], and we've been getting any combination of github pull requests, tickets, patches, emails, etc.  We need to normalize this workflow to make sure we don't miss any fixes.
+
+* Make sure you're accessing the source from the {official repository}[http://github.com/thoughtbot/shoulda/tree/master].
+* We prefer git branches over patches, but we can take either.
+* If you're using git, please make a branch for each separate contribution.  We can cherry pick your commits, but pulling from a branch is easier.
+* If you're submitting patches, please cut each fix or feature into a separate patch.
+* There should be an issue[http://github.com/thoughtbot/shoulda/issues] for any submission.  If you've found a bug and want to fix it, open a new ticket at the same time.
+* Please <b>don't send pull requests</b>  Just update the issue with the url for your fix (or attach the patch) when it's ready.  The github pull requests pretty much get dropped on the floor until someone with commit rights notices them in the mailbox.
+* Contributions without tests won't be accepted.  The file <tt>/test/README</tt> explains the testing system pretty thoroughly.
+

data/Gemfile

@@ -0,0 +1,10 @@
+source 'http://rubygems.org'
+
+gem 'rails', '3.0.3'
+gem 'sqlite3-ruby', :require => 'sqlite3'
+gem 'mocha'
+gem 'rspec-rails'
+gem 'ruby-debug'
+gem 'cucumber'
+gem "aruba"
+

data/Gemfile.lock

@@ -0,0 +1,116 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    actionmailer (3.0.3)
+      actionpack (= 3.0.3)
+      mail (~> 2.2.9)
+    actionpack (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.4)
+      rack (~> 1.2.1)
+      rack-mount (~> 0.6.13)
+      rack-test (~> 0.5.6)
+      tzinfo (~> 0.3.23)
+    activemodel (3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      i18n (~> 0.4)
+    activerecord (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+      arel (~> 2.0.2)
+      tzinfo (~> 0.3.23)
+    activeresource (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+    activesupport (3.0.3)
+    arel (2.0.6)
+    aruba (0.2.7)
+      background_process
+      cucumber (~> 0.10.0)
+    background_process (1.2)
+    builder (2.1.2)
+    columnize (0.3.2)
+    cucumber (0.10.0)
+      builder (>= 2.1.2)
+      diff-lcs (~> 1.1.2)
+      gherkin (~> 2.3.2)
+      json (~> 1.4.6)
+      term-ansicolor (~> 1.0.5)
+    diff-lcs (1.1.2)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    gherkin (2.3.2)
+      json (~> 1.4.6)
+      term-ansicolor (~> 1.0.5)
+    i18n (0.5.0)
+    json (1.4.6)
+    linecache (0.43)
+    mail (2.2.12)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    mocha (0.9.10)
+      rake
+    polyglot (0.3.1)
+    rack (1.2.1)
+    rack-mount (0.6.13)
+      rack (>= 1.0.0)
+    rack-test (0.5.6)
+      rack (>= 1.0)
+    rails (3.0.3)
+      actionmailer (= 3.0.3)
+      actionpack (= 3.0.3)
+      activerecord (= 3.0.3)
+      activeresource (= 3.0.3)
+      activesupport (= 3.0.3)
+      bundler (~> 1.0)
+      railties (= 3.0.3)
+    railties (3.0.3)
+      actionpack (= 3.0.3)
+      activesupport (= 3.0.3)
+      rake (>= 0.8.7)
+      thor (~> 0.14.4)
+    rake (0.8.7)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.0)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    rspec-rails (2.3.0)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      railties (~> 3.0)
+      rspec (~> 2.3.0)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    sqlite3-ruby (1.3.2)
+    term-ansicolor (1.0.5)
+    thor (0.14.6)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.23)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba
+  cucumber
+  mocha
+  rails (= 3.0.3)
+  rspec-rails
+  ruby-debug
+  sqlite3-ruby

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2007, Tammer Saleh, Thoughtbot, Inc.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,70 @@
+= shoulda-matchers
+
+{Official Documentation}[http://rubydoc.info/github/thoughtbot/shoulda-matchers/master/frames]
+
+Test::Unit- and RSpec-compatible one-liners that test common Rails functionality.
+These tests would otherwise be much longer, more complex, and error-prone.
+
+Refer to the {shoulda}[https://github.com/thoughtbot/shoulda] gem if you want to know more
+about using shoulda with Test::Unit.
+
+=== ActiveRecord Matchers
+
+Matchers to test associations and validations:
+
+  describe Post do
+    it { should belong_to(:user) }
+    it { should have_many(:tags).through(:taggings) }
+
+    it { should validate_uniqueness_of(:title) }
+    it { should validate_presence_of(:body).with_message(/wtf/) }
+    it { should validate_presence_of(:title) }
+    it { should validate_numericality_of(:user_id) }
+  end
+
+  describe User do
+    it { should have_many(:posts) }
+
+    it { should_not allow_value("blah").for(:email) }
+    it { should allow_value("a@b.com").for(:email) }
+    it { should ensure_inclusion_of(:age).in_range(1..100) }
+    it { should_not allow_mass_assignment_of(:password) }
+  end
+
+=== ActionController Matchers
+
+Matchers to test common patterns:
+
+  describe PostsController, "#show" do
+    context "for a fictional user" do
+      before do
+        get :show, :id => 1
+      end
+
+      it { should assign_to(:user) }
+      it { should respond_with(:success) }
+      it { should render_template(:show) }
+      it { should_not set_the_flash }
+    end
+  end
+
+= Installation
+
+In Rails 3 and Bundler, add the following to your Gemfile:
+
+  group :test do
+    gem "shoulda-matchers"
+    gem "rspec-rails"
+  end
+
+Shoulda will automatically include matchers into the appropriate example groups.
+
+= Credits
+
+Shoulda is maintained and funded by {thoughtbot}[http://thoughtbot.com/community].
+Thank you to all the {contributors}[https://github.com/thoughtbot/shoulda-matchers/contributors].
+
+= License
+
+Shoulda is Copyright © 2006-2010 thoughtbot, inc.
+It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.

data/Rakefile

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'rake'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rspec/core/rake_task'
+require 'cucumber/rake/task'
+
+$LOAD_PATH.unshift("lib")
+require 'shoulda/matchers/version'
+
+Rake::RDocTask.new { |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title    = "Shoulda -- Making tests easy on the fingers and eyes"
+  rdoc.options << '--line-numbers'
+  rdoc.template = "#{ENV['template']}.rb" if ENV['template']
+  rdoc.rdoc_files.include('README.rdoc', 'CONTRIBUTION_GUIDELINES.rdoc', 'lib/**/*.rb')
+}
+
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "spec/**/*_spec.rb"
+  t.rspec_opts = '--color --format progress'
+  t.verbose = false
+end
+
+desc "Run code-coverage analysis using rcov"
+RSpec::Core::RakeTask.new(:coverage) do |t|
+  t.rspec_opts = '--color --format progress'
+  t.rcov = true
+  t.rcov_opts = %{--exclude osx\/objc,spec,gems\/ --failure-threshold 100}
+  t.pattern = "spec/**/*_spec.rb"
+end
+
+eval("$specification = begin; #{IO.read('shoulda-matchers.gemspec')}; end")
+Rake::GemPackageTask.new $specification do |pkg|
+  pkg.need_tar = true
+  pkg.need_zip = true
+end
+
+desc "Clean files generated by rake tasks"
+task :clobber => [:clobber_rdoc, :clobber_package]
+
+Cucumber::Rake::Task.new do |t|
+  t.fork = true
+  t.cucumber_opts = ['--format', (ENV['CUCUMBER_FORMAT'] || 'progress')]
+end
+
+desc 'Default: run specs and cucumber features'
+task :default => [:spec, :cucumber]
+

data/lib/shoulda-matchers.rb

@@ -0,0 +1,8 @@
+require 'shoulda/matchers/version'
+
+if defined?(RSpec)
+  require 'shoulda/matchers/integrations/rspec'
+else
+  require 'shoulda/matchers/integrations/test_unit'
+end
+

data/lib/shoulda/matchers/action_controller.rb

@@ -0,0 +1,38 @@
+require 'shoulda/matchers/action_controller/assign_to_matcher'
+require 'shoulda/matchers/action_controller/filter_param_matcher'
+require 'shoulda/matchers/action_controller/set_the_flash_matcher'
+require 'shoulda/matchers/action_controller/render_with_layout_matcher'
+require 'shoulda/matchers/action_controller/respond_with_matcher'
+require 'shoulda/matchers/action_controller/respond_with_content_type_matcher'
+require 'shoulda/matchers/action_controller/set_session_matcher'
+require 'shoulda/matchers/action_controller/route_matcher'
+require 'shoulda/matchers/action_controller/redirect_to_matcher'
+require 'shoulda/matchers/action_controller/render_template_matcher'
+
+module Shoulda
+  module Matchers
+    # By using the matchers you can quickly and easily create concise and
+    # easy to read test suites.
+    #
+    # This code segment:
+    #
+    #   describe UsersController, "on GET to show with a valid id" do
+    #     before(:each) do
+    #       get :show, :id => User.first.to_param
+    #     end
+    #
+    #     it { should assign_to(:user) }
+    #     it { should respond_with(:success) }
+    #     it { should render_template(:show) }
+    #     it { should not_set_the_flash) }
+    #
+    #     it "should do something else really cool" do
+    #       assigns[:user].id.should == 1
+    #     end
+    #   end
+    #
+    # Would produce 5 tests for the show action
+    module ActionController
+    end
+  end
+end

data/lib/shoulda/matchers/action_controller/assign_to_matcher.rb

@@ -0,0 +1,114 @@
+module Shoulda # :nodoc:
+  module Matchers
+    module ActionController # :nodoc:
+
+      # Ensures that the controller assigned to the named instance variable.
+      #
+      # Options:
+      # * <tt>with_kind_of</tt> - The expected class of the instance variable
+      #   being checked.
+      # * <tt>with</tt> - The value that should be assigned.
+      #
+      # Example:
+      #
+      #   it { should assign_to(:user) }
+      #   it { should_not assign_to(:user) }
+      #   it { should assign_to(:user).with_kind_of(User) }
+      #   it { should assign_to(:user).with(@user) }
+      def assign_to(variable)
+        AssignToMatcher.new(variable)
+      end
+
+      class AssignToMatcher # :nodoc:
+
+        def initialize(variable)
+          @variable    = variable.to_s
+          @check_value = false
+        end
+
+        def with_kind_of(expected_class)
+          @expected_class = expected_class
+          self
+        end
+
+        def with(expected_value = nil, &block)
+          @check_value       = true
+          @expected_value    = expected_value
+          @expectation_block = block
+          self
+        end
+
+        def matches?(controller)
+          @controller = controller
+          @expected_value = @context.instance_eval(&@expectation_block) if @expectation_block
+          assigned_value? && kind_of_expected_class? && equal_to_expected_value?
+        end
+
+        attr_reader :failure_message, :negative_failure_message
+
+        def description
+          description = "assign @#{@variable}"
+          description << " with a kind of #{@expected_class}" if @expected_class
+          description
+        end
+
+        def in_context(context)
+          @context = context
+          self
+        end
+
+        private
+
+        def assigned_value?
+          if !@controller.instance_variables.include?("@#{@variable}")
+            @failure_message =
+              "Expected action to assign a value for @#{@variable}"
+            false
+          else
+            @negative_failure_message =
+              "Didn't expect action to assign a value for @#{@variable}, " <<
+              "but it was assigned to #{assigned_value.inspect}"
+            true
+          end
+        end
+
+        def kind_of_expected_class?
+          return true unless @expected_class
+          if assigned_value.kind_of?(@expected_class)
+            @negative_failure_message =
+              "Didn't expect action to assign a kind of #{@expected_class} " <<
+              "for #{@variable}, but got one anyway"
+            true
+          else
+            @failure_message =
+              "Expected action to assign a kind of #{@expected_class} " <<
+              "for #{@variable}, but got #{@variable.inspect} " <<
+              "(#{@variable.class.name})"
+            false
+          end
+        end
+
+        def equal_to_expected_value?
+          return true unless @check_value
+          if @expected_value == assigned_value
+            @negative_failure_message =
+              "Didn't expect action to assign #{@expected_value.inspect} " <<
+              "for #{@variable}, but got it anyway"
+            true
+          else
+            @failure_message =
+              "Expected action to assign #{@expected_value.inspect} " <<
+              "for #{@variable}, but got #{assigned_value.inspect}"
+            false
+          end
+        end
+
+        def assigned_value
+          @controller.instance_variable_get("@#{@variable}")
+        end
+
+      end
+
+    end
+  end
+end