Class: RuboCop::Cop::FormulaAuditStrict::Text Private

Inherits:
RuboCop::Cop::FormulaCop show all
Extended by:
AutoCorrector
Defined in:
rubocops/text.rb,
sorbet/rbi/dsl/rubo_cop/cop/formula_audit_strict/text.rbi

Overview

This class is part of a private API. This class may only be used in the Homebrew/brew repository. Third parties should avoid using this class if possible, as it may be removed or changed without warning.

This cop contains stricter checks for various problems in a formula's source code.

Instance Attribute Summary

Attributes inherited from RuboCop::Cop::FormulaCop

#file_path

Instance Method Summary collapse

Methods inherited from RuboCop::Cop::FormulaCop

#audit_comments, #audit_urls, #caveats_strings, #dependency_name_hash_match?, #dependency_type_hash_match?, #depends_on?, #depends_on_name_type?, #formula_tap, #get_checksum_node, #on_class, #required_dependency?, #required_dependency_name?, #style_exceptions_dir, #tap_style_exception?, #versioned_formula?

Methods included from HelperFunctions

#block_method_called_in_block?, #block_size, #check_precedence, #class_name, #component_precedes?, #end_column, #expression_negated?, #find_all_blocks, #find_block, #find_blocks, #find_const, #find_every_func_call_by_name, #find_every_method_call_by_name, #find_instance_call, #find_instance_method_call, #find_method_calls_by_name, #find_method_def, #find_method_with_args, #find_node_method_by_name, #find_strings, #format_component, #line_number, #line_start_column, #method_called?, #method_called_ever?, #method_name, #node_equals?, #offending_node, #parameters, #parameters_passed?, #problem, #regex_match_group, #size, #source_buffer, #start_column, #string_content

Instance Method Details

#audit_formula(formula_nodes) ⇒ void

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

This method returns an undefined value.

Parameters:



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
 
# File 'rubocops/text.rb', line 123

def audit_formula(formula_nodes)
  return if (body_node = formula_nodes.body_node).nil?

  find_method_with_args(body_node, :go_resource) do
    problem "`go_resource`s are deprecated. Please ask upstream to implement Go vendoring"
  end

  find_method_with_args(body_node, :env, :userpaths) do
    problem "`env :userpaths` in homebrew/core formulae is deprecated"
  end

  share_path_starts_with(body_node, T.must(@formula_name)) do |share_node|
    offending_node(share_node)
    problem "Use `pkgshare` instead of `share/\"#{@formula_name}\"`"
  end

  interpolated_share_path_starts_with(body_node, "/#{@formula_name}") do |share_node|
    offending_node(share_node)
    problem "Use `\#{pkgshare}` instead of `\#{share}/#{@formula_name}`"
  end

  interpolated_bin_path_starts_with(body_node, "/#{@formula_name}") do |bin_node|
    next if bin_node.ancestors.any?(&:array_type?)

    offending_node(bin_node)
    cmd = bin_node.source.match(%r{\#{bin}/(\S+)})[1]&.delete_suffix('"') || @formula_name
    problem "Use `bin/\"#{cmd}\"` instead of `\"\#{bin}/#{cmd}\"`" do |corrector|
      corrector.replace(bin_node.loc.expression, "bin/\"#{cmd}\"")
    end
  end

  return if formula_tap != "homebrew-core"

  find_method_with_args(body_node, :env, :std) do
    problem "`env :std` in homebrew/core formulae is deprecated"
  end
end

#interpolated_bin_path_starts_with(node, *pattern, **kwargs, &block) ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

Returns:

  • (T.untyped) 


17
 
# File 'sorbet/rbi/dsl/rubo_cop/cop/formula_audit_strict/text.rbi', line 17

def interpolated_bin_path_starts_with(node, *pattern, **kwargs, &block); end

#interpolated_share_path_starts_with(node, *pattern, **kwargs, &block) ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

Returns:

  • (T.untyped) 


27
 
# File 'sorbet/rbi/dsl/rubo_cop/cop/formula_audit_strict/text.rbi', line 27

def interpolated_share_path_starts_with(node, *pattern, **kwargs, &block); end

#path_starts_with?(path, starts_with, bin: false) ⇒ Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Check whether value starts with the formula name and then a "/", " " or EOS. If we're checking for "#bin", we also check for "-" since similar binaries also don't need interpolation.

Parameters:

  • path (String)
  • starts_with (String)
  • bin (Boolean) (defaults to: false)

Returns:

  • (Boolean) 


164
165
166
167
 
# File 'rubocops/text.rb', line 164

def path_starts_with?(path, starts_with, bin: false)
  ending = bin ? "/|-|$" : "/| |$"
  path.match?(/^#{Regexp.escape(starts_with)}(#{ending})/)
end

#path_starts_with_bin?(path, starts_with) ⇒ Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

Returns:

  • (Boolean) 


170
171
172
173
174
 
# File 'rubocops/text.rb', line 170

def path_starts_with_bin?(path, starts_with)
  return false if path.include?(" ")

  path_starts_with?(path, starts_with, bin: true)
end

#share_path_starts_with(node, *pattern, **kwargs, &block) ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

Returns:

  • (T.untyped) 


37
 
# File 'sorbet/rbi/dsl/rubo_cop/cop/formula_audit_strict/text.rbi', line 37

def share_path_starts_with(node, *pattern, **kwargs, &block); end