Class: RuboCop::ConfigLoader

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain: self, `FileFinder`
Inherits:	Object
Defined in:	lib/rubocop/config_loader.rb

Overview

This class represents the configuration of the RuboCop application and all its cops. A Config is associated with a YAML configuration file from which it was read. Several different Configs can be used during a run of the rubocop program, if files in several directories are inspected.

Constant Summary

DEFAULT_FILE =
# File 'lib/rubocop/config_loader.rb', line 20
```
File.join(RUBOCOP_HOME, 'config', 'default.yml')
```
DOTFILE =
# File 'lib/rubocop/config_loader.rb', line 18
```
ConfigFinder::DOTFILE
```

PENDING_BANNER =
# File 'lib/rubocop/config_loader.rb', line 25

<<~BANNER
  The following cops were added to RuboCop, but are not configured. Please set Enabled to either `true` or `false` in your `.rubocop.yml` file.

  Please also note that you can opt-in to new cops by default by adding this to your config:
    AllCops:
      NewCops: enable
BANNER

RUBOCOP_HOME =
# File 'lib/rubocop/config_loader.rb', line 19

File.realpath(File.join(File.dirname(__FILE__), '..', '..'))

Class Attribute Summary

.debug? rw

Alias for .debug.
.default_configuration rw
.default_configuration=(value) rw
.disable_pending_cops rw
.enable_pending_cops rw
.ignore_parent_exclusion? rw

Alias for .ignore_parent_exclusion.
.ignore_unrecognized_cops rw
.loaded_features readonly
.loaded_plugins readonly

Class Method Summary

.add_excludes_from_files(config, config_file)
.add_loaded_features(loaded_features) Internal use only Internal use only

Used to add features that were required inside a config or from the CLI using --require.
.add_loaded_plugins(loaded_plugins) Internal use only Internal use only

Used to add plugins that were required inside a config or from the CLI using --plugin.
.add_missing_namespaces(path, hash)
.clear_options
.configuration_file_for(target_dir)

Returns the path of .rubocop.yml searching upwards in the directory structure starting at the given directory where the inspected file is.
.configuration_from_file(config_file, check: true)
.debug (also: .debug?) rw
.ignore_parent_exclusion (also: .ignore_parent_exclusion?) rw
.inject_defaults!(config_yml_path)

This API is primarily intended for testing and documenting plugins.
.load_file(file, check: true)
.load_yaml_configuration(absolute_path)
.merge(base_hash, derived_hash)

Return a recursive merge of two hashes.
.merge_with_default(config, config_file, unset_nil: true)

Merges the given configuration with the default one.
.pending_cops_only_qualified(pending_cops)
.possible_new_cops?(config) ⇒ Boolean
.project_root deprecated Deprecated.

Use ConfigFinder.project_root instead.
.warn_on_pending_cops(pending_cops)
.warn_pending_cop(cop)
.check_duplication(yaml_code, absolute_path) private
.file_path(file) private
.read_file(absolute_path) private

Read the specified file, or exit with a friendly, concise message on stderr.
.resolver private
.yaml_tree_to_hash(yaml_tree) private
.yaml_tree_to_hash!(yaml_tree) private

`FileFinder` - Extended

find_file_upwards, find_last_file_upwards, traverse_directories_upwards, traverse_files_upwards

Class Attribute Details

.debug? (rw)

Alias for .debug.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 38


alias debug? debug

.default_configuration (rw)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 162


def default_configuration
  @default_configuration ||= begin
    print 'Default ' if debug?
    load_file(DEFAULT_FILE)
  end
end

.default_configuration=(value) (rw)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 35


attr_writer :default_configuration

.disable_pending_cops (rw)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 33


attr_accessor :debug, :ignore_parent_exclusion, :disable_pending_cops, :enable_pending_cops,
              :ignore_unrecognized_cops

.enable_pending_cops (rw)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 33


attr_accessor :debug, :ignore_parent_exclusion, :disable_pending_cops, :enable_pending_cops,
              :ignore_unrecognized_cops

.ignore_parent_exclusion? (rw)

Alias for .ignore_parent_exclusion.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 39


alias ignore_parent_exclusion? ignore_parent_exclusion

.ignore_unrecognized_cops (rw)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 33


attr_accessor :debug, :ignore_parent_exclusion, :disable_pending_cops, :enable_pending_cops,
              :ignore_unrecognized_cops

.loaded_features (readonly)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 36


attr_reader :loaded_plugins, :loaded_features

.loaded_plugins (readonly)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 36


attr_reader :loaded_plugins, :loaded_features

Class Method Details

.add_excludes_from_files(config, config_file)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 152


def add_excludes_from_files(config, config_file)
  exclusion_file = find_last_file_upwards(DOTFILE, config_file, ConfigFinder.project_root)

  return unless exclusion_file
  return if PathUtil.relative_path(exclusion_file) == PathUtil.relative_path(config_file)

  print 'AllCops/Exclude ' if debug?
  config.add_excludes_from_higher_level(load_file(exclusion_file))
end

.add_loaded_features(loaded_features)

This method is for internal use only.

Used to add features that were required inside a config or from the CLI using --require.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 241


def add_loaded_features(loaded_features)
  @loaded_features.merge(Array(loaded_features))
end

.add_loaded_plugins(loaded_plugins)

This method is for internal use only.

Used to add plugins that were required inside a config or from the CLI using --plugin.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 234


def add_loaded_plugins(loaded_plugins)
  @loaded_plugins.merge(Array(loaded_plugins))
end

.add_missing_namespaces(path, hash)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 91


def add_missing_namespaces(path, hash)
  # Using `hash.each_key` will cause the
  # `can't add a new key into hash during iteration` error
  obsoletion = ConfigObsoletion.new(hash)

  hash_keys = hash.keys
  hash_keys.each do |key|
    next if obsoletion.deprecated_cop_name?(key)

    q = Cop::Registry.qualified_cop_name(key, path)
    next if q == key

    hash[q] = hash.delete(key)
  end
end

.check_duplication(yaml_code, absolute_path) (private)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 255


def check_duplication(yaml_code, absolute_path)
  smart_path = PathUtil.smart_path(absolute_path)
  YAMLDuplicationChecker.check(yaml_code, absolute_path) do |key1, key2|
    value = key1.value
    # .start_line is only available since ruby 2.5 / psych 3.0
    message = if key1.respond_to? :start_line
                line1 = key1.start_line + 1
                line2 = key2.start_line + 1
                "#{smart_path}:#{line1}: " \
                  "`#{value}` is concealed by line #{line2}"
              else
                "#{smart_path}: `#{value}` is concealed by duplicate"
              end
    warn Rainbow(message).yellow
  end
end

.clear_options

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 41


def clear_options
  @debug = nil
  @loaded_plugins = Set.new
  @loaded_features = Set.new
  @disable_pending_cops = nil
  @enable_pending_cops = nil
  @ignore_parent_exclusion = nil
  @ignore_unrecognized_cops = nil
  FileFinder.root_level = nil
end

.configuration_file_for(target_dir)

Returns the path of .rubocop.yml searching upwards in the directory structure starting at the given directory where the inspected file is. If no .rubocop.yml is found there, the user’s home directory is checked. If there’s no .rubocop.yml there either, the path to the default file is returned.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 119


def configuration_file_for(target_dir)
  ConfigFinder.find_config_path(target_dir)
end

.configuration_from_file(config_file, check: true)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 123


def configuration_from_file(config_file, check: true)
  return default_configuration if config_file == DEFAULT_FILE

  config = load_file(config_file, check: check)
  config.validate_after_resolution if check

  if ignore_parent_exclusion?
    print 'Ignoring AllCops/Exclude from parent folders' if debug?
  else
    add_excludes_from_files(config, config_file)
  end

  merge_with_default(config, config_file).tap do |merged_config|
    unless possible_new_cops?(merged_config)
      pending_cops = pending_cops_only_qualified(merged_config.pending_cops)
      warn_on_pending_cops(pending_cops) unless pending_cops.empty?
    end
  end
end

.debug (rw) Also known as: .debug?

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 33


attr_accessor :debug, :ignore_parent_exclusion, :disable_pending_cops, :enable_pending_cops,
              :ignore_unrecognized_cops

.file_path(file) (private)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 247


def file_path(file)
  File.absolute_path(file.is_a?(RemoteConfig) ? file.file : file)
end

.ignore_parent_exclusion (rw) Also known as: .ignore_parent_exclusion?

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 33


attr_accessor :debug, :ignore_parent_exclusion, :disable_pending_cops, :enable_pending_cops,
              :ignore_unrecognized_cops

.inject_defaults!(config_yml_path)

This API is primarily intended for testing and documenting plugins. When testing a plugin using rubocop/rspec/support, the plugin is loaded automatically, so this API is usually not needed. It is intended to be used only when implementing tests that do not use rubocop/rspec/support.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 174


def inject_defaults!(config_yml_path)
  if Pathname(config_yml_path).directory?
    # TODO: Since the warning noise is expected to be high until some time after the release,
    # warnings will only be issued when `RUBYOPT=-w` is specified.
    # To proceed step by step, the next step is to remove `$VERBOSE` and always issue warning.
    # Eventually, `project_root` will no longer be accepted.
    if $VERBOSE
      warn Rainbow(<<~MESSAGE).yellow, uplevel: 1
        Use config YAML file path instead of project root directory.
        e.g., `path/to/config/default.yml`
      MESSAGE
    end
    # NOTE: For compatibility.
    project_root = config_yml_path
    path = File.join(project_root, 'config', 'default.yml')
    config = load_file(path)
  else
    hash = ConfigLoader.load_yaml_configuration(config_yml_path.to_s)
    config = Config.new(hash, config_yml_path).tap(&:make_excludes_absolute)
  end

  @default_configuration = ConfigLoader.merge_with_default(config, path)
end

.load_file(file, check: true)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 53


def load_file(file, check: true)
  path = file_path(file)

  hash = load_yaml_configuration(path)

  rubocop_config = Config.create(hash, path, check: false)
  plugins = hash.delete('plugins')
  loaded_plugins = resolver.resolve_plugins(rubocop_config, plugins)
  add_loaded_plugins(loaded_plugins)

  loaded_features = resolver.resolve_requires(path, hash)
  add_loaded_features(loaded_features)

  resolver.resolve_inheritance_from_gems(hash)
  resolver.resolve_inheritance(path, hash, file, debug?)
  hash.delete('inherit_from')

  # Adding missing namespaces only after resolving requires & inheritance,
  # since both can introduce new cops that need to be considered here.
  add_missing_namespaces(path, hash)

  Config.create(hash, path, check: check)
end

.load_yaml_configuration(absolute_path)

Raises:

(TypeError)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 78


def load_yaml_configuration(absolute_path)
  file_contents = read_file(absolute_path)
  yaml_code = Dir.chdir(File.dirname(absolute_path)) { ERB.new(file_contents).result }
  yaml_tree = check_duplication(yaml_code, absolute_path)
  hash = yaml_tree_to_hash(yaml_tree) || {}

  puts "configuration from #{absolute_path}" if debug?

  raise(TypeError, "Malformed configuration in #{absolute_path}") unless hash.is_a?(Hash)

  hash
end

.merge(base_hash, derived_hash)

Return a recursive merge of two hashes. That is, a normal hash merge, with the addition that any value that is a hash, and occurs in both arguments, will also be merged. And so on.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 110


def merge(base_hash, derived_hash)
  resolver.merge(base_hash, derived_hash)
end

.merge_with_default(config, config_file, unset_nil: true)

Merges the given configuration with the default one.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 227


def merge_with_default(config, config_file, unset_nil: true)
  resolver.merge_with_default(config, config_file, unset_nil: unset_nil)
end

.pending_cops_only_qualified(pending_cops)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 143


def pending_cops_only_qualified(pending_cops)
  pending_cops.select { |cop| Cop::Registry.qualified_cop?(cop.name) }
end

.possible_new_cops?(config) ⇒ `Boolean`

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 147


def possible_new_cops?(config)
  disable_pending_cops || enable_pending_cops ||
    config.disabled_new_cops? || config.enabled_new_cops?
end

.project_root

Deprecated.

Use ConfigFinder.project_root instead.

Returns the path RuboCop inferred as the root of the project. No file searches will go past this directory.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 202


def project_root
  warn Rainbow(<<~WARNING).yellow, uplevel: 1
    `RuboCop::ConfigLoader.project_root` is deprecated and will be removed in RuboCop 2.0. \
    Use `RuboCop::ConfigFinder.project_root` instead.
  WARNING

  ConfigFinder.project_root
end

.read_file(absolute_path) (private)

Read the specified file, or exit with a friendly, concise message on stderr. Care is taken to use the standard OS exit code for a "file not found" error.

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 275


def read_file(absolute_path)
  File.read(absolute_path, encoding: Encoding::UTF_8)
rescue Errno::ENOENT
  raise ConfigNotFoundError, "Configuration file not found: #{absolute_path}"
end

.resolver (private)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 251


def resolver
  @resolver ||= ConfigLoaderResolver.new
end

.warn_on_pending_cops(pending_cops)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 211


def warn_on_pending_cops(pending_cops)
  warn Rainbow(PENDING_BANNER).yellow

  pending_cops.each { |cop| warn_pending_cop cop }

  warn Rainbow('For more information: https://docs.rubocop.org/rubocop/versioning.html').yellow
end

.warn_pending_cop(cop)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 219


def warn_pending_cop(cop)
  version = cop.metadata['VersionAdded'] || 'N/A'

  warn Rainbow("#{cop.name}: # new in #{version}").yellow
  warn Rainbow('  Enabled: true').yellow
end

.yaml_tree_to_hash(yaml_tree) (private)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 281


def yaml_tree_to_hash(yaml_tree)
  yaml_tree_to_hash!(yaml_tree)
rescue ::StandardError
  if defined?(::SafeYAML)
    raise 'SafeYAML is unmaintained, no longer needed and should be removed'
  end

  raise
end

.yaml_tree_to_hash!(yaml_tree) (private)

[ GitHub ]

# File 'lib/rubocop/config_loader.rb', line 291


def yaml_tree_to_hash!(yaml_tree)
  return nil unless yaml_tree

  # Optimization: Because we checked for duplicate keys, we already have the
  # yaml tree and don't need to parse it again.
  # Also see https://github.com/ruby/psych/blob/v5.1.2/lib/psych.rb#L322-L336
  class_loader = YAML::ClassLoader::Restricted.new(%w[Regexp Symbol], [])
  scanner = YAML::ScalarScanner.new(class_loader)
  visitor = YAML::Visitors::ToRuby.new(scanner, class_loader)
  visitor.accept(yaml_tree)
end

Class: RuboCop::ConfigLoader

Overview

Constant Summary

Class Attribute Summary

Class Method Summary

FileFinder - Extended

Class Attribute Details

.debug? (rw)

.default_configuration (rw)

.default_configuration=(value) (rw)

.disable_pending_cops (rw)

.enable_pending_cops (rw)

.ignore_parent_exclusion? (rw)

.ignore_unrecognized_cops (rw)

.loaded_features (readonly)

.loaded_plugins (readonly)

Class Method Details

.add_excludes_from_files(config, config_file)

.add_loaded_features(loaded_features)

.add_loaded_plugins(loaded_plugins)

.add_missing_namespaces(path, hash)

.check_duplication(yaml_code, absolute_path) (private)

.clear_options

.configuration_file_for(target_dir)

.configuration_from_file(config_file, check: true)

.debug (rw) Also known as: .debug?

.file_path(file) (private)

.ignore_parent_exclusion (rw) Also known as: .ignore_parent_exclusion?

.inject_defaults!(config_yml_path)

.load_file(file, check: true)

.load_yaml_configuration(absolute_path)

.merge(base_hash, derived_hash)

.merge_with_default(config, config_file, unset_nil: true)

.pending_cops_only_qualified(pending_cops)

.possible_new_cops?(config) ⇒ Boolean

.project_root

.read_file(absolute_path) (private)

.resolver (private)

.warn_on_pending_cops(pending_cops)

.warn_pending_cop(cop)

.yaml_tree_to_hash(yaml_tree) (private)

.yaml_tree_to_hash!(yaml_tree) (private)

`FileFinder` - Extended

.possible_new_cops?(config) ⇒ `Boolean`