class RSpec::Matchers::BuiltIn::RaiseError

Public Class Methods

new(expected_error_or_message=Exception, expected_message=nil, &block) click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 5
def initialize(expected_error_or_message=Exception, expected_message=nil, &block)
  @block = block
  @actual_error = nil
  case expected_error_or_message
  when String, Regexp
    @expected_error, @expected_message = Exception, expected_error_or_message
  else
    @expected_error, @expected_message = expected_error_or_message, expected_message
  end
end

Public Instance Methods

==(given_proc, negative_expectation = false)
Alias for: matches?
description() click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 73
def description
  "raise #{expected_error}"
end
does_not_match?(given_proc) click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 40
def does_not_match?(given_proc)
  !matches?(given_proc, :negative_expectation)
end
eval_block() click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 44
def eval_block
  @eval_block = true
  begin
    @block[@actual_error]
    @eval_block_passed = true
  rescue Exception => err
    @actual_error = err
  end
end
failure_message_for_should() click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 65
def failure_message_for_should
  @eval_block ? @actual_error.message : "expected #{expected_error}#{given_error}"
end
failure_message_for_should_not() click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 69
def failure_message_for_should_not
  "expected no #{expected_error}#{given_error}"
end
matches?(given_proc, negative_expectation = false) click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 16
def matches?(given_proc, negative_expectation = false)
  @raised_expected_error = false
  @with_expected_message = false
  @eval_block = false
  @eval_block_passed = false
  begin
    given_proc.call
  rescue @expected_error => @actual_error
    @raised_expected_error = true
    @with_expected_message = verify_message
  rescue Exception => @actual_error
    # This clause should be empty, but rcov will not report it as covered
    # unless something (anything) is executed within the clause
    "http://eigenclass.org/hiki.rb?rcov-0.8.0"
  end

  unless negative_expectation
    eval_block if @raised_expected_error && @with_expected_message && @block
  end
ensure
  return (@raised_expected_error & @with_expected_message) ? (@eval_block ? @eval_block_passed : true) : false
end
Also aliased as: ==
verify_message() click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 54
def verify_message
  case @expected_message
  when nil
    true
  when Regexp
    @expected_message =~ @actual_error.message
  else
    @expected_message == @actual_error.message
  end
end

Private Instance Methods

expected_error() click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 79
def expected_error
  case @expected_message
  when nil
    @expected_error
  when Regexp
    "#{@expected_error} with message matching #{@expected_message.inspect}"
  else
    "#{@expected_error} with #{@expected_message.inspect}"
  end
end
format_backtrace(backtrace) click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 90
def format_backtrace(backtrace)
  formatter = Matchers.configuration.backtrace_formatter
  formatter.format_backtrace(backtrace)
end
given_error() click to toggle source
# File lib/rspec/matchers/built_in/raise_error.rb, line 95
def given_error
  return " but nothing was raised" unless @actual_error

  backtrace = format_backtrace(@actual_error.backtrace)
  [
    ", got #{@actual_error.inspect} with backtrace:",
    *backtrace
  ].join("\n  # ")
end