mutant 0.10.31 → 0.10.35

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ef901ceb41d6239377dac9b9c7c8cc908775e76f12dee66998087f3f6ef70a0
-  data.tar.gz: fc6b949b0bb8c8353cdab6186307daf67e5274faded923aaa8941dd0f5219de3
+  metadata.gz: b90188339d2ae50f1bc48723f56dc2740b6932a99cd8aae263543734aa66c494
+  data.tar.gz: dcd1e40f9dc9b37467ec067142da4f2c1c6351191de235b2a88237c16b6b936c
 SHA512:
-  metadata.gz: c05c611a7cc443e82d278fcaac02f1b43413b30dff81c602d468aea5256cb3389850c414f5415fbd6d7fa67aac035669c325edf3ffccaa915fa70cb03b8dbdc0
-  data.tar.gz: e171127271fc59b0d66a9050e9cb9398e5f0caecf13df14289e9acf1f7940cefa9b9760c051655c41090a5cb2235e18465b7dde72b4ed27ac21b80a745850cc0
+  metadata.gz: 323cc89a39fb5163c7778d5a9ae7e989e207c974436207803d91118c502e17219b47514573d24d2e9003043bb170744110e68c9fa8dc2201236566d1a2f701c7
+  data.tar.gz: 4f27f289f727c157237f65a15241b8adce8f91027894690994908eb698895a4c81f57344138e7c1a010454aee06776a41460f1ed37a4f164871b58e71291c1ca

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Mutant
+  module CLI
+    class Command
+      class Environment
+        class IRB < self
+          NAME              = 'irb'
+          SHORT_DESCRIPTION = 'Run irb with mutant environment loaded'
+          SUBCOMMANDS       = EMPTY_ARRAY
+
+        private
+
+          def action
+            bootstrap.fmap { TOPLEVEL_BINDING.irb }
+          end
+        end # IRB
+      end # Environment
+    end # Command
+  end # CLI
+end # Mutant

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

@@ -7,7 +7,7 @@ module Mutant
         class Run < self
           NAME              = 'run'
           SHORT_DESCRIPTION = 'Run code analysis'
-          SLEEP             = 40
+          SLEEP             = 60
           SUBCOMMANDS       = EMPTY_ARRAY
 
           UNLICENSED = <<~MESSAGE.lines.freeze
@@ -16,6 +16,20 @@ module Mutant
             See https://github.com/mbj/mutant#licensing
           MESSAGE
 
+          NO_TESTS_MESSAGE = <<~'MESSAGE'
+            ===============
+            Mutant found no tests. Mutation testing cannot be started.
+
+            This can have various reasons:
+
+            * You did not setup an integration, see:
+              https://github.com/mbj/mutant/blob/main/docs/configuration.md#integration
+            * You set environment variables like RSPEC_OPTS that filter out all tests.
+            * You set configuration optiosn like `config.filter_run :focus` which do
+              make rspec to not report any test.
+            ===============
+          MESSAGE
+
           # Test if command needs to be executed in zombie environment
           #
           # @return [Bool]
@@ -28,10 +42,19 @@ module Mutant
           def action
             soft_fail(License.call(world))
               .bind { bootstrap }
+              .bind(&method(:validate_tests))
               .bind(&Runner.public_method(:call))
               .bind(&method(:from_result))
           end
 
+          def validate_tests(environment)
+            if environment.integration.all_tests.length.zero?
+              Either::Left.new(NO_TESTS_MESSAGE)
+            else
+              Either::Right.new(environment)
+            end
+          end
+
           def from_result(result)
             if result.success?
               Either::Right.new(nil)

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

@@ -4,13 +4,13 @@ module Mutant
   module CLI
     class Command
       class Environment < self
-        SUBCOMMANDS = [Environment::Subject, Environment::Show, Environment::Test].freeze
+        SUBCOMMANDS = [Environment::Subject, Environment::Show, Environment::IRB, Environment::Test].freeze
       end # Environment
 
       class Root < self
         NAME              = 'mutant'
         SHORT_DESCRIPTION = 'mutation testing engine main command'
-        SUBCOMMANDS       = [Environment::Run, Environment, Subscription].freeze
+        SUBCOMMANDS       = [Environment::Run, Environment, Subscription, Util].freeze
       end # Root
     end # Command
   end # CLI

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

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Mutant
+  module CLI
+    class Command
+      class Util < self
+        NAME              = 'util'
+        SHORT_DESCRIPTION = 'Utility subcommands'
+
+        class Mutation < self
+          NAME              = 'mutation'
+          SHORT_DESCRIPTION = 'Print mutations of a code snippet'
+          SUBCOMMANDS       = [].freeze
+          OPTIONS           = %i[add_target_options].freeze
+
+          def action
+            @targets.each(&method(:print_mutations))
+            Either::Right.new(nil)
+          end
+
+        private
+
+          class Target
+            include Adamantium
+
+            def node
+              Unparser.parse(source)
+            end
+            memoize :node
+
+            class File < self
+              include Concord.new(:pathname, :source)
+
+              public :source
+
+              def identification
+                "file:#{pathname}"
+              end
+            end # File
+
+            class Source < self
+              include Concord::Public.new(:source)
+
+              def identification
+                '<cli-source>'
+              end
+            end # source
+          end # Target
+
+          def initialize(_arguments)
+            super
+
+            @targets = []
+          end
+
+          def add_target_options(parser)
+            parser.on('-e', '--evaluate SOURCE') do |source|
+              @targets << Target::Source.new(source)
+            end
+          end
+
+          def print_mutations(target)
+            world.stdout.puts(target.identification)
+            Mutator.mutate(target.node).each do |mutation|
+              Reporter::CLI::Printer::Mutation.call(
+                world.stdout,
+                Mutant::Mutation::Evil.new(target, mutation)
+              )
+            end
+          end
+
+          def parse_remaining_arguments(arguments)
+            @targets.concat(
+              arguments.map do |argument|
+                parse_pathname(argument)
+                  .bind(&method(:read_file))
+                  .from_right { |error| return Either::Left.new(error) }
+              end
+            )
+
+            Either::Right.new(self)
+          end
+
+          def read_file(pathname)
+            Either::Right.new(Target::File.new(pathname, pathname.read))
+          rescue StandardError => exception
+            Either::Left.new("Cannot read file: #{exception}")
+          end
+
+          def parse_pathname(input)
+            Either.wrap_error(ArgumentError) { Pathname.new(input) }
+              .lmap(&:message)
+          end
+        end # Mutation
+
+        SUBCOMMANDS = [Mutation].freeze
+      end # Util
+    end # Command
+  end # CLI
+end # Mutant

data/lib/mutant/cli/command.rb

@@ -69,6 +69,8 @@ module Mutant
         false
       end
 
+      abstract_method :action
+
     private
 
       def subcommands
@@ -128,6 +130,8 @@ module Mutant
       end
 
       def add_global_options(parser)
+        parser.separator("mutant version: #{VERSION}")
+        parser.separator(nil)
         parser.separator('Global Options:')
         parser.separator(nil)
 

data/lib/mutant/mutation.rb

@@ -72,6 +72,15 @@ module Mutant
       )
     end
 
+    # Rendered mutation diff
+    #
+    # @return [String, nil]
+    #   the diff, if present
+    def diff
+      Unparser::Diff.build(original_source, source)
+    end
+    memoize :diff
+
   private
 
     def sha1
@@ -80,7 +89,6 @@ module Mutant
 
     # Evil mutation that should case mutations to fail tests
     class Evil < self
-
       SYMBOL            = 'evil'
       TEST_PASS_SUCCESS = false
 

data/lib/mutant/mutator/node/binary.rb

@@ -21,8 +21,11 @@ module Mutant
           emit_singletons
           emit_promotions
           emit_operator_mutations
-          emit_left_negation
-          emit_left_mutations
+
+          emit_left_mutations do |mutation|
+            !(n_irange?(mutation) || n_erange?(mutation)) || !mutation.children.fetch(1).nil?
+          end
+
           emit_right_mutations
         end
 
@@ -35,10 +38,6 @@ module Mutant
           emit(right)
         end
 
-        def emit_left_negation
-          emit(s(node.type, n_not(left), right))
-        end
-
       end # Binary
     end # Node
   end # Mutator

data/lib/mutant/mutator/node/numblock.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Mutant
+  class Mutator
+    class Node
+      class Numblock < self
+
+        handle(:numblock)
+
+        children :receiver, :count, :block
+
+      private
+
+        def dispatch
+          emit_nil
+          emit_receiver_mutations(&method(:n_send?))
+        end
+      end # Numblock
+    end # Node
+  end # Mutator
+end # Mutant

data/lib/mutant/parallel/worker.rb

@@ -29,9 +29,6 @@ module Mutant
         response = Pipe.from_io(io)
 
         pid = process.fork do
-          request.reset_binmode
-          response.reset_binmode
-
           world.thread.current.name = process_name
           world.process.setproctitle(process_name)
 

data/lib/mutant/pipe.rb

@@ -35,18 +35,6 @@ module Mutant
       reader
     end
 
-    # Set binmode (again)
-    #
-    # Ruby has a bug where the binmode setting may be lost duringa fork.
-    # This API allows to set the binmode again.
-    #
-    # @return [self]
-    def reset_binmode
-      reader.binmode
-      writer.binmode
-      self
-    end
-
     class Connection
       include Anima.new(:marshal, :reader, :writer)
 
@@ -69,6 +57,7 @@ module Mutant
 
           fail Error, 'message to big' if bytesize > MAX_BYTES
 
+          io.binmode
           io.write([bytesize].pack(HEADER_FORMAT))
           io.write(body)
         end
@@ -76,6 +65,7 @@ module Mutant
       private
 
         def read(bytes)
+          io.binmode
           io.read(bytes) or fail Error, 'Unexpected EOF'
         end
       end

data/lib/mutant/reporter/cli/printer/mutation.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Mutant
+  class Reporter
+    class CLI
+      class Printer
+        # Reporter for mutations
+        class Mutation < self
+          NO_DIFF_MESSAGE = <<~'MESSAGE'
+            --- Internal failure ---
+            BUG: A generated mutation did not result in exactly one diff hunk!
+            This is an invariant violation by the mutation generation engine.
+            Please report a reproduction to https://github.com/mbj/mutant
+            Original unparsed source:
+            %s
+            Original AST:
+            %s
+            Mutated unparsed source:
+            %s
+            Mutated AST:
+            %s
+          MESSAGE
+
+          SEPARATOR = '-----------------------'
+
+          # Run report printer
+          #
+          # @return [undefined]
+          def run
+            diff = object.diff
+            diff = color? ? diff.colorized_diff : diff.diff
+
+            if diff
+              output.write(diff)
+            else
+              print_no_diff_message
+            end
+          end
+
+          def print_no_diff_message
+            info(
+              NO_DIFF_MESSAGE,
+              object.original_source,
+              original_node.inspect,
+              object.source,
+              object.node.inspect
+            )
+          end
+
+          def original_node
+            object.subject.node
+          end
+
+        end # MutationResult
+      end # Printer
+    end # CLI
+  end # Reporter
+end # Mutant

data/lib/mutant/reporter/cli/printer/mutation_result.rb

@@ -27,7 +27,7 @@ module Mutant
 
           NO_DIFF_MESSAGE = <<~'MESSAGE'
             --- Internal failure ---
-            BUG: A generted mutation did not result in exactly one diff hunk!
+            BUG: A generated mutation did not result in exactly one diff hunk!
             This is an invariant violation by the mutation generation engine.
             Please report a reproduction to https://github.com/mbj/mutant
             Original unparsed source:
@@ -66,23 +66,7 @@ module Mutant
           end
 
           def evil_details
-            diff = Unparser::Diff.build(mutation.original_source, mutation.source)
-            diff = color? ? diff.colorized_diff : diff.diff
-            if diff
-              output.write(diff)
-            else
-              print_no_diff_message
-            end
-          end
-
-          def print_no_diff_message
-            info(
-              NO_DIFF_MESSAGE,
-              mutation.original_source,
-              original_node.inspect,
-              mutation.source,
-              mutation.node.inspect
-            )
+            visit(Mutation, mutation)
           end
 
           def noop_details
@@ -90,11 +74,7 @@ module Mutant
           end
 
           def neutral_details
-            info(NEUTRAL_MESSAGE, original_node.inspect, mutation.source)
-          end
-
-          def original_node
-            mutation.subject.node
+            info(NEUTRAL_MESSAGE, mutation.node.inspect, mutation.source)
           end
 
         end # MutationResult

data/lib/mutant/version.rb

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

data/lib/mutant.rb

@@ -4,6 +4,7 @@ require 'diff/lcs'
 require 'diff/lcs/hunk'
 require 'digest/sha1'
 require 'etc'
+require 'irb'
 require 'json'
 require 'open3'
 require 'optparse'
@@ -152,6 +153,7 @@ require 'mutant/mutator/node/match_current_line'
 require 'mutant/mutator/node/index'
 require 'mutant/mutator/node/procarg_zero'
 require 'mutant/mutator/node/kwargs'
+require 'mutant/mutator/node/numblock'
 require 'mutant/loader'
 require 'mutant/context'
 require 'mutant/scope'
@@ -193,10 +195,12 @@ require 'mutant/cli'
 require 'mutant/cli/command'
 require 'mutant/cli/command/subscription'
 require 'mutant/cli/command/environment'
+require 'mutant/cli/command/environment/irb'
 require 'mutant/cli/command/environment/run'
 require 'mutant/cli/command/environment/show'
 require 'mutant/cli/command/environment/subject'
 require 'mutant/cli/command/environment/test'
+require 'mutant/cli/command/util'
 require 'mutant/cli/command/root'
 require 'mutant/runner'
 require 'mutant/runner/sink'
@@ -212,6 +216,7 @@ 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'
 require 'mutant/reporter/cli/printer/mutation_result'
 require 'mutant/reporter/cli/printer/status_progressive'
 require 'mutant/reporter/cli/printer/subject_result'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mutant
 version: !ruby/object:Gem::Version
-  version: 0.10.31
+  version: 0.10.35
 platform: ruby
 authors:
 - Markus Schirp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-03 00:00:00.000000000 Z
+date: 2021-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs
@@ -180,12 +180,14 @@ files:
 - lib/mutant/cli.rb
 - lib/mutant/cli/command.rb
 - lib/mutant/cli/command/environment.rb
+- lib/mutant/cli/command/environment/irb.rb
 - lib/mutant/cli/command/environment/run.rb
 - lib/mutant/cli/command/environment/show.rb
 - lib/mutant/cli/command/environment/subject.rb
 - lib/mutant/cli/command/environment/test.rb
 - lib/mutant/cli/command/root.rb
 - lib/mutant/cli/command/subscription.rb
+- lib/mutant/cli/command/util.rb
 - lib/mutant/config.rb
 - lib/mutant/config/coverage_criteria.rb
 - lib/mutant/context.rb
@@ -268,6 +270,7 @@ files:
 - lib/mutant/mutator/node/next.rb
 - lib/mutant/mutator/node/noop.rb
 - lib/mutant/mutator/node/nthref.rb
+- lib/mutant/mutator/node/numblock.rb
 - lib/mutant/mutator/node/op_asgn.rb
 - lib/mutant/mutator/node/or_asgn.rb
 - lib/mutant/mutator/node/procarg_zero.rb
@@ -316,6 +319,7 @@ files:
 - lib/mutant/reporter/cli/printer/env_progress.rb
 - lib/mutant/reporter/cli/printer/env_result.rb
 - lib/mutant/reporter/cli/printer/isolation_result.rb
+- lib/mutant/reporter/cli/printer/mutation.rb
 - lib/mutant/reporter/cli/printer/mutation_result.rb
 - lib/mutant/reporter/cli/printer/status_progressive.rb
 - lib/mutant/reporter/cli/printer/subject_result.rb
@@ -357,14 +361,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
 summary: ''