This file is indexed.

/usr/share/doc/ruby-rspec-mocks/features/old_syntax/stub_chain.feature is in ruby-rspec-mocks 3.7.0c1e0m0s1-1.

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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
@allow-old-syntax
Feature: `stub_chain`

  `stub_chain` is the old way to [allow a message chain](../working-with-legacy-code/message-chains) but carries the
  baggage of a global monkey patch on all objects. As with
  `receive_message_chain`, use with care; we recommend treating usage of `stub_chain` as a
  code smell.

  Background:
    Given a file named "spec/spec_helper.rb" with:
      """ruby
      RSpec.configure do |config|
        config.mock_with :rspec do |mocks|
          mocks.syntax = :should
        end
      end
      """
    And a file named ".rspec" with:
      """
      --require spec_helper
      """

  Scenario: Use `stub_chain` on a double
    Given a file named "spec/stub_chain_spec.rb" with:
      """ruby
      RSpec.describe "Using stub_chain on a double" do
        let(:dbl) { double }

        example "using a string and a block" do
          dbl.stub_chain("foo.bar") { :baz }
          expect(dbl.foo.bar).to eq(:baz)
        end

        example "using symbols and a hash" do
          dbl.stub_chain(:foo, :bar => :baz)
          expect(dbl.foo.bar).to eq(:baz)
        end

        example "using symbols and a block" do
          dbl.stub_chain(:foo, :bar) { :baz }
          expect(dbl.foo.bar).to eq(:baz)
        end
      end
      """
    When I run `rspec spec/stub_chain_spec.rb`
    Then the examples should all pass

  Scenario: Use `stub_chain` on any instance of a class
    Given a file named "spec/stub_chain_spec.rb" with:
      """ruby
      RSpec.describe "Using any_instance.stub_chain" do
        example "using a string and a block" do
          Object.any_instance.stub_chain("foo.bar") { :baz }
          expect(Object.new.foo.bar).to eq(:baz)
        end

        example "using symbols and a hash" do
          Object.any_instance.stub_chain(:foo, :bar => :baz)
          expect(Object.new.foo.bar).to eq(:baz)
        end

        example "using symbols and a block" do
          Object.any_instance.stub_chain(:foo, :bar) { :baz }
          expect(Object.new.foo.bar).to eq(:baz)
        end
      end
      """
    When I run `rspec spec/stub_chain_spec.rb`
    Then the examples should all pass