rspec 1.3.0 → 2.0.0

data/lib/spec/matchers/has.rb

@@ -1,35 +0,0 @@
-module Spec
-  module Matchers
-    
-    class Has
-      
-      def initialize(expected, *args, &block)
-        @expected, @args, @block = expected, args, block
-      end
-      
-      def matches?(actual)
-        actual.__send__(predicate(@expected), *@args, &@block)
-      end
-      
-      def failure_message_for_should
-        "expected ##{predicate(@expected)}(#{@args[0].inspect}) to return true, got false"
-      end
-      
-      def failure_message_for_should_not
-        "expected ##{predicate(@expected)}(#{@args[0].inspect}) to return false, got true"
-      end
-      
-      def description
-        "have key #{@args[0].inspect}"
-      end
-    
-    private
-    
-      def predicate(sym)
-        "#{sym.to_s.sub("have_","has_")}?".to_sym
-      end
-      
-    end
-    
-  end
-end

data/lib/spec/matchers/have.rb

@@ -1,152 +0,0 @@
-module Spec
-  module Matchers
-    class Have #:nodoc:
-      def initialize(expected, relativity=:exactly)
-        @expected = (expected == :no ? 0 : expected)
-        @relativity = relativity
-        @actual = nil
-        @plural_collection_name = nil
-      end
-    
-      def relativities
-        @relativities ||= {
-          :exactly => "",
-          :at_least => "at least ",
-          :at_most => "at most "
-        }
-      end
-    
-      def matches?(collection_owner)
-        if collection_owner.respond_to?(@collection_name)
-          collection = collection_owner.__send__(@collection_name, *@args, &@block)
-        elsif (@plural_collection_name && collection_owner.respond_to?(@plural_collection_name))
-          collection = collection_owner.__send__(@plural_collection_name, *@args, &@block)
-        elsif (collection_owner.respond_to?(:length) || collection_owner.respond_to?(:size))
-          collection = collection_owner
-        else
-          collection_owner.__send__(@collection_name, *@args, &@block)
-        end
-        @actual = collection.size if collection.respond_to?(:size)
-        @actual = collection.length if collection.respond_to?(:length)
-        raise not_a_collection if @actual.nil?
-        return @actual >= @expected if @relativity == :at_least
-        return @actual <= @expected if @relativity == :at_most
-        return @actual == @expected
-      end
-      
-      def not_a_collection
-        "expected #{@collection_name} to be a collection but it does not respond to #length or #size"
-      end
-    
-      def failure_message_for_should
-        "expected #{relative_expectation} #{@collection_name}, got #{@actual}"
-      end
-
-      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 <<-EOF
-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}
-EOF
-        elsif @relativity == :at_least
-          return <<-EOF
-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}
-EOF
-        end
-      end
-      
-      def description
-        "have #{relative_expectation} #{@collection_name}"
-      end
-      
-      def respond_to?(sym)
-        @expected.respond_to?(sym) || super
-      end
-    
-      private
-      
-      def method_missing(sym, *args, &block)
-        @collection_name = sym
-        if inflector = (defined?(ActiveSupport::Inflector) ? ActiveSupport::Inflector : (defined?(Inflector) ? Inflector : nil))
-          @plural_collection_name = inflector.pluralize(sym.to_s)
-        end
-        @args = args
-        @block = block
-        self
-      end
-      
-      def relative_expectation
-        "#{relativities[@relativity]}#{@expected}"
-      end
-    end
-
-    # :call-seq:
-    #   should have(number).named_collection__or__sugar
-    #   should_not have(number).named_collection__or__sugar
-    #
-    # Passes if receiver is a collection with the submitted
-    # number of items OR if the receiver OWNS a collection
-    # with the submitted number of items.
-    #
-    # If the receiver OWNS the collection, you must use the name
-    # of the collection. So if a <tt>Team</tt> instance has a
-    # collection named <tt>#players</tt>, you must use that name
-    # to set the expectation.
-    #
-    # If the receiver IS the collection, you can use any name
-    # you like for <tt>named_collection</tt>. We'd recommend using
-    # either "elements", "members", or "items" as these are all
-    # standard ways of describing the things IN a collection.
-    #
-    # This also works for Strings, letting you set an expectation
-    # about its length
-    #
-    # == Examples
-    #
-    #   # Passes if team.players.size == 11
-    #   team.should have(11).players
-    #
-    #   # Passes if [1,2,3].length == 3
-    #   [1,2,3].should have(3).items #"items" is pure sugar
-    #
-    #   # Passes if "this string".length == 11
-    #   "this string".should have(11).characters #"characters" is pure sugar
-    def have(n)
-      Matchers::Have.new(n)
-    end
-    alias :have_exactly :have
-
-    # :call-seq:
-    #   should have_at_least(number).items
-    #
-    # Exactly like have() with >=.
-    #
-    # == Warning
-    #
-    # +should_not+ +have_at_least+ is not supported
-    def have_at_least(n)
-      Matchers::Have.new(n, :at_least)
-    end
-
-    # :call-seq:
-    #   should have_at_most(number).items
-    #
-    # Exactly like have() with <=.
-    #
-    # == Warning
-    #
-    # +should_not+ +have_at_most+ is not supported
-    def have_at_most(n)
-      Matchers::Have.new(n, :at_most)
-    end
-  end
-end

data/lib/spec/matchers/include.rb

@@ -1,44 +0,0 @@
-module Spec
-  module Matchers
-    # :call-seq:
-    #   should include(expected)
-    #   should_not include(expected)
-    #
-    # Passes if actual includes expected. This works for
-    # collections and Strings. You can also pass in multiple args
-    # and it will only pass if all args are found in collection.
-    #
-    # == Examples
-    #
-    #   [1,2,3].should include(3)
-    #   [1,2,3].should include(2,3) #would pass
-    #   [1,2,3].should include(2,3,4) #would fail
-    #   [1,2,3].should_not include(4)
-    #   "spread".should include("read")
-    #   "spread".should_not include("red")
-    def include(*expected)
-      Matcher.new :include, *expected do |*_expected_|
-        match do |actual|
-          helper(actual, *_expected_)
-        end
-        
-        def helper(actual, *_expected_)
-          _expected_.each do |expected|
-            if actual.is_a?(Hash)
-              if expected.is_a?(Hash)
-                expected.each_pair do |k,v|
-                  return false unless actual[k] == v
-                end
-              else
-                return false unless actual.has_key?(expected)
-              end
-            else
-              return false unless actual.include?(expected)
-            end
-          end
-          true
-        end
-      end
-    end
-  end
-end

data/lib/spec/matchers/match.rb

@@ -1,21 +0,0 @@
-module Spec
-  module Matchers
-    # :call-seq:
-    #   should match(pattern)
-    #   should_not match(pattern)
-    #
-    # Given a Regexp or String, passes if actual.match(pattern)
-    #
-    # == Examples
-    #
-    #   email.should match(/^([^\s]+)((?:[-a-z0-9]+\.)+[a-z]{2,})$/i)
-    #   email.should match("@example.com")
-    def match(expected)
-      Matcher.new :match, expected do |_expected_|
-        match do |actual|
-          actual.match(_expected_)
-        end
-      end
-    end
-  end
-end

data/lib/spec/matchers/match_array.rb

@@ -1,71 +0,0 @@
-module Spec
-  module Matchers
-
-    class MatchArray #:nodoc:
-      include Spec::Matchers::Pretty
-      
-      def initialize(expected)
-        @expected = expected
-      end
-
-      def matches?(actual)
-        @actual = actual        
-        @extra_items = difference_between_arrays(@actual, @expected)
-        @missing_items = difference_between_arrays(@expected, @actual)
-        @extra_items.empty? & @missing_items.empty?
-      end
-
-      def failure_message_for_should
-        message =  "expected collection contained:  #{safe_sort(@expected).inspect}\n"
-        message += "actual collection contained:    #{safe_sort(@actual).inspect}\n"
-        message += "the missing elements were:      #{safe_sort(@missing_items).inspect}\n" unless @missing_items.empty?
-        message += "the extra elements were:        #{safe_sort(@extra_items).inspect}\n"   unless @extra_items.empty?
-        message
-      end
-      
-      def failure_message_for_should_not
-        "Matcher does not support should_not"
-      end
-      
-      def description
-        "contain exactly #{_pretty_print(@expected)}"
-      end
-
-      private
-
-        def safe_sort(array)
-          array.all?{|item| item.respond_to?(:<=>)} ? array.sort : array
-        end
-
-        def difference_between_arrays(array_1, array_2)
-          difference = array_1.dup
-          array_2.each do |element|
-            if index = difference.index(element)
-              difference.delete_at(index)
-            end
-          end
-          difference
-        end
-
-
-    end
-
-    # :call-seq:
-    #   should =~ expected
-    #
-    # Passes if actual contains all of the expected regardless of order. 
-    # This works for collections. Pass in multiple args  and it will only 
-    # pass if all args are found in collection.
-    #
-    # NOTE: there is no should_not version of array.should =~ other_array
-    # 
-    # == Examples
-    #
-    #   [1,2,3].should   =~ [1,2,3]   # => would pass
-    #   [1,2,3].should   =~ [2,3,1]   # => would pass
-    #   [1,2,3,4].should =~ [1,2,3]   # => would fail
-    #   [1,2,2,3].should =~ [1,2,3]   # => would fail
-    #   [1,2,3].should   =~ [1,2,3,4] # => would fail
-    OperatorMatcher.register(Array, '=~', Spec::Matchers::MatchArray)
-  end
-end

data/lib/spec/matchers/matcher.rb

@@ -1,132 +0,0 @@
-module Spec
-  module Matchers
-    class Matcher
-      include Spec::Matchers::InstanceExec
-      include Spec::Matchers::Pretty
-      include Spec::Matchers
-
-      attr_reader :expected, :actual
-
-      def initialize(name, *expected, &declarations)
-        @name     = name
-        @expected = expected
-        @actual   = nil
-        @diffable = false
-        @expected_exception = nil
-        @messages = {
-          :description => lambda {"#{name_to_sentence}#{expected_to_sentence}"},
-          :failure_message_for_should => lambda {|actual| "expected #{actual.inspect} to #{name_to_sentence}#{expected_to_sentence}"},
-          :failure_message_for_should_not => lambda {|actual| "expected #{actual.inspect} not to #{name_to_sentence}#{expected_to_sentence}"}
-        }
-        making_declared_methods_public do
-          instance_exec(*@expected, &declarations)
-        end
-      end
-
-      #Used internally by objects returns by +should+ and +should_not+.
-      def matches?(actual)
-        @actual = actual
-        if @expected_exception
-          begin
-            instance_exec(actual, &@match_block)
-            true
-          rescue @expected_exception
-            false
-          end
-        else
-          begin
-            instance_exec(actual, &@match_block)
-          rescue Spec::Expectations::ExpectationNotMetError
-            false
-          end
-        end
-      end
-
-      # See Spec::Matchers
-      def match(&block)
-        @match_block = block
-      end
-
-      # See Spec::Matchers
-      def match_unless_raises(exception=Exception, &block)
-        @expected_exception = exception
-        match(&block)
-      end
-
-      # See Spec::Matchers
-      def failure_message_for_should(&block)
-        cache_or_call_cached(:failure_message_for_should, &block)
-      end
-
-      # See Spec::Matchers
-      def failure_message_for_should_not(&block)
-        cache_or_call_cached(:failure_message_for_should_not, &block)
-      end
-
-      # See Spec::Matchers
-      def description(&block)
-        cache_or_call_cached(:description, &block)
-      end
-
-      #Used internally by objects returns by +should+ and +should_not+.
-      def diffable?
-        @diffable
-      end
-
-      # See Spec::Matchers
-      def diffable
-        @diffable = true
-      end
-      
-      # See Spec::Matchers
-      def chain(method, &block)
-        self.class.class_eval do
-          define_method method do |*args|
-            block.call(*args)
-            self
-          end
-        end
-      end
-
-    private
-
-      def making_declared_methods_public # :nodoc:
-        # Our home-grown instance_exec in ruby 1.8.6 results in any methods
-        # declared in the block eval'd by instance_exec in the block to which we
-        # are yielding here are scoped private. This is NOT the case for Ruby
-        # 1.8.7 or 1.9.
-        #
-        # Also, due some crazy scoping that I don't understand, these methods
-        # are actually available in the specs (something about the matcher being
-        # defined in the scope of Spec::Matchers or within an example), so not
-        # doing the following will not cause specs to fail, but they *will*
-        # cause features to fail and that will make users unhappy. So don't.
-        orig_private_methods = private_methods
-        yield
-        st = (class << self; self; end)
-        (private_methods - orig_private_methods).each {|m| st.__send__ :public, m}
-      end
-
-      def cache_or_call_cached(key, &block)
-        block ? cache(key, &block) : call_cached(key)
-      end
-
-      def cache(key, &block)
-        @messages[key] = block
-      end
-
-      def call_cached(key)
-        @messages[key].arity == 1 ? @messages[key].call(@actual) : @messages[key].call
-      end
-
-      def name_to_sentence
-        split_words(@name)
-      end
-
-      def expected_to_sentence
-        to_sentence(@expected)
-      end
-
-    end
-  end
-end

data/lib/spec/matchers/method_missing.rb

@@ -1,9 +0,0 @@
-module Spec
-  module Matchers
-    def method_missing(sym, *args, &block) # :nodoc:
-      return Matchers::BePredicate.new(sym, *args, &block) if sym.to_s =~ /^be_/
-      return Matchers::Has.new(sym, *args, &block) if sym.to_s =~ /^have_/
-      super
-    end
-  end
-end

data/lib/spec/matchers/operator_matcher.rb

@@ -1,78 +0,0 @@
-module Spec
-  module Matchers
-
-    class OperatorMatcher
-      class << self
-        def registry
-          @registry ||= {}
-        end
-
-        def register(klass, operator, matcher)
-          registry[klass] ||= {}
-          registry[klass][operator] = matcher
-        end
-
-        def get(klass, operator)
-          registry[klass] && registry[klass][operator]
-        end
-      end
-
-      def initialize(actual)
-        @actual = actual
-      end
-
-      def self.use_custom_matcher_or_delegate(operator)
-        define_method(operator) do |expected|
-          if matcher = OperatorMatcher.get(@actual.class, operator)
-            @actual.send(::Spec::Matchers.last_should, matcher.new(expected))
-          else
-            eval_match(@actual, operator, expected)
-          end
-        end
-      end
-
-      ['==', '===', '=~', '>', '>=', '<', '<='].each do |operator|
-        use_custom_matcher_or_delegate operator
-      end
-
-      def fail_with_message(message)
-        Spec::Expectations.fail_with(message, @expected, @actual)
-      end
-
-      def description
-        "#{@operator} #{@expected.inspect}"
-      end
-      
-    private
-      
-      def eval_match(actual, operator, expected)
-        ::Spec::Matchers.last_matcher = self
-        @operator, @expected = operator, expected
-        __delegate_operator(actual, operator, expected)
-      end
-
-    end
-
-    class PositiveOperatorMatcher < OperatorMatcher #:nodoc:
-      def __delegate_operator(actual, operator, expected)
-        if actual.__send__(operator, expected)
-          true
-        elsif ['==','===', '=~'].include?(operator)
-          fail_with_message("expected: #{expected.inspect},\n     got: #{actual.inspect} (using #{operator})") 
-        else
-          fail_with_message("expected: #{operator} #{expected.inspect},\n     got: #{operator.gsub(/./, ' ')} #{actual.inspect}")
-        end
-      end
-
-    end
-
-    class NegativeOperatorMatcher < OperatorMatcher #:nodoc:
-      def __delegate_operator(actual, operator, expected)
-        return false unless actual.__send__(operator, expected)
-        return fail_with_message("expected not: #{operator} #{expected.inspect},\n         got: #{operator.gsub(/./, ' ')} #{actual.inspect}")
-      end
-
-    end
-
-  end
-end

data/lib/spec/matchers/pretty.rb

@@ -1,37 +0,0 @@
-module Spec
-  module Matchers
-    module Pretty
-      def split_words(sym)
-        sym.to_s.gsub(/_/,' ')
-      end
-
-      def to_sentence(words)
-        words = words.map{|w| w.inspect}
-        case words.length
-          when 0
-            ""
-          when 1
-            " #{words[0]}"
-          when 2
-            " #{words[0]} and #{words[1]}"
-          else
-            " #{words[0...-1].join(', ')}, and #{words[-1]}"
-        end
-      end
-
-      def _pretty_print(array)
-        result = ""
-        array.each_with_index do |item, index|
-          if index < (array.length - 2)
-            result << "#{item.inspect}, "
-          elsif index < (array.length - 1)
-            result << "#{item.inspect} and "
-          else
-            result << "#{item.inspect}"
-          end
-        end
-        result
-      end
-    end
-  end
-end