RubyGems - mocha - Versions diffs - 0.10.5 → 0.11.0 - Mend

mocha 0.10.5 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (229) hide show

data/COPYING.rdoc +1 -1
data/README.rdoc +6 -4
data/RELEASE.rdoc +12 -0
data/Rakefile +29 -60
data/doc/Mocha.html +112 -0
data/doc/Mocha/API.html +898 -0
data/doc/Mocha/ClassMethods.html +246 -0
data/doc/Mocha/Configuration.html +471 -0
data/doc/Mocha/Expectation.html +2570 -0
data/doc/Mocha/Mock.html +830 -0
data/doc/Mocha/ObjectMethods.html +668 -0
data/doc/Mocha/ParameterMatchers.html +2715 -0
data/doc/Mocha/ParameterMatchers/AllOf.html +137 -0
data/doc/Mocha/ParameterMatchers/AnyOf.html +137 -0
data/doc/Mocha/ParameterMatchers/AnyParameters.html +136 -0
data/doc/Mocha/ParameterMatchers/Anything.html +136 -0
data/doc/Mocha/ParameterMatchers/Base.html +419 -0
data/doc/Mocha/ParameterMatchers/Equals.html +137 -0
data/doc/Mocha/ParameterMatchers/HasEntries.html +137 -0
data/doc/Mocha/ParameterMatchers/HasEntry.html +137 -0
data/doc/Mocha/ParameterMatchers/HasKey.html +137 -0
data/doc/Mocha/ParameterMatchers/HasValue.html +137 -0
data/doc/Mocha/ParameterMatchers/Includes.html +137 -0
data/doc/Mocha/ParameterMatchers/InstanceOf.html +137 -0
data/doc/Mocha/ParameterMatchers/IsA.html +136 -0
data/doc/Mocha/ParameterMatchers/KindOf.html +137 -0
data/doc/Mocha/ParameterMatchers/Not.html +137 -0
data/doc/Mocha/ParameterMatchers/Optionally.html +136 -0
data/doc/Mocha/ParameterMatchers/QueryStringMatches.html +136 -0
data/doc/Mocha/ParameterMatchers/RegexpMatches.html +137 -0
data/doc/Mocha/ParameterMatchers/RespondsWith.html +137 -0
data/doc/Mocha/ParameterMatchers/YamlEquivalent.html +137 -0
data/doc/Mocha/Sequence.html +133 -0
data/doc/Mocha/StateMachine.html +510 -0
data/doc/Mocha/StateMachine/State.html +125 -0
data/doc/Mocha/StateMachine/StatePredicate.html +125 -0
data/doc/Mocha/StubbingError.html +134 -0
data/doc/Mocha/UnexpectedInvocation.html +124 -0
data/doc/_index.html +481 -0
data/doc/class_list.html +47 -0
data/doc/css/common.css +1 -0
data/doc/css/full_list.css +55 -0
data/doc/css/style.css +322 -0
data/doc/file.COPYING.html +72 -0
data/doc/file.MIT-LICENSE.html +86 -0
data/doc/file.README.html +153 -0
data/doc/file.RELEASE.html +933 -0
data/doc/file.misc.html +108 -0
data/doc/file.mocha.html +90 -0
data/doc/file.stubba.html +129 -0
data/doc/file_list.html +67 -0
data/doc/frames.html +13 -0
data/doc/index.html +153 -0
data/doc/js/app.js +205 -0
data/doc/js/full_list.js +173 -0
data/doc/js/jquery.js +16 -0
data/doc/method_list.html +510 -0
data/doc/top-level-namespace.html +105 -0
data/lib/mocha/any_instance_method.rb +16 -11
data/lib/mocha/api.rb +120 -106
data/lib/mocha/argument_iterator.rb +6 -6
data/lib/mocha/backtrace_filter.rb +1 -1
data/lib/mocha/cardinality.rb +21 -21
data/lib/mocha/central.rb +8 -8
data/lib/mocha/change_state_side_effect.rb +5 -5
data/lib/mocha/class_method.rb +14 -19
data/lib/mocha/configuration.rb +47 -37
data/lib/mocha/deprecation.rb +8 -8
data/lib/mocha/exception_raiser.rb +7 -7
data/lib/mocha/expectation.rb +173 -77
data/lib/mocha/expectation_error.rb +2 -2
data/lib/mocha/expectation_list.rb +11 -11
data/lib/mocha/in_state_ordering_constraint.rb +5 -5
data/lib/mocha/inspect.rb +8 -8
data/lib/mocha/instance_method.rb +1 -17
data/lib/mocha/integration.rb +9 -9
data/lib/mocha/integration/mini_test/assertion_counter.rb +9 -9
data/lib/mocha/integration/mini_test/exception_translation.rb +6 -6
data/lib/mocha/integration/mini_test/version_13.rb +6 -6
data/lib/mocha/integration/mini_test/version_140.rb +6 -6
data/lib/mocha/integration/mini_test/version_141.rb +6 -6
data/lib/mocha/integration/mini_test/version_142_to_172.rb +7 -7
data/lib/mocha/integration/mini_test/version_200.rb +7 -7
data/lib/mocha/integration/test_unit/assertion_counter.rb +10 -10
data/lib/mocha/integration/test_unit/gem_version_200.rb +6 -6
data/lib/mocha/integration/test_unit/gem_version_201_to_202.rb +6 -6
data/lib/mocha/integration/test_unit/ruby_version_185_and_below.rb +6 -6
data/lib/mocha/integration/test_unit/ruby_version_186_and_above.rb +6 -6
data/lib/mocha/is_a.rb +1 -1
data/lib/mocha/logger.rb +6 -6
data/lib/mocha/method_matcher.rb +7 -7
data/lib/mocha/mock.rb +85 -48
data/lib/mocha/mockery.rb +47 -33
data/lib/mocha/module_method.rb +2 -2
data/lib/mocha/multiple_yields.rb +9 -9
data/lib/mocha/names.rb +18 -18
data/lib/mocha/no_yields.rb +7 -7
data/lib/mocha/object.rb +104 -75
data/lib/mocha/parameter_matchers.rb +3 -3
data/lib/mocha/parameter_matchers/all_of.rb +22 -12
data/lib/mocha/parameter_matchers/any_of.rb +23 -12
data/lib/mocha/parameter_matchers/any_parameters.rb +15 -8
data/lib/mocha/parameter_matchers/anything.rb +20 -11
data/lib/mocha/parameter_matchers/base.rb +35 -27
data/lib/mocha/parameter_matchers/equals.rb +23 -12
data/lib/mocha/parameter_matchers/has_entries.rb +22 -12
data/lib/mocha/parameter_matchers/has_entry.rb +31 -13
data/lib/mocha/parameter_matchers/has_key.rb +21 -11
data/lib/mocha/parameter_matchers/has_value.rb +21 -11
data/lib/mocha/parameter_matchers/includes.rb +15 -5
data/lib/mocha/parameter_matchers/instance_of.rb +23 -12
data/lib/mocha/parameter_matchers/is_a.rb +23 -12
data/lib/mocha/parameter_matchers/kind_of.rb +23 -12
data/lib/mocha/parameter_matchers/not.rb +22 -12
data/lib/mocha/parameter_matchers/object.rb +5 -3
data/lib/mocha/parameter_matchers/optionally.rb +24 -12
data/lib/mocha/parameter_matchers/query_string.rb +14 -3
data/lib/mocha/parameter_matchers/regexp_matches.rb +21 -11
data/lib/mocha/parameter_matchers/responds_with.rb +17 -6
data/lib/mocha/parameter_matchers/yaml_equivalent.rb +16 -6
data/lib/mocha/parameters_matcher.rb +8 -8
data/lib/mocha/pretty_parameters.rb +7 -7
data/lib/mocha/return_values.rb +11 -11
data/lib/mocha/sequence.rb +23 -14
data/lib/mocha/single_return_value.rb +7 -7
data/lib/mocha/single_yield.rb +9 -9
data/lib/mocha/standalone.rb +1 -1
data/lib/mocha/state_machine.rb +61 -46
data/lib/mocha/stubbing_error.rb +8 -5
data/lib/mocha/thrower.rb +2 -2
data/lib/mocha/unexpected_invocation.rb +9 -6
data/lib/mocha/version.rb +1 -1
data/lib/mocha/yield_parameters.rb +10 -10
data/lib/mocha_standalone.rb +1 -1
data/mocha.gemspec +4 -7
data/test/acceptance/acceptance_test_helper.rb +10 -10
data/test/acceptance/api_test.rb +20 -20
data/test/acceptance/bug_18914_test.rb +12 -12
data/test/acceptance/bug_21465_test.rb +6 -6
data/test/acceptance/bug_21563_test.rb +5 -5
data/test/acceptance/exception_rescue_test.rb +1 -1
data/test/acceptance/expected_invocation_count_test.rb +17 -17
data/test/acceptance/failure_messages_test.rb +13 -13
data/test/acceptance/minitest_test.rb +39 -39
data/test/acceptance/mocha_example_test.rb +26 -26
data/test/acceptance/mocha_test_result_test.rb +13 -13
data/test/acceptance/mock_test.rb +5 -5
data/test/acceptance/mock_with_initializer_block_test.rb +5 -5
data/test/acceptance/mocked_methods_dispatch_test.rb +4 -4
data/test/acceptance/multiple_expectations_failure_message_test.rb +2 -2
data/test/acceptance/optional_parameters_test.rb +5 -5
data/test/acceptance/parameter_matcher_test.rb +18 -18
data/test/acceptance/partial_mocks_test.rb +9 -9
data/test/acceptance/raise_exception_test.rb +1 -1
data/test/acceptance/return_value_test.rb +5 -5
data/test/acceptance/sequence_test.rb +29 -29
data/test/acceptance/states_test.rb +17 -17
data/test/acceptance/stub_any_instance_method_test.rb +13 -13
data/test/acceptance/stub_class_method_defined_on_active_record_association_proxy_test.rb +7 -7
data/test/acceptance/stub_everything_test.rb +5 -5
data/test/acceptance/stub_instance_method_defined_on_singleton_class_test.rb +1 -1
data/test/acceptance/stub_module_method_test.rb +17 -17
data/test/acceptance/stub_test.rb +5 -5
data/test/acceptance/stubba_example_test.rb +24 -24
data/test/acceptance/stubba_test_result_test.rb +11 -11
data/test/acceptance/stubbing_error_backtrace_test.rb +6 -6
data/test/acceptance/stubbing_frozen_object_test.rb +88 -0
data/test/acceptance/stubbing_method_unnecessarily_test.rb +9 -9
data/test/acceptance/stubbing_nil_test.rb +59 -0
data/test/acceptance/stubbing_non_existent_any_instance_method_test.rb +13 -13
data/test/acceptance/stubbing_non_existent_class_method_test.rb +15 -15
data/test/acceptance/stubbing_non_existent_instance_method_test.rb +14 -14
data/test/acceptance/stubbing_non_public_any_instance_method_test.rb +13 -13
data/test/acceptance/stubbing_non_public_class_method_test.rb +12 -12
data/test/acceptance/stubbing_non_public_instance_method_test.rb +12 -12
data/test/acceptance/stubbing_on_non_mock_object_test.rb +9 -9
data/test/acceptance/stubbing_same_class_method_on_parent_and_child_classes_test.rb +35 -0
data/test/acceptance/throw_test.rb +1 -1
data/test/deprecation_disabler.rb +1 -1
data/test/execution_point.rb +7 -7
data/test/method_definer.rb +1 -1
data/test/mini_test_result.rb +21 -21
data/test/simple_counter.rb +5 -5
data/test/test_helper.rb +1 -1
data/test/test_runner.rb +22 -24
data/test/test_unit_result.rb +20 -0
data/test/unit/any_instance_method_test.rb +28 -32
data/test/unit/array_inspect_test.rb +3 -3
data/test/unit/backtrace_filter_test.rb +3 -3
data/test/unit/cardinality_test.rb +12 -12
data/test/unit/central_test.rb +18 -18
data/test/unit/change_state_side_effect_test.rb +12 -12
data/test/unit/class_method_test.rb +33 -91
data/test/unit/date_time_inspect_test.rb +4 -4
data/test/unit/exception_raiser_test.rb +5 -5
data/test/unit/expectation_list_test.rb +7 -7
data/test/unit/expectation_test.rb +66 -66
data/test/unit/hash_inspect_test.rb +4 -4
data/test/unit/in_state_ordering_constraint_test.rb +13 -13
data/test/unit/method_matcher_test.rb +3 -3
data/test/unit/mock_test.rb +40 -40
data/test/unit/mockery_test.rb +25 -25
data/test/unit/multiple_yields_test.rb +2 -2
data/test/unit/no_yields_test.rb +2 -2
data/test/unit/object_inspect_test.rb +4 -4
data/test/unit/object_test.rb +15 -15
data/test/unit/parameter_matchers/all_of_test.rb +6 -6
data/test/unit/parameter_matchers/any_of_test.rb +6 -6
data/test/unit/parameter_matchers/anything_test.rb +5 -5
data/test/unit/parameter_matchers/has_entries_test.rb +10 -10
data/test/unit/parameter_matchers/has_entry_test.rb +13 -13
data/test/unit/parameter_matchers/has_key_test.rb +11 -11
data/test/unit/parameter_matchers/has_value_test.rb +12 -12
data/test/unit/parameter_matchers/includes_test.rb +4 -4
data/test/unit/parameter_matchers/not_test.rb +6 -6
data/test/unit/parameter_matchers/regexp_matches_test.rb +9 -9
data/test/unit/parameter_matchers/responds_with_test.rb +6 -6
data/test/unit/parameter_matchers/stub_matcher.rb +4 -4
data/test/unit/parameter_matchers/yaml_equivalent_test.rb +6 -6
data/test/unit/parameters_matcher_test.rb +16 -16
data/test/unit/return_values_test.rb +5 -5
data/test/unit/sequence_test.rb +10 -10
data/test/unit/single_return_value_test.rb +3 -3
data/test/unit/single_yield_test.rb +2 -2
data/test/unit/state_machine_test.rb +19 -19
data/test/unit/string_inspect_test.rb +2 -2
data/test/unit/thrower_test.rb +1 -1
data/test/unit/yield_parameters_test.rb +11 -11
metadata +113 -101

data/doc/Mocha/ObjectMethods.html ADDED

@@ -0,0 +1,668 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>
+  Module: Mocha::ObjectMethods
+    &mdash; Mocha 0.11.0
+</title>
+  <link rel="stylesheet" href="../css/style.css" type="text/css" media="screen" charset="utf-8" />
+  <link rel="stylesheet" href="../css/common.css" type="text/css" media="screen" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  relpath = '..';
+  if (relpath != '') relpath += '/';
+</script>
+  <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
+  <script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
+  </head>
+  <body>
+    <script type="text/javascript" charset="utf-8">
+      if (window.top.frames.main) document.body.className = 'frames';
+    </script>
+    <div id="header">
+      <div id="menu">
+    <a href="../_index.html">Index (O)</a> &raquo;
+    <span class='title'><span class='object_link'><a href="../Mocha.html" title="Mocha (module)">Mocha</a></span></span>
+     &raquo;
+    <span class="title">ObjectMethods</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+    <a id="class_list_link" href="#">Class List</a>
+    <a id="method_list_link" href="#">Method List</a>
+    <a id="file_list_link" href="#">File List</a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><h1>Module: Mocha::ObjectMethods
+</h1>
+<dl class="box">
+    <dt class="r1 last">Defined in:</dt>
+    <dd class="r1 last">lib/mocha/object.rb<span class="defines">,<br />
+  lib/mocha/parameter_matchers/object.rb</span>
+</dd>
+</dl>
+<div class="clear"></div>
+<h2>Overview</h2><div class="docstring">
+  <div class="discussion">
+<p>Methods added to all objects to allow mocking and stubbing on real (i.e.
+non-mock) objects.</p>
+<p>Both <span class='object_link'><a href="#expects-instance_method" title="Mocha::ObjectMethods#expects (method)">#expects</a></span> and <span class='object_link'><a href="#stubs-instance_method" title="Mocha::ObjectMethods#stubs (method)">#stubs</a></span> return an <span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span> which can be further
+modified by methods on <span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span>.</p>
+  </div>
+</div>
+<div class="tags">
+</div>
+    <h2>
+      Instance Method Summary
+      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
+    </h2>
+    <ul class="summary">
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#expects-instance_method" title="#expects (instance method)">- (Expectation) <strong>expects</strong>(expected_methods_vs_return_values) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Adds an expectation that the specified method must be called exactly once
+with any parameters.</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#stubs-instance_method" title="#stubs (instance method)">- (Expectation) <strong>stubs</strong>(stubbed_methods_vs_return_values) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Adds an expectation that the specified method may be called any number of
+times with any parameters.</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#unstub-instance_method" title="#unstub (instance method)">- (Object) <strong>unstub</strong>(*method_names) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Removes the specified stubbed methods (added by calls to <span class='object_link'><a href="#expects-instance_method" title="Mocha::ObjectMethods#expects (method)">#expects</a></span> or
+<span class='object_link'><a href="#stubs-instance_method" title="Mocha::ObjectMethods#stubs (method)">#stubs</a></span>) and all expectations associated with them.</p>
+</div></span>
+</li>
+    </ul>
+  <div id="instance_method_details" class="method_details_list">
+    <h2>Instance Method Details</h2>
+      <div class="method_details first">
+  <p class="signature first" id="expects-instance_method">
+      <span class="overload">- (<tt><span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span></tt>) <strong>expects</strong>(method_name) </span>
+      <span class="overload">- (<tt><span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span></tt>) <strong>expects</strong>(expected_methods_vs_return_values) </span>
+</p><div class="docstring">
+  <div class="discussion">
+<p>Adds an expectation that the specified method must be called exactly once
+with any parameters.</p>
+<p>The original implementation of the method is replaced during the test and
+then restored at the end of the test.</p>
+  </div>
+</div>
+<div class="tags">
+  <div class="examples">
+    <h3>Examples:</h3>
+      <h4><div class='inline'>
+<p>Setting up an expectation on a non-mock object.</p>
+</div></h4>
+      <pre class="example code"><span class='id identifier rubyid_product'>product</span> <span class='op'>=</span> <span class='const'>Product</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+<span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_expects'>expects</span><span class='lparen'>(</span><span class='symbol'>:save</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_returns'>returns</span><span class='lparen'>(</span><span class='kw'>true</span><span class='rparen'>)</span>
+<span class='id identifier rubyid_assert_equal'>assert_equal</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_save'>save</span></pre>
+      <h4><div class='inline'>
+<p>Setting up multiple expectations on a non-mock object.</p>
+</div></h4>
+      <pre class="example code"><span class='id identifier rubyid_product'>product</span> <span class='op'>=</span> <span class='const'>Product</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+<span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_expects'>expects</span><span class='lparen'>(</span><span class='symbol'>:valid?</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:save</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='rparen'>)</span>
+<span class='comment'># exactly equivalent to
+</span>
+<span class='id identifier rubyid_product'>product</span> <span class='op'>=</span> <span class='const'>Product</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+<span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_expects'>expects</span><span class='lparen'>(</span><span class='symbol'>:valid?</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_returns'>returns</span><span class='lparen'>(</span><span class='kw'>true</span><span class='rparen'>)</span>
+<span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_expects'>expects</span><span class='lparen'>(</span><span class='symbol'>:save</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_returns'>returns</span><span class='lparen'>(</span><span class='kw'>true</span><span class='rparen'>)</span></pre>
+  </div>
+<h3>Parameters:</h3>
+<ul class="param">
+    <li>
+        <span class='name'>method_name</span>
+        <span class='type'>(<tt>Symbol</tt>, <tt>String</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>name of expected method</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>expected_methods_vs_return_values</span>
+        <span class='type'>(<tt>Hash</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>expected method name symbols as keys and corresponding return values as
+values - these expectations are setup as if <span class='object_link'><a href="#expects-instance_method" title="Mocha::ObjectMethods#expects (method)">#expects</a></span> were called multiple
+times.</p>
+</div>
+    </li>
+</ul>
+<h3>Returns:</h3>
+<ul class="return">
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>last-built expectation which can be further modified by methods on
+<span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span>.</p>
+</div>
+    </li>
+</ul>
+<h3>Raises:</h3>
+<ul class="raise">
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="StubbingError.html" title="Mocha::StubbingError (class)">StubbingError</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>if attempting to stub method which is not allowed.</p>
+</div>
+    </li>
+</ul>
+  <h3>See Also:</h3>
+  <ul class="see">
+      <li><span class='object_link'><a href="Mock.html#expects-instance_method" title="Mocha::Mock#expects (method)">Mock#expects</a></span></li>
+  </ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+63
+64
+65
+66
+67
+68
+69
+70
+71
+72
+73
+74
+75
+76
+77
+78
+79
+80
+81
+82</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/mocha/object.rb', line 63</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_expects'>expects</span><span class='lparen'>(</span><span class='id identifier rubyid_expected_methods_vs_return_values'>expected_methods_vs_return_values</span><span class='rparen'>)</span>
+  <span class='kw'>if</span> <span class='id identifier rubyid_expected_methods_vs_return_values'>expected_methods_vs_return_values</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span> <span class='op'>=~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>the[^a-z]*spanish[^a-z]*inquisition</span><span class='regexp_end'>/i</span></span>
+    <span class='id identifier rubyid_raise'>raise</span> <span class='const'>Mocha</span><span class='op'>::</span><span class='const'>ExpectationError</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>NOBODY EXPECTS THE SPANISH INQUISITION!</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
+  <span class='kw'>if</span> <span class='id identifier rubyid_frozen?'>frozen?</span>
+    <span class='id identifier rubyid_raise'>raise</span> <span class='const'>StubbingError</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>can't stub method on frozen object: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_mocha_inspect'>mocha_inspect</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_caller'>caller</span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
+  <span class='id identifier rubyid_expectation'>expectation</span> <span class='op'>=</span> <span class='kw'>nil</span>
+  <span class='id identifier rubyid_mockery'>mockery</span> <span class='op'>=</span> <span class='const'>Mocha</span><span class='op'>::</span><span class='const'>Mockery</span><span class='period'>.</span><span class='id identifier rubyid_instance'>instance</span>
+  <span class='id identifier rubyid_iterator'>iterator</span> <span class='op'>=</span> <span class='const'>ArgumentIterator</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_expected_methods_vs_return_values'>expected_methods_vs_return_values</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_iterator'>iterator</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='op'>|</span>
+    <span class='id identifier rubyid_method_name'>method_name</span> <span class='op'>=</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_shift'>shift</span>
+    <span class='id identifier rubyid_mockery'>mockery</span><span class='period'>.</span><span class='id identifier rubyid_on_stubbing'>on_stubbing</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span> <span class='id identifier rubyid_method_name'>method_name</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_method'>method</span> <span class='op'>=</span> <span class='id identifier rubyid_stubba_method'>stubba_method</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_stubba_object'>stubba_object</span><span class='comma'>,</span> <span class='id identifier rubyid_method_name'>method_name</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_mockery'>mockery</span><span class='period'>.</span><span class='id identifier rubyid_stubba'>stubba</span><span class='period'>.</span><span class='id identifier rubyid_stub'>stub</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_expectation'>expectation</span> <span class='op'>=</span> <span class='id identifier rubyid_mocha'>mocha</span><span class='period'>.</span><span class='id identifier rubyid_expects'>expects</span><span class='lparen'>(</span><span class='id identifier rubyid_method_name'>method_name</span><span class='comma'>,</span> <span class='id identifier rubyid_caller'>caller</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_expectation'>expectation</span><span class='period'>.</span><span class='id identifier rubyid_returns'>returns</span><span class='lparen'>(</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_shift'>shift</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span> <span class='op'>&gt;</span> <span class='int'>0</span>
+  <span class='rbrace'>}</span>
+  <span class='id identifier rubyid_expectation'>expectation</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="stubs-instance_method">
+      <span class="overload">- (<tt><span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span></tt>) <strong>stubs</strong>(method_name) </span>
+      <span class="overload">- (<tt><span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span></tt>) <strong>stubs</strong>(stubbed_methods_vs_return_values) </span>
+</p><div class="docstring">
+  <div class="discussion">
+<p>Adds an expectation that the specified method may be called any number of
+times with any parameters.</p>
+  </div>
+</div>
+<div class="tags">
+  <div class="examples">
+    <h3>Examples:</h3>
+      <h4><div class='inline'>
+<p>Setting up a stubbed methods on a non-mock object.</p>
+</div></h4>
+      <pre class="example code"><span class='id identifier rubyid_product'>product</span> <span class='op'>=</span> <span class='const'>Product</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+<span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_stubs'>stubs</span><span class='lparen'>(</span><span class='symbol'>:save</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_returns'>returns</span><span class='lparen'>(</span><span class='kw'>true</span><span class='rparen'>)</span>
+<span class='id identifier rubyid_assert_equal'>assert_equal</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_save'>save</span></pre>
+      <h4><div class='inline'>
+<p>Setting up multiple stubbed methods on a non-mock object.</p>
+</div></h4>
+      <pre class="example code"><span class='id identifier rubyid_product'>product</span> <span class='op'>=</span> <span class='const'>Product</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+<span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_stubs'>stubs</span><span class='lparen'>(</span><span class='symbol'>:valid?</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:save</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='rparen'>)</span>
+<span class='comment'># exactly equivalent to
+</span>
+<span class='id identifier rubyid_product'>product</span> <span class='op'>=</span> <span class='const'>Product</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+<span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_stubs'>stubs</span><span class='lparen'>(</span><span class='symbol'>:valid?</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_returns'>returns</span><span class='lparen'>(</span><span class='kw'>true</span><span class='rparen'>)</span>
+<span class='id identifier rubyid_product'>product</span><span class='period'>.</span><span class='id identifier rubyid_stubs'>stubs</span><span class='lparen'>(</span><span class='symbol'>:save</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_returns'>returns</span><span class='lparen'>(</span><span class='kw'>true</span><span class='rparen'>)</span></pre>
+  </div>
+<h3>Parameters:</h3>
+<ul class="param">
+    <li>
+        <span class='name'>method_name</span>
+        <span class='type'>(<tt>Symbol</tt>, <tt>String</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>name of stubbed method</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>stubbed_methods_vs_return_values</span>
+        <span class='type'>(<tt>Hash</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>stubbed method name symbols as keys and corresponding return values as
+values - these stubbed methods are setup as if <span class='object_link'><a href="#stubs-instance_method" title="Mocha::ObjectMethods#stubs (method)">#stubs</a></span> were called
+multiple times.</p>
+</div>
+    </li>
+</ul>
+<h3>Returns:</h3>
+<ul class="return">
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>last-built expectation which can be further modified by methods on
+<span class='object_link'><a href="Expectation.html" title="Mocha::Expectation (class)">Expectation</a></span>.</p>
+</div>
+    </li>
+</ul>
+<h3>Raises:</h3>
+<ul class="raise">
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="StubbingError.html" title="Mocha::StubbingError (class)">StubbingError</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>if attempting to stub method which is not allowed.</p>
+</div>
+    </li>
+</ul>
+  <h3>See Also:</h3>
+  <ul class="see">
+      <li><span class='object_link'><a href="Mock.html#stubs-instance_method" title="Mocha::Mock#stubs (method)">Mock#stubs</a></span></li>
+  </ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+110
+111
+112
+113
+114
+115
+116
+117
+118
+119
+120
+121
+122
+123
+124
+125
+126</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/mocha/object.rb', line 110</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_stubs'>stubs</span><span class='lparen'>(</span><span class='id identifier rubyid_stubbed_methods_vs_return_values'>stubbed_methods_vs_return_values</span><span class='rparen'>)</span>
+  <span class='kw'>if</span> <span class='id identifier rubyid_frozen?'>frozen?</span>
+    <span class='id identifier rubyid_raise'>raise</span> <span class='const'>StubbingError</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>can't stub method on frozen object: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_mocha_inspect'>mocha_inspect</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_caller'>caller</span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
+  <span class='id identifier rubyid_expectation'>expectation</span> <span class='op'>=</span> <span class='kw'>nil</span>
+  <span class='id identifier rubyid_mockery'>mockery</span> <span class='op'>=</span> <span class='const'>Mocha</span><span class='op'>::</span><span class='const'>Mockery</span><span class='period'>.</span><span class='id identifier rubyid_instance'>instance</span>
+  <span class='id identifier rubyid_iterator'>iterator</span> <span class='op'>=</span> <span class='const'>ArgumentIterator</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_stubbed_methods_vs_return_values'>stubbed_methods_vs_return_values</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_iterator'>iterator</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='op'>|</span>
+    <span class='id identifier rubyid_method_name'>method_name</span> <span class='op'>=</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_shift'>shift</span>
+    <span class='id identifier rubyid_mockery'>mockery</span><span class='period'>.</span><span class='id identifier rubyid_on_stubbing'>on_stubbing</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span> <span class='id identifier rubyid_method_name'>method_name</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_method'>method</span> <span class='op'>=</span> <span class='id identifier rubyid_stubba_method'>stubba_method</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_stubba_object'>stubba_object</span><span class='comma'>,</span> <span class='id identifier rubyid_method_name'>method_name</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_mockery'>mockery</span><span class='period'>.</span><span class='id identifier rubyid_stubba'>stubba</span><span class='period'>.</span><span class='id identifier rubyid_stub'>stub</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_expectation'>expectation</span> <span class='op'>=</span> <span class='id identifier rubyid_mocha'>mocha</span><span class='period'>.</span><span class='id identifier rubyid_stubs'>stubs</span><span class='lparen'>(</span><span class='id identifier rubyid_method_name'>method_name</span><span class='comma'>,</span> <span class='id identifier rubyid_caller'>caller</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_expectation'>expectation</span><span class='period'>.</span><span class='id identifier rubyid_returns'>returns</span><span class='lparen'>(</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_shift'>shift</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span> <span class='op'>&gt;</span> <span class='int'>0</span>
+  <span class='rbrace'>}</span>
+  <span class='id identifier rubyid_expectation'>expectation</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <p class="signature " id="unstub-instance_method">
+    - (<tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>) <strong>unstub</strong>(*method_names)
+</p><div class="docstring">
+  <div class="discussion">
+<p>Removes the specified stubbed methods (added by calls to <span class='object_link'><a href="#expects-instance_method" title="Mocha::ObjectMethods#expects (method)">#expects</a></span> or
+<span class='object_link'><a href="#stubs-instance_method" title="Mocha::ObjectMethods#stubs (method)">#stubs</a></span>) and all expectations associated with them.</p>
+<p>Restores the original behaviour of the methods before they were stubbed.</p>
+<p>WARNING: If you <span class='object_link'><a href="#unstub-instance_method" title="Mocha::ObjectMethods#unstub (method)">#unstub</a></span> a method which still has unsatisfied
+expectations, you may be removing the only way those expectations can be
+satisfied. Use <span class='object_link'><a href="#unstub-instance_method" title="Mocha::ObjectMethods#unstub (method)">#unstub</a></span> with care.</p>
+  </div>
+</div>
+<div class="tags">
+  <div class="examples">
+    <h3>Examples:</h3>
+      <h4><div class='inline'>
+<p>Stubbing and unstubbing a method on a real (non-mock) object.</p>
+</div></h4>
+      <pre class="example code"><span class='id identifier rubyid_multiplier'>multiplier</span> <span class='op'>=</span> <span class='const'>Multiplier</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+<span class='id identifier rubyid_multiplier'>multiplier</span><span class='period'>.</span><span class='id identifier rubyid_double'>double</span><span class='lparen'>(</span><span class='int'>2</span><span class='rparen'>)</span> <span class='comment'># =&gt; 4
+</span><span class='id identifier rubyid_multiplier'>multiplier</span><span class='period'>.</span><span class='id identifier rubyid_stubs'>stubs</span><span class='lparen'>(</span><span class='symbol'>:double</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_raises'>raises</span> <span class='comment'># new behaviour defined
+</span><span class='id identifier rubyid_multiplier'>multiplier</span><span class='period'>.</span><span class='id identifier rubyid_double'>double</span><span class='lparen'>(</span><span class='int'>2</span><span class='rparen'>)</span> <span class='comment'># =&gt; raises exception
+</span><span class='id identifier rubyid_multiplier'>multiplier</span><span class='period'>.</span><span class='id identifier rubyid_unstub'>unstub</span><span class='lparen'>(</span><span class='symbol'>:double</span><span class='rparen'>)</span> <span class='comment'># original behaviour restored
+</span><span class='id identifier rubyid_multiplier'>multiplier</span><span class='period'>.</span><span class='id identifier rubyid_double'>double</span><span class='lparen'>(</span><span class='int'>2</span><span class='rparen'>)</span> <span class='comment'># =&gt; 4</span></pre>
+      <h4><div class='inline'>
+<p>Unstubbing multiple methods on a real (non-mock) object.</p>
+</div></h4>
+      <pre class="example code"><span class='id identifier rubyid_multiplier'>multiplier</span><span class='period'>.</span><span class='id identifier rubyid_unstub'>unstub</span><span class='lparen'>(</span><span class='symbol'>:double</span><span class='comma'>,</span> <span class='symbol'>:triple</span><span class='rparen'>)</span>
+<span class='comment'># exactly equivalent to
+</span>
+<span class='id identifier rubyid_multiplier'>multiplier</span><span class='period'>.</span><span class='id identifier rubyid_unstub'>unstub</span><span class='lparen'>(</span><span class='symbol'>:double</span><span class='rparen'>)</span>
+<span class='id identifier rubyid_multiplier'>multiplier</span><span class='period'>.</span><span class='id identifier rubyid_unstub'>unstub</span><span class='lparen'>(</span><span class='symbol'>:triple</span><span class='rparen'>)</span></pre>
+  </div>
+<h3>Parameters:</h3>
+<ul class="param">
+    <li>
+        <span class='name'>method_names</span>
+        <span class='type'>(<tt>Array&lt;Symbol&gt;</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>names of methods to unstub.</p>
+</div>
+    </li>
+</ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+151
+152
+153
+154
+155
+156
+157</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/mocha/object.rb', line 151</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_unstub'>unstub</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid_method_names'>method_names</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_mockery'>mockery</span> <span class='op'>=</span> <span class='const'>Mocha</span><span class='op'>::</span><span class='const'>Mockery</span><span class='period'>.</span><span class='id identifier rubyid_instance'>instance</span>
+  <span class='id identifier rubyid_method_names'>method_names</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_method_name'>method_name</span><span class='op'>|</span>
+    <span class='id identifier rubyid_method'>method</span> <span class='op'>=</span> <span class='id identifier rubyid_stubba_method'>stubba_method</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_stubba_object'>stubba_object</span><span class='comma'>,</span> <span class='id identifier rubyid_method_name'>method_name</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_mockery'>mockery</span><span class='period'>.</span><span class='id identifier rubyid_stubba'>stubba</span><span class='period'>.</span><span class='id identifier rubyid_unstub'>unstub</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+  </div>
+</div>
+    <div id="footer">
+  Generated on Thu Apr 19 10:54:34 2012 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.7.5 (ruby-1.9.3).
+</div>
+  </body>
+</html>