class RSpec::Mocks::Configuration

Provides configuration options for rspec-mocks.

Attributes

Sets whether RSpec will warn, ignore, or fail a test when expectations are set on nil. By default, when this flag is not set, warning messages are issued when expectations are set on nil. This is to prevent false-positives and to catch potential bugs early on. When set to ‘true`, warning messages are suppressed. When set to `false`, it will raise an error.

@example

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

temporarily_suppress_partial_double_verification [RW]

@private Used to track whether we are temporarily suppressing verifying partial doubles with ‘without_partial_double_verification { … }`

transfer_nested_constants [W]

Sets the default for the ‘transfer_nested_constants` option when stubbing constants.

verify_doubled_constant_names [W]

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. You probably only want to set this when running your entire test suite, with all production code loaded. Setting this for an isolated unit test will prevent you from being able to isolate it!

yield_receiver_to_any_instance_implementation_blocks [W]

Sets whether or not RSpec will yield the receiving instance of a message to blocks that are used for any_instance stub implementations. When set, the first yielded argument will be the receiving instance. Defaults to ‘true`.

@example

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

Public Class Methods

new ()

# File rspec-mocks/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 = true
  @temporarily_suppress_partial_double_verification = false
  @color = false
end

Public Instance Methods

before_verifying_doubles (&block)

Provides a way to perform customisations when verifying doubles.

@example

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

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

Also aliased as: when_declaring_verifying_double

color? ()

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

patch_marshal_to_support_partial_doubles= (val)

Monkey-patch ‘Marshal.dump` to enable dumping of mocked or stubbed objects. By default this will not work since RSpec mocks works by adding singleton methods that cannot be serialized. This patch removes these singleton methods before serialization. Setting to falsey removes the patch.

This method is idempotent.

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

transfer_nested_constants? ()

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

verify_doubled_constant_names? ()

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

verify_partial_doubles= (val)

When set to true, partial mocks will be verified the same as object doubles. Any stubs will have their arguments checked against the original method, and methods that do not exist cannot be stubbed.

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

verify_partial_doubles? ()

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

verifying_double_callbacks ()

@api private Returns an array of blocks to call when verifying doubles

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

when_declaring_verifying_double (&block)

Alias for: before_verifying_doubles

yield_receiver_to_any_instance_implementation_blocks? ()

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