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
```

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.
.project_root deprecated Deprecated.

Use ConfigFinder.project_root instead.
.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 30


alias debug? debug

.default_configuration (rw)

[ GitHub ]

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


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 27


attr_writer :default_configuration

.disable_pending_cops (rw)

[ GitHub ]

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


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 25


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 31


alias ignore_parent_exclusion? ignore_parent_exclusion

.ignore_unrecognized_cops (rw)

[ GitHub ]

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


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 28


attr_reader :loaded_plugins, :loaded_features

.loaded_plugins (readonly)

[ GitHub ]

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


attr_reader :loaded_plugins, :loaded_features

Class Method Details

.add_excludes_from_files(config, config_file)

[ GitHub ]

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


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 204


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 197


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 83


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 218


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 33


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 111


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 115


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)
end

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

[ GitHub ]

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


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 210


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 25


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 152


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 45


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 70


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 102


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 190


def merge_with_default(config, config_file, unset_nil: true)
  resolver.merge_with_default(config, config_file, unset_nil: unset_nil)
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 180


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 238


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 214


def resolver
  @resolver ||= ConfigLoaderResolver.new
end

.yaml_tree_to_hash(yaml_tree) (private)

[ GitHub ]

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


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 254


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)

.project_root

.read_file(absolute_path) (private)

.resolver (private)

.yaml_tree_to_hash(yaml_tree) (private)

.yaml_tree_to_hash!(yaml_tree) (private)

`FileFinder` - Extended