mutant 0.5.26 → 0.6.0

data/spec/integration/mutant/null_spec.rb

@@ -1,6 +1,4 @@
-require 'spec_helper'
-
-describe 'null integration' do
+RSpec.describe 'null integration' do
 
   let(:base_cmd) { 'bundle exec mutant -I lib --require test_app "TestApp*"' }
 

data/spec/integration/mutant/rspec_spec.rb

@@ -1,6 +1,4 @@
-require 'spec_helper'
-
-describe 'rspec integration' do
+RSpec.describe 'rspec integration' do
 
   let(:base_cmd) { 'bundle exec mutant -I lib --require test_app --use rspec' }
 

data/spec/integration/mutant/test_mutator_handles_types_spec.rb

@@ -1,6 +1,4 @@
-require 'spec_helper'
-
-describe do
+RSpec.describe do
 
   specify 'mutant should not crash for any node parser can generate' do
     Mutant::AST::Types::ALL.each do |type|

data/spec/integration/mutant/zombie_spec.rb

@@ -1,6 +1,4 @@
-require 'spec_helper'
-
-describe 'as a zombie' do
+RSpec.describe 'as a zombie' do
   specify 'it allows to create zombie from mutant' do
     expect { Mutant.zombify }.to change { defined?(Zombie) }.from(nil).to('constant')
     expect(Zombie.constants).to include(:Mutant)

data/spec/integrations.yml

@@ -32,3 +32,10 @@
   mutation_generation: true
   exclude: []
   expect_coverage: 100.0
+- name: axiom
+  namespace: Axiom
+  repo_uri: 'https://github.com/dkubb/axiom.git'
+  mutation_coverage: false
+  mutation_generation: true
+  exclude: []
+  expect_coverage: 100.0

data/spec/shared/method_matcher_behavior.rb

@@ -1,4 +1,4 @@
-shared_examples_for 'a method matcher' do
+RSpec.shared_examples_for 'a method matcher' do
 
   before { subject }
 

data/spec/spec_helper.rb

@@ -26,6 +26,7 @@ require 'devtools/spec_helper'
 require 'unparser/cli'
 require 'mutant'
 require 'mutant/meta'
+Devtools.init_spec_helper
 
 $LOAD_PATH << File.join(TestApp.root, 'lib')
 

data/spec/support/compress_helper.rb

@@ -2,6 +2,7 @@ module CompressHelper
   def strip_indent(string)
     lines       = string.lines
     match       = /\A( *)/.match(lines.first)
+    return string unless match
     whitespaces = match[1].to_s.length
     lines.map { |line| line[whitespaces..-1] }.join
   end

data/spec/support/corpus.rb

@@ -0,0 +1,239 @@
+require 'morpher'
+require 'anima'
+
+# Namespace module for corpus testing
+module Corpus
+  # Project under corpus test
+  # rubocop:disable ClassLength
+  ROOT = Pathname.new(__FILE__).parent.parent.parent
+  TMP = ROOT.join('tmp').freeze
+
+  class Project
+    MUTEX = Mutex.new
+    include Adamantium, Anima.new(
+      :name,
+      :repo_uri,
+      :exclude,
+      :mutation_coverage,
+      :mutation_generation,
+      :namespace,
+      :expect_coverage
+    )
+
+    # Verify mutation coverage
+    #
+    # @return [self]
+    #   if successful
+    #
+    # @raise [Exception]
+    #
+    def verify_mutation_coverage
+      checkout
+      Dir.chdir(repo_path) do
+        Bundler.with_clean_env do
+          install_mutant
+          system(%W[bundle exec mutant --use rspec -I lib -r #{name} --score #{expect_coverage} #{namespace}*])
+        end
+      end
+    end
+
+    # Verify mutation generation
+    #
+    # @return [self]
+    #   if successful
+    #
+    # @raise [Exception]
+    #   otherwise
+    #
+    # rubocop:disable MethodLength
+    def verify_mutation_generation
+      checkout
+      start = Time.now
+      paths = Pathname.glob(repo_path.join('**/*.rb')).sort_by(&:size).reverse
+      options = {
+        finish: method(:finish),
+        start: method(:start),
+        in_processes: parallel_processes
+      }
+      total = Parallel.map(paths, options) do |path|
+        count = 0
+        node =
+          begin
+            Parser::CurrentRuby.parse(path.read)
+          rescue EncodingError, ArgumentError
+            nil # Make rubocop happy
+          end
+        if node
+          Mutant::Mutator::Node.each(node) do
+            count += 1
+          end
+        end
+        count
+      end.inject(0, :+)
+      took = Time.now - start
+      puts format(
+        'Total Mutations/Time/Parse-Errors: %s/%0.2fs - %0.2f/s',
+        total,
+        took,
+        total / took
+      )
+      self
+    end
+
+    # Checkout repository
+    #
+    # @return [self]
+    #
+    # @api private
+    #
+    def checkout
+      return self if noinstall?
+      TMP.mkdir unless TMP.directory?
+      if repo_path.exist?
+        Dir.chdir(repo_path) do
+          system(%w[git fetch])
+          system(%w[git reset --hard])
+          system(%w[git clean -f -d -x])
+          system(%w[git checkout origin/master])
+          system(%w[git reset --hard])
+          system(%w[git clean -f -d -x])
+        end
+      else
+        system(%W[git clone #{repo_uri} #{repo_path}])
+      end
+      self
+    end
+    memoize :checkout
+
+  private
+
+    # Install mutant
+    #
+    # @return [undefined]
+    #
+    # @api private
+    #
+    def install_mutant
+      return if noinstall?
+      relative = ROOT.relative_path_from(repo_path)
+      devtools = ROOT.join('Gemfile.devtools').read
+      devtools << "gem 'mutant', path: '#{relative}'\n"
+      devtools << "gem 'mutant-rspec', path: '#{relative}'\n"
+      File.write(repo_path.join('Gemfile.devtools'), devtools)
+      lockfile = repo_path.join('Gemfile.lock')
+      lockfile.delete if lockfile.exist?
+      system('bundle install')
+    end
+
+    # Not in the docs. Number from chatting with their support.
+    CIRCLE_CI_CONTAINER_PROCESSES = 2
+
+    # Return number of parallel processes to use
+    #
+    # @return [Fixnum]
+    #
+    # @api private
+    #
+    def parallel_processes
+      case
+      when Devtools.circle_ci?
+        CIRCLE_CI_CONTAINER_PROCESSES
+      else
+        Parallel.processor_count
+      end
+    end
+
+    # Return repository path
+    #
+    # @return [Pathname]
+    #
+    # @api private
+    #
+    def repo_path
+      TMP.join(name)
+    end
+
+    # Test if installation should be skipped
+    #
+    # @return [Boolean]
+    #
+    # @api private
+    #
+    def noinstall?
+      ENV.key?('NOINSTALL')
+    end
+
+    # Print start progress
+    #
+    # @param [Pathname] path
+    # @param [Fixnum] _index
+    #
+    # @return [undefined]
+    #
+    def start(path, _index)
+      MUTEX.synchronize do
+        puts format('Starting - %s', path)
+      end
+    end
+
+    # Print finish progress
+    #
+    # @param [Pathname] path
+    # @param [Fixnum] _index
+    # @param [Fixnum] count
+    #
+    # @return [undefined]
+    #
+    def finish(path, _index, count)
+      MUTEX.synchronize do
+        puts format('Mutations - %4i - %s', count, path)
+      end
+    end
+
+    # Helper method to execute system commands
+    #
+    # @param [Array<String>] arguments
+    #
+    # @api private
+    #
+    def system(arguments)
+      return if Kernel.system(*arguments)
+      if block_given?
+        yield
+      else
+        fail 'System command failed!'
+      end
+    end
+
+    LOADER = Morpher.build do
+      s(:block,
+        s(:guard, s(:primitive, Array)),
+        s(:map,
+          s(:block,
+            s(:guard, s(:primitive, Hash)),
+            s(:hash_transform,
+              s(:key_symbolize, :repo_uri,            s(:guard, s(:primitive, String))),
+              s(:key_symbolize, :name,                s(:guard, s(:primitive, String))),
+              s(:key_symbolize, :namespace,           s(:guard, s(:primitive, String))),
+              s(:key_symbolize, :expect_coverage,     s(:guard, s(:primitive, Float))),
+              s(:key_symbolize, :mutation_coverage,
+                s(:guard, s(:or, s(:primitive, TrueClass), s(:primitive, FalseClass)))),
+              s(:key_symbolize, :mutation_generation,
+                s(:guard, s(:or, s(:primitive, TrueClass), s(:primitive, FalseClass)))),
+              s(:key_symbolize, :exclude,             s(:map, s(:guard, s(:primitive, String))))
+            ),
+            s(:load_attribute_hash,
+              # NOTE: The domain param has no DSL currently!
+              Morpher::Evaluator::Transformer::Domain::Param.new(
+                Project,
+                [:repo_uri, :name, :exclude, :mutation_coverage, :mutation_generation]
+              )
+            )
+          )
+        )
+      )
+    end
+
+    ALL = LOADER.call(YAML.load_file(ROOT.join('spec', 'integrations.yml')))
+  end # Project
+end # Corpus

data/spec/support/mutation_verifier.rb

@@ -1,5 +1,3 @@
-# encoding: UTF-8
-
 class MutationVerifier
   include Adamantium::Flat, Concord.new(:original_node, :expected, :generated)
 
@@ -28,7 +26,7 @@ class MutationVerifier
 
 private
 
-  # Return unexpected mutationso
+  # Return unexpected mutations
   #
   # @return [Array<Parser::AST::Node>]
   #
@@ -71,7 +69,7 @@ private
     ].join("\n")
   end
 
-  # Return missing mutationso
+  # Return missing mutations
   #
   # @return [Array<Parser::AST::Node>]
   #

data/spec/unit/mutant/cli_spec.rb

@@ -1,6 +1,4 @@
-require 'spec_helper'
-
-shared_examples_for 'an invalid cli run' do
+RSpec.shared_examples_for 'an invalid cli run' do
   it 'raises error' do
     expect do
       subject
@@ -8,13 +6,13 @@ shared_examples_for 'an invalid cli run' do
   end
 end
 
-shared_examples_for 'a cli parser' do
+RSpec.shared_examples_for 'a cli parser' do
   it { expect(subject.config.integration).to eql(expected_integration)       }
   it { expect(subject.config.reporter).to eql(expected_reporter)             }
   it { expect(subject.config.matcher_config).to eql(expected_matcher_config) }
 end
 
-describe Mutant::CLI do
+RSpec.describe Mutant::CLI do
   let(:object) { described_class }
 
   describe '.run' do
@@ -38,7 +36,7 @@ describe Mutant::CLI do
       end
     end
 
-    context 'when report signalls error' do
+    context 'when report signals error' do
       let(:report_success) { false }
 
       it 'exits failure' do
@@ -67,18 +65,16 @@ describe Mutant::CLI do
     subject { object.new(arguments) }
 
     # Defaults
-    let(:expected_filter)         { Morpher.evaluator(s(:true))        }
-    let(:expected_integration)    { Mutant::Integration::Null.new      }
-    let(:expected_reporter)       { Mutant::Reporter::CLI.new($stdout) }
-    let(:expected_matcher_config) { default_matcher_config             }
+    let(:expected_filter)         { Morpher.evaluator(s(:true))      }
+    let(:expected_integration)    { Mutant::Integration::Null.new    }
+    let(:expected_reporter)       { Mutant::Config::DEFAULT.reporter }
+    let(:expected_matcher_config) { default_matcher_config           }
 
     let(:default_matcher_config) do
       Mutant::Matcher::Config::DEFAULT
         .update(match_expressions: expressions.map(&Mutant::Expression.method(:parse)))
     end
 
-    let(:ns)    { Mutant::Matcher    }
-
     let(:flags)       { []           }
     let(:expressions) { %w[TestApp*] }
 
@@ -132,6 +128,7 @@ Environment:
         --zombie                     Run mutant zombified
     -I, --include DIRECTORY          Add DIRECTORY to $LOAD_PATH
     -r, --require NAME               Require file with NAME
+    -j, --jobs NUMBER                Number of kill processes. Defaults to number of processors.
 
 Options:
         --score COVERAGE             Fail unless COVERAGE is not reached exactly
@@ -161,7 +158,7 @@ Options:
 
       it_should_behave_like 'a cli parser'
 
-      let(:expected_integration) { Mutant::Integration::Rspec2.new }
+      let(:expected_integration) { Mutant::Integration::Rspec.build }
     end
 
     context 'with version flag' do
@@ -175,6 +172,16 @@ Options:
       it_should_behave_like 'a cli parser'
     end
 
+    context 'with jobs flag' do
+      let(:flags) { %w[--jobs 0] }
+
+      it_should_behave_like 'a cli parser'
+
+      it 'configures expected coverage' do
+        expect(subject.config.processes).to eql(0)
+      end
+    end
+
     context 'with score flag' do
       let(:flags) { %w[--score 99.5] }
 

data/spec/unit/mutant/context/root_spec.rb

@@ -1,6 +1,4 @@
-require 'spec_helper'
-
-describe Mutant::Context, '#root' do
+RSpec.describe Mutant::Context, '#root' do
   subject { object.root }
 
   let(:object) { described_class.allocate }

data/spec/unit/mutant/context/scope/root_spec.rb

@@ -1,6 +1,4 @@
-require 'spec_helper'
-
-describe Mutant::Context::Scope, '#root' do
+RSpec.describe Mutant::Context::Scope, '#root' do
   subject { object.root(node) }
 
   let(:object) { described_class.new(TestApp::Literal, path) }

data/spec/unit/mutant/context/scope/unqualified_name_spec.rb

@@ -1,6 +1,4 @@
-require 'spec_helper'
-
-describe Mutant::Context::Scope, '#unqualified_name' do
+RSpec.describe Mutant::Context::Scope, '#unqualified_name' do
   subject { object.unqualified_name }
 
   let(:path)   { double('Path') }