developwithpassion_fakes 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+blah.rb
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.2@developwithpassion.fakes --create

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/developwithpassion_fakes.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib",__FILE__)
+require "developwithpassion_fakes/version"
+
+Gem::Specification.new do |s|
+  s.name        = "developwithpassion_fakes"
+  s.version     = DevelopWithPassion::Fakes::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Develop With Passion®"]
+  s.email       = ["open_source@developwithpassion.com"]
+  s.homepage    = "http://www.developwithpassion.com"
+  s.summary     = %q{Simple faking library}
+  s.description = %q{Faking library that allows inspection of received calls after they have been made. Also supports tracking calls with multiple argument sets.}
+  s.rubyforge_project = "developwithpassion_fakes"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/developwithpassion_fakes/arg_behaviour.rb

@@ -0,0 +1,24 @@
+module DevelopWithPassion
+  module Fakes
+    module ArgBehaviour
+      attr_accessor :return_value,:times_called
+
+      def and_return(item)
+        @return_value = item
+      end
+
+      def capture_args(*args)
+        @times_called += 1
+        @called_args = *args
+      end
+
+      def matches?(*args)
+        return @args == args
+      end
+
+      def was_called_with?(*args)
+        return @called_args == args
+      end
+    end
+  end
+end

data/lib/developwithpassion_fakes/arg_set.rb

@@ -0,0 +1,12 @@
+module DevelopWithPassion
+  module Fakes
+    class ArgSet
+      include ArgBehaviour
+
+      def initialize(*args)
+        @args = *args
+        @times_called = 0
+      end
+    end
+  end
+end

data/lib/developwithpassion_fakes/fake.rb

@@ -0,0 +1,31 @@
+module DevelopWithPassion
+  module Fakes
+    class Fake
+      def initialize(invocation_set = {})
+        @method_invocations = invocation_set
+      end
+
+      def method_missing(name,*args,&block)
+        return @method_invocations.has_key?(name.to_sym) ? @method_invocations[name.to_sym].invoke(*args) : handle_unexpected_method_invocation(name,*args,block)
+      end
+
+      def handle_unexpected_method_invocation(name,*args,block)
+        method = stub(name.to_sym)
+        method.ignore_arg
+        return method.invoke(*args)
+      end
+
+      def stub(symbol)
+        return @method_invocations[symbol] || @method_invocations[symbol] = MethodStub.new
+      end
+
+      def received(symbol)
+        return @method_invocations[symbol]
+      end
+
+      def never_received?(symbol)
+        return !@method_invocations.has_key?(symbol)
+      end
+    end
+  end
+end

data/lib/developwithpassion_fakes/ignore_set.rb

@@ -0,0 +1,15 @@
+module DevelopWithPassion
+  module Fakes
+    class IgnoreSet
+      include ArgBehaviour
+
+      def initialize
+        @times_called = 0
+      end
+
+      def matches?(*args)
+        return true
+      end
+    end
+  end
+end

data/lib/developwithpassion_fakes/method_stub.rb

@@ -0,0 +1,42 @@
+module DevelopWithPassion
+  module Fakes
+    class MethodStub
+      def initialize(arg_sets = [])
+        @arg_sets = arg_sets
+      end
+
+      def with(*args)
+        return add_new_set(ArgSet.new(*args))
+      end
+
+      def add_new_set(set)
+        @arg_sets << set
+        return set
+      end
+
+      def ignore_arg
+        return add_new_set(IgnoreSet.new)
+      end
+
+      def and_return(item)
+        ignore_arg.and_return(item)
+      end
+
+
+      def invoke(*args)
+        set = @arg_sets.find{|item| item.matches?(*args)} || ignore_arg
+        set.capture_args(*args)
+        return set.return_value
+      end
+
+      def called_with(*args)
+        return @arg_sets.find{|item| item.was_called_with?(*args)}
+      end
+
+      def times?(value)
+        total = @arg_sets.inject(0){|sum,item|sum += item.times_called}
+        return total == value
+      end
+    end
+  end
+end

data/lib/developwithpassion_fakes/version.rb

@@ -0,0 +1,5 @@
+module DevelopWithPassion
+  module Fakes
+    VERSION = "0.0.1"
+  end
+end

data/lib/developwithpassion_fakes.rb

@@ -0,0 +1,5 @@
+require 'developwithpassion_fakes/arg_behaviour'
+require 'developwithpassion_fakes/arg_set'
+require 'developwithpassion_fakes/fake'
+require 'developwithpassion_fakes/ignore_set'
+require 'developwithpassion_fakes/method_stub'

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'rspec'
+
+Dir.chdir(File.join(File.dirname(__FILE__),"..,lib".split(','))) do
+  Dir.glob("**/*.rb").each do |file| 
+    full_path = File.expand_path(file)
+    $:.unshift File.expand_path(File.dirname(full_path))
+    require full_path
+  end
+end

data/spec/specs/arg_behaviour_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+
+module DevelopWithPassion
+  module Fakes
+    describe ArgBehaviour do
+      class AnArg
+        attr_accessor :called_args,:args
+        def initialize
+          @times_called = 0
+        end
+      end
+
+      let(:sut){AnArg.new}
+      before (:each) do
+        sut.send(:extend,ArgBehaviour)
+      end
+      context "when a return value is specified" do
+        before (:each) do
+          sut.and_return(2)
+        end
+        it "should store the return value to be returned during invocation" do
+          sut.return_value.should == 2
+        end
+      end
+
+      context "when handling an invocation" do
+        before (:each) do
+          sut.capture_args(2)
+        end
+        it "should increment the number of times it was called" do
+          sut.times_called.should == 1
+        end
+        it "should store the arguments it was called with" do
+          sut.called_args.should == [2]
+        end
+      end
+
+      context "when matching a set of arguments" do
+        before (:each) do
+          sut.args = [2]
+        end
+        it "should match if its own set of arguments are the same" do
+          sut.matches?(2).should be_true
+          sut.matches?(3).should be_false
+        end
+      end
+
+      context "when determining whether it was called with a set of arguments" do
+        before (:each) do
+          sut.called_args = [2]
+        end
+
+        it "should match if the arguments are the same as the arguments it was invoked with" do
+          sut.was_called_with?(2).should be_true
+          sut.was_called_with?(3).should be_false
+        end
+      end
+    end
+  end
+end

data/spec/specs/arg_set_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+module DevelopWithPassion
+  module Fakes
+    describe ArgSet do
+      context "when created" do
+        let(:sut){ArgSet.new(1)}
+
+        it "should initialize required members" do
+          sut.times_called.should == 0
+        end
+      end
+    end
+  end
+end

data/spec/specs/fake_spec.rb

@@ -0,0 +1,140 @@
+require 'spec_helper'
+
+module DevelopWithPassion
+  module Fakes
+    describe Fake do
+      context "when stubbing a method" do
+        let(:invocations){Hash.new}
+        let(:sut){Fake.new(invocations)}
+        let(:symbol){:hello}
+        let(:new_method){Object.new}
+
+        context "and the method is not currently setup to be called" do
+          before (:each) do
+            MethodStub.stub(:new).and_return(new_method)
+          end
+          before (:each) do
+            @result = sut.stub(symbol)
+          end
+          it "should add a new method stub to the list of all invocations" do
+            invocations[symbol].should == new_method
+          end
+          it "should return the method invocation to continue specifying call behaviour" do
+            @result.should == new_method 
+          end
+        end
+
+        context "and the method is already in the list of invocations" do
+          before (:each) do
+            invocations[symbol] = new_method
+          end
+          before (:each) do
+            @result = sut.stub(symbol)
+          end
+
+          it "should not readd the method to the list of invocations" do
+            invocations.count.should == 1
+          end
+
+          it "should return the method invocation to continue specifying call behaviour" do
+            @result.should == new_method 
+          end
+        end
+      end
+      context "when accessing the behaviour for a received call" do
+        let(:invocations){Hash.new}
+        let(:sut){Fake.new(invocations)}
+        let(:symbol){:hello}
+        let(:method_invocation){Object.new}
+
+        before (:each) do
+          invocations[symbol] = method_invocation
+        end
+        before (:each) do
+          @result = sut.received(symbol)
+        end
+        it "should return the method invocation for the called method" do
+          @result.should == method_invocation 
+        end
+      end
+      context "when verifying whether a call was never received" do
+        let(:invocations){Hash.new}
+        let(:sut){Fake.new(invocations)}
+        let(:existing){:hello}
+        let(:method_invocation){Object.new}
+
+        before (:each) do
+          invocations[existing] = method_invocation
+        end
+
+
+        it "should base its decision on the list of received invocations" do
+          [:other,existing].each do|item|
+            sut.never_received?(item).should_not be_equal(invocations.has_key?(item))
+          end
+        end
+      end
+      context "when method missing is triggered" do
+        class FakeInvocation
+          attr_accessor :invoke_was_called,:args,:return_value,:ignores_args
+
+          def initialize(return_value)
+            @return_value = return_value
+          end
+
+          def invoke(args)
+            @args = args
+            return @return_value
+          end
+
+          def ignore_arg
+            @ignores_args = true
+          end
+        end
+        let(:invocations){Hash.new}
+        let(:sut){Fake.new(invocations)}
+        let(:symbol){:hello}
+        let(:invocation){FakeInvocation.new(Object.new)}
+        let(:args){"world"}
+        context "and the method is for an invocation that was prepared" do
+          before (:each) do
+            invocations[symbol] = invocation
+          end
+          before (:each) do
+            @result = sut.hello(args)
+          end
+          it "should trigger the invocation with the arguments" do
+            invocation.args.should == args
+          end
+          it "should return the result of triggering the invocation" do
+            @result.should == invocation.return_value
+          end
+        end
+        context "and the method is for an invocation that was not prepared" do
+          before (:each) do
+            MethodStub.stub(:new).and_return(invocation)
+          end
+          before (:each) do
+            @result = sut.hello(args)
+          end
+          it "should add a new invocation which ignores arguments to the list of all invocations" do
+            invocations.has_key?(:hello).should be_true
+          end
+
+          it "should configure the new invocation to ignore all arguments" do
+            invocation.ignores_args.should be_true 
+          end
+
+          it "should invoke the invocation with the arguments" do
+            invocation.args.should == args 
+          end
+
+          it "should return the result of triggering the new invocation" do
+            @result.should == invocation.return_value
+          end
+        end
+
+      end
+    end
+  end
+end

data/spec/specs/ignore_set_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+module DevelopWithPassion
+  module Fakes
+    describe IgnoreSet do
+      let(:sut){IgnoreSet.new}
+
+      context "when created" do
+        it "should initialize required members" do
+          sut.times_called.should == 0
+        end
+      end
+
+      context "when matching an argument set" do
+        it "should match any argument set" do
+          sut.matches?(1,2,3,4).should be_true
+          sut.matches?(3,"hello",4,5).should be_true
+        end
+      end
+    end
+
+  end
+end

data/spec/specs/method_stub_spec.rb

@@ -0,0 +1,152 @@
+require 'spec_helper'
+
+module DevelopWithPassion
+  module Fakes
+    describe MethodStub do
+      let(:args){[1,2,3]}
+      let(:argument_set){Object.new}
+
+      context "when specifying a set of arguments it should be called with" do
+        let(:arg_sets){[]}
+        let(:sut){MethodStub.new(arg_sets)}
+
+        before (:each) do
+          ArgSet.stub(:new).with(args).and_return(argument_set)
+        end
+        before (:each) do
+          @result = sut.with(args)
+        end
+        it "should add a new argument set to its list of arguments" do
+          arg_sets[0].should == argument_set
+        end
+        it "should return the argument set to continue specifying behaviour" do
+          @result.should == argument_set
+        end
+      end
+
+      context "when ignoring arguments" do
+        let(:ignored_set){Object.new}
+        let(:arg_sets){[]}
+        let(:sut){MethodStub.new(arg_sets)}
+
+        before (:each) do
+          IgnoreSet.stub(:new).and_return(ignored_set)
+        end
+        before (:each) do
+          @result = sut.ignore_arg
+        end
+        it "should add the ignored set to the list of argument sets" do
+          arg_sets[0].should == ignored_set
+        end
+        it "should return the ignored set to specify other behaviour" do
+          @result.should == ignored_set
+        end
+      end
+
+      context "when invoked with a set of arguments" do
+        let(:arg_sets){[]}
+        let(:sut){MethodStub.new(arg_sets)}
+        class DummyArgSet
+          attr_accessor :args
+
+          def capture_args(*args)
+            @args = *args
+          end
+        end
+        context "and it has the specified argument set" do
+          let(:arguments){[1]}
+          let(:arg_set){DummyArgSet.new(2)}
+          before (:each) do
+            arg_sets.push(arg_set)
+            arg_set.stub(:matches?).and_return(true)
+            arg_set.stub(:return_value).and_return(2)
+          end
+          before (:each) do
+            @result = sut.invoke(arguments)
+          end
+          it "should tell the argument set to capture the arguments it was called with" do
+            arg_set.args.should == [arguments]
+          end
+          it "should return using from the arg set" do
+            @result.should == 2
+          end
+
+        end
+        context "and it does not have the specified argument set" do
+          let(:arguments){[1]}
+          let(:arg_set){DummyArgSet.new(2)}
+          before (:each) do
+            sut.stub(:ignore_arg).and_return(arg_set)
+            arg_set.stub(:return_value).and_return(2)
+          end
+          before (:each) do
+            @result = sut.invoke(arguments)
+          end
+          it "should tell the argument set to capture the arguments it was called with" do
+            arg_set.args.should == [arguments]
+          end
+          it "should return using from the missing arg set" do
+            @result.should == 2
+          end
+        end
+
+      end
+
+      context "when determining whether it was called with a set of arguments" do
+        let(:arg_sets){[]}
+        let(:sut){MethodStub.new(arg_sets)}
+        class DummyArgSet
+          attr_accessor :args
+
+          def capture_args(*args)
+            @args = *args
+          end
+        end
+        let(:arguments){[1]}
+
+        context "and one of its argument sets was called with the set of arguments" do
+          let(:arg_set){DummyArgSet.new(2)}
+          before (:each) do
+            arg_sets.push(arg_set)
+            arg_set.stub(:was_called_with?).with(arguments).and_return(true)
+          end
+          before (:each) do
+            @result = sut.called_with(arguments)
+          end
+
+          it "should return the argument set that was called with the arguments" do
+            @result.should == arg_set
+          end
+        end
+        context "and none of its argument sets were called with the arguments" do
+          before (:each) do
+            @result = sut.called_with(arguments)
+          end
+          it "should return nil" do
+            @result.should be_nil
+          end
+        end
+
+      end
+
+      context "when verifying whether it was called a certain number of times" do
+        let(:arg_sets){[]}
+        let(:sut){MethodStub.new(arg_sets)}
+        let(:arg_set){DummyArgSet.new(2)}
+        let(:arg_set_2){DummyArgSet.new(2)}
+
+        before (:each) do
+          arg_sets.push(arg_set)
+          arg_sets.push(arg_set_2)
+          arg_set.stub(:times_called).and_return(2)
+          arg_set_2.stub(:times_called).and_return(3)
+        end
+
+        it "it should return whether the sum of its argset invocations is the same as the number of request made" do
+          sut.times?(5).should be_true
+          sut.times?(3).should be_false
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification 
+name: developwithpassion_fakes
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- "Develop With Passion\xC2\xAE"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-02-10 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Faking library that allows inspection of received calls after they have been made. Also supports tracking calls with multiple argument sets.
+email: 
+- open_source@developwithpassion.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rvmrc
+- Gemfile
+- Rakefile
+- developwithpassion_fakes.gemspec
+- lib/developwithpassion_fakes.rb
+- lib/developwithpassion_fakes/arg_behaviour.rb
+- lib/developwithpassion_fakes/arg_set.rb
+- lib/developwithpassion_fakes/fake.rb
+- lib/developwithpassion_fakes/ignore_set.rb
+- lib/developwithpassion_fakes/method_stub.rb
+- lib/developwithpassion_fakes/version.rb
+- spec/spec_helper.rb
+- spec/specs/arg_behaviour_spec.rb
+- spec/specs/arg_set_spec.rb
+- spec/specs/fake_spec.rb
+- spec/specs/ignore_set_spec.rb
+- spec/specs/method_stub_spec.rb
+homepage: http://www.developwithpassion.com
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: developwithpassion_fakes
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Simple faking library
+test_files: 
+- spec/spec_helper.rb
+- spec/specs/arg_behaviour_spec.rb
+- spec/specs/arg_set_spec.rb
+- spec/specs/fake_spec.rb
+- spec/specs/ignore_set_spec.rb
+- spec/specs/method_stub_spec.rb