Class: Transpec::Syntax::MethodStub

Inherits:
Transpec::Syntax show all
Includes:
Transpec::Syntax::Mixin::MessagingHost, Transpec::Syntax::Mixin::MonkeyPatchAnyInstance, Util
Defined in:
lib/transpec/syntax/method_stub.rb

Defined Under Namespace

Classes: AllowRecord, DeprecatedMethodRecord, NoMessageAllowanceRecord

Constant Summary collapse

CLASSES_DEFINING_OWN_STUB_METHOD =

rubocop:disable LineLength

[
  'Typhoeus', # https://github.com/typhoeus/typhoeus/blob/6a59c62/lib/typhoeus.rb#L66-L85
  'Excon',    # https://github.com/geemus/excon/blob/6af4f9c/lib/excon.rb#L143-L178
  'Factory'   # https://github.com/thoughtbot/factory_girl/blob/v3.6.2/lib/factory_girl/syntax/vintage.rb#L112
]

Constants included from Util

Util::LITERAL_TYPES, Util::WHITESPACES

Instance Attribute Summary

Attributes inherited from Transpec::Syntax

#node, #report, #runtime_data, #source_rewriter

Instance Method Summary collapse

Methods included from Transpec::Syntax::Mixin::MonkeyPatchAnyInstance

#any_instance?

Methods included from Transpec::Syntax::Mixin::MonkeyPatch

#register_syntax_availability_analysis_request, #subject_node, #subject_range, #syntax_available?

Methods included from Transpec::Syntax::Mixin::Send

#arg_node, #arg_nodes, #arg_range, #args_range, #method_name, #parentheses_range, #range_after_arg, #range_in_between_receiver_and_selector, #range_in_between_selector_and_arg, #receiver_node, #receiver_range, #selector_range

Methods included from Transpec::Syntax::Mixin::NoMessageAllowance

#allow_no_message?, #any_number_of_times?, #at_least_zero?

Methods included from Transpec::Syntax::Mixin::UselessAndReturn

#and_return?, #and_return_node, #and_return_with_block?, #useless_and_return?

Methods included from Util

beginning_of_line_range, block_node_taken_by_method, chainable_source, const_name, contain_here_document?, each_backward_chained_node, each_forward_chained_node, each_line_range, end_of_line_range, expand_range_to_adjacent_whitespaces, find_consecutive_whitespace_position, first_block_arg_name, here_document?, in_explicit_parentheses?, indentation_of_line, line_range, literal?, node_id, proc_literal?, range_from_arg

Methods inherited from Transpec::Syntax

#expression_range, #initialize, #parent_node, snake_case_name, standalone?, #static_context_inspector

Methods included from Collection

#all_syntaxes, #inherited, #require_all, #standalone_syntaxes

Methods included from DynamicAnalysis

#register_dynamic_analysis_request

Constructor Details

This class inherits a constructor from Transpec::Syntax

Instance Method Details

#add_receiver_arg_to_any_instance_implementation_block! ⇒ Object 



93
94
95
 
# File 'lib/transpec/syntax/method_stub.rb', line 93

def add_receiver_arg_to_any_instance_implementation_block!
  super && register_record(:any_instance_block)
end

#allow_to_receive_available? ⇒ Boolean

Returns:

  • (Boolean) 


50
51
52
 
# File 'lib/transpec/syntax/method_stub.rb', line 50

def allow_to_receive_available?
  syntax_available?(__method__)
end

#allowize!(rspec_version) ⇒ Object 



58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/transpec/syntax/method_stub.rb', line 58

def allowize!(rspec_version)
  # There's no way of unstubbing in #allow syntax.
  return unless [:stub, :stub!, :stub_chain].include?(method_name)
  return if method_name == :stub_chain && !rspec_version.receive_message_chain_available?

  unless allow_to_receive_available?
    fail ContextError.new("##{method_name}", '#allow', selector_range)
  end

  source, type = replacement_source_and_conversion_type(rspec_version)
  return unless source

  replace(expression_range, source)

  register_record(type)
end

#conversion_target? ⇒ Boolean

Returns:

  • (Boolean) 


36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'lib/transpec/syntax/method_stub.rb', line 36

def conversion_target?
  return false unless dynamic_analysis_target?

  # Check if the method is RSpec's one or not.
  if runtime_data.run?(send_analysis_target_node)
    # If we have runtime data, check with it.
    defined_by_rspec?
  else
    # Otherwise check with a static whitelist.
    const_name = const_name(receiver_node)
    !CLASSES_DEFINING_OWN_STUB_METHOD.include?(const_name)
  end
end

#convert_deprecated_method! ⇒ Object 



75
76
77
78
79
80
81
 
# File 'lib/transpec/syntax/method_stub.rb', line 75

def convert_deprecated_method!
  return unless replacement_method_for_deprecated_method

  replace(selector_range, replacement_method_for_deprecated_method)

  register_record(:deprecated)
end

#dynamic_analysis_target? ⇒ Boolean

Returns:

  • (Boolean) 


30
31
32
33
34
 
# File 'lib/transpec/syntax/method_stub.rb', line 30

def dynamic_analysis_target?
  super &&
    !receiver_node.nil? &&
    [:stub, :stub!, :stub_chain, :unstub, :unstub!].include?(method_name)
end

#hash_arg? ⇒ Boolean

Returns:

  • (Boolean) 


54
55
56
 
# File 'lib/transpec/syntax/method_stub.rb', line 54

def hash_arg?
  arg_node.hash_type?
end

#remove_no_message_allowance! ⇒ Object 



83
84
85
86
87
 
# File 'lib/transpec/syntax/method_stub.rb', line 83

def remove_no_message_allowance!
  return unless allow_no_message?
  super
  register_record(:no_message_allowance)
end

#remove_useless_and_return! ⇒ Object 



89
90
91
 
# File 'lib/transpec/syntax/method_stub.rb', line 89

def remove_useless_and_return!
  super && register_record(:useless_and_return)
end