rr 1.0.4 → 1.0.5.rc1

data/benchmarks/rspec_benchmark.rb

@@ -1,14 +0,0 @@
-require "rubygems"
-require "spec/mocks"
-require "benchmark"
-
-o = Object.new
-
-Benchmark.bm do |x|
-  x.report do
-    1000.times do
-      o.should_receive(:foobar).and_return("baz")
-      o.foobar
-    end
-  end
-end

data/doc/0.6.0.release.markdown

@@ -1,81 +0,0 @@
-I'm pleased to announce the 0.6.0 version of RR. The [changes](http://github.com/btakita/rr/tree/master%2FCHANGES?raw=true) include:
-
-  * Declaring Double subject objects without having to pass it in via the mock!, stub!, dont_allow!, instance_of!, and proxy! methods
-  * Revised Double chaining API
-  * satisfy matcher
-  * hash_including matcher
-
-# Declaring Double Subjects (The bang methods)
-
-In previous versions of RR, you always needed to pass in the subject of the double. For example:
-
-    subject = Object.new
-    mock(subject).does_something {:and_returns_me}
-    subject.does_something # :and_returns_me
-
-Now you can have RR automatically create the subject object for you by using the ! method:
-
-    subject = mock!.does_something {:and_returns_me}.subject
-    subject.does_something # :and_returns_me
-
-Now the bang methods by themselves don't really add a whole lot, but when used in the context of Double chaining, they become a powerful addition.
-
-# Double Chaining
-
-Nick Kallen presented the use case for Double chaining and contributed a patch for the 0.5.0 release of RR. It has proved useful and is now more fully incorporated into RR. Now you can pass in your subject or use the subject provided by RR by using the ! method. Here are some examples of Double Chaining:
-
-    mock(subject).first(1) {mock(Object.new).second(2) {mock(Object.new).third(3) {4}}}
-    subject.first(1).second(2).third(3) # 4
-
-    mock(subject).first(1) {mock!.second(2) {mock!.third(3) {4}}}
-    subject.first(1).second(2).third(3) # 4
-      
-    mock(subject).first(1).mock!.second(2).mock!.third(3) {4}
-    subject.first(1).second(2).third(3) # 4
-
-Of course you have access to the proxy facilities:
-
-    mock.proxy(User).find('1').mock.proxy!.children.mock.proxy!.find_all_by_group_id(10)
-    User.find('1').children.find_all_by_group_id(10) # Makes verifications pass and returns the actual children
-
-You can also do branched Double chaining:
-
-    mock(subject).first do
-      mock! do |expect|
-        expect.branch1.mock!.branch11 {11} # or expect.branch1 {mock!.branch11 {11}}
-        expect.branch2.mock!.branch22 {22} # or expect.branch2 {mock!.branch22 {22}}
-      end
-    end
-    o = subject.first
-    o.branch1.branch11 # 11
-    o.branch2.branch22 # 22
-
-# Satisfy Matcher
-
-Matthew O'Conner submitted a patch that added the satisfy matcher. This adds the ability to add arbitrary argument expectation matchers.
-
-    mock(object).foobar(satisfy {|arg| arg.length == 2})
-    object.foobar("xy")
-
-
-# Hash Including Matcher
-
-Matthew O'Conner also submitted a patch that added the hash_including matcher. This adds a convenient way to assert that the passed-in hash includes certain key/value pairs.
-
-    mock(object).foobar(hash_including(:red => "#FF0000", :blue => "#0000FF"))
-    object.foobar({:red => "#FF0000", :blue => "#0000FF", :green => "#00FF00"})
-
-# Mailing list
-
-RR has a mailing lists at:
-
-* [double-ruby-users@rubyforge.org](mailto:double-ruby-users@rubyforge.org)
-* [double-ruby-devel@rubyforge.org](mailto:double-ruby-devel@rubyforge.org)
-
-Also, RR's rubyforge page is at [http://rubyforge.org/projects/double-ruby](http://rubyforge.org/projects/double-ruby) and of course the github page is at [http://github.com/btakita/rr](http://github.com/btakita/rr).
-
-# Yes, and there is more to come
-
-There are many interesting ideas floating around. Joseph Wilk has been playing around with [adding Spies](http://github.com/JoeSniff/rr) into RR. I'm also thinking about adding Double validation scoping into RR. Also, I'm impressed by Mocha's warning of unused stubs. Josh Susser also proposed having a mode where a warning would occur if a mocked method is not implemented on the subject being mocked.
-
-If you have any feature requests, please send an email to the mailing list or add it to the rubyforge tracker.

data/introducting_rr.txt

@@ -1,206 +0,0 @@
-**Introducting RR**
-
-I'm pleased to introduce a new Test Double framework names RR, which is short for Double Ruby.
-A Test Double is [double description]. You can read more about test doubles at http://xunitpatterns.com/Test%20Double.html.
-
-RR supports the following constructs:
- * Mock
- * Stub
- * instance_of
- * Probe
-
-**Mock**
-<pre>
-  real_user = User.new
-  mock(User).find('2') {real_user}
-</pre>
-
-The previous example overrides the User.find method and returns real_user. It also sets an expectation
-that the find method will receive the argument '2' once.
-
-**Stub**
-<pre>
-  user = User.new
-  my_article = articles(:my_article)
-  stub(user).can_edit?(my_article) {true}
-</pre>
-
-The previous example overrides can_edit?. When the method receives the article, it returns true.
-
-**instance_of**
-You can mock or stub instances of a class.
-<pre>
-  stub.instance_of(User).can_edit?(my_article) {true}
-</pre>
-
-The previous example stubs the can_edit? method of any intstance of User.
-
-**Probe**
-
-A probe is a test double strategy that lets the real method implementation be called, and allows you
-to intercept the return value, and possibly inject you own replacement return value.
-<pre>
-  my_article = articles(:my_article)
-  mock.probe(User).find('2') do |real_user|
-    stub.probe(real_user).can_edit?(my_article) {true}
-    real_user
-  end
-</pre>
-
-The previous example, lets the real User.find method call happen, and intercepts its return value inside
-of the block.
-
-The real_user's can_edit? method is then stubbed and probed to return true.
-
-**Thats nice, how is it useful?**
-
-As with any tool, Mocks and Stubs have limitations.
-For example, mocks alone do not verify that the mocked out method conforms to the real object's interface.
-Probes solve this issue.
-
-Adding a probe ensures that:
- * The method call to User.find is valid
- * The return value of User.find is available to validate and/or add test doubles to
- * The method call to real_user.can_edit? is valid
-
-**I don't use Mocks. Why should I care?**
-
-State based testing is often the simplest and most straightforward way to make assertions.
-However Interaction assertions can serve as good documentation of how your system fits together.
-Interaction tests can also aid you in making your tests easier to set up and removing coupling between tests.
-
-Lets compare the state and interaction testing approaches in the can edit article example for the
-ArticlesController#edit action:
-
-**State Based Example**
-<pre>
-  user = users(:bob)
-  login(user)
-  my_article = articles(:my_article)
-  user.can_edit?(my_article).should == false
-
-  lambda do
-    post :edit, :id => my_article.id, :body => "Hello everybody"
-  end.should raise_error(SecurityTrangressionError)
-</pre>
-
-**Interaction Based Example**
-<pre>
-  user = users(:bob)
-  login(user)
-  my_article = articles(:my_article)
-  mock.probe(user).can_edit? {false}
-
-  lambda do
-    post :edit, :id => my_article.id, :body => "Hello everybody"
-  end.should raise_error(SecurityTrangressionError)
-</pre>
-
-These two examples are interesting because they verify slight different things.
-The interaction example states that when can_edit? with @article is called and returns false, a SecurityTrangressionError
-is raised.
-The state example gives information that bob cannot edit the article, and from that one can infer that
-bob trying to edit the article will raise a SecurityTrangressionError.
-
-State based testing tends to be more coupling than interaction based testing.
-Note that coupling is not necessarily bad.
-The state based example has both interface, data, and knowledge coupling compared to the interaction based test:
- * Interface coupling - If can_edit? does not return false, there is an error.
- * Fixture Data coupling - If the fixture data changes, there is an error.
- * Knowledge coupling - The ArticleController test needs to know how can_edit? returns false
-
-Interface coupling is actually a good thing, because it verifies the User and ArticleController work
-together proberly. This sort of testing is functional or integration testing.
-
-The Data and Knowledge coupling are not desirable characteristics because they cause the
-developer to be concerned about another part of the system, which takes development time.
-It can also cause unwanted test failures when the global fixture data is changed or when a change
-occurs that makes the ArticleController's test setup logic incorrect.
-
-Martin Fowler also notes that interaction testing has coupling to the edit action's implementation,
-in that the interaction example states that User#can_edit? must be called for the test to pass.
-I've found that sometimes this is desirable and sometimes it is not desirable.
-
-The coupling to the implementation encourages more decomposition but it also makes
-causes brittleness because changing the edit action to call another method will cause
-the test to fail.
-
-I'm not proposing the right solution in this case, because it is dependent on
-your situation. One thing to consider is:
- * Do you have functional or integration tests for the failure case?
-
-Taking the desirable and undesirable coupling into account
-
-Here is a view example that renders counts:
-
-**State Based Example**
-<pre>
-  user = users(:bob)
-  user.articles.count.should == 5
-  user.articles.comments.count.should == 15
-  user.gold_stars.count.should == 0
-
-  render :template => "users/show"
-  response.body.should include("Articles Posted: 5")
-  response.body.should include("Comments Received: 15")
-  response.body.should include("Gold Stars Received: 0")
-</pre>
-
-**Interaction Based Example**
-<pre>
-  user = User.new
-  mock.probe(user.articles).count {5}
-  mock.probe(user.articles.comments).count {15}
-  mock.probe(user.gold_stars).count {80}
-
-  render :template => "users/show"
-  response.body.should include("Articles Posted: 5")
-  response.body.should include("Comments Received: 15")
-  response.body.should include("Gold Stars Received: 80")
-</pre>
-
-The same tradeoffs are present in this view example as in the ActiclesController example,
-but the values of each of the tradeoffs are different.
-
-State testing couplings:
- * Interface coupling - If count returns a non-number, there is an error.
- * Fixture Data coupling - If the fixture data changes, there is an error.
- * Knowledge coupling - There is no noticeable knowledge coupling.
-
-Interaction testing couplings:
- * Implementation coupling - If the way the count is determined changes, there is an error.
-
-In these examples, it is fair to expect the counts derived from the fixtures to change quite often.
-Decoupling the counts from your fixtures yields more of a benefit because the interaction based example
-will probably not need to be changed as often as the state based example.
-
-The interaction based example also provides the benefits of:
- * being faster because there is no database access
- * providing more focus because non-count user data is not important to this example (the interaction example
-   ignores the user data while the state based approach includes the user data)
- * not requiring you to change the fixture data to provide add "Gold Stars Received" because having
-   "Gold Stars Received: 0" is almost meaningless (It could easily be calling count on something else
-   that returns 0)
-
-**State vs. Interaction Based testing?**
-
-The examples I provided favor or are neutral to interaction based testing.
-This does not mean all testing should be done with interaction testing.
-There are many situations where state based testing is more
-straightforward and no more coupled than an interaction based test.
-
-Please pick the right toolset for your situation.
-In the future, I will blog about different situations and the trade-offs of
-using a state based approach, and/or an interaction based approach.
-
-**Extremely Bad Examples**
-
-Since this is a blog post, the examples are short and relatively benign.
-However, There are many examples where state and/or interaction
-based testing is overused and abused.
-Expanding your toolset can help you and your coworkers fix these issues.
-
-There are already several nice Mock/Stub frameworks in the ruby world. These libraries include:
- * Mocha
- * Flexmock
- * Rspec's Mock Framework

data/rr.gemspec

@@ -1,37 +0,0 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = %q{rr}
-  s.version = "1.0.4"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Brian Takita"]
-  s.date = %q{2011-06-16}
-  s.description = %q{RR (Double Ruby) is a double framework that features a rich selection of double techniques and a terse syntax. http://xunitpatterns.com/Test%20Double.html}
-  s.email = %q{brian@pivotallabs.com}
-  s.extra_rdoc_files = [
-    "CHANGES",
-    "README.rdoc"
-  ]
-  s.files              = `git ls-files`.split("\n")
-  s.test_files         = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.homepage = %q{http://pivotallabs.com}
-  s.rdoc_options = ["--main", "README.rdoc", "--inline-source", "--line-numbers"]
-  s.require_paths = ["lib"]
-  s.rubyforge_project = %q{pivotalrb}
-  s.rubygems_version = %q{1.6.2}
-  s.summary = %q{RR (Double Ruby) is a double framework that features a rich selection of double techniques and a terse syntax. http://xunitpatterns.com/Test%20Double.html}
-
-  if s.respond_to? :specification_version then
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-    else
-    end
-  else
-  end
-end
-

data/spec/api/any_instance_of/all_instances_of_spec.rb

@@ -1,12 +0,0 @@
-require File.expand_path("#{File.dirname(__FILE__)}/../../spec_helper")
-
-describe "all_instances_of" do
-  it "applies to instances instantiated before the Double expection was created" do
-    subject_class = Class.new
-    subject = subject_class.new
-    all_instances_of(subject_class) do |o|
-      o.to_s {"Subject is stubbed"}
-    end
-    subject.to_s.should == "Subject is stubbed"
-  end
-end

data/spec/api/any_instance_of/any_instance_of_spec.rb

@@ -1,47 +0,0 @@
-require File.expand_path("#{File.dirname(__FILE__)}/../../spec_helper")
-
-describe "any_instance_of" do
-  context "when passed a block" do
-    it "applies to instances instantiated before the Double expection was created" do
-      subject_class = Class.new
-      subject = subject_class.new
-      class_called = false
-      any_instance_of(subject_class) do |o|
-        stub(o).to_s {"Subject is stubbed"}
-        stub.proxy(o).class {|klass| class_called = true; klass}
-        stub(o).foobar {:baz}
-      end
-
-      subject.to_s.should == "Subject is stubbed"
-      subject.class.should == subject_class
-      class_called.should == true
-      subject.foobar.should == :baz
-
-      RR.reset
-
-      subject.to_s.should_not == "Subject is stubbed"
-      class_called = false
-      subject.class.should == subject_class
-      class_called.should == false
-      subject.should_not respond_to(:baz)
-    end
-  end
-
-  context "when passed a Hash" do
-    it "stubs methods (key) with the value on instances instantiated before the Double expection was created" do
-      subject_class = Class.new
-      subject = subject_class.new
-      subject.should_not respond_to(:baz)
-
-      any_instance_of(subject_class, :to_s => "Subject is stubbed", :foobar => lambda {:baz})
-
-      subject.to_s.should == "Subject is stubbed"
-      subject.foobar.should == :baz
-
-      RR.reset
-
-      subject.to_s.should_not == "Subject is stubbed"
-      subject.should_not respond_to(:baz)
-    end
-  end
-end

data/spec/api/any_instance_of/instance_of_spec.rb

@@ -1,12 +0,0 @@
-require File.expand_path("#{File.dirname(__FILE__)}/../../spec_helper")
-
-describe "instance_of" do
-  it "applies to instances instantiated before the Double expection was created" do
-    subject_class = Class.new
-    subject = subject_class.new
-    instance_of(subject_class) do |o|
-      o.to_s {"Subject is stubbed"}
-    end
-    subject.to_s.should == "Subject is stubbed"
-  end
-end

data/spec/api/dont_allow/dont_allow_after_stub_spec.rb

@@ -1,14 +0,0 @@
-require File.expand_path("#{File.dirname(__FILE__)}/../../spec_helper")
-
-describe "dont_allow called after stub" do
-  context "when the subject method is called" do
-    it "raises a TimesCalledError" do
-      subject = Object.new
-      stub(subject).foobar
-      dont_allow(subject).foobar
-      lambda do
-        subject.foobar
-      end.should raise_error(RR::Errors::TimesCalledError)
-    end
-  end
-end

data/spec/api/mock/mock_spec.rb

@@ -1,193 +0,0 @@
-require File.expand_path("#{File.dirname(__FILE__)}/../../spec_helper")
-
-describe "mock" do
-  attr_reader :subject
-  before(:each) do
-    @subject = Object.new
-    extend RR::Adapters::RRMethods
-  end
-
-  after(:each) do
-    RR.reset
-  end
-
-  it "mocks via inline call" do
-    mock(subject).to_s {"a value"}
-    subject.to_s.should == "a value"
-    lambda {subject.to_s}.should raise_error(RR::Errors::TimesCalledError)
-  end
-
-  describe ".once.ordered" do
-    it "returns the values in the ordered called" do
-      mock(subject).to_s {"value 1"}.ordered
-      mock(subject).to_s {"value 2"}.twice
-      subject.to_s.should == "value 1"
-      subject.to_s.should == "value 2"
-      subject.to_s.should == "value 2"
-      lambda {subject.to_s}.should raise_error(RR::Errors::TimesCalledError)
-    end
-  end
-
-  context "when the subject is a proxy for the object with the defined method" do
-    it "stubs the method on the proxy object" do
-      proxy_target = Class.new {def foobar; :original_foobar; end}.new
-      proxy = Class.new do
-        def initialize(target)
-          @target = target
-        end
-
-        instance_methods.each do |m|
-          unless m =~ /^_/ || m.to_s == 'object_id' || m.to_s == 'method_missing'
-            alias_method "__blank_slated_#{m}", m
-            undef_method m
-          end
-        end
-
-        def method_missing(method_name, *args, &block)
-          @target.send(method_name, *args, &block)
-        end
-      end.new(proxy_target)
-      proxy.methods.should =~ proxy_target.methods
-
-      mock(proxy).foobar {:new_foobar}
-      proxy.foobar.should == :new_foobar
-    end
-  end
-
-  it 'allows terse chaining' do
-    mock(subject).first(1) {mock(Object.new).second(2) {mock(Object.new).third(3) {4}}}
-    subject.first(1).second(2).third(3).should == 4
-
-    mock(subject).first(1) {mock!.second(2) {mock!.third(3) {4}}}
-    subject.first(1).second(2).third(3).should == 4
-
-    mock(subject).first(1) {mock!.second(2).mock!.third(3) {4}}
-    subject.first(1).second(2).third(3).should == 4
-
-    mock(subject).first(1) {mock!.second(2).mock! {third(3) {4}}}
-    subject.first(1).second(2).third(3).should == 4
-
-    mock(subject).first(1).mock!.second(2).mock!.third(3) {4}
-    subject.first(1).second(2).third(3).should == 4
-  end
-
-  it 'allows chaining with proxy' do
-    find_return_value = Object.new
-    def find_return_value.child
-      :the_child
-    end
-    (class << subject; self; end).class_eval do
-      define_method(:find) do |id|
-        id == '1' ? find_return_value : raise(ArgumentError)
-      end
-    end
-
-    mock.proxy(subject).find('1').mock.proxy!.child
-    subject.find('1').child.should == :the_child
-  end
-
-  it 'allows branched chaining' do
-    mock(subject).first do
-      mock! do |expect|
-        expect.branch1 {mock!.branch11 {11}}
-        expect.branch2 {mock!.branch22 {22}}
-      end
-    end
-    o = subject.first
-    o.branch1.branch11.should == 11
-    o.branch2.branch22.should == 22
-  end
-
-  it 'allows chained ordering' do
-    mock(subject).to_s {"value 1"}.then.to_s {"value 2"}.twice.then.to_s {"value 3"}.once
-    subject.to_s.should == "value 1"
-    subject.to_s.should == "value 2"
-    subject.to_s.should == "value 2"
-    subject.to_s.should == "value 3"
-    lambda {subject.to_s}.should raise_error(RR::Errors::TimesCalledError)
-  end
-
-  it "mocks via block with argument" do
-    mock subject do |c|
-      c.to_s {"a value"}
-      c.to_sym {:crazy}
-    end
-    subject.to_s.should == "a value"
-    subject.to_sym.should == :crazy
-  end
-
-  it "mocks via block without argument" do
-    mock subject do
-      to_s {"a value"}
-      to_sym {:crazy}
-    end
-    subject.to_s.should == "a value"
-    subject.to_sym.should == :crazy
-  end
-
-  it "has wildcard matchers" do
-    mock(subject).foobar(
-      is_a(String),
-      anything,
-      numeric,
-      boolean,
-      duck_type(:to_s),
-      /abc/
-    ) {"value 1"}.twice
-    subject.foobar(
-      'hello',
-      Object.new,
-      99,
-      false,
-      "My String",
-      "Tabcola"
-    ).should == "value 1"
-    lambda do
-      subject.foobar(:failure)
-    end.should raise_error( RR::Errors::DoubleNotFoundError )
-  end
-
-  it "mocks methods without letters" do
-    mock(subject, :==).with(55)
-
-    subject == 55
-    lambda do
-      subject == 99
-    end.should raise_error(RR::Errors::DoubleNotFoundError)
-  end
-
-  it "expects a method call to a mock via another mock's block yield only once" do
-    cage = Object.new
-    cat = Object.new
-    mock(cat).miau    # should be expected to be called only once
-    mock(cage).find_cat.yields(cat)
-    mock(cage).cats
-    cage.find_cat { |c| c.miau }
-    cage.cats
-  end
-
-  describe "on class method" do
-    class SampleClass1
-      def self.hello; "hello!"; end
-    end
-
-    class SampleClass2 < SampleClass1; end
-
-    it "can mock" do
-      mock(SampleClass1).hello { "hola!" }
-
-      SampleClass1.hello.should == "hola!"
-    end
-
-    it "does not override subclasses" do
-      mock(SampleClass1).hello { "hi!" }
-
-      SampleClass2.hello.should == "hello!"
-    end
-
-    it "should not get affected from a previous example" do
-      SampleClass2.hello.should == "hello!"
-    end
-
-  end
-end