muack 1.0.4 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a9ba1c6a1c4f4eb8a2a2899c4a140aaf344c0d4b
-  data.tar.gz: e258c9b2c1351d7ab3e3d11c40855f07d5791893
+  metadata.gz: f1c224f1dd6be101ec8dada7a46d3df32f788d82
+  data.tar.gz: cc3f213b4d737ecea14fb3492467c985dcbbe685
 SHA512:
-  metadata.gz: e3b9ee3b07c99e2a7522086045d7e1eaec8f90b989c8bd3113ad963c98d4735a14b6cfee956156802963fd75ec723559bfeff91b95dd578998c49b67de8ce78a
-  data.tar.gz: 0db81e2e647e106f5173436caf64ebc5aa321089068263b64e6dc4b627d28edb730841c1b75406bbbb838da6eeaa86d6399078ff3e7092bf6b243d6f757e02a4
+  metadata.gz: 690163afe7968b15fde073e447d54604a20c431645fc56fd56e8fa5f52f1ea0d10bdec7e92ebb78c2b3a38c6291d79c242f49aec6744a7a2639c1abf44e52c90
+  data.tar.gz: 9b4ff0d87fd84b0f76b17983f1e2524fa60d435b5ad48c87f593dbde6c2fc0d5dead257beac7147bad5a37def75dd567c145dc07ab9760ed2310b3ebdaf356ad

data/CHANGES.md

@@ -1,5 +1,22 @@
 # CHANGES
 
+## Muack 1.1.0 -- 2014-04-17
+
+Improvements:
+
+* Now we show "Unexpected call" instead of "Expected ... was not called".
+  This should make it easier to read and understand.
+
+Incompatible changes:
+
+* Previously, if you're using a spy, it would examine all the messages for
+  the given stub. However this might not be desired as then we need to
+  specify everything in the stub for the say. Tedious. From now on, spies
+  would only examine specified messages, ignoring unspecified stubbed
+  methods. This sort of breaks the concept that "mocks = stubs + spies"
+  as spies would not fully examine the stubs now. It's now more like:
+  "mocks >= stubs + spies".
+
 ## Muack 1.0.4 -- 2014-03-29
 
 * Now we could `Muack.verify(obj)` or `Muack.reset(obj)` a single object.

data/README.md

@@ -25,7 +25,7 @@ Muack is much simpler and thus much faster and much more consistent.
 
 ## REQUIREMENTS:
 
-* Tested with MRI (official CRuby) 2.0.0, 2.1.0, Rubinius and JRuby.
+* Tested with MRI (official CRuby), Rubinius and JRuby.
 
 ## INSTALLATION:
 
@@ -77,9 +77,10 @@ There are also 3 different kinds of mocks in Muack, which are:
 * Stubs
 * Spies
 
-You could also think of _mocks_ are _stubs_ + _spies_. Here's the equation:
+You could think of _mocks_ are sort of _stubs_ combined with _spies_. Here's
+the inequation:
 
-    mock = stub + spy
+    mock >= stub + spy
 
 Stubs help us inject methods into the objects we want to observe. Spies
 help us observe the behaviours of the objects. As for mocks, they inject
@@ -113,13 +114,21 @@ or not, but sometimes we do care. With stubs and spies, we could always put
 stubs in the before/setup block, and only when we really care if they are
 called or not, we put spies to examine.
 
-On the other hand, stubs aren't limited to testing. If we want to monkey
-patching something, stubs could be useful as we don't care how many times
-the injected methods are called. Jump to _Muack as a mocky patching library_
-section for more detail.
+The other difference is that, spies could partially verify the corresponding
+stubs, but not necessarily completely as mocks. For example, we could stub
+two methods, but only verify one of them with a spy.
 
-Note that you could also mix mocks and stubs for a given object.
-Here's an example:
+``` ruby
+obj = Object.new
+stub(obj).name{ 'obj' }
+stub(obj).id  { 12345 }
+p obj.name     # 'obj'
+p obj.id       # 12345
+spy(obj).name
+p Muack.verify # true
+```
+
+This is similar as mixing mocks and stubs, as in the following example:
 
 ``` ruby
 obj = Object.new
@@ -133,6 +142,11 @@ p Muack.verify # true
 However you should not mix mocks and stubs with the same method, or you
 might encounter some unexpected result. Jump to _Caveat_ for more detail.
 
+On the other hand, stubs aren't limited to testing. If we want to monkey
+patching something, stubs could be useful as we don't care how many times
+the injected methods are called. Jump to _Muack as a mocky patching library_
+section for more detail.
+
 ### reset and verify
 
 Calling `Muack.reset` is essentially resetting all mocks, returning all

data/lib/muack/failure.rb

@@ -16,7 +16,7 @@ module Muack
       @was = "#{obj.inspect}.#{msg}(" \
              "#{args.map(&:inspect).join(', ')})"
       if expected_defis.empty?
-        super("\nExpected: #{@was}\n          was not called.")
+        super("\nUnexpected call: #{@was}")
       else
         build_expected(obj, expected_defis)
         super("\nExpected: #{expected}\n but was: #{was}")

data/lib/muack/spy.rb

@@ -10,7 +10,9 @@ module Muack
 
     # used for Muack::Session#verify
     def __mock_verify
-      @secret.each{ |defi| __mock_dispatch(defi.msg, defi.args) }
+      @secret.each do |defi|
+        __mock_dispatch(defi.msg, defi.args) if __mock_defis.key?(defi.msg)
+      end
       super # simulate dispatching before passing to mock to verify
     end
 

data/lib/muack/version.rb

@@ -1,4 +1,4 @@
 
 module Muack
-  VERSION = '1.0.4'
+  VERSION = '1.1.0'
 end

data/muack.gemspec

@@ -1,14 +1,14 @@
 # -*- encoding: utf-8 -*-
-# stub: muack 1.0.4 ruby lib
+# stub: muack 1.1.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "muack"
-  s.version = "1.0.4"
+  s.version = "1.1.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
   s.authors = ["Lin Jen-Shin (godfat)"]
-  s.date = "2014-03-29"
+  s.date = "2014-04-17"
   s.description = "Muack -- A fast, small, yet powerful mocking library.\n\nInspired by [RR][], and it's 32x times faster (750s vs 23s) than RR\nfor running [Rib][] tests.\n\n[RR]: https://github.com/rr/rr\n[Rib]: https://github.com/godfat/rib"
   s.email = ["godfat (XD) godfat.org"]
   s.files = [

data/test/test_mock.rb

@@ -160,7 +160,7 @@ describe Muack::Mock do
       rescue Muack::Unexpected => e
         e.expected.should.eq nil
         e.was     .should.eq 'obj.say()'
-        e.message .should.start_with "\nExpected: #{e.was}\n"
+        e.message .should.eq "\nUnexpected call: #{e.was}"
       end
     end
 
@@ -172,7 +172,7 @@ describe Muack::Mock do
       rescue Muack::Unexpected => e
         e.expected.should.eq nil
         e.was     .should.eq 'obj.say(true)'
-        e.message .should.start_with "\nExpected: #{e.was}\n"
+        e.message .should.eq "\nUnexpected call: #{e.was}"
       end
     end
 

data/test/test_stub.rb

@@ -47,13 +47,13 @@ describe Muack::Stub do
     should 'work with spy' do
       stub(Obj).say{0}
       Obj.say.should.eq 0
-      spy(Obj).say
+       spy(Obj).say
     end
 
     should 'work with spy twice' do
       stub(Obj).say{}
       2.times{ Obj.say.should.eq nil }
-      spy(Obj).say.times(2)
+       spy(Obj).say.times(2)
     end
 
     should 'work with spy spy' do
@@ -65,13 +65,21 @@ describe Muack::Stub do
     should 'verify spy arguments' do
       stub(Obj).say(1){|a|a}
       Obj.say(1).should.eq 1
-      spy( Obj).say(1)
+       spy(Obj).say(1)
     end
 
     should 'properly verify spy arguments' do
       stub(Obj).say(is_a(String)){|a|a}
       Obj.say('Hi!').should.eq 'Hi!'
-      spy( Obj).say(is_a(String))
+       spy(Obj).say(is_a(String))
+    end
+
+    should 'ignore messages spies not interested' do
+      stub(Obj).saya{0}
+      stub(Obj).sayb{1}
+      Obj.saya.should.eq 0
+      Obj.sayb.should.eq 1
+       spy(Obj).saya
     end
   end
 
@@ -108,7 +116,7 @@ describe Muack::Stub do
 
     should 'raise Expected if the spy is not satisfied' do
       stub(Obj).say{}
-      spy( Obj).say
+       spy(Obj).say
       begin
         Muack.verify
         'never'.should.eq 'reach'
@@ -124,7 +132,7 @@ describe Muack::Stub do
     should 'raise Expected if the spy is not satisfied enough' do
       stub(Obj).say{}
       Obj.say
-      spy( Obj).say(0)
+       spy(Obj).say(0)
       begin
         Muack.verify
         'never'.should.eq 'reach'
@@ -138,7 +146,7 @@ describe Muack::Stub do
     should 'show correct times for under satisfaction' do
       stub(Obj).say{}
       2.times{ Obj.say }
-      spy( Obj).say.times(3)
+       spy(Obj).say.times(3)
       begin
         Muack.verify
         'never'.should.eq 'reach'
@@ -154,7 +162,7 @@ describe Muack::Stub do
     should 'show correct times for over satisfaction' do
       stub(Obj).say{}
       2.times{ Obj.say }
-      spy( Obj).say
+       spy(Obj).say
       begin
         Muack.verify
         'never'.should.eq 'reach'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: muack
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.1.0
 platform: ruby
 authors:
 - Lin Jen-Shin (godfat)
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-29 00:00:00.000000000 Z
+date: 2014-04-17 00:00:00.000000000 Z
 dependencies: []
 description: |-
   Muack -- A fast, small, yet powerful mocking library.