verified_double 0.5.3 → 0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 97ca8fc74d9ad9dddff6b285850a673f46e092f1
-  data.tar.gz: 638a65c4724ac5023ba85c717cda05c93bf9fde9
+  metadata.gz: e6bfd029b36750aeb01fc1a6d0176f58a7d3c623
+  data.tar.gz: aace4f64cbafacac1d051939faa93a6c7c1a1742
 SHA512:
-  metadata.gz: e813041bbf2731d2b2b4f7aae3bb547c1e57cf85181da4422f563e0ad725b3b90841a9fae2d32ae1bc9597f3767077de97202b658e70880596d315c0af5d51db
-  data.tar.gz: 3180a6b9822c22912b9117cc993be47ebbfe8770c5bef2e3304a706005f141741b731396598e74528a3f03a4da0243a97d9a593c76a192fcacd35607f462b6bb
+  metadata.gz: 90eda38fbddf5d17f03df6f06bbc23e099598564e9329fb6e891d9dfb3516de474352e46f5e4840cf3252ca03082554e6324c38556ad272fb464d745a95315b4
+  data.tar.gz: 9fbae516d65fbafc7f748479c147eb8fb35f62f1a0d450940f397142d007038fc6fc000a6e920c22e70b344a87c99144eea4a4913c56b00d84e219877de992fc

data/CHANGELOG.markdown

@@ -1,3 +1,8 @@
+0.6.0 - 2013-12-28
+------------------
+
+* Implement partial mocks.
+
 0.5.3 - 2013-12-26
 ------------------
 

data/Guardfile

@@ -1,6 +1,6 @@
 guard :rspec do
   watch(%r{^spec/.+_spec\.rb$})
-  watch(%r{^lib/(.+)\.rb$}) { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch(%r{^lib/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
   watch('spec/spec_helper.rb') { "spec" }
 end
 

data/README.md

@@ -148,9 +148,19 @@ describe Collaborator do
 end
 ```
 
-## Any Instance mocks
+## Partial and Any Instance mocks
 
-Aside for instance and class doubles, VerifiedDouble also supports `any_instance` mocks:
+Aside for instance and class doubles, VerifiedDouble also supports partial and "any instance" mocks:
+
+```
+object_under_test = ObjectUnderTest.new
+
+expect(VerifiedDouble.wrap(object_under_test))
+  .to receive(:some_method).with(input).and_return(output)
+
+expect(VerifiedDouble.wrap(ObjectUnderTest))
+  .to receive(:some_method).with(input).and_return(output)
+```
 
 ```
 VerifiedDouble.expect_any_instance_of(Collaborator)

data/features/CHANGELOG.markdown

@@ -1,3 +1,8 @@
+0.6.0 - 2013-12-28
+------------------
+
+* Implement partial mocks.
+
 0.5.3 - 2013-12-26
 ------------------
 

data/features/partial_mocks.feature

@@ -0,0 +1,162 @@
+Feature: 65. Partial mocks
+
+  Background:
+    Given the following classes:
+      """
+      class ObjectUnderTest
+        def do_something(input)
+          some_method(input)
+        end
+
+        def some_method(input)
+          SomeOutput.new
+        end
+
+        def self.do_something(input)
+          some_method(input)
+        end
+
+        def self.some_method(input)
+          SomeOutput.new
+        end
+      end
+
+      class SomeInput
+      end
+
+      class SomeOutput
+      end
+      """
+
+    And the test suite is configured to use VerifiedDouble:
+      """
+      require 'verified_double'
+      require 'verified_double/rspec_configuration'
+      require 'main'
+      """
+
+  Scenario: Verified partial mocks of instance variables
+
+    Given a test that uses VerifiedDouble to mock the object under test:
+      """
+      require 'spec_helper'
+      describe ObjectUnderTest do
+        let(:input) { SomeInput.new }
+        let(:output) { SomeOutput.new }
+
+        it "tests something" do
+          object_under_test = ObjectUnderTest.new
+          expect(VerifiedDouble.wrap(object_under_test))
+            .to receive(:some_method).with(input).and_return(output)
+
+          object_under_test.do_something(input)
+        end
+      end
+      """
+
+    And the test suite has a contract test for the mock:
+      """
+      require 'spec_helper'
+
+      describe ObjectUnderTest do
+        describe '#some_method(SomeInput)=>SomeOutput', verifies_contract: true do
+          it "tests something" do
+            # do nothing
+          end
+        end
+      end
+      """
+
+    When I run the test suite
+    Then I should not see any output saying the mock is unverified
+
+  Scenario: Unverified partial mocks of instance variables
+
+    Given a test that uses VerifiedDouble to mock the object under test:
+      """
+      require 'spec_helper'
+      describe ObjectUnderTest do
+        let(:input) { SomeInput.new }
+        let(:output) { SomeOutput.new }
+
+        it "tests something" do
+          object_under_test = ObjectUnderTest.new
+          expect(VerifiedDouble.wrap(object_under_test))
+            .to receive(:some_method).with(input).and_return(output)
+
+          object_under_test.do_something(input)
+        end
+      end
+      """
+
+    And the test suite does not have a contract test for the mock
+
+    When I run the test suite
+    Then I should be informed that the stub is unverified:
+      """
+      The following mocks are not verified:
+
+      1. ObjectUnderTest#some_method(SomeInput)=>SomeOutput
+      """
+
+  Scenario: Verified partial mocks of class variables
+
+    Given a test that uses VerifiedDouble to mock the object under test:
+      """
+      require 'spec_helper'
+      describe ObjectUnderTest do
+        let(:input) { SomeInput.new }
+        let(:output) { SomeOutput.new }
+
+        it "tests something" do
+          expect(VerifiedDouble.wrap(ObjectUnderTest))
+            .to receive(:some_method).with(input).and_return(output)
+
+          ObjectUnderTest.do_something(input)
+        end
+      end
+      """
+
+    And the test suite has a contract test for the mock:
+      """
+      require 'spec_helper'
+
+      describe ObjectUnderTest do
+        describe '.some_method(SomeInput)=>SomeOutput', verifies_contract: true do
+          it "tests something" do
+            # do nothing
+          end
+        end
+      end
+      """
+
+    When I run the test suite
+    Then I should not see any output saying the mock is unverified
+
+  Scenario: Unverified partial mocks of class variables
+
+    Given a test that uses VerifiedDouble to mock the object under test:
+      """
+      require 'spec_helper'
+      describe ObjectUnderTest do
+        let(:input) { SomeInput.new }
+        let(:output) { SomeOutput.new }
+
+        it "tests something" do
+          expect(VerifiedDouble.wrap(ObjectUnderTest))
+            .to receive(:some_method).with(input).and_return(output)
+
+          ObjectUnderTest.do_something(input)
+        end
+      end
+      """
+
+    And the test suite does not have a contract test for the mock
+
+    When I run the test suite
+    Then I should be informed that the stub is unverified:
+      """
+      The following mocks are not verified:
+
+      1. ObjectUnderTest.some_method(SomeInput)=>SomeOutput
+      """

data/features/readme.md

@@ -148,9 +148,19 @@ describe Collaborator do
 end
 ```
 
-## Any Instance mocks
+## Partial and Any Instance mocks
 
-Aside for instance and class doubles, VerifiedDouble also supports `any_instance` mocks:
+Aside for instance and class doubles, VerifiedDouble also supports partial and "any instance" mocks:
+
+```
+object_under_test = ObjectUnderTest.new
+
+expect(VerifiedDouble.wrap(object_under_test))
+  .to receive(:some_method).with(input).and_return(output)
+
+expect(VerifiedDouble.wrap(ObjectUnderTest))
+  .to receive(:some_method).with(input).and_return(output)
+```
 
 ```
 VerifiedDouble.expect_any_instance_of(Collaborator)

data/features/step_definitions/verified_double_steps.rb

@@ -10,6 +10,10 @@ Given(/^a test that uses VerifiedDouble to mock any instance of the class:$/) do
   write_file 'spec/main_spec.rb', string
 end
 
+Given /^a test that uses VerifiedDouble to mock the object under test:$/ do |string|
+  write_file 'spec/main_spec.rb', string
+end
+
 Given /^a test that uses VerifiedDouble to stub an object:$/ do |string|
   write_file 'spec/main_spec.rb', string
 end

data/lib/verified_double.rb

@@ -37,7 +37,9 @@ module VerifiedDouble
   end
 
   def self.of_class(class_value, options = {})
-    options[:transfer_nested_constants] = true if options[:transfer_nested_constants].nil?
+    if options[:transfer_nested_constants].nil?
+      options[:transfer_nested_constants] = true
+    end
     d = stub_const(class_value.to_s, Class.new, options)
     d.extend(VerifiedDouble::IsAClassDouble)
     VerifiedDouble.record(d)
@@ -81,5 +83,14 @@ module VerifiedDouble
   def self.verified_signatures_from_matchers
     @verified_signatures_from_matchers ||= []
   end
-end
 
+  def self.wrap(object)
+    if object.is_a?(Module)
+      object.extend(VerifiedDouble::IsAClassDouble)
+    else
+      object.extend(VerifiedDouble::IsAnInstanceDouble)
+    end
+
+    VerifiedDouble.record(object)
+  end
+end

data/lib/verified_double/simple_double.rb

@@ -22,7 +22,7 @@ module VerifiedDouble
       elsif any_instance_double?
         internal.instance_variable_get('@target').to_s
       else
-        raise 'Unable to handle internal #{internal.inspect}'
+        internal.class.name
       end
     end
 

data/lib/verified_double/version.rb

@@ -1,3 +1,3 @@
 module VerifiedDouble
-  VERSION = "0.5.3"
+  VERSION = "0.6"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: verified_double
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: '0.6'
 platform: ruby
 authors:
 - George Mendoza
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-26 00:00:00.000000000 Z
+date: 2013-12-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -157,6 +157,7 @@ files:
 - features/any_instance.feature
 - features/customizing_arguments_and_return_values.feature
 - features/describe_contract.feature
+- features/partial_mocks.feature
 - features/readme.md
 - features/rspec_mock_compatibility.feature
 - features/step_definitions/verified_double_steps.rb
@@ -235,6 +236,7 @@ test_files:
 - features/any_instance.feature
 - features/customizing_arguments_and_return_values.feature
 - features/describe_contract.feature
+- features/partial_mocks.feature
 - features/readme.md
 - features/rspec_mock_compatibility.feature
 - features/step_definitions/verified_double_steps.rb