mutant 0.10.32 → 0.10.33

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b12eb31fc385dfce5e13bfb8341ac87efea9f8cb6e26531c584477e8eda2a73
-  data.tar.gz: 576c9eb28548bec20da7818589f110c56f4ffb230af11914bca2bed27c0f8b1a
+  metadata.gz: 2c20fb3fdc41f7d6e0f8164916206353716c037ec596fccccd06db10c05e810c
+  data.tar.gz: 276612decdc11bf06de38e704fed0d6dc3b9b0b590d9e2f333be7ae383396ca0
 SHA512:
-  metadata.gz: 0c8a3ae71a2e8f1d82a11a0793c89e47a61cc5169025e0081801bf3211aadf5aadb84c23ea220077ae10746fb35ae6095f3d64969ba751ec1d766575cacc78ae
-  data.tar.gz: 118ee4f62eea31fe0ae3a616e6abf9ede75b03b7095af0bc9e75082c55ad199c9bb143677007411b3409bbfec47d37db73c7ec0716424b8dbc86b64eac2b005a
+  metadata.gz: 652ac4959565f27514568c25c43a0ab64d3af74f9f9de50712bf6e6e825dcf44d27e55e40ff76f0e7c91e27c4199c4f67a0d2205f2268eefae5acc338e2aecb5
+  data.tar.gz: a7e9b023ffefb0d3da5a13d7ec83fbb6696a10efe0f8840b867e8f6e788a55e7d2eabd077173957a697e9f0689ce109fec5d8668078946e317f7c9c4b7216614

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

@@ -10,7 +10,7 @@ module Mutant
       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

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/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 generted 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

@@ -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.32'
+  VERSION = '0.10.33'
 end # Mutant

data/lib/mutant.rb

@@ -197,6 +197,7 @@ 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 +213,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.32
+  version: 0.10.33
 platform: ruby
 authors:
 - Markus Schirp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-16 00:00:00.000000000 Z
+date: 2021-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs
@@ -186,6 +186,7 @@ files:
 - 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
@@ -316,6 +317,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
@@ -364,7 +366,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
 summary: ''