free_mutant/lib/mutant/killer.rb
2013-01-15 23:46:05 +01:00

152 lines
2.4 KiB
Ruby

module Mutant
# Abstract base class for mutant killers
class Killer
include Adamantium::Flat, AbstractType, Equalizer.new(:strategy, :mutation, :killed?)
# Test for kill failure
#
# @return [true]
# when mutant was killed
#
# @return [false]
# otherwise
#
# @api private
#
def success?
mutation.success?(self)
end
memoize :success?
# Test if mutant was killed
#
# @return [true]
# if mutant was killed
#
# @return [false]
# otherwise
#
# @api private
#
def killed?
@killed
end
# Return runtime of killer
#
# @return [Float]
#
# @api private
#
attr_reader :runtime
# Return configuration
#
# @return [Configuration]
#
# @api private
#
def configuration
strategy.configuration
end
# Return mutated source
#
# @return [String]
#
# @api private
#
def mutation_source
mutation.source
end
# Return name of killer
#
# @return [String]
#
# @api private
#
def self.type
self::TYPE
end
# Return strategy
#
# @return [Strategy]
#
# @api private
#
attr_reader :strategy
# Return identification
#
# @return [String]
#
# @api private
#
def identification
"#{type}:#{mutation.identification}".freeze
end
memoize :identification
# Return mae of killer
#
# @return [String]
#
# @api private
#
def type
self.class.type
end
# Return mutation to kill
#
# @return [Mutation]
#
# @api private
#
attr_reader :mutation
private
# Initialize killer object
#
# @param [Mutation] mutation
#
# @return [undefined]
#
# @api private
#
def initialize(strategy, mutation)
@strategy, @mutation = strategy, mutation
run_with_benchmark
end
# Run with taking the time
#
# @return [undefined]
#
# @api private
#
def run_with_benchmark
start_time = Time.now
@killed = run
end_time = Time.now
@runtime = end_time - start_time
end
# Run test
#
# @return [true]
# returns true when mutant was killed
#
# @return [false]
# returns false otherwise
#
# @api private
#
abstract_method :run
end
end