rr 0.4.10 → 0.6.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rr
 version: !ruby/object:Gem::Version 
-  version: 0.4.10
+  version: 0.6.0
 platform: ruby
 authors: 
 - Brian Takita
@@ -9,7 +9,7 @@ autorequire: rr
 bindir: bin
 cert_chain: []
 
-date: 2008-07-06 00:00:00 -07:00
+date: 2008-10-13 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -37,10 +37,24 @@ files:
 - lib/rr/times_called_matchers/terminal.rb
 - lib/rr/times_called_matchers/range_matcher.rb
 - lib/rr/hash_with_object_id_key.rb
-- lib/rr/double_creator.rb
 - lib/rr/expectations/argument_equality_expectation.rb
 - lib/rr/expectations/times_called_expectation.rb
 - lib/rr/expectations/any_argument_expectation.rb
+- lib/rr/double_definitions/child_double_definition_creator.rb
+- lib/rr/double_definitions/double_definition.rb
+- lib/rr/double_definitions/strategies/scope/instance_of_class.rb
+- lib/rr/double_definitions/strategies/scope/instance.rb
+- lib/rr/double_definitions/strategies/scope/scope_strategy.rb
+- lib/rr/double_definitions/strategies/verification/mock.rb
+- lib/rr/double_definitions/strategies/verification/stub.rb
+- lib/rr/double_definitions/strategies/verification/dont_allow.rb
+- lib/rr/double_definitions/strategies/verification/verification_strategy.rb
+- lib/rr/double_definitions/strategies/strategy.rb
+- lib/rr/double_definitions/strategies/implementation/proxy.rb
+- lib/rr/double_definitions/strategies/implementation/reimplementation.rb
+- lib/rr/double_definitions/strategies/implementation/implementation_strategy.rb
+- lib/rr/double_definitions/double_definition_creator.rb
+- lib/rr/double_definitions/double_definition_creator_proxy.rb
 - lib/rr/double_matches.rb
 - lib/rr/errors/double_definition_error.rb
 - lib/rr/errors/argument_equality_error.rb
@@ -48,32 +62,37 @@ files:
 - lib/rr/errors/rr_error.rb
 - lib/rr/errors/times_called_error.rb
 - lib/rr/errors/double_order_error.rb
-- lib/rr/double_definition_builder.rb
 - lib/rr/adapters/rr_methods.rb
 - lib/rr/adapters/test_unit.rb
 - lib/rr/adapters/rspec.rb
-- lib/rr/double_definition.rb
-- lib/rr/double_definition_creator.rb
 - lib/rr/double_injection.rb
 - lib/rr/space.rb
 - lib/rr/wildcard_matchers/boolean.rb
 - lib/rr/wildcard_matchers/duck_type.rb
 - lib/rr/wildcard_matchers/range.rb
+- lib/rr/wildcard_matchers/satisfy.rb
 - lib/rr/wildcard_matchers/regexp.rb
 - lib/rr/wildcard_matchers/numeric.rb
 - lib/rr/wildcard_matchers/is_a.rb
+- lib/rr/wildcard_matchers/hash_including.rb
 - lib/rr/wildcard_matchers/anything.rb
-- lib/rr/double_definition_creator_proxy.rb
 - lib/rr/double.rb
 - spec/environment_fixture_setup.rb
 - spec/spec_suite.rb
 - spec/test_unit_spec_suite.rb
 - spec/spec_helper.rb
 - spec/high_level_spec.rb
+- spec/rr_spec.rb
 - spec/rr/rspec/rspec_backtrace_tweaking_spec.rb
 - spec/rr/rspec/rspec_usage_spec.rb
 - spec/rr/rspec/rspec_adapter_spec.rb
 - spec/rr/double_spec.rb
+- spec/rr/double_injection/double_injection_has_original_method_spec.rb
+- spec/rr/double_injection/double_injection_spec.rb
+- spec/rr/double_injection/double_injection_bind_spec.rb
+- spec/rr/double_injection/double_injection_dispatching_spec.rb
+- spec/rr/double_injection/double_injection_verify_spec.rb
+- spec/rr/double_injection/double_injection_reset_spec.rb
 - spec/rr/times_called_matchers/proc_matcher_spec.rb
 - spec/rr/times_called_matchers/any_times_matcher_spec.rb
 - spec/rr/times_called_matchers/range_matcher_spec.rb
@@ -83,6 +102,7 @@ files:
 - spec/rr/times_called_matchers/integer_matcher_spec.rb
 - spec/rr/space/hash_with_object_id_key_spec.rb
 - spec/rr/space/space_spec.rb
+- spec/rr/expectations/satisfy_spec.rb
 - spec/rr/expectations/times_called_expectation/times_called_expectation_proc_spec.rb
 - spec/rr/expectations/times_called_expectation/times_called_expectation_helper.rb
 - spec/rr/expectations/times_called_expectation/times_called_expectation_at_least_spec.rb
@@ -91,37 +111,30 @@ files:
 - spec/rr/expectations/times_called_expectation/times_called_expectation_at_most_spec.rb
 - spec/rr/expectations/times_called_expectation/times_called_expectation_range_spec.rb
 - spec/rr/expectations/times_called_expectation/times_called_expectation_any_times_spec.rb
-- spec/rr/expectations/numeric_spec.rb
-- spec/rr/expectations/duck_type_spec.rb
-- spec/rr/expectations/boolean_spec.rb
 - spec/rr/expectations/boolean_argument_equality_expectation_spec.rb
-- spec/rr/expectations/regexp_argument_equality_expectation_spec.rb
 - spec/rr/expectations/anything_argument_equality_expectation_spec.rb
-- spec/rr/expectations/is_a_argument_equality_expectation_spec.rb
-- spec/rr/expectations/range_spec.rb
+- spec/rr/expectations/satisfy_argument_equality_expectation_spec.rb
 - spec/rr/expectations/any_argument_expectation_spec.rb
-- spec/rr/expectations/regexp_spec.rb
+- spec/rr/expectations/hash_including_spec.rb
 - spec/rr/expectations/argument_equality_expectation_spec.rb
-- spec/rr/expectations/is_a_spec.rb
-- spec/rr/expectations/numeric_argument_equality_expectation_spec.rb
-- spec/rr/expectations/duck_type_argument_equality_expectation_spec.rb
-- spec/rr/expectations/anything_spec.rb
-- spec/rr/expectations/range_argument_equality_expectation_spec.rb
+- spec/rr/expectations/hash_including_argument_equality_expectation_spec.rb
+- spec/rr/double_definitions/child_double_definition_creator_spec.rb
+- spec/rr/double_definitions/double_definition_spec.rb
+- spec/rr/double_definitions/double_definition_creator_proxy_spec.rb
+- spec/rr/double_definitions/double_definition_creator_spec.rb
 - spec/rr/errors/rr_error_spec.rb
 - spec/rr/adapters/rr_methods_spec_helper.rb
 - spec/rr/adapters/rr_methods_times_matcher_spec.rb
 - spec/rr/adapters/rr_methods_space_spec.rb
 - spec/rr/adapters/rr_methods_creator_spec.rb
 - spec/rr/adapters/rr_methods_argument_matcher_spec.rb
-- spec/rr/double_definition_spec.rb
-- spec/rr/double_definition_creator_proxy_spec.rb
-- spec/rr/double_definition_creator_spec.rb
-- spec/rr/double/double_injection_has_original_method_spec.rb
-- spec/rr/double/double_injection_spec.rb
-- spec/rr/double/double_injection_bind_spec.rb
-- spec/rr/double/double_injection_dispatching_spec.rb
-- spec/rr/double/double_injection_verify_spec.rb
-- spec/rr/double/double_injection_reset_spec.rb
+- spec/rr/wildcard_matchers/numeric_spec.rb
+- spec/rr/wildcard_matchers/duck_type_spec.rb
+- spec/rr/wildcard_matchers/boolean_spec.rb
+- spec/rr/wildcard_matchers/range_spec.rb
+- spec/rr/wildcard_matchers/regexp_spec.rb
+- spec/rr/wildcard_matchers/is_a_spec.rb
+- spec/rr/wildcard_matchers/anything_spec.rb
 - spec/rr/test_unit/test_unit_backtrace_test.rb
 - spec/rr/test_unit/test_helper.rb
 - spec/rr/test_unit/test_unit_integration_test.rb
@@ -152,9 +165,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: pivotalrb
-rubygems_version: 1.1.0
+rubygems_version: 1.2.0
 signing_key: 
 specification_version: 2
 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
 test_files: 
 - spec/high_level_spec.rb
+- spec/rr_spec.rb

data/lib/rr/double_creator.rb

@@ -1,271 +0,0 @@
-module RR
-  # RR::DoubleDefinitionCreator provides a strategies to create a Double.
-  # The strategies are:
-  # * mock
-  # * stub
-  # * proxy
-  # * dont_allow
-  class DoubleDefinitionCreator
-    NO_SUBJECT_ARG = Object.new
-
-    attr_reader :space
-    include Errors
-
-    def initialize(space)
-      @space = space
-      @strategy = nil
-      @using_proxy_strategy = false
-      @instance_of_called = nil
-    end
-    
-    # This method sets the Double to have a mock strategy. A mock strategy
-    # sets the default state of the Double to expect the method call
-    # with arguments exactly one time. The Double's expectations can be
-    # changed.
-    #
-    # This method can be chained with proxy.
-    #   mock.proxy(subject).method_name_1
-    #   or
-    #   proxy.mock(subject).method_name_1
-    #
-    # When passed the subject, a DoubleDefinitionCreatorProxy is returned. Passing
-    # a method with arguments to the proxy will set up expectations that
-    # the a call to the subject's method with the arguments will happen.
-    #   mock(subject).method_name_1 {return_value_1}
-    #   mock(subject).method_name_2(arg1, arg2) {return_value_2}
-    #
-    # When passed the subject and the method_name, this method returns
-    # a mock Double with the method already set.
-    #
-    #   mock(subject, :method_name_1) {return_value_1}
-    #   mock(subject, :method_name_2).with(arg1, arg2) {return_value_2}
-    #
-    # mock also takes a block for definitions.
-    #   mock(subject) do
-    #     method_name_1 {return_value_1}
-    #     method_name_2(arg_1, arg_2) {return_value_2}
-    #   end
-    def mock(subject=NO_SUBJECT_ARG, method_name=nil, &definition)
-      verify_no_strategy
-      @strategy = :mock
-      return self if subject.__id__ === NO_SUBJECT_ARG.__id__
-      DoubleDefinitionCreatorProxy.new(self, subject, method_name, &definition)
-    end
-
-    # This method sets the Double to have a stub strategy. A stub strategy
-    # sets the default state of the Double to expect the method call
-    # with any arguments any number of times. The Double's
-    # expectations can be changed.
-    #
-    # This method can be chained with proxy.
-    #   stub.proxy(subject).method_name_1
-    #   or
-    #   proxy.stub(subject).method_name_1
-    #
-    # When passed the subject, a DoubleDefinitionCreatorProxy is returned. Passing
-    # a method with arguments to the proxy will set up expectations that
-    # the a call to the subject's method with the arguments will happen,
-    # and return the prescribed value.
-    #   stub(subject).method_name_1 {return_value_1}
-    #   stub(subject).method_name_2(arg_1, arg_2) {return_value_2}
-    #
-    # When passed the subject and the method_name, this method returns
-    # a stub Double with the method already set.
-    #
-    #   mock(subject, :method_name_1) {return_value_1}
-    #   mock(subject, :method_name_2).with(arg1, arg2) {return_value_2}
-    #
-    # stub also takes a block for definitions.
-    #   stub(subject) do
-    #     method_name_1 {return_value_1}
-    #     method_name_2(arg_1, arg_2) {return_value_2}
-    #   end
-    def stub(subject=NO_SUBJECT_ARG, method_name=nil, &definition)
-      verify_no_strategy
-      @strategy = :stub
-      return self if subject.__id__ === NO_SUBJECT_ARG.__id__
-      DoubleDefinitionCreatorProxy.new(self, subject, method_name, &definition)
-    end
-
-    # This method sets the Double to have a dont_allow strategy.
-    # A dont_allow strategy sets the default state of the Double
-    # to expect never to be called. The Double's expectations can be
-    # changed.
-    #
-    # The following example sets the expectation that subject.method_name
-    # will never be called with arg1 and arg2.
-    #
-    #   dont_allow(subject).method_name(arg1, arg2)
-    #
-    # dont_allow also supports a block sytnax.
-    #    dont_allow(subject) do |m|
-    #      m.method1 # Do not allow method1 with any arguments
-    #      m.method2(arg1, arg2) # Do not allow method2 with arguments arg1 and arg2
-    #      m.method3.with_no_args # Do not allow method3 with no arguments
-    #    end
-    def dont_allow(subject=NO_SUBJECT_ARG, method_name=nil, &definition)
-      verify_no_strategy
-      proxy_when_dont_allow_error if @using_proxy_strategy
-      @strategy = :dont_allow
-      return self if subject.__id__ === NO_SUBJECT_ARG.__id__
-      DoubleDefinitionCreatorProxy.new(self, subject, method_name, &definition)
-    end
-    alias_method :do_not_allow, :dont_allow
-    alias_method :dont_call, :dont_allow
-    alias_method :do_not_call, :dont_allow
-
-    # This method add proxy capabilities to the Double. proxy can be called
-    # with mock or stub.
-    #
-    #   mock.proxy(controller.template).render(:partial => "my/socks")
-    #
-    #   stub.proxy(controller.template).render(:partial => "my/socks") do |html|
-    #     html.should include("My socks are wet")
-    #     html
-    #   end
-    #
-    #   mock.proxy(controller.template).render(:partial => "my/socks") do |html|
-    #     html.should include("My socks are wet")
-    #     "My new return value"
-    #   end
-    #
-    # mock.proxy also takes a block for definitions.
-    #   mock.proxy(subject) do
-    #     render(:partial => "my/socks")
-    #
-    #     render(:partial => "my/socks") do |html|
-    #       html.should include("My socks are wet")
-    #       html
-    #     end
-    #
-    #     render(:partial => "my/socks") do |html|
-    #       html.should include("My socks are wet")
-    #       html
-    #     end
-    #
-    #     render(:partial => "my/socks") do |html|
-    #       html.should include("My socks are wet")
-    #       "My new return value"
-    #     end
-    #   end
-    #
-    # Passing a block to the Double (after the method name and arguments)
-    # allows you to intercept the return value.
-    # The return value can be modified, validated, and/or overridden by
-    # passing in a block. The return value of the block will replace
-    # the actual return value.
-    #
-    #   mock.proxy(controller.template).render(:partial => "my/socks") do |html|
-    #     html.should include("My socks are wet")
-    #     "My new return value"
-    #   end
-    def proxy(subject=NO_SUBJECT_ARG, method_name=nil, &definition)
-      proxy_when_dont_allow_error if @strategy == :dont_allow
-      @using_proxy_strategy = true
-      return self if subject.__id__ === NO_SUBJECT_ARG.__id__
-      DoubleDefinitionCreatorProxy.new(self, subject, method_name, &definition)
-    end
-    alias_method :probe, :proxy
-
-    # Calling instance_of will cause all instances of the passed in Class
-    # to have the Double defined.
-    #
-    # The following example mocks all User's valid? method and return false. 
-    #   mock.instance_of(User).valid? {false}
-    #
-    # The following example mocks and proxies User#projects and returns the
-    # first 3 projects.
-    #   mock.instance_of(User).projects do |projects|
-    #     projects[0..2]
-    #   end
-    def instance_of(subject=NO_SUBJECT_ARG, method_name=nil, &definition)
-      @instance_of_called = true
-      return self if subject === NO_SUBJECT_ARG
-      raise ArgumentError, "instance_of only accepts class objects" unless subject.is_a?(Class)
-      DoubleDefinitionCreatorProxy.new(self, subject, method_name, &definition)
-    end
-
-    def create(subject, method_name, *args, &handler)
-      @args = args
-      @handler = handler
-      if @instance_of_called
-        setup_doubles_for_class_instances(subject, method_name)
-      else
-        setup_double(subject, method_name)
-      end
-      transform
-      @definition
-    end
-    
-    protected
-    def setup_double(subject, method_name)
-      @double_injection = @space.double_injection(subject, method_name)
-      @double = Double.new(@double_injection)
-      @definition = @double.definition
-    end
-
-    def setup_doubles_for_class_instances(subject, method_name)
-      class_double = @space.double_injection(subject, :new)
-      class_double = Double.new(class_double)
-
-      instance_method_name = method_name
-
-      @definition = DoubleDefinition.new
-      class_handler = lambda do |return_value|
-        double_injection = @space.double_injection(return_value, instance_method_name)
-        Double.new(double_injection, @definition)
-        return_value
-      end
-
-      builder = DoubleDefinitionBuilder.new(
-        class_double.definition,
-        [],
-        class_handler
-      )
-      builder.stub
-      builder.proxy
-    end
-
-    def transform
-      builder = DoubleDefinitionBuilder.new(@definition, @args, @handler)
-
-      verify_strategy
-      builder.__send__(@strategy)
-
-      if @using_proxy_strategy
-        builder.proxy
-      else
-        builder.reimplementation
-      end
-    end
-
-    def verify_no_strategy
-      strategy_already_defined_error if @strategy
-    end
-
-    def strategy_already_defined_error
-      raise(
-        DoubleDefinitionError,
-        "This Double already has a #{@strategy} strategy"
-      )
-    end
-
-    def verify_strategy
-      no_strategy_error unless @strategy
-    end
-
-    def no_strategy_error
-      raise(
-        DoubleDefinitionError,
-        "This Double has no strategy"
-      )
-    end
-
-    def proxy_when_dont_allow_error
-      raise(
-        DoubleDefinitionError,
-        "Doubles cannot be proxied when using dont_allow strategy"
-      )
-    end
-  end
-end

data/lib/rr/double_definition.rb

@@ -1,179 +0,0 @@
-module RR
-  class DoubleDefinition #:nodoc:
-    ORIGINAL_METHOD = Object.new
-    attr_accessor :times_called,
-                  :argument_expectation,
-                  :times_matcher,
-                  :implementation,
-                  :after_call_value,
-                  :yields_value,
-                  :double
-    attr_reader   :block_callback_strategy
-
-    include Space::Reader
-
-    def initialize
-      @implementation = nil
-      @argument_expectation = nil
-      @times_matcher = nil
-      @after_call_value = nil
-      @yields_value = nil
-      returns_block_callback_strategy
-    end
-
-    def with(*args, &returns)
-      @argument_expectation = Expectations::ArgumentEqualityExpectation.new(*args)
-      install_method_callback returns
-      self
-    end
-
-    def with_any_args(&returns)
-      @argument_expectation = Expectations::AnyArgumentExpectation.new
-      install_method_callback returns
-      self
-    end
-
-    def with_no_args(&returns)
-      @argument_expectation = Expectations::ArgumentEqualityExpectation.new()
-      install_method_callback returns
-      self
-    end
-
-    def never
-      @times_matcher = TimesCalledMatchers::IntegerMatcher.new(0)
-      self
-    end
-
-    def once(&returns)
-      @times_matcher = TimesCalledMatchers::IntegerMatcher.new(1)
-      install_method_callback returns
-      self
-    end
-
-    def twice(&returns)
-      @times_matcher = TimesCalledMatchers::IntegerMatcher.new(2)
-      install_method_callback returns
-      self
-    end
-
-    def at_least(number, &returns)
-      @times_matcher = TimesCalledMatchers::AtLeastMatcher.new(number)
-      install_method_callback returns
-      self
-    end
-
-    def at_most(number, &returns)
-      @times_matcher = TimesCalledMatchers::AtMostMatcher.new(number)
-      install_method_callback returns
-      self
-    end
-
-    def any_number_of_times(&returns)
-      @times_matcher = TimesCalledMatchers::AnyTimesMatcher.new
-      install_method_callback returns
-      self
-    end
-
-    def times(matcher_value, &returns)
-      @times_matcher = TimesCalledMatchers::TimesCalledMatcher.create(matcher_value)
-      install_method_callback returns
-      self
-    end
-
-    def ordered(&returns)
-      raise(
-        Errors::DoubleDefinitionError,
-        "Double Definitions must have a dedicated Double to be ordered. " <<
-        "For example, using instance_of does not allow ordered to be used. " <<
-        "proxy the class's #new method instead."
-      ) unless @double
-      @ordered = true
-      space.ordered_doubles << @double unless space.ordered_doubles.include?(@double)
-      install_method_callback returns
-      self
-    end
-
-    def ordered?
-      @ordered
-    end
-
-    def yields(*args, &returns)
-      @yields_value = args
-      install_method_callback returns
-      self
-    end
-
-    def after_call(&block)
-      raise ArgumentError, "after_call expects a block" unless block
-      @after_call_value = block
-      self
-    end
-
-    def verbose(&block)
-      @verbose = true
-      @after_call_value = block
-      self
-    end
-
-    def verbose?
-      @verbose ? true : false
-    end
-
-    def returns(*args, &implementation)
-      value = args.first
-      if !args.empty? && implementation
-        raise ArgumentError, "returns cannot accept both an argument and a block"
-      end
-      if implementation
-        implemented_by implementation
-      else
-        implemented_by lambda {value}
-      end
-      self
-    end
-
-    def proxy
-      implemented_by ORIGINAL_METHOD
-      self
-    end
-
-    def implemented_by(implementation)
-      @implementation = implementation
-      self
-    end
-
-    def exact_match?(*arguments)
-      return false unless @argument_expectation
-      @argument_expectation.exact_match?(*arguments)
-    end
-
-    def wildcard_match?(*arguments)
-      return false unless @argument_expectation
-      @argument_expectation.wildcard_match?(*arguments)
-    end
-
-    def terminal?
-      return false unless @times_matcher
-      @times_matcher.terminal?
-    end
-
-    def expected_arguments
-      return [] unless argument_expectation
-      argument_expectation.expected_arguments
-    end
-
-    def returns_block_callback_strategy # :nodoc:
-      @block_callback_strategy = :returns
-    end
-
-    def after_call_block_callback_strategy # :nodoc:
-      @block_callback_strategy = :after_call
-    end
-
-    protected
-    def install_method_callback(block)
-      return unless block
-      __send__(@block_callback_strategy, &block)
-    end
-  end
-end