rspec_candy 0.1.1 → 0.1.2

data/README.md

@@ -1,4 +1,132 @@
-Changes from previous versions:
+#rspec_candy
+
+
+A collection of nifty helpers for your rspec suite.
+
+Will work for RSpec1 and Rails 2, or RSpec2 and Rails 3, or no Rails at all..
+
+
+##Usage
+
+Add `rspec_candy` to your Gemfile.
+Add `require 'rspec_candy/helpers'` to your spec_helper.rb, after the rspec requires.
+
+
+##Helpers provided
+
+
+### Extensions to **Object**
+
+**should_receive_and_execute**
+
+  Like "should_receive", but also executes the method.
+
+
+**should_receive_and_return**
+
+  Expects multiple returns at once:
+    
+    dog.should_receive_and_return(:bark => "Woof", :fetch => "stick")
+
+
+**should_receive_chain**
+
+  Expect a chain of method calls:
+
+    dog.should_receive_chain(:bark, :upcase).and_return("WOOF")
+
+
+  You can also expect arguments, like:
+ 
+    dog.should_receive_chain([:bark, 'loudly'], :upcase).and_return("WOOF!!!")
+        
+ 
+**stub_existing**
+  
+  Like stub, put complains if the method did not exist in the first place.
+
+
+### Extensions to **Class**
+
+**disposable_copy**
+
+  Like dup for classes. This will temporarily add a method to a class:
+
+    copy = Model.disposable_copy.class_eval do
+      def foo; end
+    end
+
+    object = copy.new
+
+
+**new_with_stubs**
+  
+  Instantiates and stubs in one call:
+
+    Model.new_with_stubs(:to_param => '1')
+
+**stub_any_instance**
+
+  Backport for `any_instance.stub` to RSpec1.
+
+ 
+### Extensions to **example groups**
+
+**it_should_act_like**
+
+  Extension to 'it_should_behave_like`, not necessary for RSpec2.
+
+  Allows parametrizing shared examples, exposes parameters as lets:
+
+    shared_examples_for "an animal" do
+      it 'should make noises' do
+        subject.say.should == expected_noise
+      end
+    end
+
+    describe Dog do
+      it_should_act_like 'an animal', :expected_noise => 'Woof!'
+    end
+
+
+  Blocks are passed as a let named "block".
+
+
+**it_should_run_callbacks**
+
+   Only on Rails.
+
+   Check if callbacks are run. Note the name of the describe block is significant:
+
+     describe Model, '#after_save' do
+       it_should_run_callbacks :notify_this, :notify_that
+     end
+  
+   If you use the state_machine gem, you can also spec callbacks for state_machine transitions:
+
+
+    describe Model, '#my_event from :my_state1 to :my_state" do
+      it_should_run_callbacks :notify_this, :notify_that
+    end
+
+**it_should_run_callbacks_in_order**
+
+  Like `it_should_run_callbacks`, but also checks the correct order.
+
+  
+  
+
+### Extensions to **ActiveRecord::Base**
+
+**create_without_callbacks**
+  
+  Only on Rails.
+
+  Creates a record without validations or callbacks (like a stub in the database). Can be significantly faster than a factory.
+
+
+
+##Changes from previous versions:
 
 - `new_and_store` has been renamed `create_without_callbacks`
 - `keep_invalid!` has been renamed to `prevent_storage`

data/lib/rspec_candy/helpers/disposable_copy.rb

@@ -4,8 +4,9 @@ module RSpecCandy
 
       def disposable_copy(&body)
         this = self
-        copy = Class.new(self, &body)
+        copy = Class.new(self)
         copy.singleton_class.send(:define_method, :name) { this.name }
+        copy.class_eval(&body) if body
         copy
       end
 

data/lib/rspec_candy/version.rb

@@ -1,3 +1,3 @@
 module RSpecCandy
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

data/spec/rspec1/spec_helper.rb

@@ -8,7 +8,7 @@ require "#{File.dirname(__FILE__)}/app_root/config/environment"
 require 'spec/rails'
 
 # Load dependencies
-require 'rspec_candy'
+require 'rspec_candy/helpers'
 
 # Require support code
 Dir["../shared/support/**/*.rb"].each {|f| require f}

data/spec/rspec2/spec_helper.rb

@@ -9,7 +9,7 @@ require "#{File.dirname(__FILE__)}/app_root/config/environment"
 require 'rspec/rails'
 
 # Load dependencies
-require 'rspec_candy'
+require 'rspec_candy/helpers'
 
 # Require support code
 Dir["../shared/support/**/*.rb"].each {|f| require f}

data/spec/shared/rspec_candy/helpers/disposable_copy_spec.rb

@@ -38,6 +38,14 @@ describe RSpecCandy::Helpers::DisposableCopy do
         Model.new.should_not respond_to(:foo)
       end
 
+      it 'should evaluate the block after the copy has been renamed to the original class name' do
+        spy = mock('spy')
+        spy.should_receive(:observe_name).with('Model')
+        Model.disposable_copy do
+          spy.observe_name(name)
+        end
+      end
+
     end
 
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: rspec_candy
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 31
   prerelease: 
   segments: 
   - 0
   - 1
-  - 1
-  version: 0.1.1
+  - 2
+  version: 0.1.2
 platform: ruby
 authors: 
 - Henning Koch
@@ -16,7 +16,8 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-05-11 00:00:00 Z
+date: 2012-07-05 00:00:00 +02:00
+default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rspec
@@ -122,6 +123,7 @@ files:
 - spec/shared/support/matchers/pass_as_example.rb
 - template/spec_candy.rails2.rb
 - template/spec_candy.rails3.rb
+has_rdoc: true
 homepage: https://github.com/makandra/rspec_candy
 licenses: []
 
@@ -151,10 +153,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.3.9.4
 signing_key: 
 specification_version: 3
 summary: RSpec helpers and matchers we use in our daily work at makandra.
 test_files: []
 
-has_rdoc: