module Mutant # Comandline parser class CLI include Adamantium # Error raised when CLI argv is inalid Error = Class.new(RuntimeError) # Run cli with arguments # # @param [Array] arguments # # @return [Fixnum] # returns exit status # # @api private # def self.run(*arguments) error = Runner.run(new(*arguments).attributes).fail? error ? 1 : 0 end # Return attributes # # @return [Hash] # # @api private # def attributes { :mutation_filter => mutation_filter, :matcher => matcher, :reporter => Reporter::CLI.new($stderr), :killer => Killer::Rspec::Forking } end memoize :attributes private OPTIONS = { '--code' => [:add_filter, Mutation::Filter::Code], '-I' => [:add_load_path], '--include' => [:add_load_path], '-r' => [:require_library], '--require' => [:require_library] }.deep_freeze OPTION_PATTERN = %r(\A-(?:-)?[a-zA-Z0-9]+\z).freeze # Return option for argument with index # # @param [Fixnum] index # # @return [String] # # @api private # def option(index) @arguments.fetch(index+1) end # Initialize CLI # # @param [Array] arguments # # @return [undefined] # # @api private # def initialize(arguments) @filters, @matchers = [], [] @arguments, @index = arguments, 0 while @index < @arguments.length dispatch end end # Return current argument # # @return [String] # # @api private # def current_argument @arguments.fetch(@index) end # Return current option value # # @return [String] # # @raise [CLI::Error] # raises error when option is missing # # @api private # def current_option_value @arguments.fetch(@index+1) rescue IndexError raise Error, "#{current_argument.inspect} is missing an argument" end # Process current argument # # @return [undefined] # # @api private # def dispatch if OPTION_PATTERN.match(current_argument) dispatch_option else dispatch_matcher end end # Move processed argument by amount # # @param [Fixnum] amount # the amount of arguments to be consumed # # @return [undefined] # # @api private # def consume(amount) @index += amount end # Process matcher argument # # @return [undefined] # # @api private # def dispatch_matcher argument = current_argument matcher = Mutant::Matcher.from_string(argument) unless matcher raise Error, "Invalid matcher syntax: #{argument.inspect}" end @matchers << matcher consume(1) end # Process option argument # # @return [Undefined] # # @api private # def dispatch_option argument = current_argument arguments = *OPTIONS.fetch(argument) do raise Error, "Unknown option: #{argument.inspect}" end send(*arguments) end # Add mutation filter # # @param [Class] # # @return [undefined] # # @api private # def add_filter(klass) @filters << klass.new(current_option_value) consume(2) end # Add load path # # @api private # # @return [undefined] # def add_load_path $LOAD_PATH << current_option_value consume(2) end # Require library # # @api private # # @return [undefined] # def require_library require(current_option_value) consume(2) end # Return matcher # # @return [Mutant::Matcher] # # @raise [CLI::Error] # raises error when matcher is not given # # @api private # def matcher if @matchers.empty? raise Error, 'No matchers given' end Mutant::Matcher::Chain.new(@matchers) end # Return mutation filter # # @return [Mutant::Matcher] # # @api private # def mutation_filter if @filters.empty? Mutation::Filter::ALL else Mutation::Filter::Whitelist.new(@filters) end end end end