# encoding: utf-8
require 'optparse'
module RuboCop
# This class handles command line options.
class Options
DEFAULT_FORMATTER = 'progress'
EXITING_OPTIONS = [:version, :verbose_version, :show_cops]
DEFAULT_MAXIMUM_EXCLUSION_ITEMS = 15
def initialize
@options = {}
@validator = OptionsValidator.new(@options)
end
def parse(args)
define_options(args).parse!(args)
# The --no-color CLI option sets `color: false` so we don't want the
# `no_color` key, which is created automatically.
@options.delete(:no_color)
@validator.validate_compatibility
if @options[:stdin] && !args.one?
fail ArgumentError, '-s/--stdin requires exactly one path.'
end
[@options, args]
end
private
def define_options(args)
OptionParser.new do |opts|
opts.banner = 'Usage: rubocop [options] [file1, file2, ...]'
add_list_options(opts)
add_only_options(opts)
add_configuration_options(opts, args)
add_formatting_options(opts)
option(opts, '-r', '--require FILE') { |f| require f }
add_severity_option(opts)
add_flags_with_optional_args(opts)
add_boolean_flags(opts)
end
end
def add_only_options(opts)
add_cop_selection_csv_option('except', opts)
add_cop_selection_csv_option('only', opts)
option(opts, '--only-guide-cops')
end
def add_cop_selection_csv_option(option, opts)
option(opts, "--#{option} [COP1,COP2,...]") do |list|
@options[:"#{option}"] =
if list.empty?
['']
else
list.split(',').map do |c|
Cop::Cop.qualified_cop_name(c, "--#{option} option")
end
end
end
end
def add_configuration_options(opts, args)
option(opts, '-c', '--config FILE')
option(opts, '--auto-gen-config') do
@options[:formatters] = [[DEFAULT_FORMATTER],
[Formatter::DisabledConfigFormatter,
ConfigLoader::AUTO_GENERATED_FILE]]
end
option(opts, '--exclude-limit COUNT') do
@validator.validate_exclude_limit_option(args)
end
option(opts, '--force-exclusion')
end
def add_formatting_options(opts)
option(opts, '-f', '--format FORMATTER') do |key|
@options[:formatters] ||= []
@options[:formatters] << [key]
end
option(opts, '-o', '--out FILE') do |path|
@options[:formatters] ||= [[DEFAULT_FORMATTER]]
@options[:formatters].last << path
end
end
def add_severity_option(opts)
table = RuboCop::Cop::Severity::CODE_TABLE.merge(A: :autocorrect)
option(opts, '--fail-level SEVERITY',
RuboCop::Cop::Severity::NAMES + [:autocorrect],
table) do |severity|
@options[:fail_level] = severity
end
end
def add_flags_with_optional_args(opts)
option(opts, '--show-cops [COP1,COP2,...]') do |list|
@options[:show_cops] = list.nil? ? [] : list.split(',')
end
end
def add_boolean_flags(opts)
option(opts, '-F', '--fail-fast')
option(opts, '-C', '--cache FLAG')
option(opts, '-d', '--debug')
option(opts, '-D', '--display-cop-names')
option(opts, '-E', '--extra-details')
option(opts, '-S', '--display-style-guide')
option(opts, '-R', '--rails')
option(opts, '-l', '--lint') do
@options[:only] ||= []
@options[:only] << 'Lint'
end
option(opts, '-a', '--auto-correct')
@options[:color] = true
option(opts, '-n', '--no-color') { @options[:color] = false }
option(opts, '-v', '--version')
option(opts, '-V', '--verbose-version')
option(opts, '-s', '--stdin') { @options[:stdin] = $stdin.read }
end
def add_list_options(opts)
option(opts, '-L', '--list-target-files')
end
# Sets a value in the @options hash, based on the given long option and its
# value, in addition to calling the block if a block is given.
def option(opts, *args)
long_opt_symbol = long_opt_symbol(args)
args += Array(OptionsHelp::TEXT[long_opt_symbol])
opts.on(*args) do |arg|
@options[long_opt_symbol] = arg
yield arg if block_given?
end
end
# Finds the option in `args` starting with -- and converts it to a symbol,
# e.g. [..., '--auto-correct', ...] to :auto_correct.
def long_opt_symbol(args)
long_opt = args.find { |arg| arg.start_with?('--') }
long_opt[2..-1].sub(/ .*/, '').tr('-', '_').to_sym
end
end
# Validates option arguments and the options' compatibilty with each other.
class OptionsValidator
def initialize(options)
@options = options
end
# Cop name validation must be done later than option parsing, so it's not
# called from within Options.
def self.validate_cop_list(names)
return unless names
namespaces = Cop::Cop.all.types.map { |t| t.to_s.capitalize }
names.each do |name|
next if Cop::Cop.all.any? { |c| c.cop_name == name }
next if namespaces.include?(name)
next if %w(Syntax Lint/Syntax).include?(name)
fail ArgumentError, "Unrecognized cop or namespace: #{name}."
end
end
def validate_compatibility
if @options.key?(:only) &&
(@options[:only] & %w(Lint/UnneededDisable UnneededDisable)).any?
fail ArgumentError, 'Lint/UnneededDisable can not be used with --only.'
end
if @options.key?(:except) &&
(@options[:except] & %w(Lint/Syntax Syntax)).any?
fail ArgumentError, 'Syntax checking can not be turned off.'
end
if @options.key?(:cache) && !%w(true false).include?(@options[:cache])
fail ArgumentError, '-C/--cache argument must be true or false'
end
return if (incompat = @options.keys & Options::EXITING_OPTIONS).size <= 1
fail ArgumentError, "Incompatible cli options: #{incompat.inspect}"
end
def validate_exclude_limit_option(args)
if @options[:exclude_limit] !~ /^\d+$/
# Emulate OptionParser's behavior to make failures consistent regardless
# of option order.
fail OptionParser::MissingArgument
end
# --exclude-limit is valid if there's a parsed or yet unparsed
# --auto-gen-config.
return if @options[:auto_gen_config] || args.include?('--auto-gen-config')
fail ArgumentError,
'--exclude-limit can only be used with --auto-gen-config.'
end
end
# This module contains help texts for command line options.
module OptionsHelp
MAX_EXCL = RuboCop::Options::DEFAULT_MAXIMUM_EXCLUSION_ITEMS.to_s
TEXT = {
only: 'Run only the given cop(s).',
only_guide_cops: ['Run only cops for rules that link to a',
'style guide.'],
except: 'Disable the given cop(s).',
require: 'Require Ruby file.',
config: 'Specify configuration file.',
auto_gen_config: ['Generate a configuration file acting as a',
'TODO list.'],
exclude_limit: ['Used together with --auto-gen-config to',
'set the limit for how many Exclude',
"properties to generate. Default is #{MAX_EXCL}."],
force_exclusion: ['Force excluding files specified in the',
'configuration `Exclude` even if they are',
'explicitly passed as arguments.'],
format: ['Choose an output formatter. This option',
'can be specified multiple times to enable',
'multiple formatters at the same time.',
' [p]rogress (default)',
' [s]imple',
' [c]lang',
' [d]isabled cops via inline comments',
' [fu]ubar',
' [e]macs',
' [j]son',
' [h]tml',
' [fi]les',
' [o]ffenses',
' custom formatter class name'],
out: ['Write output to a file instead of STDOUT.',
'This option applies to the previously',
'specified --format, or the default format',
'if no format is specified.'],
fail_level: ['Minimum severity (A/R/C/W/E/F) for exit',
'with error code.'],
show_cops: ['Shows the given cops, or all cops by',
'default, and their configurations for the',
'current directory.'],
fail_fast: ['Inspect files in order of modification',
'time and stop after the first file',
'containing offenses.'],
cache: ["Use result caching (FLAG=true) or don't",
'(FLAG=false), default determined by',
'configuration parameter AllCops: UseCache.'],
debug: 'Display debug info.',
display_cop_names: 'Display cop names in offense messages.',
display_style_guide: 'Display style guide URLs in offense messages.',
extra_details: 'Display extra details in offense messages.',
rails: 'Run extra Rails cops.',
lint: 'Run only lint cops.',
list_target_files: 'List all files RuboCop will inspect.',
auto_correct: 'Auto-correct offenses.',
no_color: 'Disable color output.',
version: 'Display version.',
verbose_version: 'Display verbose version.',
stdin: ['Pipe source from STDIN.',
'This is useful for editor integration.']
}
end
end