mutant 0.10.8 → 0.10.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8448aecff5544038b0427224ef0e14c8957fcb1fb90a6ab223855a364a7de67
-  data.tar.gz: b27549faf5c9e9f610500fb48b8af63b68eedfc58ba84e600bbb120069c31b57
+  metadata.gz: 561ad5a2483b3678f3bbcd3ab1ddbef3259f589548b59f3f42e993b76e50e120
+  data.tar.gz: dd3b79cbeb3bca13e502b9c43cbb59d2d3656e0f37905d5cbb33ac1e1ac98fb1
 SHA512:
-  metadata.gz: 2f845db6418eaecf71e45e076cec52bdeaf57bd40ea4c55e5f0b3d5ec51e95cd26cf1e7f299ce756fbd9450b86a18453f69ac16e40d10f1ec374173d0e95f0af
-  data.tar.gz: f30e34bd368f29e124dedf212ebab64ecf75d807fd9c9a8b4a466e03b2e1bf8eb6b995cf54f6c4103ddabdc6902d62ff61af0a44058a6f6ab66ee7eb8fb08fd1
+  metadata.gz: 8d314dfd39fba6e6becf5d3410df2b6c95f94a5861df6446cb804b058edcad4d8b4a6ed98a6a21f4cfed3af48a450a17a3579b9b39e6814a60c4f10d746f77f9
+  data.tar.gz: 1ef113b288fca26803593efe136e2c8e49002eb6f33722373eaacf0276078ac6ac4624139c10636498cf2e9c5eec8c64512b08796833380f457e5f1497bcab61

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'
@@ -224,7 +226,7 @@ module Mutant
   # Reopen class to initialize constant to avoid dep circle
   class Config
     DEFAULT = new(
-      coverage_criteria: Config::CoverageCriteria::DEFAULT,
+      coverage_criteria: Config::CoverageCriteria::EMPTY,
       expression_parser: Expression::Parser.new([
         Expression::Method,
         Expression::Methods,

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).expand_defaults
         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

@@ -40,6 +40,12 @@ module Mutant
     class CoverageCriteria
       include Anima.new(:process_abort, :test_result, :timeout)
 
+      EMPTY = new(
+        process_abort: nil,
+        test_result:   nil,
+        timeout:       nil
+      )
+
       DEFAULT = new(
         process_abort: false,
         test_result:   true,
@@ -61,6 +67,22 @@ module Mutant
             ->(value) { Either::Right.new(DEFAULT.with(**value)) }
           ]
         )
+
+      def merge(other)
+        self.class.new(
+          process_abort: overwrite(other, :process_abort),
+          test_result:   overwrite(other, :test_result),
+          timeout:       overwrite(other, :timeout)
+        )
+      end
+
+    private
+
+      def overwrite(other, attribute_name)
+        other_value = other.public_send(attribute_name)
+
+        other_value.nil? ? public_send(attribute_name) : other_value
+      end
     end # CoverageCriteria
 
     # Merge with other config
@@ -68,18 +90,24 @@ module Mutant
     # @param [Config] other
     #
     # @return [Config]
+    #
+    # rubocop:disable Metrics/AbcSize
+    # rubocop:disable Metrics/MethodLength
     def merge(other)
       other.with(
-        fail_fast:        fail_fast || other.fail_fast,
-        includes:         other.includes + 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,
-        zombie:           zombie || other.zombie
+        coverage_criteria: coverage_criteria.merge(other.coverage_criteria),
+        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
+    # rubocop:enable Metrics/AbcSize
+    # rubocop:enable Metrics/MethodLength
 
     # Load config file
     #
@@ -100,6 +128,16 @@ module Mutant
       end
     end
 
+    # Expand config with defaults
+    #
+    # @return [Config]
+    def expand_defaults
+      with(
+        coverage_criteria: CoverageCriteria::DEFAULT.merge(coverage_criteria),
+        jobs:              jobs || 1
+      )
+    end
+
     def self.load_contents(path)
       Transform::Named
         .new(path.to_s, TRANSFORM)

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/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mutant
 version: !ruby/object:Gem::Version
-  version: 0.10.8
+  version: 0.10.13
 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