class RSpec::Matchers::Have

Public Class Methods

new(expected, relativity=:exactly) click to toggle source
# File lib/rspec/matchers/have.rb, line 4
def initialize(expected, relativity=:exactly)
  @expected = case expected
              when :no then 0
              when String then expected.to_i
              else expected
              end
  @relativity = relativity
  @actual = @collection_name = @plural_collection_name = nil
end

Public Instance Methods

description() click to toggle source
# File lib/rspec/matchers/have.rb, line 80
def description
  "have #{relative_expectation} #{@collection_name}"
end
determine_collection(collection_or_owner) click to toggle source
# File lib/rspec/matchers/have.rb, line 34
def determine_collection(collection_or_owner)
  if collection_or_owner.respond_to?(@collection_name)
    collection_or_owner.send(@collection_name, *@args, &@block)
  elsif (@plural_collection_name && collection_or_owner.respond_to?(@plural_collection_name))
    collection_or_owner.send(@plural_collection_name, *@args, &@block)
  elsif determine_query_method(collection_or_owner)
    collection_or_owner
  else
    collection_or_owner.send(@collection_name, *@args, &@block)
  end
end
determine_query_method(collection) click to toggle source
# File lib/rspec/matchers/have.rb, line 46
def determine_query_method(collection)
  [:size, :length, :count].detect {|m| collection.respond_to?(m)}
end
failure_message_for_should() click to toggle source
# File lib/rspec/matchers/have.rb, line 54
def failure_message_for_should
  "expected #{relative_expectation} #{@collection_name}, got #{@actual}"
end
failure_message_for_should_not() click to toggle source
# File lib/rspec/matchers/have.rb, line 58
      def failure_message_for_should_not
        if @relativity == :exactly
          return "expected target not to have #{@expected} #{@collection_name}, got #{@actual}"
        elsif @relativity == :at_most
          return "Isn't life confusing enough?
Instead of having to figure out the meaning of this:
  should_not have_at_most(#{@expected}).#{@collection_name}
We recommend that you use this instead:
  should have_at_least(#{@expected + 1}).#{@collection_name}
"
        elsif @relativity == :at_least
          return "Isn't life confusing enough?
Instead of having to figure out the meaning of this:
  should_not have_at_least(#{@expected}).#{@collection_name}
We recommend that you use this instead:
  should have_at_most(#{@expected - 1}).#{@collection_name}
"
        end
      end
matches?(collection_or_owner) click to toggle source
# File lib/rspec/matchers/have.rb, line 22
def matches?(collection_or_owner)
  collection = determine_collection(collection_or_owner)
  query_method = determine_query_method(collection)
  raise not_a_collection unless query_method
  @actual = collection.send(query_method)
  case @relativity
  when :at_least then @actual >= @expected
  when :at_most  then @actual <= @expected
  else                @actual == @expected
  end
end
not_a_collection() click to toggle source
# File lib/rspec/matchers/have.rb, line 50
def not_a_collection
  "expected #{@collection_name} to be a collection but it does not respond to #length, #size or #count"
end
relativities() click to toggle source
# File lib/rspec/matchers/have.rb, line 14
def relativities
  @relativities ||= {
    :exactly => "",
    :at_least => "at least ",
    :at_most => "at most "
  }
end
respond_to?(m) click to toggle source
# File lib/rspec/matchers/have.rb, line 84
def respond_to?(m)
  @expected.respond_to?(m) || super
end