rspec_super 0.1.1

data/README.markdown

@@ -0,0 +1,51 @@
+RSpec Super
+===========
+**Git**:       [http://github.com/mattdenner/rspec_super](http://github.com/mattdenner/rspec_super)
+**Author**:    Matthew Denner
+**Copyright**: 2010
+**License**:   MIT Licence
+
+Overview
+--------
+This gem provides [RSpec](http://rspec.info/) with a way for testing methods that call super.  Consider this:
+
+    class Base
+      def do_something
+      end
+    end
+    
+    class Derived < Base
+      def do_something
+        super
+        do_something_else
+      end
+    
+      def do_something_else
+      end
+    end
+
+How do you go about testing `Derived#do_something` without having to duplicate your `Base#do_something` tests?
+
+With this gem you can use {Spec::Mocks::Methods#should_receive_super_of should_receive_super_of} and the standard RSpec expectations, just like this:
+
+    describe Derived do
+      before(:each) do
+        @object = described_class.new
+      end
+    
+      describe '#do_something' do
+        it 'calls super' do
+          @object.should_receive_super_of(:do_something).once
+          @object.should_receive(:do_something_else).once
+          @object.do_something
+        end
+      end
+    end
+
+Word of warning!
+----------------
+This is very very alpha code and has only been tested with RSpec 1.3.0 and on Ruby 1.9.1.  You should be alright to use it on Ruby 1.8.7 but don't quote me on the RSpec support for earlier versions!
+
+Copyright
+---------
+RSpec Super &copy; 2010 by [Matthew Denner](mailto:matt.denner@gmail.com). RSpec Super is licensed under the MIT license.

data/Rakefile

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'rake'
+
+require 'yard'
+
+YARD::Rake::YardocTask.new do |rd|
+  rd.files   = [ 'README.markdown', 'lib/**/*.rb' ]
+  rd.options = [ '-o', 'doc' ]
+end
+
+require 'spec/rake/spectask'
+
+Spec::Rake::SpecTask.new do |t|
+	t.spec_files = FileList[ 'spec/**/*_spec.rb' ]
+end

data/lib/rspec_super.rb

@@ -0,0 +1,62 @@
+require 'spec/mocks/methods'
+
+module Spec
+  module Mocks
+    module Methods
+      # Behaves like +should_receive+ except that it can be used to set expectations on the
+      # method specified calling super.
+      def should_receive_super_of(method)
+        should_receive(install_super_hook_for(method))
+      end
+
+    private
+
+      def rspec_reset_with_super
+        rspec_reset_without_super
+        uninstall_super_hooks
+      end
+      alias_method(:rspec_reset_without_super, :rspec_reset)
+      alias_method(:rspec_reset, :rspec_reset_with_super)
+
+      #--
+      # Complete fudge to make sure that YARD doesn't display rspec_reset_with_super in the
+      # documentation!
+      #++
+      public :rspec_reset
+
+      def uninstall_super_hooks #:nodoc:
+        @_super_hooks_installed ||= []
+        @_super_hooks_installed.each do |method|
+          method_with_super, method_without_super = :"#{ method }_with_super", :"#{ method }_without_super"
+
+          self.class.superclass.instance_eval do
+            alias_method(method, method_without_super)
+            undef_method(method_without_super)
+            undef_method(method_with_super)
+          end
+        end
+      end
+
+      def install_super_hook_for(method) #:nodoc:
+        method_with_super, method_without_super = :"#{ method }_with_super", :"#{ method }_without_super"
+
+        self.class.superclass.class_eval do
+          line_number = __LINE__ + 1
+          eval(%Q{
+            def #{ method_with_super }(*args, &block)
+              #{ method_with_super }(*args, &block)
+            end
+            alias_method(#{ method_without_super.inspect }, #{ method.inspect })
+            alias_method(#{ method.inspect }, #{ method_with_super.inspect })
+          }, binding, __FILE__, line_number)
+        end
+
+        @_super_hooks_installed ||= []
+        @_super_hooks_installed.push(method)
+
+        return method_with_super
+      end
+    end
+  end
+end
+

data/spec/rspec_super/direct_derivative_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+class DirectlyDerived < Base
+  def do_something
+    super
+    do_something_else
+  end
+
+  def do_something_else
+
+  end
+end
+
+describe DirectlyDerived do
+  before(:each) do
+    @object = described_class.new
+  end
+
+  describe '#do_something' do
+    it 'raises without the super hook' do
+      lambda { @object.do_something }.should raise_error(StandardError, "Nope, that code didn't work")
+    end
+
+    it 'calls super' do
+      @object.should_receive_super_of(:do_something).once
+      @object.should_receive(:do_something_else).once
+      @object.do_something
+    end
+  end
+end

data/spec/rspec_super/non_direct_derivative_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+class DerivedThroughIntermediary < Intermediary
+  def do_something
+    super
+    do_something_else
+  end
+
+  def do_something_else
+  end
+end
+
+describe DerivedThroughIntermediary do
+  before(:each) do
+    @object = described_class.new
+  end
+
+  describe '#do_something' do
+    it 'calls super' do
+      @object.should_receive_super_of(:do_something).once
+      @object.should_receive(:do_something_else).once
+      @object.do_something
+    end
+  end
+end

data/spec/rspec_super/passing_arguments_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+class PassingArguments < Base
+  def do_something_with_arguments(a, b)
+    super
+    do_something_else_with_arguments(a, b)
+  end
+
+  def do_something_else_with_arguments(a, b)
+  end
+end
+
+describe PassingArguments do
+  before(:each) do
+    @object = described_class.new
+  end
+
+  describe '#do_something_with_arguments' do
+    it 'calls super with arguments' do
+      @object.should_receive_super_of(:do_something_with_arguments).with(1, 2).once
+      @object.should_receive(:do_something_else_with_arguments).with(1, 2).once
+      @object.do_something_with_arguments(1, 2)
+    end
+  end
+end
+

data/spec/rspec_super/yielding_to_block_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+class YieldingToBlock < Base
+  def do_something_with_block(&block)
+    super
+    do_something_else_with_block(&block)
+  end
+
+  def do_something_else_with_block(&block)
+    block.call
+  end
+end
+
+describe YieldingToBlock do
+  before(:each) do
+    @object = described_class.new
+  end
+
+  describe '#do_something_with_block' do
+    it 'causes two callbacks by default' do
+      callback = mock('callback')
+      callback.should_receive(:called).twice
+
+      @object.do_something_with_block { callback.called }
+    end
+
+    it 'calls super with block' do
+      callback = mock('callback')
+      callback.should_receive(:called).twice
+
+      @object.should_receive_super_of(:do_something_with_block).once.and_yield
+      @object.should_receive(:do_something_else_with_block).once.and_yield
+      @object.do_something_with_block { callback.called }
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require 'rspec_super'
+
+class Base
+  def do_something
+    raise StandardError, "Nope, that code didn't work"
+  end
+
+  def do_something_with_arguments(a, b)
+    raise StandardError, "Nope, that code didn't work"
+  end
+
+  def do_something_with_block(&block)
+    yield
+  end
+end
+
+class Intermediary < Base
+
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification 
+name: rspec_super
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- Matthew Denner
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-19 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 5
+        - 4
+        version: 0.5.4
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :runtime
+  version_requirements: *id003
+description: Provides helper methods for RSpec that help you test methods that call super
+email: matt.denner@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- Rakefile
+- lib/rspec_super.rb
+- spec/rspec_super/direct_derivative_spec.rb
+- spec/rspec_super/non_direct_derivative_spec.rb
+- spec/rspec_super/passing_arguments_spec.rb
+- spec/rspec_super/yielding_to_block_spec.rb
+- spec/spec_helper.rb
+has_rdoc: yard
+homepage: http://github.com/mattdenner/rspec_super
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Test methods that call super with RSpec
+test_files: 
+- spec/spec_helper.rb
+- spec/rspec_super/direct_derivative_spec.rb
+- spec/rspec_super/non_direct_derivative_spec.rb
+- spec/rspec_super/passing_arguments_spec.rb
+- spec/rspec_super/yielding_to_block_spec.rb