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
@private Used to track whether we are temporarily suppressing verifying partial doubles with ‘without_partial_double_verification { … }`
Sets the default for the ‘transfer_nested_constants` option when stubbing constants.
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!
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
# 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 = false @temporarily_suppress_partial_double_verification = false @color = false end
Public Instance Methods
Adds ‘stub` and `should_receive` to the given modules or classes. This is usually only necessary if you application uses some proxy classes that “strip themselves down” to a bare minimum set of methods and remove `stub` and `should_receive` in the process.
@example
RSpec.configure do |rspec| rspec.mock_with :rspec do |mocks| mocks.add_stub_and_should_receive_to Delegator end end
# File rspec-mocks/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
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 128 def before_verifying_doubles(&block) verifying_double_callbacks << block end
# File rspec-mocks/lib/rspec/mocks/configuration.rb, line 164 def color? ::RSpec.configuration.color_enabled? end
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 188 def patch_marshal_to_support_partial_doubles=(val) if val RSpec::Mocks::MarshalExtension.patch! else RSpec::Mocks::MarshalExtension.unpatch! end end
@api private Resets the configured syntax to the default.
# File rspec-mocks/lib/rspec/mocks/configuration.rb, line 198 def reset_syntaxes_to_default self.syntax = [:should, :expect] RSpec::Mocks::Syntax.warn_about_should! end
Returns an array with a list of syntaxes that are enabled.
@example
unless RSpec::Mocks.configuration.syntax.include?(:expect) raise "this RSpec extension gem requires the rspec-mocks `:expect` syntax" end
# File rspec-mocks/lib/rspec/mocks/configuration.rb, line 104 def syntax syntaxes = [] syntaxes << :should if Syntax.should_enabled? syntaxes << :expect if Syntax.expect_enabled? syntaxes end
Provides the ability to set either ‘expect`, `should` or both syntaxes. RSpec
uses `expect` syntax by default. This is needed if you want to explicitly enable `should` syntax and/or explicitly disable `expect` syntax.
@example
RSpec.configure do |rspec| rspec.mock_with :rspec do |mocks| mocks.syntax = [:expect, :should] end end
# File rspec-mocks/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
# File rspec-mocks/lib/rspec/mocks/configuration.rb, line 139 def transfer_nested_constants? !!@transfer_nested_constants end
# File rspec-mocks/lib/rspec/mocks/configuration.rb, line 111 def verify_doubled_constant_names? !!@verify_doubled_constant_names end
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 150 def verify_partial_doubles=(val) @verify_partial_doubles = !!val end
# File rspec-mocks/lib/rspec/mocks/configuration.rb, line 154 def verify_partial_doubles? @verify_partial_doubles end
@api private Returns an array of blocks to call when verifying doubles
# File rspec-mocks/lib/rspec/mocks/configuration.rb, line 135 def verifying_double_callbacks @verifying_double_callbacks ||= [] end
# 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