Class: RSpec::Mocks::Configuration

Inherits:

Object

• Object
• RSpec::Mocks::Configuration

show all

Defined in:

lib/rspec/mocks/configuration.rb

Overview

Instance Attribute Summary (collapse)

• - (Object) allow_message_expectations_on_nil

  Sets whether RSpec will warn, ignore, or fail a test when expectations are set on nil.

• - (Object) color writeonly

  Indicates whether or not diffs should be colored.

• - (Object) transfer_nested_constants writeonly

  Sets the default for the transfer_nested_constants option when stubbing constants.

• - (Object) verify_doubled_constant_names writeonly

  When this is set to true, an error will be raised when instance_double or class_double is given the name of an undefined constant.

• - (Object) yield_receiver_to_any_instance_implementation_blocks writeonly

  Sets whether or not RSpec will yield the receiving instance of a message to blocks that are used for any_instance stub implementations.

Instance Method Summary (collapse)

• - (Object) add_stub_and_should_receive_to(*modules)

  Adds stub and should_receive to the given modules or classes.

• - (Object) before_verifying_doubles(&block) (also: #when_declaring_verifying_double)

  Provides a way to perform customisations when verifying doubles.

• - (Boolean) color?

  Indicates whether or not diffs should be colored.

• - (Configuration) initialize constructor

  A new instance of Configuration.

• - (Object) patch_marshal_to_support_partial_doubles=(val)

  Monkey-patch Marshal.dump to enable dumping of mocked or stubbed objects.

• - (Object) reset_syntaxes_to_default private

  Resets the configured syntax to the default.

• - (Object) syntax

  Returns an array with a list of syntaxes that are enabled.

• - (Object) syntax=(*values)

  Provides the ability to set either expect, should or both syntaxes.

• - (Boolean) transfer_nested_constants?
• - (Boolean) verify_doubled_constant_names?
• - (Object) verify_partial_doubles=(val)

  When set to true, partial mocks will be verified the same as object doubles.

• - (Boolean) verify_partial_doubles?
• - (Object) verifying_double_callbacks private

  Returns an array of blocks to call when verifying doubles.

• - (Boolean) yield_receiver_to_any_instance_implementation_blocks?

5
6
7
8
9
10
11
12
13

# File 'lib/rspec/mocks/configuration.rb', line 5
def initialize
  @allow_message_expectations_on_nil = nil
  @yield_receiver_to_any_instance_implementation_blocks = true
  @verify_doubled_constant_names = false
  @transfer_nested_constants = false
  @verify_partial_doubles = false
  @temporarily_suppress_partial_double_verification = false
  @color = false
end

RSpec.configure do |config|
  config.mock_with :rspec do |mocks|
    mocks.allow_message_expectations_on_nil = false
  end
end

29
30
31

# File 'lib/rspec/mocks/configuration.rb', line 29
def allow_message_expectations_on_nil
  @allow_message_expectations_on_nil
end

171
172
173

# File 'lib/rspec/mocks/configuration.rb', line 171
def color=(value)
  @color = value
end

145
146
147

# File 'lib/rspec/mocks/configuration.rb', line 145
def transfer_nested_constants=(value)
  @transfer_nested_constants = value
end

120
121
122

# File 'lib/rspec/mocks/configuration.rb', line 120
def verify_doubled_constant_names=(value)
  @verify_doubled_constant_names = value
end

RSpec.configure do |rspec|
  rspec.mock_with :rspec do |mocks|
    mocks.yield_receiver_to_any_instance_implementation_blocks = false
  end
end

46
47
48

# File 'lib/rspec/mocks/configuration.rb', line 46
def yield_receiver_to_any_instance_implementation_blocks=(value)
  @yield_receiver_to_any_instance_implementation_blocks = value
end

RSpec.configure do |rspec|
  rspec.mock_with :rspec do |mocks|
    mocks.add_stub_and_should_receive_to Delegator
  end
end

62
63
64
65
66

# File 'lib/rspec/mocks/configuration.rb', line 62
def add_stub_and_should_receive_to(*modules)
  modules.each do |mod|
    Syntax.enable_should(mod)
  end
end

RSpec::Mocks.configuration.before_verifying_doubles do |ref|
  ref.some_method!
end

128
129
130

# File 'lib/rspec/mocks/configuration.rb', line 128
def before_verifying_doubles(&block)
  verifying_double_callbacks << block
end

176
177
178

# File 'lib/rspec/mocks/configuration.rb', line 176
def color?
  ::RSpec.configuration.color_enabled?
end

188
189
190
191
192
193
194

# File 'lib/rspec/mocks/configuration.rb', line 188
def patch_marshal_to_support_partial_doubles=(val)
  if val
    RSpec::Mocks::MarshalExtension.patch!
  else
    RSpec::Mocks::MarshalExtension.unpatch!
  end
end

198
199
200
201

# File 'lib/rspec/mocks/configuration.rb', line 198
def reset_syntaxes_to_default
  self.syntax = [:should, :expect]
  RSpec::Mocks::Syntax.warn_about_should!
end

unless RSpec::Mocks.configuration.syntax.include?(:expect)
  raise "this RSpec extension gem requires the rspec-mocks `:expect` syntax"
end

104
105
106
107
108
109

# File 'lib/rspec/mocks/configuration.rb', line 104
def syntax
  syntaxes = []
  syntaxes << :should  if Syntax.should_enabled?
  syntaxes << :expect if Syntax.expect_enabled?
  syntaxes
end

RSpec.configure do |rspec|
  rspec.mock_with :rspec do |mocks|
    mocks.syntax = [:expect, :should]
  end

81
82
83
84
85
86
87
88
89
90
91
92
93
94

# File 'lib/rspec/mocks/configuration.rb', line 81
def syntax=(*values)
  syntaxes = values.flatten
  if syntaxes.include?(:expect)
    Syntax.enable_expect
  else
    Syntax.disable_expect
  end
  if syntaxes.include?(:should)
    Syntax.enable_should
  else
    Syntax.disable_should
  end
end

139
140
141

# File 'lib/rspec/mocks/configuration.rb', line 139
def transfer_nested_constants?
  !!@transfer_nested_constants
end

111
112
113

# File 'lib/rspec/mocks/configuration.rb', line 111
def verify_doubled_constant_names?
  !!@verify_doubled_constant_names
end

150
151
152

# File 'lib/rspec/mocks/configuration.rb', line 150
def verify_partial_doubles=(val)
  @verify_partial_doubles = !!val
end

154
155
156

# File 'lib/rspec/mocks/configuration.rb', line 154
def verify_partial_doubles?
  @verify_partial_doubles
end

135
136
137

# File 'lib/rspec/mocks/configuration.rb', line 135
def verifying_double_callbacks
  @verifying_double_callbacks ||= []
end

31
32
33

# File 'lib/rspec/mocks/configuration.rb', line 31
def yield_receiver_to_any_instance_implementation_blocks?
  @yield_receiver_to_any_instance_implementation_blocks
end