Class: RSpec::Mocks::ConstantMutator::DefinedConstantReplacer Private

Inherits:
BaseMutator
  • Object
show all
Defined in:
lib/rspec/mocks/mutate_const.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Replaces a defined constant for the duration of an example.

Instance Attribute Summary

Attributes inherited from BaseMutator

#full_constant_name, #original_value

Instance Method Summary (collapse)

Methods inherited from BaseMutator

#initialize

Methods included from RecursiveConstMethods

#const_defined_on?, #constants_defined_on, #get_const_defined_on, #normalize_const_name, #recursive_const_defined?, #recursive_const_get

Constructor Details

This class inherits a constructor from RSpec::Mocks::ConstantMutator::BaseMutator

Instance Method Details

- (Object) mutate

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 

248
249
250
251
252
253
254
255
256
257
258
 
# File 'lib/rspec/mocks/mutate_const.rb', line 248
def mutate
  @context = recursive_const_get(@context_parts.join('::'))
  @original_value = get_const_defined_on(@context, @const_name)
  constants_to_transfer = verify_constants_to_transfer!
  @context.__send__(:remove_const, @const_name)
  @context.const_set(@const_name, @mutated_value)
  transfer_nested_constants(constants_to_transfer)
end

- (Object) rspec_reset

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 

268
269
270
271
 
# File 'lib/rspec/mocks/mutate_const.rb', line 268
def rspec_reset
  @context.__send__(:remove_const, @const_name)
  @context.const_set(@const_name, @original_value)
end

- (Object) to_constant

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 

260
261
262
263
264
265
266
 
# File 'lib/rspec/mocks/mutate_const.rb', line 260
def to_constant
  const = super
  const.stubbed = true
  const.previously_defined = true
  const
end

- (Object) transfer_nested_constants(constants)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 

273
274
275
276
277
 
# File 'lib/rspec/mocks/mutate_const.rb', line 273
def transfer_nested_constants(constants)
  constants.each do |const|
    @mutated_value.const_set(const, get_const_defined_on(original_value, const))
  end
end

- (Object) verify_constants_to_transfer!

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 

279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
 
# File 'lib/rspec/mocks/mutate_const.rb', line 279
def verify_constants_to_transfer!
  return [] unless @transfer_nested_constants
  { @original_value => "the original value", @mutated_value => "the stubbed value" }.each do |value, description|
    unless value.respond_to?(:constants)
      raise ArgumentError,
        "Cannot transfer nested constants for #{@full_constant_name} " +
        "since #{description} is not a class or module and only classes " +
        "and modules support nested constants."
    end
  end
  if @transfer_nested_constants.is_a?(Array)
    @transfer_nested_constants = @transfer_nested_constants.map(&:to_s) if RUBY_VERSION == '1.8.7'
    undefined_constants = @transfer_nested_constants - constants_defined_on(@original_value)
    if undefined_constants.any?
      available_constants = constants_defined_on(@original_value) - @transfer_nested_constants
      raise ArgumentError,
        "Cannot transfer nested constant(s) #{undefined_constants.join(' and ')} " +
        "for #{@full_constant_name} since they are not defined. Did you mean " +
        "#{available_constants.join(' or ')}?"
    end
    @transfer_nested_constants
  else
    constants_defined_on(@original_value)
  end
end