clickable_link 0.0.1 → 0.0.2

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/argument_matchers/README.md

@@ -0,0 +1,27 @@
+### Introduction
+
+Argument matchers can be used:
+
+* In stubs to constrain the scope of the stubbed method
+
+    obj.stub(:foo).with(:bar) do |arg|
+      #do something for :bar
+    end
+    obj.stub(:foo).with(:baz) do |arg|
+      #do something for :baz
+    end
+
+* In expectations to validate the arguments that should be received in a method call
+
+    #create a double
+    obj = double()
+
+    #expect a message with given args
+    obj.should_receive(:message).with('an argument')
+
+If more control is needed, one can use a block
+
+    obj.should_receive(:message) do |arg1,  arg2|
+      # set expectations about the args in this block
+      # and optionally set a return value
+    end

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/argument_matchers/explicit.feature

@@ -0,0 +1,59 @@
+Feature: explicit arguments
+
+  Allows you to explicitly specify the argument values
+
+  Scenario: explicit arguments
+    Given a file named "stub_explicit_args_spec.rb" with:
+      """ruby
+      describe "stubbed explicit arguments" do
+        it "works on stubs" do
+          object = Object.new
+          object.stub(:foo).with(:this) do |arg|
+            "got this"
+          end
+          object.stub(:foo).with(:that) do |arg|
+            "got that"
+          end
+
+          object.foo(:this).should eq("got this")
+          object.foo(:that).should eq("got that")
+        end
+
+        it "works on doubles and expectations" do
+          object = double('foo')
+          object.should_receive(:bar).with(:foo)
+
+          object.bar(:foo)
+        end
+      end
+      """
+    When I run `rspec stub_explicit_args_spec.rb`
+    Then the output should contain "2 examples, 0 failures"
+
+  Scenario: explicit arguments with multiple arities
+    Given a file named "stub_multiple_explicit_args_spec.rb" with:
+      """ruby
+      describe "stubbed multiple explicit arguments" do
+        it "works on stubs" do
+          object = Object.new
+          object.stub(:foo).with(:this) do |arg|
+            "got this"
+          end
+          object.stub(:foo).with(:this, :that) do |arg1, arg2|
+            "got this and that"
+          end
+
+          object.foo(:this).should eq("got this")
+          object.foo(:this, :that).should eq("got this and that")
+        end
+
+        it "works on mocks" do
+          object = double('foo')
+          object.should_receive(:foo).with(:this, :that)
+
+          object.foo(:this, :that)
+        end
+      end
+      """
+    When I run `rspec stub_multiple_explicit_args_spec.rb`
+    Then the output should contain "2 examples, 0 failures"

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/argument_matchers/general_matchers.feature

@@ -0,0 +1,85 @@
+Feature: General matchers
+
+  The `anything`,  `any_args`,  and `no_args` matchers can be used to require the method
+  to have arguments (or not) without constraining the details of the argument, such as its
+  type,  pattern or value. The `anything` matcher only reflects a single argument, while
+  the `any_args` matcher matches any arity.
+
+  Scenario: anything argument matcher
+    Given a file named "stub_anything_args_spec.rb" with:
+      """ruby
+      describe "stubbed anything() args spec" do
+        it "works" do
+          object = Object.new
+          object.stub(:foo).with(anything) do
+            "anything"
+          end
+
+          object.foo(1).should eq("anything")
+          object.foo(:that).should eq("anything")
+        end
+      end
+      """
+    When I run `rspec stub_anything_args_spec.rb`
+    Then the output should contain "1 example, 0 failures"
+
+  Scenario: any_args argument matcher
+    Given a file named "stub_any_args_spec.rb" with:
+      """ruby
+      describe "stubbed any_args() args spec" do
+        it "works" do
+          object = Object.new
+          object.stub(:foo).with(any_args) do
+            "anything"
+          end
+
+          object.foo(1).should eq("anything")
+          object.foo(:that).should eq("anything")
+          object.foo.should eq("anything")
+        end
+      end
+      """
+    When I run `rspec stub_any_args_spec.rb`
+    Then the output should contain "1 example, 0 failures"
+
+  Scenario: no_args argument matcher
+    Given a file named "stub_no_args_spec.rb" with:
+      """ruby
+      describe "stubbed no_args() args spec" do
+        it "works for no args" do
+          object = Object.new
+          object.stub(:foo).with(no_args) do
+            "nothing"
+          end
+          object.stub(:foo).with(anything) do
+            "something"
+          end
+
+          object.foo(:that).should eq("something")
+          object.foo.should eq("nothing")
+        end
+      end
+      """
+    When I run `rspec stub_no_args_spec.rb`
+    Then the output should contain "1 example, 0 failures"
+
+  Scenario: no_args argument matcher for expectations
+    Given a file named "stub_no_args_expectations_spec.rb" with:
+      """ruby
+      describe "stubbed no_args() args spec for expectations" do
+        it "works for no args" do
+          object = Object.new
+          object.should_receive(:foo).with(no_args)
+
+          object.foo
+        end
+        it "fails for args" do
+          object = Object.new
+          object.should_receive(:foo).with(no_args)
+
+          object.foo(:bar)
+        end
+      end
+      """
+    When I run `rspec stub_no_args_expectations_spec.rb`
+    Then the output should contain "2 examples, 1 failure"

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/argument_matchers/type_matchers.feature

@@ -0,0 +1,26 @@
+Feature: stub with argument constraints
+
+  You can further specify the behavior by constraining the type,
+  format and/or number of arguments with the `#with()` method
+  chained off of `#stub()`
+
+  Scenario: an_instance_of argument matcher
+    Given a file named "stub_an_instance_of_args_spec.rb" with:
+      """ruby
+      describe "stubbed an_instance_of() args spec" do
+        it "works" do
+          object = Object.new
+          object.stub(:foo).with(an_instance_of(Symbol)) do
+            "symbol"
+          end
+          object.stub(:foo).with(an_instance_of(String)) do
+            "string"
+          end
+
+          object.foo("bar").should eq("string")
+          object.foo(:that).should eq("symbol")
+        end
+      end
+      """
+    When I run `rspec stub_an_instance_of_args_spec.rb`
+    Then the output should contain "1 example, 0 failures"

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/message_expectations/README.md

@@ -0,0 +1,73 @@
+### Basics
+
+    # create a double
+    obj = double()
+
+    # expect a message
+    obj.should_receive(:message)
+
+    # specify a return value
+    obj.should_receive(:message) { :value }
+    obj.should_receive(:message => :value)
+    obj.should_receive(:message).and_return(:value)
+
+These forms are somewhat interchangeable. The difference is that the
+block contents are evaluated lazily when the `obj` receives the
+`message` message, whereas the others are evaluated as they are read.
+
+### Fake implementation
+
+    obj.should_receive(:message) do |arg1, arg2|
+      # set expectations about the args in this block
+      # and set a return value
+    end
+
+### Using the original implementation
+
+    obj.should_receive(:message).and_call_original
+
+### Raising/Throwing
+
+    obj.should_receive(:message).and_raise("this error")
+    obj.should_receive(:message).and_throw(:this_symbol)
+
+You can also use the block format:
+
+    obj.should_receive(:message) { raise "this error" }
+    obj.should_receive(:message) { throw :this_symbol }
+
+### Argument constraints
+
+#### Explicit arguments
+
+    obj.should_receive(:message).with('an argument')
+    obj.should_receive(:message).with('more_than', 'one_argument')
+
+#### Argument matchers
+
+    obj.should_receive(:message).with(anything())
+    obj.should_receive(:message).with(an_instance_of(Money))
+    obj.should_receive(:message).with(hash_including(:a => 'b'))
+
+#### Regular expressions
+
+    obj.should_receive(:message).with(/abc/)
+
+### Counts
+
+    obj.should_receive(:message).once
+    obj.should_receive(:message).twice
+    obj.should_receive(:message).exactly(3).times
+
+    obj.should_receive(:message).at_least(:once)
+    obj.should_receive(:message).at_least(:twice)
+    obj.should_receive(:message).at_least(n).times
+
+    obj.should_receive(:message).at_most(:once)
+    obj.should_receive(:message).at_most(:twice)
+    obj.should_receive(:message).at_most(n).times
+
+### Ordering
+
+    obj.should_receive(:one).ordered
+    obj.should_receive(:two).ordered

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/message_expectations/allow_any_instance_of.feature

@@ -0,0 +1,26 @@
+Feature: allow a message on any instance of a class
+
+  Use `allow_any_instance_of(Class).to receive` when you want to configure how
+  instances of the given class respond to a message without setting an
+  expectation that the message will be received.
+
+  Scenario: allowing a message on any instance of a class
+    Given a file named "example_spec.rb" with:
+      """ruby
+      describe "any_instance.should_receive" do
+        before do
+          allow_any_instance_of(Object).to receive(:foo).and_return(:return_value)
+        end
+
+        it "allows any instance of the class to receive the message" do
+          o = Object.new
+          expect(o.foo).to eq(:return_value)
+        end
+
+        it "passes even if no instances receive that message" do
+          o = Object.new
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/message_expectations/any_instance.feature

@@ -0,0 +1,21 @@
+Feature: expect a message on any instance of a class
+
+  Use `any_instance.should_receive` to set an expectation that one (and only
+  one) instance of a class receives a message before the example is completed.
+
+  The spec will fail if no instance receives a message.
+
+  Scenario: expect a message on any instance of a class
+    Given a file named "example_spec.rb" with:
+      """ruby
+      describe "any_instance.should_receive" do
+        it "verifies that one instance of the class receives the message" do
+          Object.any_instance.should_receive(:foo).and_return(:return_value)
+
+          o = Object.new
+          o.foo.should eq(:return_value)
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/message_expectations/block_local_expectations.feature.pending

@@ -0,0 +1,55 @@
+Feature: block local expectations
+
+  Background:
+    Given a file named "lib/account.rb" with:
+      """
+      class Account
+        def self.create
+          yield new
+        end
+
+        def opening_balance(amount, currency)
+        end
+      end
+      """
+
+  Scenario: passing example
+    Given a file named "spec/account_spec.rb" with:
+      """
+      require 'account'
+
+      describe "account DSL" do
+        it "it succeeds when the block local receives the given call" do
+          account = double("Account")
+          Account.should_receive(:create).and_yield(account) do |account|
+            account.should_receive(:opening_balance).with(100, :USD)
+          end
+          Account.create do |account|
+            account.opening_balance 100, :USD
+          end
+        end
+      end
+      """
+    When I run `rspec spec/account_spec.rb`
+    Then the output should contain "1 example, 0 failures"
+
+  Scenario: failing example
+
+    Given a file named "spec/account_spec.rb" with:
+      """
+      require 'account'
+
+      describe "account DSL" do
+        it "fails when the block local does not receive the expected call" do
+          Account.should_receive(:create).and_yield do |account|
+            account.should_receive(:opening_balance).with(100, :USD)
+          end
+          Account.create do |account|
+            # opening_balance is not called here
+          end
+        end
+      end
+      """
+
+    When I run `rspec spec/account_spec.rb`
+    Then the output should contain "1 example, 1 failure"

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/message_expectations/call_original.feature

@@ -0,0 +1,24 @@
+Feature: Calling the original method
+
+  You can use `and_call_original` on the fluent interface
+  to "pass through" the received message to the original method.
+
+  Scenario: expect a message
+    Given a file named "call_original_spec.rb" with:
+      """ruby
+      class Addition
+        def self.two_plus_two
+          4
+        end
+      end
+
+      describe "and_call_original" do
+        it "delegates the message to the original implementation" do
+          Addition.should_receive(:two_plus_two).and_call_original
+          Addition.two_plus_two.should eq(4)
+        end
+      end
+      """
+    When I run `rspec call_original_spec.rb`
+    Then the examples should all pass
+

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/message_expectations/expect_any_instance_of.feature

@@ -0,0 +1,27 @@
+Feature: expect a message on any instance of a class
+
+  Use `expect_any_instance_of(Class).to receive` to set an expectation that one
+  (and only one) instance of a class receives a message before the example is
+  completed. The spec will fail if no instance receives a message.
+
+  Scenario: expect a message on any instance of a class
+    Given a file named "example_spec.rb" with:
+      """ruby
+      describe "expect_any_instance_of" do
+        before do
+          expect_any_instance_of(Object).to receive(:foo).and_return(:return_value)
+        end
+
+        it "verifies that one instance of the class receives the message" do
+          o = Object.new
+          expect(o.foo).to eq(:return_value)
+        end
+
+        it "fails unless an instance receives that message" do
+          o = Object.new
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "2 examples, 1 failure"
+    And the output should contain "1) expect_any_instance_of fails unless an instance receives that message"

data/vendor/bundle/ruby/1.9.1/gems/rspec-mocks-2.14.3/features/message_expectations/expect_message_using_expect.feature

@@ -0,0 +1,107 @@
+Feature: expect message using `expect`
+
+  Use `expect(object).to receive(:message)` to set an expectation that
+  `object` should receive the message `:message` before the example is
+  completed.
+
+  Note: You can use `expect_any_instance_of` when you don't have a reference
+  to the object that receives a message in your test. For more information,
+  see the message_expectations/expect_any_instance_of feature.
+
+  Scenario: expect a message
+    Given a file named "spec/account_spec.rb" with:
+      """ruby
+      require "account"
+
+      describe Account do
+        context "when closed" do
+          it "logs an account closed message" do
+            logger = double("logger")
+            account = Account.new logger
+
+            expect(logger).to receive(:account_closed)
+
+            account.close
+          end
+        end
+      end
+      """
+    And a file named "lib/account.rb" with:
+      """ruby
+      Account = Struct.new(:logger) do
+        def close
+          logger.account_closed
+        end
+      end
+      """
+    When I run `rspec spec/account_spec.rb`
+    Then the output should contain "1 example, 0 failures"
+
+  Scenario: expect a message with an argument
+    Given a file named "spec/account_spec.rb" with:
+      """ruby
+      require "account"
+
+      describe Account do
+        context "when closed" do
+          it "logs an account closed message" do
+            logger = double("logger")
+            account = Account.new logger
+
+            expect(logger).to receive(:account_closed).with(account)
+
+            account.close
+          end
+        end
+      end
+      """
+    And a file named "lib/account.rb" with:
+      """ruby
+      Account = Struct.new(:logger) do
+        def close
+          logger.account_closed(self)
+        end
+      end
+      """
+    When I run `rspec spec/account_spec.rb`
+    Then the output should contain "1 example, 0 failures"
+
+  Scenario: provide a return value
+    Given a file named "spec/message_expectation_spec.rb" with:
+      """ruby
+
+      describe "a message expectation with a return value" do
+        context "specified in a block" do
+          it "returns the specified value" do
+            object = double("object")
+            expect(object).to receive(:message) { :return_value }
+            object.message.should eq(:return_value)
+          end
+        end
+
+        context "specified with and_return" do
+          it "returns the specified value" do
+            object = double("object")
+            expect(object).to receive(:message).and_return(:return_value)
+            object.message.should eq(:return_value)
+          end
+        end
+      end
+      """
+    When I run `rspec spec/message_expectation_spec.rb`
+    Then the output should contain "2 examples, 0 failures"
+
+  Scenario: expect a specific number of calls
+    Given a file named "spec/message_count_spec.rb" with:
+      """ruby
+      describe "a message expectation with a count" do
+        it "passes if the expected number of calls happen" do
+          string = "hi"
+          expect(string).to receive(:length).exactly(3).times
+
+          3.times { string.length }
+        end
+      end
+      """
+    When I run `rspec spec/message_count_spec.rb`
+    Then the output should contain "1 example, 0 failures"