/usr/share/doc/ruby-rspec-mocks/features/basics/test_doubles.feature is in ruby-rspec-mocks 3.4.0c3e0m1s1-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 | Feature: Test Doubles
_Test double_ is a generic term for any object that stands in for a real object during a test
(think "stunt double"). You create one using the `double` method. Doubles are "strict" by
default -- any message you have not allowed or expected will trigger an error -- but you can
[switch a double to being "loose"](./null-object-doubles). When creating a double, you can allow messages (and set
their return values) by passing a hash.
Once you have a test double, you can [allow](./allowing-messages) or [expect](./expecting-messages) messages on it.
We recommend you use [verifying doubles](../verifying-doubles) whenever possible.
Scenario: Doubles are strict by default
Given a file named "double_spec.rb" with:
"""ruby
RSpec.describe "A test double" do
it "raises errors when messages not allowed or expected are received" do
dbl = double("Some Collaborator")
dbl.foo
end
end
"""
When I run `rspec double_spec.rb`
Then it should fail with:
"""
#<Double "Some Collaborator"> received unexpected message :foo with (no args)
"""
Scenario: A hash can be used to define allowed messages and return values
Given a file named "double_spec.rb" with:
"""ruby
RSpec.describe "A test double" do
it "returns canned responses from the methods named in the provided hash" do
dbl = double("Some Collaborator", :foo => 3, :bar => 4)
expect(dbl.foo).to eq(3)
expect(dbl.bar).to eq(4)
end
end
"""
When I run `rspec double_spec.rb`
Then the examples should all pass
|