mutant 0.10.6 → 0.10.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b5a7d1620b6792fa1cef90ead01124cf50287a165a0bdd415fbc9aab9ecfde8
-  data.tar.gz: 758609938988d4d8de30a6f95a47c603fc4d5365ba98ad1a113a6de11f8e074f
+  metadata.gz: f812d15b5c09f8681cc6c75eb01bd00fffe412bc53397b9e13c29c7cad69db9a
+  data.tar.gz: 45c24afcbfbef29a50b90b81946e75391c58ecea7ac32b9545a5e7fdc22fd063
 SHA512:
-  metadata.gz: 3ecd6aea62e2d01cb68cc9c9c651190305459b7f1b796f4360ce872ce0dbb1871cb40821744d1c09a029a80f39a93cbda9a242591ceae405e47ed971d3d861f9
-  data.tar.gz: '09e132e435163308309c0185abdd39ea9b6be0d2bd0efa0956049c366f0b521df866a3b7fd04d2e13550bd4f2b09993c659530f86b00142adff69ebc14af3a16'
+  metadata.gz: fcb16a15ec71fe5dc51d07e08b426e8dc68e2f4bad2bd47f95a19b136cd06dbefdc9be44f4a7e0723b8a9450b4b924ab2744f8be05b09fbf1d6e9774431f2e97
+  data.tar.gz: b9213ce07ce70908f072b23d92bd86c86492ed8f348ae2c7419ed625989a36b7b2d1e110048e14364e044790e7e086894c124f081043d989844de02adcc81684

data/lib/mutant.rb

@@ -167,8 +167,10 @@ require 'mutant/world'
 require 'mutant/config'
 require 'mutant/cli'
 require 'mutant/cli/command'
-require 'mutant/cli/command/run'
 require 'mutant/cli/command/subscription'
+require 'mutant/cli/command/environment'
+require 'mutant/cli/command/environment/run'
+require 'mutant/cli/command/environment/show'
 require 'mutant/cli/command/root'
 require 'mutant/runner'
 require 'mutant/runner/sink'
@@ -179,16 +181,14 @@ require 'mutant/reporter/sequence'
 require 'mutant/reporter/cli'
 require 'mutant/reporter/cli/printer'
 require 'mutant/reporter/cli/printer/config'
+require 'mutant/reporter/cli/printer/coverage_result'
 require 'mutant/reporter/cli/printer/env'
 require 'mutant/reporter/cli/printer/env_progress'
 require 'mutant/reporter/cli/printer/env_result'
 require 'mutant/reporter/cli/printer/isolation_result'
-require 'mutant/reporter/cli/printer/mutation_progress_result'
 require 'mutant/reporter/cli/printer/mutation_result'
 require 'mutant/reporter/cli/printer/status_progressive'
-require 'mutant/reporter/cli/printer/subject_progress'
 require 'mutant/reporter/cli/printer/subject_result'
-require 'mutant/reporter/cli/printer/test_result'
 require 'mutant/reporter/cli/format'
 require 'mutant/repository'
 require 'mutant/repository/diff'
@@ -219,12 +219,14 @@ module Mutant
     stderr:             $stderr,
     stdout:             $stdout,
     thread:             Thread,
+    timer:              Timer.new(Process),
     warnings:           Warnings.new(Warning)
   )
 
   # Reopen class to initialize constant to avoid dep circle
   class Config
     DEFAULT = new(
+      coverage_criteria: Config::CoverageCriteria::DEFAULT,
       expression_parser: Expression::Parser.new([
         Expression::Method,
         Expression::Methods,
@@ -237,6 +239,7 @@ module Mutant
       isolation:         Mutant::Isolation::Fork.new(WORLD),
       jobs:              nil,
       matcher:           Matcher::Config::DEFAULT,
+      mutation_timeout:  nil,
       reporter:          Reporter::CLI.build(WORLD.stdout),
       requires:          EMPTY_ARRAY,
       zombie:            false

data/lib/mutant/cli/command.rb

@@ -66,7 +66,7 @@ module Mutant
       #
       # @return [Bool]
       def zombie?
-        instance_of?(Run)
+        false
       end
 
     private

data/lib/mutant/cli/command/{run.rb → environment.rb}

@@ -3,10 +3,9 @@
 module Mutant
   module CLI
     class Command
-      # rubocop:disable Metrics/ClassLength
-      class Run < self
-        NAME              = 'run'
-        SHORT_DESCRIPTION = 'Run code analysis'
+      class Environment < self
+        NAME              = 'environment'
+        SHORT_DESCRIPTION = 'Environment subcommands'
 
         OPTIONS =
           %i[
@@ -16,57 +15,21 @@ module Mutant
             add_matcher_options
           ].freeze
 
-        SLEEP = 40
-
-        UNLICENSED = <<~MESSAGE.lines.freeze
-          Soft fail, continuing in #{SLEEP} seconds
-          Next major version will enforce the license
-          See https://github.com/mbj/mutant#licensing
-        MESSAGE
-
-        # Test if command needs to be executed in zombie environment
-        #
-        # @return [Bool]
-        def zombie?
-          @config.zombie
-        end
-
       private
 
         def initialize(attributes)
           super(attributes)
-          @config = Config::DEFAULT
+          @config = Config.env
         end
 
-        def execute
-          soft_fail(License.apply(world))
-            .bind { Config.load_config_file(world) }
+        def bootstrap
+          Config.load_config_file(world)
             .fmap(&method(:expand))
             .bind { Bootstrap.apply(world, @config) }
-            .bind(&Runner.public_method(:apply))
-            .from_right { |error| world.stderr.puts(error); return false }
-            .success?
         end
 
         def expand(file_config)
-          @config = Config.env.merge(file_config).merge(@config)
-        end
-
-        def soft_fail(result)
-          result.either(
-            lambda do |message|
-              stderr = world.stderr
-              stderr.puts(message)
-              UNLICENSED.each { |line| stderr.puts(unlicensed(line)) }
-              world.kernel.sleep(SLEEP)
-              Either::Right.new(nil)
-            end,
-            ->(_subscription) { Either::Right.new(nil) }
-          )
-        end
-
-        def unlicensed(message)
-          "[Mutant-License-Error]: #{message}"
+          @config = file_config.merge(@config)
         end
 
         def parse_remaining_arguments(arguments)
@@ -153,9 +116,11 @@ module Mutant
           parser.on('-j', '--jobs NUMBER', 'Number of kill jobs. Defaults to number of processors.') do |number|
             set(jobs: Integer(number))
           end
+          parser.on('-t', '--mutation-timeout NUMBER', 'Per mutation analysis timeout') do |number|
+            set(mutation_timeout: Float(number))
+          end
         end
       end # Run
-      # rubocop:enable Metrics/ClassLength
     end # Command
   end # CLI
 end # Mutant

data/lib/mutant/cli/command/environment/run.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Mutant
+  module CLI
+    class Command
+      class Environment
+        class Run < self
+          NAME              = 'run'
+          SHORT_DESCRIPTION = 'Run code analysis'
+          SLEEP             = 40
+          SUBCOMMANDS       = EMPTY_ARRAY
+
+          UNLICENSED = <<~MESSAGE.lines.freeze
+            Soft fail, continuing in #{SLEEP} seconds
+            Next major version will enforce the license
+            See https://github.com/mbj/mutant#licensing
+          MESSAGE
+
+          # Test if command needs to be executed in zombie environment
+          #
+          # @return [Bool]
+          def zombie?
+            @config.zombie
+          end
+
+        private
+
+          def execute
+            soft_fail(License.apply(world))
+              .bind { bootstrap }
+              .bind(&Runner.public_method(:apply))
+              .from_right { |error| world.stderr.puts(error); return false }
+              .success?
+          end
+
+          def soft_fail(result)
+            result.either(
+              lambda do |message|
+                stderr = world.stderr
+                stderr.puts(message)
+                UNLICENSED.each { |line| stderr.puts(unlicensed(line)) }
+                world.kernel.sleep(SLEEP)
+                Either::Right.new(nil)
+              end,
+              ->(_subscription) { Either::Right.new(nil) }
+            )
+          end
+
+          def unlicensed(message)
+            "[Mutant-License-Error]: #{message}"
+          end
+        end # Run
+      end # Environment
+    end # Command
+  end # CLI
+end # Mutant

data/lib/mutant/cli/command/environment/show.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Mutant
+  module CLI
+    class Command
+      class Environment
+        class Show < self
+          NAME              = 'show'
+          SHORT_DESCRIPTION = 'Display environment without coverage analysis'
+          SUBCOMMANDS       = EMPTY_ARRAY
+
+        private
+
+          def execute
+            Config.load_config_file(world)
+              .fmap(&method(:expand))
+              .bind { Bootstrap.apply(world, @config) }
+              .fmap(&method(:report_env))
+              .right?
+          end
+
+          def report_env(env)
+            env.config.reporter.start(env)
+          end
+        end # Show
+      end # Environment
+    end # Command
+  end # CLI
+end # Mutant

data/lib/mutant/cli/command/root.rb

@@ -3,11 +3,15 @@
 module Mutant
   module CLI
     class Command
+      class Environment < self
+        SUBCOMMANDS = [Environment::Show].freeze
+      end # Environment
+
       class Root < self
-        SUBCOMMANDS       = [Run, Subscription].freeze
-        SHORT_DESCRIPTION = 'mutation testing engine main command'
         NAME              = 'mutant'
-      end
+        SHORT_DESCRIPTION = 'mutation testing engine main command'
+        SUBCOMMANDS       = [Environment::Run, Environment, Subscription].freeze
+      end # Root
     end # Command
   end # CLI
 end # Mutant

data/lib/mutant/config.rb

@@ -7,6 +7,7 @@ module Mutant
   # to current environment is being represented by the Mutant::Env object.
   class Config
     include Adamantium::Flat, Anima.new(
+      :coverage_criteria,
       :expression_parser,
       :fail_fast,
       :includes,
@@ -14,6 +15,7 @@ module Mutant
       :isolation,
       :jobs,
       :matcher,
+      :mutation_timeout,
       :reporter,
       :requires,
       :zombie
@@ -23,30 +25,6 @@ module Mutant
       define_method(:"#{name}?") { public_send(name) }
     end
 
-    boolean = Transform::Boolean.new
-    integer = Transform::Primitive.new(Integer)
-    string  = Transform::Primitive.new(String)
-
-    string_array = Transform::Array.new(string)
-
-    TRANSFORM = Transform::Sequence.new(
-      [
-        Transform::Exception.new(SystemCallError, :read.to_proc),
-        Transform::Exception.new(YAML::SyntaxError, YAML.method(:safe_load)),
-        Transform::Hash.new(
-          optional: [
-            Transform::Hash::Key.new('fail_fast',   boolean),
-            Transform::Hash::Key.new('includes',    string_array),
-            Transform::Hash::Key.new('integration', string),
-            Transform::Hash::Key.new('jobs',        integer),
-            Transform::Hash::Key.new('requires',    string_array)
-          ],
-          required: []
-        ),
-        Transform::Hash::Symbolize.new
-      ]
-    )
-
     MORE_THAN_ONE_CONFIG_FILE = <<~'MESSAGE'
       Found more than one candidate for use as implicit config file: %s
     MESSAGE
@@ -57,6 +35,34 @@ module Mutant
       mutant.yml
     ].freeze
 
+    private_constant(*constants(false))
+
+    class CoverageCriteria
+      include Anima.new(:process_abort, :test_result, :timeout)
+
+      DEFAULT = new(
+        process_abort: false,
+        test_result:   true,
+        timeout:       false
+      )
+
+      TRANSFORM =
+        Transform::Sequence.new(
+          [
+            Transform::Hash.new(
+              optional: [
+                Transform::Hash::Key.new('process_abort', Transform::BOOLEAN),
+                Transform::Hash::Key.new('test_result',   Transform::BOOLEAN),
+                Transform::Hash::Key.new('timeout',       Transform::BOOLEAN)
+              ],
+              required: []
+            ),
+            Transform::Hash::Symbolize.new,
+            ->(value) { Either::Right.new(DEFAULT.with(**value)) }
+          ]
+        )
+    end # CoverageCriteria
+
     # Merge with other config
     #
     # @param [Config] other
@@ -64,18 +70,17 @@ module Mutant
     # @return [Config]
     def merge(other)
       other.with(
-        fail_fast:   fail_fast || other.fail_fast,
-        includes:    includes + other.includes,
-        jobs:        other.jobs || jobs,
-        integration: other.integration || integration,
-        matcher:     matcher.merge(other.matcher),
-        requires:    requires + other.requires,
-        zombie:      zombie || other.zombie
+        fail_fast:        fail_fast || other.fail_fast,
+        includes:         includes + other.includes,
+        jobs:             other.jobs || jobs,
+        integration:      other.integration || integration,
+        mutation_timeout: other.mutation_timeout || mutation_timeout,
+        matcher:          matcher.merge(other.matcher),
+        requires:         requires + other.requires,
+        zombie:           zombie || other.zombie
       )
     end
 
-    private_constant(*constants(false))
-
     # Load config file
     #
     # @param [World] world
@@ -98,7 +103,7 @@ module Mutant
     def self.load_contents(path)
       Transform::Named
         .new(path.to_s, TRANSFORM)
-        .apply(path)
+        .call(path)
         .lmap(&:compact_message)
     end
     private_class_method :load_contents
@@ -109,5 +114,27 @@ module Mutant
     def self.env
       DEFAULT.with(jobs: Etc.nprocessors)
     end
+
+    TRANSFORM = Transform::Sequence.new(
+      [
+        Transform::Exception.new(SystemCallError, :read.to_proc),
+        Transform::Exception.new(YAML::SyntaxError, YAML.method(:safe_load)),
+        Transform::Hash.new(
+          optional: [
+            Transform::Hash::Key.new('coverage_criteria', CoverageCriteria::TRANSFORM),
+            Transform::Hash::Key.new('fail_fast',         Transform::BOOLEAN),
+            Transform::Hash::Key.new('includes',          Transform::STRING_ARRAY),
+            Transform::Hash::Key.new('integration',       Transform::STRING),
+            Transform::Hash::Key.new('jobs',              Transform::INTEGER),
+            Transform::Hash::Key.new('mutation_timeout',  Transform::FLOAT),
+            Transform::Hash::Key.new('requires',          Transform::STRING_ARRAY)
+          ],
+          required: []
+        ),
+        Transform::Hash::Symbolize.new
+      ]
+    )
+
+    private_constant(:TRANSFORM)
   end # Config
 end # Mutant

data/lib/mutant/env.rb

@@ -24,10 +24,15 @@ module Mutant
     # @param [Config] config
     #
     # @return [Env]
+    #
+    # rubocop:disable Metrics/MethodLength
     def self.empty(world, config)
       new(
         config:           config,
-        integration:      Integration::Null.new(config),
+        integration:      Integration::Null.new(
+          expression_parser: config.expression_parser,
+          timer:             world.timer
+        ),
         matchable_scopes: EMPTY_ARRAY,
         mutations:        EMPTY_ARRAY,
         parser:           Parser.new,
@@ -36,6 +41,7 @@ module Mutant
         world:            world
       )
     end
+    # rubocop:enable Metrics/MethodLength
 
     # Kill mutation
     #
@@ -43,14 +49,14 @@ module Mutant
     #
     # @return [Result::Mutation]
     def kill(mutation)
-      start = Timer.now
+      start = timer.now
 
       tests = selections.fetch(mutation.subject)
 
       Result::Mutation.new(
         isolation_result: run_mutation_tests(mutation, tests),
         mutation:         mutation,
-        runtime:          Timer.now - start
+        runtime:          timer.now - start
       )
     end
 
@@ -127,7 +133,7 @@ module Mutant
   private
 
     def run_mutation_tests(mutation, tests)
-      config.isolation.call do
+      config.isolation.call(config.mutation_timeout) do
         result = mutation.insert(world.kernel)
 
         if result.equal?(Loader::Result::VoidValue.instance)
@@ -138,5 +144,9 @@ module Mutant
       end
     end
 
+    def timer
+      world.timer
+    end
+
   end # Env
 end # Mutant