free_mutant/lib/mutant/killer.rb
2014-01-18 00:15:42 +01:00

123 lines
1.9 KiB
Ruby

# encoding: utf-8
module Mutant
# Abstract base class for mutant killers
class Killer
include Adamantium::Flat, AbstractType
include Equalizer.new(:strategy, :mutation, :killed?)
# Return strategy
#
# @return [Strategy]
#
# @api private
#
attr_reader :strategy
# Return mutation to kill
#
# @return [Mutation]
#
# @api private
#
attr_reader :mutation
# Initialize killer object
#
# @param [Strategy] strategy
# @param [Mutation] mutation
#
# @return [undefined]
#
# @api private
#
def initialize(strategy, mutation)
@strategy, @mutation = strategy, mutation
@killed = run
end
# Test for kill failure
#
# @return [true]
# when killer succeeded
#
# @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 mutated source
#
# @return [String]
#
# @api private
#
def mutation_source
mutation.source
end
private
# Return subject
#
# @return [Subject]
#
# @api private
#
def subject
mutation.subject
end
# Run killer
#
# @return [true]
# when mutant was killed
#
# @return [false]
# otherwise
#
# @api private
#
abstract_method :run
# Null killer that never kills a mutation
class Null < self
private
# Run killer
#
# @return [true]
# when mutant was killed
#
# @return [false]
# otherwise
#
# @api private
#
def run
false
end
end
end # Killer
end # Mutant