mutant 0.10.7 → 0.10.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: defe26105634d28a81b10e876713ab4e29a53a5d78ac8fe7e2d8a44d32b644c6
-  data.tar.gz: fad9645931798ed165a249e8e8d4a1c032896ceba6b823a1464ff2f60a7cadbb
+  metadata.gz: 4c573735f4e77ea0dd9313412e82bbca47771e8fd379c5d53393e855248b7792
+  data.tar.gz: 7c59c273789c9fb3d85dd858a7ed7d6bec85b8440ad05736f70541325d214947
 SHA512:
-  metadata.gz: 79da9f75f18510bbf81e43e2b98e43c4b92ddf2e6cb68b66828f9f4240f7d3e8747d6e475130f83a2d1edec8c1dda43a34f48524bd7439372e545a046099c28d
-  data.tar.gz: 7d8aac2776eca84aff051b7a146863bb271c5df4ec7dc344f041d3a22a17b4d87f9f48d5201e2dceec30f548adc7135d443ee78bc00764a9399fb677f2cf0aa5
+  metadata.gz: ff3a349908f6f3f83ace0ce4de9555b981f6a82515954e635a7539b2d8852d9bfa740a2c33afd2b3b49a34e0358920be9d0c22b8c05c2903356d75b9c4a4ccc6
+  data.tar.gz: 2b3cc3f947b50bc407c8c5a3239ad5bbddf2ff2adc773e661f8279d650297accaad05cdcdbce5e64ae04e419dd63740e0de493542f44464bb5d7d7ee60ab37c1

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'

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.env
+          @config = Config::DEFAULT
         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.merge(file_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 = Config.env.merge(file_config).merge(@config)
         end
 
         def parse_remaining_arguments(arguments)
@@ -158,7 +121,6 @@ module Mutant
           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

@@ -38,11 +38,12 @@ module Mutant
     private_constant(*constants(false))
 
     class CoverageCriteria
-      include Anima.new(:timeout, :test_result)
+      include Anima.new(:process_abort, :test_result, :timeout)
 
       DEFAULT = new(
-        timeout:     false,
-        test_result: true
+        process_abort: false,
+        test_result:   true,
+        timeout:       false
       )
 
       TRANSFORM =
@@ -50,8 +51,9 @@ module Mutant
           [
             Transform::Hash.new(
               optional: [
-                Transform::Hash::Key.new('timeout',     Transform::BOOLEAN),
-                Transform::Hash::Key.new('test_result', Transform::BOOLEAN)
+                Transform::Hash::Key.new('process_abort', Transform::BOOLEAN),
+                Transform::Hash::Key.new('test_result',   Transform::BOOLEAN),
+                Transform::Hash::Key.new('timeout',       Transform::BOOLEAN)
               ],
               required: []
             ),
@@ -69,12 +71,12 @@ module Mutant
     def merge(other)
       other.with(
         fail_fast:        fail_fast || other.fail_fast,
-        includes:         other.includes + includes,
+        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:         other.requires + requires,
+        requires:         requires + other.requires,
         zombie:           zombie || other.zombie
       )
     end

data/lib/mutant/integration.rb

@@ -19,6 +19,11 @@ module Mutant
       The integration is supposed to define %<constant_name>s!
     MESSAGE
 
+    INTEGRATION_MISSING = <<~'MESSAGE'
+      No test framework integration configured.
+      See https://github.com/mbj/mutant/blob/master/docs/configuration.md#integration
+    MESSAGE
+
     private_constant(*constants(false))
 
     # Setup integration
@@ -27,6 +32,10 @@ module Mutant
     #
     # @return [Either<String, Integration>]
     def self.setup(env)
+      unless env.config.integration
+        return Either::Left.new(INTEGRATION_MISSING)
+      end
+
       attempt_require(env).bind { attempt_const_get(env) }.fmap do |klass|
         klass.new(
           expression_parser: env.config.expression_parser,

data/lib/mutant/license.rb

@@ -3,7 +3,7 @@
 module Mutant
   module License
     NAME    = 'mutant-license'
-    VERSION = '~> 0.1.0'
+    VERSION = ['>= 0.1', '< 0.3'].freeze
 
     # Load license
     #
@@ -20,7 +20,7 @@ module Mutant
 
     def self.load_mutant_license(world)
       Either
-        .wrap_error(LoadError) { world.gem_method.call(NAME, VERSION) }
+        .wrap_error(LoadError) { world.gem_method.call(NAME, *VERSION) }
         .lmap(&:message)
         .lmap(&method(:check_for_rubygems_mutant_license))
     end

data/lib/mutant/meta.rb

@@ -17,8 +17,7 @@ module Mutant
       #
       # @return [undefined]
       def self.add(*types, &block)
-        file = caller.first.split(':in', 2).first
-        ALL << DSL.call(file, Set.new(types), block)
+        ALL << DSL.call(caller_locations(1).first, Set.new(types), block)
       end
 
       Pathname.glob(Pathname.new(__dir__).parent.parent.join('meta', '*.rb'))

data/lib/mutant/meta/example.rb

@@ -3,10 +3,11 @@
 module Mutant
   module Meta
     class Example
-      include Adamantium
+      include Adamantium::Flat
+
       include Anima.new(
         :expected,
-        :file,
+        :location,
         :lvars,
         :node,
         :original_source,
@@ -25,6 +26,23 @@ module Mutant
       end
       memoize :verification
 
+      # Example identification
+      #
+      # @return [String]
+      def identification
+        location.to_s
+      end
+
+      # Context of mutation
+      #
+      # @return [Context]
+      def context
+        Context.new(
+          Object,
+          location.path
+        )
+      end
+
       # Original source as generated by unparser
       #
       # @return [String]

data/lib/mutant/meta/example/dsl.rb

@@ -9,12 +9,12 @@ module Mutant
 
         # Run DSL on block
         #
-        # @param [Pathname] file
+        # @param [Thread::Backtrace::Location] location
         # @param [Set<Symbol>] types
         #
         # @return [Example]
-        def self.call(file, types, block)
-          instance = new(file, types)
+        def self.call(location, types, block)
+          instance = new(location, types)
           instance.instance_eval(&block)
           instance.example
         end
@@ -24,12 +24,12 @@ module Mutant
         # Initialize object
         #
         # @return [undefined]
-        def initialize(file, types)
-          @expected = []
-          @file     = file
-          @lvars    = []
-          @source   = nil
-          @types    = types
+        def initialize(location, types)
+          @expected    = []
+          @location    = location
+          @lvars       = []
+          @source      = nil
+          @types       = types
         end
 
         # Example captured by DSL
@@ -40,9 +40,10 @@ module Mutant
         #   in case example cannot be build
         def example
           fail 'source not defined' unless @source
+
           Example.new(
             expected:        @expected,
-            file:            @file,
+            location:        @location,
             lvars:           @lvars,
             node:            @node,
             original_source: @source,

data/lib/mutant/meta/example/verification.rb

@@ -28,7 +28,7 @@ module Mutant
       private
 
         def reports
-          reports = [example.file]
+          reports = [example.location]
           reports.concat(original)
           reports.concat(original_verification)
           reports.concat(make_report('Missing mutations:', missing))
@@ -94,7 +94,7 @@ module Mutant
 
         def missing
           (example.expected.map(&:node) - mutations.map(&:node)).map do |node|
-            Mutation::Evil.new(nil, node)
+            Mutation::Evil.new(example, node)
           end
         end
         memoize :missing

data/lib/mutant/mutation.rb

@@ -9,37 +9,34 @@ module Mutant
     CODE_DELIMITER = "\0"
     CODE_RANGE     = (0..4).freeze
 
-    # Identification string
-    #
-    # @return [String]
-    def identification
-      "#{self.class::SYMBOL}:#{subject.identification}:#{code}"
+    def initialize(subject, node)
+      super(subject, node)
+
+      @source         = Unparser.unparse(node)
+      @code           = sha1[CODE_RANGE]
+      @identification = "#{self.class::SYMBOL}:#{subject.identification}:#{code}"
+      @monkeypatch    = Unparser.unparse(subject.context.root(node))
     end
-    memoize :identification
 
-    # Mutation code
+    # Mutation identification code
     #
     # @return [String]
-    def code
-      sha1[CODE_RANGE]
-    end
-    memoize :code
+    attr_reader :code
 
     # Normalized mutation source
     #
     # @return [String]
-    def source
-      Unparser.unparse(node)
-    end
-    memoize :source
+    attr_reader :source
+
+    # Identification string
+    #
+    # @return [String]
+    attr_reader :identification
 
     # The monkeypatch to insert the mutation
     #
     # @return [String]
-    def monkeypatch
-      Unparser.unparse(subject.context.root(node))
-    end
-    memoize :monkeypatch
+    attr_reader :monkeypatch
 
     # Normalized original source
     #
@@ -77,7 +74,6 @@ module Mutant
     def sha1
       Digest::SHA1.hexdigest(subject.identification + CODE_DELIMITER + source)
     end
-    memoize :sha1
 
     # Evil mutation that should case mutations to fail tests
     class Evil < self

data/lib/mutant/result.rb

@@ -233,7 +233,7 @@ module Mutant
       #
       # @return [Boolean]
       def success?
-        test_result || timeout
+        process_abort || test_result || timeout
       end
     end
 
@@ -250,8 +250,9 @@ module Mutant
       # @praam [Result::CoverageCriteria]
       def criteria_result(coverage_criteria)
         CoverageCriteria.new(
-          test_result: coverage_criteria.test_result && test_result_success?,
-          timeout:     coverage_criteria.timeout     && timeout?
+          process_abort: coverage_criteria.process_abort && process_abort?,
+          test_result:   coverage_criteria.test_result   && test_result_success?,
+          timeout:       coverage_criteria.timeout       && timeout?
         )
       end
 
@@ -269,6 +270,15 @@ module Mutant
         !isolation_result.timeout.nil?
       end
 
+      # Test for unexpected process abort
+      #
+      # @return [Boolean]
+      def process_abort?
+        process_status = isolation_result.process_status or return false
+
+        !timeout? && !process_status.exited?
+      end
+
     private
 
       # Test if mutation was handled successfully

data/lib/mutant/version.rb

@@ -2,5 +2,5 @@
 
 module Mutant
   # Current mutant version
-  VERSION = '0.10.7'
+  VERSION = '0.10.12'
 end # Mutant

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mutant
 version: !ruby/object:Gem::Version
-  version: 0.10.7
+  version: 0.10.12
 platform: ruby
 authors:
 - Markus Schirp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-11-22 00:00:00.000000000 Z
+date: 2020-12-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: abstract_type
@@ -304,8 +304,10 @@ files:
 - lib/mutant/bootstrap.rb
 - lib/mutant/cli.rb
 - lib/mutant/cli/command.rb
+- lib/mutant/cli/command/environment.rb
+- lib/mutant/cli/command/environment/run.rb
+- lib/mutant/cli/command/environment/show.rb
 - lib/mutant/cli/command/root.rb
-- lib/mutant/cli/command/run.rb
 - lib/mutant/cli/command/subscription.rb
 - lib/mutant/config.rb
 - lib/mutant/context.rb