shoulda-matchers 1.0.0.beta1

data/lib/shoulda/matchers/active_record/validate_numericality_of_matcher.rb

@@ -0,0 +1,39 @@
+module Shoulda # :nodoc:
+  module Matchers
+    module ActiveRecord # :nodoc:
+
+      # Ensure that the attribute is numeric
+      #
+      # Options:
+      # * <tt>with_message</tt> - value the test expects to find in
+      #   <tt>errors.on(:attribute)</tt>. Regexp or string.  Defaults to the
+      #   translation for <tt>:not_a_number</tt>.
+      #
+      # Example:
+      #   it { should validate_numericality_of(:age) }
+      #
+      def validate_numericality_of(attr)
+        ValidateNumericalityOfMatcher.new(attr)
+      end
+
+      class ValidateNumericalityOfMatcher < ValidationMatcher # :nodoc:
+
+        def with_message(message)
+          @expected_message = message if message
+          self
+        end
+
+        def matches?(subject)
+          super(subject)
+          @expected_message ||= :not_a_number
+          disallows_value_of('abcd', @expected_message)
+        end
+
+        def description
+          "only allow numeric values for #{@attribute}"
+        end
+      end
+
+    end
+  end
+end

data/lib/shoulda/matchers/active_record/validate_presence_of_matcher.rb

@@ -0,0 +1,60 @@
+module Shoulda # :nodoc:
+  module Matchers
+    module ActiveRecord # :nodoc:
+
+      # Ensures that the model is not valid if the given attribute is not
+      # present.
+      #
+      # Options:
+      # * <tt>with_message</tt> - value the test expects to find in
+      #   <tt>errors.on(:attribute)</tt>. <tt>Regexp</tt> or <tt>String</tt>.
+      #   Defaults to the translation for <tt>:blank</tt>.
+      #
+      # Examples:
+      #   it { should validate_presence_of(:name) }
+      #   it { should validate_presence_of(:name).
+      #                 with_message(/is not optional/) }
+      #
+      def validate_presence_of(attr)
+        ValidatePresenceOfMatcher.new(attr)
+      end
+
+      class ValidatePresenceOfMatcher < ValidationMatcher # :nodoc:
+
+        def with_message(message)
+          @expected_message = message if message
+          self
+        end
+
+        def matches?(subject)
+          super(subject)
+          @expected_message ||= :blank
+          disallows_value_of(blank_value, @expected_message)
+        end
+
+        def description
+          "require #{@attribute} to be set"
+        end
+
+        private
+
+        def blank_value
+          if collection?
+            []
+          else
+            nil
+          end
+        end
+
+        def collection?
+          if reflection = @subject.class.reflect_on_association(@attribute)
+            [:has_many, :has_and_belongs_to_many].include?(reflection.macro)
+          else
+            false
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/shoulda/matchers/active_record/validate_uniqueness_of_matcher.rb

@@ -0,0 +1,148 @@
+module Shoulda # :nodoc:
+  module Matchers
+    module ActiveRecord # :nodoc:
+
+      # Ensures that the model is invalid if the given attribute is not unique.
+      #
+      # Internally, this uses values from existing records to test validations,
+      # so this will always fail if you have not saved at least one record for
+      # the model being tested, like so:
+      #
+      #   describe User do
+      #     before(:each) { User.create!(:email => 'address@example.com') }
+      #     it { should validate_uniqueness_of(:email) }
+      #   end
+      #
+      # Options:
+      #
+      # * <tt>with_message</tt> - value the test expects to find in
+      #   <tt>errors.on(:attribute)</tt>. <tt>Regexp</tt> or <tt>String</tt>.
+      #   Defaults to the translation for <tt>:taken</tt>.
+      # * <tt>scoped_to</tt> - field(s) to scope the uniqueness to.
+      # * <tt>case_insensitive</tt> - ensures that the validation does not
+      #   check case. Off by default. Ignored by non-text attributes.
+      #
+      # Examples:
+      #   it { should validate_uniqueness_of(:keyword) }
+      #   it { should validate_uniqueness_of(:keyword).with_message(/dup/) }
+      #   it { should validate_uniqueness_of(:email).scoped_to(:name) }
+      #   it { should validate_uniqueness_of(:email).
+      #                 scoped_to(:first_name, :last_name) }
+      #   it { should validate_uniqueness_of(:keyword).case_insensitive }
+      #
+      def validate_uniqueness_of(attr)
+        ValidateUniquenessOfMatcher.new(attr)
+      end
+
+      class ValidateUniquenessOfMatcher < ValidationMatcher # :nodoc:
+        include Helpers
+
+        def initialize(attribute)
+          @attribute = attribute
+        end
+
+        def scoped_to(*scopes)
+          @scopes = [*scopes].flatten
+          self
+        end
+
+        def with_message(message)
+          @expected_message = message
+          self
+        end
+
+        def case_insensitive
+          @case_insensitive = true
+          self
+        end
+
+        def description
+          result = "require "
+          result << "case sensitive " unless @case_insensitive
+          result << "unique value for #{@attribute}"
+          result << " scoped to #{@scopes.join(', ')}" unless @scopes.blank?
+          result
+        end
+
+        def matches?(subject)
+          @subject = subject.class.new
+          @expected_message ||= :taken
+          find_existing &&
+            set_scoped_attributes &&
+            validate_attribute &&
+            validate_after_scope_change
+        end
+
+        private
+
+        def find_existing
+          if @existing = @subject.class.find(:first)
+            true
+          else
+            @failure_message = "Can't find first #{class_name}"
+            false
+          end
+        end
+
+        def set_scoped_attributes
+          unless @scopes.blank?
+            @scopes.each do |scope|
+              setter = :"#{scope}="
+              unless @subject.respond_to?(setter)
+                @failure_message =
+                  "#{class_name} doesn't seem to have a #{scope} attribute."
+                return false
+              end
+              @subject.send("#{scope}=", @existing.send(scope))
+            end
+          end
+          true
+        end
+
+        def validate_attribute
+          disallows_value_of(existing_value, @expected_message)
+        end
+
+        # TODO:  There is a chance that we could change the scoped field
+        # to a value that's already taken.  An alternative implementation
+        # could actually find all values for scope and create a unique
+        def validate_after_scope_change
+          if @scopes.blank?
+            true
+          else
+            @scopes.all? do |scope|
+              previous_value = @existing.send(scope)
+
+              # Assume the scope is a foreign key if the field is nil
+              previous_value ||= 0
+
+              next_value = previous_value.next
+
+              @subject.send("#{scope}=", next_value)
+
+              if allows_value_of(existing_value, @expected_message)
+                @negative_failure_message <<
+                  " (with different value of #{scope})"
+                true
+              else
+                @failure_message << " (with different value of #{scope})"
+                false
+              end
+            end
+          end
+        end
+
+        def class_name
+          @subject.class.name
+        end
+
+        def existing_value
+          value = @existing.send(@attribute)
+          value.swapcase! if @case_insensitive && value.respond_to?(:swapcase!)
+          value
+        end
+      end
+
+    end
+  end
+end

data/lib/shoulda/matchers/active_record/validation_matcher.rb

@@ -0,0 +1,56 @@
+module Shoulda # :nodoc:
+  module Matchers
+    module ActiveRecord # :nodoc:
+
+      class ValidationMatcher # :nodoc:
+
+        attr_reader :failure_message
+
+        def initialize(attribute)
+          @attribute = attribute
+        end
+
+        def negative_failure_message
+          @negative_failure_message || @failure_message
+        end
+
+        def matches?(subject)
+          @subject = subject
+          false
+        end
+
+        private
+
+        def allows_value_of(value, message = nil)
+          allow = AllowValueMatcher.
+            new(value).
+            for(@attribute).
+            with_message(message)
+          if allow.matches?(@subject)
+            @negative_failure_message = allow.failure_message
+            true
+          else
+            @failure_message = allow.negative_failure_message
+            false
+          end
+        end
+
+        def disallows_value_of(value, message = nil)
+          disallow = AllowValueMatcher.
+            new(value).
+            for(@attribute).
+            with_message(message)
+          if disallow.matches?(@subject)
+            @failure_message = disallow.negative_failure_message
+            false
+          else
+            @negative_failure_message = disallow.failure_message
+            true
+          end
+        end
+      end
+
+    end
+  end
+
+    end

data/lib/shoulda/matchers/integrations/rspec.rb

@@ -0,0 +1,23 @@
+# :enddoc:
+
+if defined?(::ActiveRecord)
+  require 'shoulda/matchers/active_record'
+  module RSpec::Matchers
+    include Shoulda::Matchers::ActiveRecord
+  end
+end
+
+if defined?(::ActionController)
+  require 'shoulda/matchers/action_controller'
+  module RSpec::Rails::ControllerExampleGroup
+    include Shoulda::Matchers::ActionController
+  end
+end
+
+if defined?(::ActionMailer)
+  require 'shoulda/matchers/action_mailer'
+  module RSpec::Rails::MailerExampleGroup
+    include Shoulda::Matchers::ActionMailer
+  end
+end
+

data/lib/shoulda/matchers/integrations/test_unit.rb

@@ -0,0 +1,41 @@
+# :enddoc:
+
+if defined?(ActionController)
+  require 'shoulda/matchers/action_controller'
+
+  class ActionController::TestCase
+    include Shoulda::Matchers::ActionController
+    extend Shoulda::Matchers::ActionController
+
+    def subject
+      @controller
+    end
+  end
+end
+
+if defined?(ActionMailer)
+  require 'shoulda/matchers/action_mailer'
+
+  module Test
+    module Unit
+      class TestCase
+        include Shoulda::Matchers::ActionMailer
+        extend Shoulda::Matchers::ActionMailer
+      end
+    end
+  end
+end
+
+if defined?(ActiveRecord)
+  require 'shoulda/matchers/active_record'
+
+  module Test
+    module Unit
+      class TestCase
+        include Shoulda::Matchers::ActiveRecord
+        extend Shoulda::Matchers::ActiveRecord
+      end
+    end
+  end
+end
+

data/lib/shoulda/matchers/version.rb

@@ -0,0 +1,5 @@
+module Shoulda
+  module Matchers
+    VERSION = "1.0.0.beta1"
+  end
+end

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification 
+name: shoulda-matchers
+version: !ruby/object:Gem::Version 
+  hash: 299253597
+  prerelease: true
+  segments: 
+  - 1
+  - 0
+  - 0
+  - beta1
+  version: 1.0.0.beta1
+platform: ruby
+authors: 
+- Tammer Saleh
+- Joe Ferris
+- Ryan McGeary
+- Dan Croak
+- Matt Jankowski
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-19 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Making tests easy on the fingers and eyes
+email: support@thoughtbot.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- CONTRIBUTION_GUIDELINES.rdoc
+files: 
+- CONTRIBUTION_GUIDELINES.rdoc
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE
+- Rakefile
+- README.rdoc
+- lib/shoulda/matchers/action_controller/assign_to_matcher.rb
+- lib/shoulda/matchers/action_controller/filter_param_matcher.rb
+- lib/shoulda/matchers/action_controller/redirect_to_matcher.rb
+- lib/shoulda/matchers/action_controller/render_template_matcher.rb
+- lib/shoulda/matchers/action_controller/render_with_layout_matcher.rb
+- lib/shoulda/matchers/action_controller/respond_with_content_type_matcher.rb
+- lib/shoulda/matchers/action_controller/respond_with_matcher.rb
+- lib/shoulda/matchers/action_controller/route_matcher.rb
+- lib/shoulda/matchers/action_controller/set_session_matcher.rb
+- lib/shoulda/matchers/action_controller/set_the_flash_matcher.rb
+- lib/shoulda/matchers/action_controller.rb
+- lib/shoulda/matchers/action_mailer/have_sent_email.rb
+- lib/shoulda/matchers/action_mailer.rb
+- lib/shoulda/matchers/active_record/allow_mass_assignment_of_matcher.rb
+- lib/shoulda/matchers/active_record/allow_value_matcher.rb
+- lib/shoulda/matchers/active_record/association_matcher.rb
+- lib/shoulda/matchers/active_record/ensure_inclusion_of_matcher.rb
+- lib/shoulda/matchers/active_record/ensure_length_of_matcher.rb
+- lib/shoulda/matchers/active_record/have_db_column_matcher.rb
+- lib/shoulda/matchers/active_record/have_db_index_matcher.rb
+- lib/shoulda/matchers/active_record/have_readonly_attribute_matcher.rb
+- lib/shoulda/matchers/active_record/helpers.rb
+- lib/shoulda/matchers/active_record/validate_acceptance_of_matcher.rb
+- lib/shoulda/matchers/active_record/validate_format_of_matcher.rb
+- lib/shoulda/matchers/active_record/validate_numericality_of_matcher.rb
+- lib/shoulda/matchers/active_record/validate_presence_of_matcher.rb
+- lib/shoulda/matchers/active_record/validate_uniqueness_of_matcher.rb
+- lib/shoulda/matchers/active_record/validation_matcher.rb
+- lib/shoulda/matchers/active_record.rb
+- lib/shoulda/matchers/integrations/rspec.rb
+- lib/shoulda/matchers/integrations/test_unit.rb
+- lib/shoulda/matchers/version.rb
+- lib/shoulda-matchers.rb
+has_rdoc: true
+homepage: http://thoughtbot.com/community/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Making tests easy on the fingers and eyes
+test_files: []
+