class RSpec::Expectations::ExpectationTarget
Wraps the target of an expectation. @example
expect(something) # => ExpectationTarget wrapping something # used with `to` expect(actual).to eq(3) # with `not_to` expect(actual).not_to eq(3)
Attributes
deprecated_should_enabled[RW]
deprecated_should_enabled?[RW]
Public Class Methods
disable_deprecated_should()
click to toggle source
# File lib/rspec/expectations/expectation_target.rb, line 67 def self.disable_deprecated_should return unless deprecated_should_enabled? remove_method :should remove_method :should_not self.deprecated_should_enabled = false end
enable_deprecated_should()
click to toggle source
# File lib/rspec/expectations/expectation_target.rb, line 51 def self.enable_deprecated_should return if deprecated_should_enabled? def should(*args) RSpec.deprecate "`expect { }.should`", :replacement => "`expect { }.to`" @target.should(*args) end def should_not(*args) RSpec.deprecate "`expect { }.should_not`", :replacement => "`expect { }.not_to`" @target.should_not(*args) end self.deprecated_should_enabled = true end
new(target)
click to toggle source
@api private
# File lib/rspec/expectations/expectation_target.rb, line 19 def initialize(target) @target = target end
Public Instance Methods
not_to(matcher=nil, message=nil, &block)
click to toggle source
Runs the given expectation, passing if `matcher` returns false. @example
expect(value).not_to eq(5)
@param [Matcher]
matcher
@param [String] message optional message to display when the expectation fails @return [Boolean] false if the negative expectation succeeds (else raises) @see RSpec::Matchers
# File lib/rspec/expectations/expectation_target.rb, line 45 def not_to(matcher=nil, message=nil, &block) prevent_operator_matchers(:not_to, matcher) RSpec::Expectations::NegativeExpectationHandler.handle_matcher(@target, matcher, message, &block) end
Also aliased as: to_not
should(*args)
click to toggle source
# File lib/rspec/expectations/expectation_target.rb, line 54 def should(*args) RSpec.deprecate "`expect { }.should`", :replacement => "`expect { }.to`" @target.should(*args) end
should_not(*args)
click to toggle source
# File lib/rspec/expectations/expectation_target.rb, line 59 def should_not(*args) RSpec.deprecate "`expect { }.should_not`", :replacement => "`expect { }.not_to`" @target.should_not(*args) end
to(matcher=nil, message=nil, &block)
click to toggle source
Runs the given expectation, passing if `matcher` returns true. @example
expect(value).to eq(5) expect { perform }.to raise_error
@param [Matcher]
matcher
@param [String] message optional message to display when the expectation fails @return [Boolean] true if the expectation succeeds (else raises) @see RSpec::Matchers
# File lib/rspec/expectations/expectation_target.rb, line 32 def to(matcher=nil, message=nil, &block) prevent_operator_matchers(:to, matcher) RSpec::Expectations::PositiveExpectationHandler.handle_matcher(@target, matcher, message, &block) end
Private Instance Methods
prevent_operator_matchers(verb, matcher)
click to toggle source
# File lib/rspec/expectations/expectation_target.rb, line 78 def prevent_operator_matchers(verb, matcher) return if matcher raise ArgumentError, "The expect syntax does not support operator matchers, " + "so you must pass a matcher to `##{verb}`." end