/usr/lib/ruby/vendor_ruby/rspec/mocks/configuration.rb is in ruby-rspec-mocks 3.5.0c3e0m0s0-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 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 | module RSpec
module Mocks
# Provides configuration options for rspec-mocks.
class Configuration
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
end
# 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
attr_accessor :allow_message_expectations_on_nil
def yield_receiver_to_any_instance_implementation_blocks?
@yield_receiver_to_any_instance_implementation_blocks
end
# 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
attr_writer :yield_receiver_to_any_instance_implementation_blocks
# 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
#
def add_stub_and_should_receive_to(*modules)
modules.each do |mod|
Syntax.enable_should(mod)
end
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
#
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
# 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
#
def syntax
syntaxes = []
syntaxes << :should if Syntax.should_enabled?
syntaxes << :expect if Syntax.expect_enabled?
syntaxes
end
def verify_doubled_constant_names?
!!@verify_doubled_constant_names
end
# 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!
attr_writer :verify_doubled_constant_names
# Provides a way to perform customisations when verifying doubles.
#
# @example
# RSpec::Mocks.configuration.before_verifying_doubles do |ref|
# ref.some_method!
# end
def before_verifying_doubles(&block)
verifying_double_callbacks << block
end
alias :when_declaring_verifying_double :before_verifying_doubles
# @api private
# Returns an array of blocks to call when verifying doubles
def verifying_double_callbacks
@verifying_double_callbacks ||= []
end
def transfer_nested_constants?
!!@transfer_nested_constants
end
# Sets the default for the `transfer_nested_constants` option when
# stubbing constants.
attr_writer :transfer_nested_constants
# 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.
def verify_partial_doubles=(val)
@verify_partial_doubles = !!val
end
def verify_partial_doubles?
@verify_partial_doubles
end
if ::RSpec.respond_to?(:configuration)
def color?
::RSpec.configuration.color_enabled?
end
else
# Indicates whether or not diffs should be colored.
# Delegates to rspec-core's color option if rspec-core
# is loaded; otherwise you can set it here.
attr_writer :color
# Indicates whether or not diffs should be colored.
# Delegates to rspec-core's color option if rspec-core
# is loaded; otherwise you can set it here.
def color?
@color
end
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.
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.
def reset_syntaxes_to_default
self.syntax = [:should, :expect]
RSpec::Mocks::Syntax.warn_about_should!
end
end
# Mocks specific configuration, as distinct from `RSpec.configuration`
# which is core RSpec configuration.
def self.configuration
@configuration ||= Configuration.new
end
configuration.reset_syntaxes_to_default
end
end
|