Fail fast if invocation matches never expectation

[floehopper]

TODO

• Come up with a version of this that emits a deprecation warning rather than actually changing the behaviour.
• Ensure all the relevant documentation is updated, e.g. method dispatch in README, class docs for Mock, and docs for any relevant methods.
• Update commit note(s) to reference being consistent with the behaviour described in the following test which was added in d358377

mocha/test/acceptance/expected_invocation_count_test.rb

Lines 202 to 214 in f899c03

	def test_should_fail_fast_if_method_is_never_expected_but_is_called_once_even_if_everything_is_stubbed
	test_result = run_as_test do
	stub = stub_everything('stub')
	stub.expects(:method).never
	1.times { stub.method }
	end
	assert_failed(test_result)
	assert_equal [
	'unexpected invocation: #<Mock:stub>.method()',
	'unsatisfied expectations:',
	'- expected never, invoked once: #<Mock:stub>.method(any_parameters)'
	], test_result.failure_message_lines
	end

Previously when an invocation matched an expectation which did not allow invocations (i.e. Expectation#never had been called on it), but the invocation also matched another expectation which did allow invocations, then the test would not fail with an unexpected invocation error.

This was happening because neither the if condition was true, because the "never" expectation was not returned by ExpectationList#match_allowing_invocation, but the other expectation allowing expectations was returned. Thus Expectation#invoke was called on the latter and Mock#raise_unexpected_invocation_error was not called.

This behaviour was confusing and had led to a number of issues being raised over the years: #44, #131, #490 & most recently #678. Previously I had thought this was a symptom of the JMock v1 dispatch behaviour (which might still be true) and thus would be best addressed by adopting the JMock v2 dispatch behaviour (#173). However, having considered this specific scenario involving a "never" expectation more carefully, I've decided to try to fix it with the changes in this PR.

Now a test like this will fail with an unexpected invocation error:

mock = mock('mock')
mock.stubs(:method)
mock.expects(:method).never
mock.method

unexpected invocation: #<Mock:mock>.method()
unsatisfied expectations:
- expected never, invoked once: #<Mock:mock>.method(any_parameters)
satisfied expectations:
- allowed any number of times, invoked never: #<Mock:mock>.method(any_parameters)

Closes #678. Also addresses #490, #131 & #44.