caricature 0.7.1 → 0.7.2

data/spec/rspec/unit/interop_spec.rb

@@ -0,0 +1,43 @@
+require File.dirname(__FILE__) + "/../spec_helper"
+
+describe "Event handling" do
+
+
+
+  describe "for precompiled CLR classes" do
+
+    before do
+      @warrior = ClrModels::ExposingWarrior.new
+    end
+
+    it "should subscribe to an event" do
+      ClrModels::ExposedChangedSubscriber.new(@warrior)
+      @warrior.has_event_subscriptions.should be_true
+    end
+
+    it "should not raise an error when subcribing to an event" do
+      lambda { ClrModels::ExposedChangedSubscriber.new(@warrior) }.should_not raise_error
+    end
+
+    it "should handle an event when raised" do
+      subscriber = ClrModels::ExposedChangedSubscriber.new(@warrior)
+      @warrior.change_is_exposed
+      subscriber.counter.should == 1
+    end
+
+  end
+
+  describe "for an IR generated interface proxy" do
+
+    before do
+      @proxy = isolate ClrModels::IExposingWarrior
+    end
+
+    # apparently events don't work yet in IronRuby.. keeping this spec here to find out when it does
+#    it "should not raise an error when subcribing to an event" do
+#      lambda { ClrModels::ExposedChangedSubscriber.new(@proxy) }.should_not raise_error
+#    end
+
+  end
+
+end

data/spec/rspec/unit/isolation_spec.rb

@@ -0,0 +1,87 @@
+require File.dirname(__FILE__) + "/../spec_helper"
+
+describe "Caricature::Isolation" do
+
+  describe "when creating an isolation for ruby objects" do
+
+    it "should not raise" do
+      lambda { Caricature::Isolation.for(Soldier) }.should_not raise_error
+    end
+
+  end
+
+  describe "after creation of the isolation for a ruby object" do
+
+    before do
+      @isolator = Caricature::Isolation.for(Soldier)
+    end
+
+    it "should create a proxy" do
+      @isolator.should_not be_nil
+    end
+
+    describe "when asked to stub a method" do
+
+      it "should create an expectation with a block" do
+        nm = "What's in a name"
+        expectation = @isolator.when_receiving(:name) do |cl|
+          cl.return(nm)
+        end
+        expectation.method_name.should == :name
+        expectation.should be_has_return_value
+        expectation.return_value.should == nm
+      end
+
+      it "should create an expectation without a block" do
+        nm = "What's in a name"
+        expectation = @isolator.when_receiving(:name).return(nm)
+        expectation.method_name.should == :name
+        expectation.should be_has_return_value
+        expectation.return_value.should == nm
+      end
+    end
+
+  end
+    
+  describe "when creating an isolation for CLR objects" do
+
+    it "should not raise" do
+      lambda { Caricature::Isolation.for(ClrModels::Ninja) }.should_not raise_error
+    end
+
+  end
+
+  describe "after creation of the isolation for a CLR object" do
+
+    before do
+      @isolator = Caricature::Isolation.for(ClrModels::Ninja)
+    end
+
+    it "should create a proxy" do
+      @isolator.should_not be_nil
+    end
+
+    describe "when asked to stub a method" do
+
+      it "should create an expectation with a block" do
+        nm = "What's in a name"
+        expectation = @isolator.when_receiving(:name) do |cl|
+          cl.return(nm)
+        end
+        expectation.method_name.should == :name
+        expectation.should be_has_return_value
+        expectation.return_value.should == nm
+      end
+
+      it "should create an expectation without a block" do
+        nm = "What's in a name"
+        expectation = @isolator.when_receiving(:name).return(nm)
+        expectation.method_name.should == :name
+        expectation.should be_has_return_value
+        expectation.return_value.should == nm
+      end
+    end
+
+  end
+
+end

data/spec/rspec/unit/isolator_spec.rb

@@ -0,0 +1,220 @@
+require File.dirname(__FILE__) + "/../spec_helper"
+
+class TestIsolation
+  attr_accessor :instance, :expectations
+  def initialize(instance, expectations)
+    @instance, @expectations = instance, expectations
+  end
+  def send_message(method_name, return_type, *args, &b)
+    internal_send method_name, :internal, return_type, *args, &b
+  end
+  def send_class_message(method_name, return_type, *args, &b)
+    internal_send method_name, :class, return_type, *args, &b
+  end
+  def internal_send(method_name, mode, return_type, *args, &b)
+    exp = expectations.find(method_name, mode, *args)
+    if exp
+      res = instance.__send__(method_name, *args, &b) if exp.super_before?
+      res = exp.execute(*args)
+      res = instance.__send__(method_name, *args, &b) if !exp.super_before? and exp.call_super?
+      res
+    else
+      rt = nil
+      is_value_type = return_type && return_type != System::Void.to_clr_type && return_type.is_value_type
+      rt = System::Activator.create_instance(return_type) if is_value_type
+      rt
+    end
+  end
+end
+
+describe "Caricature::RubyIsolator" do
+
+  before do    
+    @subj = Soldier.new
+    res = Caricature::RubyIsolator.for Caricature::IsolatorContext.new(@subj)
+    iso = TestIsolation.new res.subject, Caricature::Expectations.new
+    @proxy = res.isolation
+    @proxy.class.instance_variable_set("@___context___", iso)
+  end
+
+  
+  describe "when invoking a method" do
+
+    before do
+      @proxy.name
+    end
+
+    it "should return nil" do
+      @proxy.name.should be_nil
+    end
+
+  end
+
+  describe "when isolating a class with class members" do
+
+    before do
+      res = Caricature::RubyIsolator.for Caricature::IsolatorContext.new(DaggerWithClassMembers)
+      iso = TestIsolation.new res.subject, Caricature::Expectations.new
+      @proxy = res.isolation
+      @proxy.class.instance_variable_set("@___context___", iso)
+    end
+
+    it "should return nil for the class method" do
+
+      @proxy.class.class_name.should be_nil
+
+    end
+
+  end
+end
+
+describe "Caricature::RecordingClrProxy" do
+
+  describe "for an instance of a CLR class" do
+
+    before do
+      @ninja = ClrModels::Ninja.new
+      @ninja.name = "Nakiro"
+      context = Caricature::IsolatorContext.new(@ninja)
+      res = Caricature::ClrIsolator.for context
+      iso = TestIsolation.new res.subject, Caricature::Expectations.new
+      @proxy = res.isolation
+      @proxy.class.instance_variable_set("@___context___", iso)
+    end
+
+    it "should create a proxy" do
+
+      @proxy.___super___.name.should == @ninja.name
+      @proxy.___super___.id.should == 1
+    end
+
+    describe "when invoking a method" do
+
+      before do
+        @proxy.name
+      end
+
+      it "should return nil" do
+        @proxy.name.should be_nil
+      end
+
+    end
+
+    describe "when isolating a class with class members" do
+
+      before do
+        res = Caricature::ClrIsolator.for Caricature::IsolatorContext.new(ClrModels::SwordWithStatics)
+        iso = TestIsolation.new res.subject, Caricature::Expectations.new
+        @proxy = res.isolation
+        @proxy.class.instance_variable_set("@___context___", iso)
+      end
+
+      it "should return nil for the class method" do
+
+        @proxy.class.class_naming.should be_nil
+
+      end
+
+    end
+
+  end
+
+  describe "for a CLR class" do
+
+    before do
+      @recorder = Caricature::MethodCallRecorder.new
+      context = Caricature::IsolatorContext.new(ClrModels::Ninja, @recorder)
+      res = Caricature::ClrIsolator.for context
+      iso = TestIsolation.new res.subject, Caricature::Expectations.new
+      @proxy = res.isolation
+      @proxy.class.instance_variable_set("@___context___", iso)
+    end
+
+    it "should create a proxy" do
+      
+      @proxy.class.superclass.should == ClrModels::Ninja
+      
+    end
+
+
+  end
+
+  describe "for a CLR interface" do
+
+    before do
+      res = Caricature::ClrInterfaceIsolator.for Caricature::IsolatorContext.new(ClrModels::IWarrior)
+      @proxy = res.isolation
+    end
+
+    it "should create a proxy" do
+      @proxy.class.to_s.should match(/^IWarrior/)
+    end
+
+    it "should create a method on the proxy" do
+      @proxy.should respond_to(:is_killed_by)
+    end
+
+    it "should create a getter for a property on the proxy" do
+      @proxy.should respond_to(:id)
+    end
+
+    it "should create a setter for a writable property on the proxy" do
+      @proxy.should respond_to(:name=)
+    end
+
+  end
+
+  describe "for a CLR Interface with an event" do
+
+    before do
+      res = Caricature::ClrInterfaceIsolator.for Caricature::IsolatorContext.new(ClrModels::IExposing)
+      @proxy = res.isolation
+    end
+
+    it "should create an add method for the event" do
+      @proxy.should respond_to(:add_is_exposed_changed)
+    end
+
+    it "should create a remove method for the event" do
+      @proxy.should respond_to(:remove_is_exposed_changed)
+    end
+
+  end
+
+  describe "for CLR interface recursion" do
+
+    before do
+      res = Caricature::ClrInterfaceIsolator.for Caricature::IsolatorContext.new(ClrModels::IExposingWarrior)
+      @proxy = res.isolation
+    end
+
+    it "should create a method defined on the CLR interface" do
+      @proxy.should respond_to(:own_method)
+    end
+
+    it "should create a method defined on one of the composing interfaces" do
+      @proxy.should respond_to(:some_method)
+    end
+
+    it "should create a method defined on one of the topmost composing interfaces" do
+      @proxy.should respond_to(:is_killed_by)
+    end
+
+    it "should create an add method for an event defined on a composing interface" do
+      @proxy.should respond_to(:add_is_exposed_changed)
+    end
+
+    it "should create a remove method for an event defined on a composing interface" do
+      @proxy.should respond_to(:remove_is_exposed_changed)
+    end
+
+    it "should create a getter for a property on the proxy" do
+      @proxy.should respond_to(:id)
+    end
+
+    it "should create a setter for a writable property on the proxy" do
+      @proxy.should respond_to(:name=)
+    end
+  end
+
+end

data/spec/rspec/unit/messaging_spec.rb

@@ -0,0 +1,311 @@
+require File.dirname(__FILE__) + "/../spec_helper"
+
+class EmptyExpectations
+
+  def find(method_name, *args, &b)
+    nil
+  end
+end
+
+class ReturnValueExpecation
+
+  def initialize
+    @super_before_called = false
+    @call_super_called = false
+    @called_super_after = false
+  end
+
+  def block
+    nil
+  end
+
+  def super_before?
+    @super_before_called = true
+    false
+  end
+
+  def call_super?
+    @call_super_called = true
+    false
+  end
+
+  def have_called_super_before?
+    @super_before_called
+  end
+
+  def have_called_call_super?
+    @super_before_called && @called_super_after
+  end
+
+  def execute(*args)
+    @called_super_after = !@call_super_called
+    5
+  end
+end
+
+class ReturnValueExpectations
+
+  def expectation
+    @expectation ||= ReturnValueExpecation.new
+    @expectation
+  end
+  def find(method_name, *args, &b)
+    return expectation  if method_name == :a_message
+    nil
+  end
+end
+
+class PassThruBlockExpectation
+
+  def block
+    @block
+  end
+
+  def block=(val)
+    @block=val
+  end
+
+  def block_args
+    [5,6,7]
+  end
+
+  def execute(*args, &b)
+    b.call *block_args
+  end
+
+  def super_before?
+    false
+  end
+
+  def call_super?
+    false
+  end
+
+end
+
+class CallingBlock
+  def a_message(*args, &b)
+    b.call(7,8,9)
+  end
+end
+
+class BlockExpectation
+  def block
+    lambda { |*args| return args }
+  end
+
+  def super_before?
+    false
+  end
+
+  def call_super?
+    true
+  end
+
+  def execute(*args, &b)
+
+  end
+
+end
+
+class BlockExpectations
+
+  def initialize(pass_thru=true)
+    @pass_thru = pass_thru
+  end
+
+  def expectation
+    @expectation ||= (@pass_thru ? PassThruBlockExpectation.new : BlockExpectation.new)
+    @expectation
+  end
+  def find(method_name, *args, &b)
+    return expectation  if method_name == :a_message
+    nil
+  end
+end
+
+
+describe "Caricature::Messenger strategies" do
+
+  describe "Caricature::RubyMessenger" do
+
+    it "should return nil for any method name not in the expectation collection" do
+      messenger = Caricature::RubyMessenger.new EmptyExpectations.new
+      messenger.deliver(:a_message, nil).should be_nil
+    end
+
+    describe "when an expectation with a return value has been defined" do
+
+      before do
+        @messenger = Caricature::RubyMessenger.new ReturnValueExpectations.new
+      end
+
+      it "should return the a value when specified by the expecation" do
+        @messenger.deliver(:a_message, nil).should_not be_nil
+      end
+
+      it "should return the value specified by the expecation" do
+        @messenger.deliver(:a_message, nil).should == 5
+      end
+
+      it "should call super_before before executing the expectation" do
+        @messenger.deliver(:a_message, nil)
+        @messenger.expectations.expectation.should be_have_called_super_before
+      end
+
+      it "should call call_super? after executing the expectation" do
+        @messenger.deliver(:a_message, nil)
+        @messenger.expectations.expectation.should be_have_called_call_super
+      end
+
+    end
+
+    describe "when an expectation with a block has been defined" do
+
+      it "should invoke the block that is passed with the args from the expectation only once"  do
+        messenger = Caricature::RubyMessenger.new BlockExpectations.new
+        messenger.recorder = Caricature::MethodCallRecorder.new
+        counter = 0
+        arguments = []
+        messenger.deliver(:a_message, nil) do |*args|
+          counter += 1
+          arguments = args
+        end
+        counter.should == 1
+        [5,6,7].should == arguments
+      end
+
+      it "should call the block that is defined on the expectation by super when call super is enabled" do
+        exp =  BlockExpectations.new(false)
+        messenger = Caricature::RubyMessenger.new exp, CallingBlock.new
+        result = messenger.deliver(:a_message, nil, exp.expectation)
+        [7,8,9].should == result
+      end
+
+    end
+
+
+  end
+
+  describe "Caricature::ClrClassMessenger" do
+
+    it "should return nil for any method name not in the expectation collection" do
+      messenger = Caricature::ClrClassMessenger.new EmptyExpectations.new
+      messenger.deliver(:a_message, nil).should be_nil
+    end
+
+    it "should return the default value for a value type return type" do
+      messenger = Caricature::ClrClassMessenger.new EmptyExpectations.new
+      messenger.deliver(:a_message, System::Int32.to_clr_type).should == 0
+    end
+
+    describe "when an expectation with a return value has been defined" do
+
+      before do
+        @messenger = Caricature::ClrClassMessenger.new ReturnValueExpectations.new
+      end
+
+      it "should return the a value when specified by the expecation" do
+        @messenger.deliver(:a_message, nil).should_not be_nil
+      end
+
+      it "should return the value specified by the expecation" do
+        @messenger.deliver(:a_message, nil).should == 5
+      end
+
+      it "should call super_before before executing the expectation" do
+        @messenger.deliver(:a_message, nil)
+        @messenger.expectations.expectation.should be_have_called_super_before
+      end
+
+      it "should call call_super? after executing the expectation" do
+        @messenger.deliver(:a_message, nil)
+        @messenger.expectations.expectation.should be_have_called_call_super
+      end
+
+    end
+
+    describe "when an expectation with a block has been defined" do
+
+      it "should invoke the block that is passed with the args from the expectation only once"  do
+        messenger = Caricature::ClrClassMessenger.new BlockExpectations.new
+        messenger.recorder = Caricature::MethodCallRecorder.new
+        counter = 0
+        arguments = []
+        messenger.deliver(:a_message, nil) do |*args|
+          counter += 1
+          arguments = args
+        end
+        counter.should == 1
+        [5,6,7].should == arguments
+      end
+
+      it "should call the block that is defined on the expectation by super when call super is enabled" do
+        messenger = Caricature::ClrClassMessenger.new BlockExpectations.new(false), CallingBlock.new
+        result = messenger.deliver(:a_message, nil)
+        [7,8,9].should == result
+      end
+
+    end
+
+  end
+
+  describe "Caricature::ClrInterfaceMessenger" do
+
+    it "should return nil for any method name not in the expectation collection" do
+      messenger = Caricature::ClrInterfaceMessenger.new EmptyExpectations.new
+      messenger.deliver(:a_message, nil).should be_nil
+    end
+
+    it "should return the default value for a value type return type" do
+      messenger = Caricature::ClrClassMessenger.new EmptyExpectations.new
+      messenger.deliver(:a_message, System::Int32.to_clr_type).should == 0
+    end
+
+    describe "when an expectation with a return value has been defined" do
+
+      before do
+        @messenger = Caricature::ClrInterfaceMessenger.new ReturnValueExpectations.new
+      end
+
+      it "should return the a value when specified by the expecation" do
+        @messenger.deliver(:a_message, nil).should_not be_nil
+      end
+
+      it "should return the value specified by the expecation" do
+        @messenger.deliver(:a_message, nil).should == 5
+      end
+
+      it "should not call super_before before executing the expectation" do
+        @messenger.deliver(:a_message, nil)
+        @messenger.expectations.expectation.should_not be_have_called_super_before
+      end
+
+      it "should not call call_super? after executing the expectation" do
+        @messenger.deliver(:a_message, nil)
+        @messenger.expectations.expectation.should_not be_have_called_call_super
+      end
+
+    end
+
+    describe "when an expectation with a block has been defined" do
+
+      it "should invoke the block that is passed with the args from the expectation only once"  do
+        exp = BlockExpectations.new
+        messenger = Caricature::ClrInterfaceMessenger.new exp
+        messenger.recorder = Caricature::MethodCallRecorder.new
+        counter = 0
+        arguments = []
+        messenger.deliver(:a_message, nil, exp.expectation) do |*args|
+          counter += 1
+          arguments = args
+        end
+        counter.should == 1
+        [5,6,7].should == arguments
+      end
+
+    end
+
+  end
+
+end