free_mutant/lib/mutant/killer/rspec.rb

module Mutant
  class Killer
    # Simple runner for rspec tests
    class Rspec < self

      # Run block in clean rspec environment
      #
      # @return [Object]
      #   returns the value of block
      #
      # @api private
      #
      def self.nest
        original_world, original_configuration = 
          ::RSpec.instance_variable_get(:@world),
          ::RSpec.instance_variable_get(:@configuration)

        ::RSpec.instance_variable_set(:@world,nil)
        ::RSpec.instance_variable_set(:@configuration,nil)

        yield
      ensure
        ::RSpec.instance_variable_set(:@world,original_world)
        ::RSpec.instance_variable_set(:@configuration,original_configuration)
      end

      # Return identification
      #
      # @return [String]
      #
      # @api private
      # 
      def identification
        "rspec:#{mutation.identification}"
      end

    private

      # Initialize rspec runner
      #
      # @return [undefined]
      #
      # @api private
      #
      def initialize(*)
        @error_stream, @output_stream = StringIO.new, StringIO.new
        super
      end

      # Run rspec test
      #
      # @return [true]
      #   returns true when test is NOT successful and the mutant was killed
      #
      # @return [false]
      #   returns false otherwise
      #
      # @api private
      #
      def run
        self.class.nest do 
          !RSpec::Core::Runner.run(command_line_arguments, @error_stream, @output_stream).zero?
        end
      end

      # Return command line arguments
      #
      # @return [Array]
      #
      # @api private
      #
      def command_line_arguments
        %W(
          --fail-fast
        ) + Dir[filename_pattern]
      end

      # Return rspec filename pattern
      #
      # @return [String]
      #
      # @api private
      #
      # TODO: Add an option or be clever and only run affected specs.
      #
      def filename_pattern
        'spec/unit/**/*_spec.rb'
      end
    end
  end
end