module RuboCop::Cop::HashSubset
def decorate_source(value)
def decorate_source(value) return ":\"#{value.source}\"" if value.dsym_type? return "\"#{value.source}\"" if value.dstr_type? return ":#{value.source}" if value.sym_type? "'#{value.source}'" end
def except_key(node)
def except_key(node) key_arg = node.argument_list.first.source body, = extract_body_if_negated(node.body) lhs, _method_name, rhs = *body lhs.source == key_arg ? rhs : lhs end
def except_key_source(key)
def except_key_source(key) if key.array_type? key = if key.percent_literal? key.each_value.map { |v| decorate_source(v) } else key.each_value.map(&:source) end return key.join(', ') end key.literal? ? key.source : "*#{key.source}" end
def extract_body_if_negated(body)
def extract_body_if_negated(body) if body.method?('!') [body.receiver, true] else [body, false] end end
def extract_offense(node)
def extract_offense(node) block = node.parent return unless extracts_hash_subset?(block) except_key = except_key(block) return if except_key.nil? || !safe_to_register_offense?(block, except_key) [offense_range(node), except_key_source(except_key)] end
def extracts_hash_subset?(block)
def extracts_hash_subset?(block) block_with_first_arg_check?(block) do |key_arg, value_arg, send_node, method| # Only consider methods that have one argument return false unless send_node.arguments.one? return false unless supported_subset_method?(method) return false if range_include?(send_node) case method when :include?, :exclude? slices_key?(send_node, :first_argument, key_arg, value_arg) when :in? slices_key?(send_node, :receiver, key_arg, value_arg) else true end end end
def included?(body, negated)
def included?(body, negated) if negated body.method?('exclude?') else body.method?('include?') || body.method?('in?') end end
def not_included?(body, negated)
def not_included?(body, negated) included?(body, !negated) end
def offense_range(node)
def offense_range(node) range_between(node.loc.selector.begin_pos, node.parent.loc.end.end_pos) end
def on_send(node)
def on_send(node) offense_range, key_source = extract_offense(node) return unless offense_range return unless semantically_subset_method?(node) preferred_method = "#{preferred_method_name}(#{key_source})" add_offense(offense_range, message: format(MSG, prefer: preferred_method)) do |corrector| corrector.replace(offense_range, preferred_method) end end
def preferred_method_name
def preferred_method_name raise NotImplementedError end
def range_include?(send_node)
def range_include?(send_node) # When checking `include?`, `exclude?` and `in?` for offenses, if the receiver # or first argument is a range, an offense should not be registered. # ie. `(1..5).include?(k)` or `k.in?('a'..'z')` return true if send_node.first_argument.range_type? receiver = send_node.receiver receiver = receiver.child_nodes.first while receiver.begin_type? receiver.range_type? end
def safe_to_register_offense?(block, except_key)
def safe_to_register_offense?(block, except_key) body = block.body if body.method?('==') || body.method?('!=') except_key.type?(:sym, :str) else true end end
def semantically_except_method?(node)
def semantically_except_method?(node) block = node.parent body, negated = extract_body_if_negated(block.body) if node.method?('reject') body.method?('==') || body.method?('eql?') || included?(body, negated) else body.method?('!=') || not_included?(body, negated) end end
def semantically_slice_method?(node)
def semantically_slice_method?(node) !semantically_except_method?(node) end
def semantically_subset_method?(node)
def semantically_subset_method?(node) raise NotImplementedError end
def slices_key?(send_node, method, key_arg, value_arg)
def slices_key?(send_node, method, key_arg, value_arg) return false if using_value_variable?(send_node, value_arg) node = method == :receiver ? send_node.receiver : send_node.first_argument node.source == key_arg.source end
def supported_subset_method?(method)
def supported_subset_method?(method) if active_support_extensions_enabled? ACTIVE_SUPPORT_SUBSET_METHODS.include?(method) else SUBSET_METHODS.include?(method) end end
def using_value_variable?(send_node, value_arg)
def using_value_variable?(send_node, value_arg) # If the receiver of `include?` or `exclude?`, or the first argument of `in?` is the # hash value block argument, an offense should not be registered. # ie. `v.include?(k)` or `k.in?(v)` (send_node.receiver.lvar_type? && send_node.receiver.name == value_arg.name) || (send_node.first_argument.lvar_type? && send_node.first_argument.name == value_arg.name) end