rr 0.2.2 → 0.2.3

data/CHANGES

@@ -1,3 +1,6 @@
+* 0.2.3
+- Added InstanceMethods#rr_verify and InstanceMethods#rr_reset
+
 * 0.2.2
 - Fixed "singleton method bound for a different object"
 - Doing Method aliasing again to store original method

data/README

@@ -18,21 +18,37 @@ http://xunitpatterns.com/Test%20Stub.html
   stub(User).find('42') {jane}
   mock(jane).valid? {true}
 
-== Probing
+== Mock Probing
 Add verifications that a method was called while actually calling it.
 The following example verifies render partial will be called and
 renders the partial.
 
   view = controller.template
   probe(view).render(:partial => "user_info")
+  # or mock_probe.render(:partial => "user_info")
 
 Probes also support after_call callbacks. This is useful for Stubbing out
-a class method and getting its return value. For example, using ActiveRecord:
+a class method and getting its return value. You can also change the return value.
+This technique is also useful for verifying that you are mocking exists and
+functions proberly, thereby testing you interface.
+For example, using ActiveRecord:
 
   probe(User).find('5') do |user|
     mock(user).valid? {false}
+    user
   end
-  
+
+== Mock Stubbing
+Intercept the return value of a method call.
+The following example verifies render partial will be called and
+renders the partial.
+
+  view = controller.template
+  stub_probe(view).render(:partial => "user_info") do |html|
+    html.should include("Joe Smith")
+    html
+  end
+
 == Block Syntax
   script = MyScript.new
   mock(script) do |m|

data/Rakefile

@@ -21,7 +21,7 @@ def run_suite
 end
 
 PKG_NAME = "rr"
-PKG_VERSION = "0.2.2"
+PKG_VERSION = "0.2.3"
 PKG_FILES = FileList[
   '[A-Z]*',
   '*.rb',

data/examples/rr/extensions/instance_methods_space_example.rb

@@ -0,0 +1,122 @@
+require "examples/example_helper"
+
+module RR
+module Extensions
+  describe InstanceMethods, " space example", :shared => true do
+    it_should_behave_like "RR::Extensions::InstanceMethods"
+    before do
+      @old_space = Space.instance
+
+      @space = Space.new
+      Space.instance = @space
+      @object1 = Object.new
+      @object2 = Object.new
+      @method_name = :foobar
+    end
+
+    after do
+      Space.instance = @old_space
+    end
+  end
+
+  describe InstanceMethods, "#verify" do
+    it_should_behave_like "RR::Extensions::InstanceMethods space example"
+
+    it "#verify verifies and deletes the doubles" do
+      should verify_all_doubles {verify}
+    end
+
+    it "#rr_verify verifies and deletes the doubles" do
+      should verify_all_doubles {rr_verify}
+    end
+
+    def verify_all_doubles
+      double1 = @space.create_double(@object1, @method_name)
+      double1_verify_calls = 0
+      double1_reset_calls = 0
+      (class << double1; self; end).class_eval do
+        define_method(:verify) do ||
+          double1_verify_calls += 1
+        end
+        define_method(:reset) do ||
+          double1_reset_calls += 1
+        end
+      end
+      double2 = @space.create_double(@object2, @method_name)
+      double2_verify_calls = 0
+      double2_reset_calls = 0
+      (class << double2; self; end).class_eval do
+        define_method(:verify) do ||
+          double2_verify_calls += 1
+        end
+        define_method(:reset) do ||
+          double2_reset_calls += 1
+        end
+      end
+
+      yield
+      double1_verify_calls.should == 1
+      double2_verify_calls.should == 1
+      double1_reset_calls.should == 1
+      double1_reset_calls.should == 1
+    end
+  end
+
+  describe InstanceMethods, "#reset" do
+    it_should_behave_like "RR::Extensions::InstanceMethods space example"
+
+    it "#reset removes the ordered scenarios" do
+      should remove_ordered_scenarios {reset}
+    end
+
+    it "#rr_reset removes the ordered scenarios" do
+      should remove_ordered_scenarios {rr_reset}
+    end
+
+    it "#reset resets all doubles" do
+      should reset_all_doubles {reset}
+    end
+
+    it "#rr_reset resets all doubles" do
+      should reset_all_doubles {rr_reset}
+    end
+
+    def remove_ordered_scenarios
+      double1 = @space.create_double(@object1, :foobar1)
+      double2 = @space.create_double(@object1, :foobar2)
+
+      scenario1 = @space.create_scenario(double1)
+      scenario2 = @space.create_scenario(double2)
+
+      scenario1.ordered
+      scenario2.ordered
+
+      @space.ordered_scenarios.should_not be_empty
+
+      yield
+      @space.ordered_scenarios.should be_empty
+    end
+
+    def reset_all_doubles
+      double1 = @space.create_double(@object1, @method_name)
+      double1_reset_calls = 0
+      (class << double1; self; end).class_eval do
+        define_method(:reset) do ||
+          double1_reset_calls += 1
+        end
+      end
+      double2 = @space.create_double(@object2, @method_name)
+      double2_reset_calls = 0
+      (class << double2; self; end).class_eval do
+        define_method(:reset) do ||
+          double2_reset_calls += 1
+        end
+      end
+
+      yield
+      double1_reset_calls.should == 1
+      double2_reset_calls.should == 1
+    end
+  end
+end
+end

data/lib/rr/adapters/rspec.rb

@@ -6,13 +6,13 @@ module RR
     module Rspec
       include RR::Extensions::InstanceMethods
       def setup_mocks_for_rspec
-        RR::Space.instance.reset
+        rr_reset
       end
       def verify_mocks_for_rspec
-        RR::Space.instance.verify_doubles
+        rr_verify
       end
       def teardown_mocks_for_rspec
-        RR::Space.instance.reset
+        rr_reset
       end
     end
   end

data/lib/rr/adapters/test_unit.rb

@@ -9,13 +9,13 @@ module RR
           alias_method :setup_without_rr, :setup
           def setup_with_rr
             setup_without_rr
-            RR::Space.instance.reset
+            rr_reset
           end
           alias_method :setup, :setup_with_rr
 
           alias_method :teardown_without_rr, :teardown
           def teardown_with_rr
-            RR::Space.instance.verify_doubles
+            rr_verify
             teardown_without_rr
           end
           alias_method :teardown, :teardown_with_rr

data/lib/rr/extensions/instance_methods.rb

@@ -1,6 +1,17 @@
 module RR
 module Extensions
   module InstanceMethods
+    # Verifies all the Double objects have met their
+    # TimesCalledExpectations.
+    def verify
+      RR::Space.instance.verify_doubles
+    end
+
+    # Resets the registered Doubles and ordered Scenarios
+    def reset
+      RR::Space.instance.reset
+    end
+
     # Sets up a MockCreator that generates a Double Scenario that
     # acts like a mock.
     #   mock(object).method_name(arg1, arg2) {return_value}

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.3
+rubygems_version: 0.9.2
 specification_version: 1
 name: rr
 version: !ruby/object:Gem::Version 
-  version: 0.2.2
-date: 2007-07-17 00:00:00 -07:00
+  version: 0.2.3
+date: 2007-07-18 00:00:00 -07:00
 summary: RR (Double Ruby) is a double framework that features a rich selection of double techniques and a terse syntax. http://xunitpatterns.com/Test%20Double.html
 require_paths: 
 - lib
@@ -29,106 +29,107 @@ post_install_message:
 authors: 
 - Brian Takita
 files: 
+- README
 - Rakefile
 - CHANGES
-- README
-- lib/rr.rb
-- lib/rr/mock_probe_creator.rb
-- lib/rr/scenario.rb
-- lib/rr/creator.rb
-- lib/rr/stub_probe_creator.rb
-- lib/rr/scenario_matches.rb
-- lib/rr/stub_creator.rb
-- lib/rr/space.rb
-- lib/rr/double.rb
-- lib/rr/do_not_allow_creator.rb
-- lib/rr/mock_creator.rb
-- lib/rr/times_called_matchers/any_times_matcher.rb
-- lib/rr/times_called_matchers/at_most_matcher.rb
-- lib/rr/times_called_matchers/times_called_matcher.rb
-- lib/rr/times_called_matchers/at_least_matcher.rb
-- lib/rr/times_called_matchers/proc_matcher.rb
-- lib/rr/times_called_matchers/integer_matcher.rb
-- lib/rr/times_called_matchers/non_terminal.rb
-- lib/rr/times_called_matchers/terminal.rb
-- lib/rr/times_called_matchers/range_matcher.rb
+- lib/rr/extensions/instance_methods.rb
+- lib/rr/adapters/test_unit.rb
+- lib/rr/adapters/rspec.rb
 - lib/rr/expectations/argument_equality_expectation.rb
 - lib/rr/expectations/times_called_expectation.rb
 - lib/rr/expectations/any_argument_expectation.rb
+- lib/rr/scenario.rb
+- lib/rr/stub_creator.rb
+- lib/rr/errors/times_called_error.rb
 - lib/rr/errors/scenario_not_found_error.rb
-- lib/rr/errors/argument_equality_error.rb
 - lib/rr/errors/scenario_order_error.rb
+- lib/rr/errors/argument_equality_error.rb
 - lib/rr/errors/rr_error.rb
-- lib/rr/errors/times_called_error.rb
-- lib/rr/adapters/test_unit.rb
-- lib/rr/adapters/rspec.rb
+- lib/rr/do_not_allow_creator.rb
+- lib/rr/mock_creator.rb
+- lib/rr/double.rb
+- lib/rr/space.rb
+- lib/rr/creator.rb
 - lib/rr/wildcard_matchers/boolean.rb
+- lib/rr/wildcard_matchers/anything.rb
+- lib/rr/wildcard_matchers/numeric.rb
 - lib/rr/wildcard_matchers/duck_type.rb
-- lib/rr/wildcard_matchers/range.rb
 - lib/rr/wildcard_matchers/regexp.rb
-- lib/rr/wildcard_matchers/numeric.rb
 - lib/rr/wildcard_matchers/is_a.rb
-- lib/rr/wildcard_matchers/anything.rb
-- lib/rr/extensions/instance_methods.rb
-- examples/environment_fixture_setup.rb
-- examples/rspec_example_suite.rb
-- examples/example_suite.rb
-- examples/example_helper.rb
-- examples/test_unit_example_suite.rb
-- examples/high_level_example.rb
-- examples/rr/stub_probe_creator_example.rb
-- examples/rr/mock_creator_example.rb
-- examples/rr/stub_creator_example.rb
-- examples/rr/scenario_example.rb
-- examples/rr/do_not_allow_creator_example.rb
-- examples/rr/mock_probe_creator_example.rb
-- examples/rr/rspec/rspec_backtrace_tweaking_example.rb
-- examples/rr/rspec/rspec_adapter_example.rb
-- examples/rr/rspec/rspec_usage_example.rb
-- examples/rr/times_called_matchers/at_most_matcher_example.rb
-- examples/rr/times_called_matchers/at_least_matcher_example.rb
-- examples/rr/times_called_matchers/times_called_matcher_example.rb
-- examples/rr/times_called_matchers/range_matcher_example.rb
-- examples/rr/times_called_matchers/proc_matcher_example.rb
-- examples/rr/times_called_matchers/any_times_matcher_example.rb
-- examples/rr/times_called_matchers/integer_matcher_example.rb
-- examples/rr/space/space_verify_example.rb
-- examples/rr/space/space_reset_example.rb
-- examples/rr/space/space_create_example.rb
-- examples/rr/space/space_helper.rb
-- examples/rr/space/space_example.rb
-- examples/rr/space/space_register_example.rb
-- examples/rr/expectations/is_a_argument_equality_expectation_example.rb
-- examples/rr/expectations/any_argument_expectation_example.rb
-- examples/rr/expectations/regexp_argument_equality_expectation_example.rb
-- examples/rr/expectations/boolean_argument_equality_expectation_example.rb
-- examples/rr/expectations/duck_type_argument_equality_expectation_example.rb
-- examples/rr/expectations/numeric_argument_equality_expectation_example.rb
-- examples/rr/expectations/range_argument_equality_expectation_example.rb
+- lib/rr/wildcard_matchers/range.rb
+- lib/rr/times_called_matchers/at_least_matcher.rb
+- lib/rr/times_called_matchers/range_matcher.rb
+- lib/rr/times_called_matchers/integer_matcher.rb
+- lib/rr/times_called_matchers/non_terminal.rb
+- lib/rr/times_called_matchers/proc_matcher.rb
+- lib/rr/times_called_matchers/times_called_matcher.rb
+- lib/rr/times_called_matchers/at_most_matcher.rb
+- lib/rr/times_called_matchers/any_times_matcher.rb
+- lib/rr/times_called_matchers/terminal.rb
+- lib/rr/stub_probe_creator.rb
+- lib/rr/mock_probe_creator.rb
+- lib/rr/scenario_matches.rb
+- lib/rr.rb
+- examples/rr/extensions/instance_methods_creator_example.rb
+- examples/rr/extensions/instance_methods_example_helper.rb
+- examples/rr/extensions/instance_methods_times_matcher_example.rb
+- examples/rr/extensions/instance_methods_argument_matcher_example.rb
+- examples/rr/extensions/instance_methods_space_example.rb
 - examples/rr/expectations/argument_equality_expectation_example.rb
 - examples/rr/expectations/anything_argument_equality_expectation_example.rb
+- examples/rr/expectations/times_called_expectation/times_called_expectation_at_least_example.rb
+- examples/rr/expectations/times_called_expectation/times_called_expectation_range_example.rb
 - examples/rr/expectations/times_called_expectation/times_called_expectation_integer_example.rb
-- examples/rr/expectations/times_called_expectation/times_called_expectation_any_times_example.rb
-- examples/rr/expectations/times_called_expectation/times_called_expectation_helper.rb
-- examples/rr/expectations/times_called_expectation/times_called_expectation_proc_example.rb
 - examples/rr/expectations/times_called_expectation/times_called_expectation_example.rb
-- examples/rr/expectations/times_called_expectation/times_called_expectation_at_least_example.rb
+- examples/rr/expectations/times_called_expectation/times_called_expectation_proc_example.rb
+- examples/rr/expectations/times_called_expectation/times_called_expectation_helper.rb
 - examples/rr/expectations/times_called_expectation/times_called_expectation_at_most_example.rb
-- examples/rr/expectations/times_called_expectation/times_called_expectation_range_example.rb
-- examples/rr/errors/rr_error_example.rb
-- examples/rr/double/double_reset_example.rb
+- examples/rr/expectations/times_called_expectation/times_called_expectation_any_times_example.rb
+- examples/rr/expectations/any_argument_expectation_example.rb
+- examples/rr/expectations/is_a_argument_equality_expectation_example.rb
+- examples/rr/expectations/numeric_argument_equality_expectation_example.rb
+- examples/rr/expectations/boolean_argument_equality_expectation_example.rb
+- examples/rr/expectations/duck_type_argument_equality_expectation_example.rb
+- examples/rr/expectations/regexp_argument_equality_expectation_example.rb
+- examples/rr/expectations/range_argument_equality_expectation_example.rb
+- examples/rr/rspec/rspec_adapter_example.rb
+- examples/rr/rspec/rspec_usage_example.rb
+- examples/rr/rspec/rspec_backtrace_tweaking_example.rb
+- examples/rr/test_unit/test_helper.rb
+- examples/rr/test_unit/test_unit_integration_test.rb
+- examples/rr/test_unit/test_unit_backtrace_test.rb
+- examples/rr/scenario_example.rb
 - examples/rr/double/double_bind_example.rb
-- examples/rr/double/double_register_scenario_example.rb
-- examples/rr/double/double_example.rb
 - examples/rr/double/double_dispatching_example.rb
+- examples/rr/double/double_example.rb
+- examples/rr/double/double_reset_example.rb
 - examples/rr/double/double_verify_example.rb
-- examples/rr/test_unit/test_unit_backtrace_test.rb
-- examples/rr/test_unit/test_helper.rb
-- examples/rr/test_unit/test_unit_integration_test.rb
-- examples/rr/extensions/instance_methods_argument_matcher_example.rb
-- examples/rr/extensions/instance_methods_times_matcher_example.rb
-- examples/rr/extensions/instance_methods_creator_example.rb
-- examples/rr/extensions/instance_methods_example_helper.rb
+- examples/rr/double/double_register_scenario_example.rb
+- examples/rr/space/space_example.rb
+- examples/rr/space/space_reset_example.rb
+- examples/rr/space/space_create_example.rb
+- examples/rr/space/space_helper.rb
+- examples/rr/space/space_register_example.rb
+- examples/rr/space/space_verify_example.rb
+- examples/rr/mock_creator_example.rb
+- examples/rr/times_called_matchers/proc_matcher_example.rb
+- examples/rr/times_called_matchers/times_called_matcher_example.rb
+- examples/rr/times_called_matchers/at_most_matcher_example.rb
+- examples/rr/times_called_matchers/any_times_matcher_example.rb
+- examples/rr/times_called_matchers/at_least_matcher_example.rb
+- examples/rr/times_called_matchers/range_matcher_example.rb
+- examples/rr/times_called_matchers/integer_matcher_example.rb
+- examples/rr/stub_probe_creator_example.rb
+- examples/rr/stub_creator_example.rb
+- examples/rr/do_not_allow_creator_example.rb
+- examples/rr/mock_probe_creator_example.rb
+- examples/rr/errors/rr_error_example.rb
+- examples/rspec_example_suite.rb
+- examples/high_level_example.rb
+- examples/test_unit_example_suite.rb
+- examples/example_suite.rb
+- examples/environment_fixture_setup.rb
+- examples/example_helper.rb
 test_files: []
 
 rdoc_options: