mutant 0.9.10 → 0.10.0

data/lib/mutant/matcher/config.rb

@@ -7,6 +7,7 @@ module Mutant
       include Adamantium, Anima.new(
         :ignore_expressions,
         :match_expressions,
+        :start_expressions,
         :subject_filters
       )
 
@@ -18,6 +19,7 @@ module Mutant
       PRESENTATIONS       = IceNine.deep_freeze(
         ignore_expressions: :syntax,
         match_expressions:  :syntax,
+        start_expressions:  :syntax,
         subject_filters:    :inspect
       )
       private_constant(*constants(false))

data/lib/mutant/meta/example.rb

@@ -3,7 +3,19 @@
 module Mutant
   module Meta
     class Example
-      include Adamantium, Anima.new(:file, :node, :types, :expected)
+      include Adamantium
+      include Anima.new(
+        :expected,
+        :file,
+        :lvars,
+        :node,
+        :original_source,
+        :types
+      )
+
+      class Expected
+        include Anima.new(:original_source, :node)
+      end
 
       # Verification instance for example
       #
@@ -13,13 +25,13 @@ module Mutant
       end
       memoize :verification
 
-      # Normalized source
+      # Original source as generated by unparser
       #
       # @return [String]
-      def source
+      def original_source_generated
         Unparser.unparse(node)
       end
-      memoize :source
+      memoize :original_source_generated
 
       # Generated mutations on example source
       #

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

@@ -25,10 +25,11 @@ module Mutant
         #
         # @return [undefined]
         def initialize(file, types)
+          @expected = []
           @file     = file
+          @lvars    = []
+          @source   = nil
           @types    = types
-          @node     = nil
-          @expected = []
         end
 
         # Example captured by DSL
@@ -38,28 +39,41 @@ module Mutant
         # @raise [RuntimeError]
         #   in case example cannot be build
         def example
-          fail 'source not defined' unless @node
+          fail 'source not defined' unless @source
           Example.new(
-            file:     @file,
-            node:     @node,
-            types:    @types,
-            expected: @expected
+            expected:        @expected,
+            file:            @file,
+            lvars:           @lvars,
+            node:            @node,
+            original_source: @source,
+            types:           @types
           )
         end
 
+        # Declare a local variable
+        #
+        # @param [Symbol]
+        def declare_lvar(name)
+          @lvars << name
+        end
+
       private
 
         def source(input)
-          fail 'source already defined' if @node
-          @node = node(input)
+          fail 'source already defined' if @source
+
+          @source = input
+          @node   = node(input)
         end
 
         def mutation(input)
-          node = node(input)
-          if @expected.include?(node)
+          expected = Expected.new(original_source: input, node: node(input))
+
+          if @expected.include?(expected)
             fail "Mutation for input: #{input.inspect} is already expected"
           end
-          @expected << node
+
+          @expected << expected
         end
 
         def singleton_mutations
@@ -70,14 +84,17 @@ module Mutant
         def node(input)
           case input
           when String
-            Unparser::Preprocessor.run(Unparser.parse(input))
-          when ::Parser::AST::Node
-            input
+            parser.parse(Unparser.buffer(input))
           else
-            fail "Cannot coerce to node: #{input.inspect}"
+            fail "Unsupported input: #{input.inspect}"
           end
         end
 
+        def parser
+          Unparser.parser.tap do |parser|
+            @lvars.each(&parser.static_env.public_method(:declare))
+          end
+        end
       end # DSL
     end # Example
   end # Meta

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

@@ -11,54 +11,96 @@ module Mutant
         #
         # @return [Boolean]
         def success?
-          [missing, unexpected, no_diffs, invalid_syntax].all?(&:empty?)
+          [
+            original_verification,
+            invalid,
+            missing,
+            no_diffs,
+            unexpected
+          ].all?(&:empty?)
         end
         memoize :success?
 
-        # Error report
-        #
-        # @return [String]
         def error_report
-          fail 'no error report on successful validation' if success?
-
-          YAML.dump(
-            'file'            => example.file,
-            'original_ast'    => example.node.inspect,
-            'original_source' => example.source,
-            'missing'         => format_mutations(missing),
-            'unexpected'      => format_mutations(unexpected),
-            'invalid_syntax'  => format_mutations(invalid_syntax),
-            'no_diff'         => no_diff_report
-          )
+          reports.join("\n")
         end
-        memoize :error_report
 
       private
 
+        def reports
+          reports = [example.file]
+          reports.concat(original)
+          reports.concat(original_verification)
+          reports.concat(make_report('Missing mutations:', missing))
+          reports.concat(make_report('Unexpected mutations:', unexpected))
+          reports.concat(make_report('No-Diff mutations:', no_diffs))
+          reports.concat(invalid)
+        end
+
+        def make_report(label, mutations)
+          if mutations.any?
+            [label, mutations.map(&method(:report_mutation))]
+          else
+            []
+          end
+        end
+
+        def report_mutation(mutation)
+          [
+            mutation.node.inspect,
+            mutation.source
+          ]
+        end
+
+        def original
+          [
+            'Original:',
+            example.node,
+            example.original_source
+          ]
+        end
+
+        def original_verification
+          validation = Unparser::Validation.from_string(example.original_source)
+          if validation.success?
+            []
+          else
+            [
+              prefix('[original]', validation.report)
+            ]
+          end
+        end
+
+        def prefix(prefix, string)
+          string.each_line.map do |line|
+            "#{prefix} #{line}"
+          end.join
+        end
+
+        def invalid
+          mutations.each_with_object([]) do |mutation, aggregate|
+            validation = Unparser::Validation.from_node(mutation.node)
+            aggregate << prefix('[invalid-mutation]', validation.report) unless validation.success?
+          end
+        end
+        memoize :invalid
+
         def unexpected
           mutations.reject do |mutation|
-            example.expected.include?(mutation.node)
+            example.expected.any? { |expected| expected.node.eql?(mutation.node) }
           end
         end
         memoize :unexpected
 
         def missing
-          (example.expected - mutations.map(&:node)).map do |node|
-            Mutation::Evil.new(self, node)
+          (example.expected.map(&:node) - mutations.map(&:node)).map do |node|
+            Mutation::Evil.new(nil, node)
           end
         end
         memoize :missing
 
-        def invalid_syntax
-          mutations.reject do |mutation|
-            ::Parser::CurrentRuby.parse(mutation.source)
-          rescue ::Parser::SyntaxError # rubocop:disable Lint/SuppressedException
-          end
-        end
-        memoize :invalid_syntax
-
         def no_diffs
-          mutations.select { |mutation| mutation.source.eql?(example.source) }
+          mutations.select { |mutation| mutation.source.eql?(example.original_source_generated) }
         end
         memoize :no_diffs
 

data/lib/mutant/minitest/coverage.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'minitest'
+
+module Mutant
+  module Minitest
+    module Coverage
+      # Setup coverage declaration for current class
+      #
+      # @param [String]
+      #
+      # @example
+      #
+      #   class MyTest < MiniTest::Test
+      #     cover 'MyCode*'
+      #
+      #     def test_some_stuff
+      #     end
+      #   end
+      #
+      # @api public
+      def cover(expression)
+        if defined?(@cover_expression)
+          fail "#{self} already declares to cover: #{@cover_expression.inspect}"
+        end
+
+        @cover_expression = expression
+      end
+
+      # Effective coverage expression
+      #
+      # @return [String, nil]
+      #
+      # @api private
+      def resolve_cover_expression
+        return @cover_expression if defined?(@cover_expression)
+
+        try_superclass_cover_expression
+      end
+
+    private
+
+      def try_superclass_cover_expression
+        return if superclass.equal?(::Minitest::Runnable)
+
+        superclass.resolve_cover_expression
+      end
+
+    end # Coverage
+  end # Minitest
+end # Mutant
+
+Minitest::Test.extend(Mutant::Minitest::Coverage)

data/lib/mutant/mutator/node.rb

@@ -75,7 +75,7 @@ module Mutant
       end
 
       def emit_nil
-        emit(N_NIL) unless left_assignment?
+        emit(N_NIL) unless left_op_assignment?
       end
 
       def parent_node
@@ -86,7 +86,7 @@ module Mutant
         parent_node&.type
       end
 
-      def left_assignment?
+      def left_op_assignment?
         AST::Types::OP_ASSIGN.include?(parent_type) && parent.node.children.first.equal?(node)
       end
 

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Mutant
+  class Mutator
+    class Node
+      class BlockPass < self
+
+        handle(:block_pass)
+
+        children :argument
+
+      private
+
+        def dispatch
+          emit_argument_mutations
+          emit_symbol_to_proc_mutations
+        end
+
+        def emit_symbol_to_proc_mutations
+          return unless n_sym?(argument)
+
+          Send::SELECTOR_REPLACEMENTS.fetch(*argument, EMPTY_ARRAY).each do |method|
+            emit_argument(s(:sym, method))
+          end
+        end
+      end # Block
+    end # Node
+  end # Mutator
+end # Mutant

data/lib/mutant/mutator/node/{dstr.rb → dynamic_literal.rb}

@@ -3,17 +3,19 @@
 module Mutant
   class Mutator
     class Node
+      # Mutator for dynamic literals
+      class DynamicLiteral < self
 
-      # Dstr mutator
-      class Dstr < Generic
-
-        handle(:dstr)
+        handle(:dstr, :dsym)
 
       private
 
         def dispatch
-          super()
           emit_singletons
+
+          children.each_index do |index|
+            mutate_child(index, &method(:n_begin?))
+          end
         end
 
       end # Dstr

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

@@ -24,7 +24,7 @@ module Mutant
         end
 
         def emit_send_forms
-          return if left_assignment?
+          return if left_op_assignment?
 
           SEND_REPLACEMENTS.each do |selector|
             emit(s(:send, receiver, selector, *indices))
@@ -43,7 +43,7 @@ module Mutant
 
         def mutate_indices
           children_indices(index_range).each do |index|
-            emit_propagation(children.fetch(index)) unless left_assignment?
+            emit_propagation(children.fetch(index)) unless left_op_assignment?
             delete_child(index)
             mutate_child(index)
           end
@@ -77,7 +77,7 @@ module Mutant
           def dispatch
             super()
 
-            return if left_assignment?
+            return if left_op_assignment?
 
             emit_index_read
             emit(children.last)
@@ -89,7 +89,7 @@ module Mutant
           end
 
           def index_range
-            if left_assignment?
+            if left_op_assignment?
               NO_VALUE_RANGE
             else
               REGULAR_RANGE

data/lib/mutant/mutator/node/literal/range.rb

@@ -21,9 +21,12 @@ module Mutant
 
           def dispatch
             emit_singletons
-            emit_inverse
             emit_lower_bound_mutations
-            emit_upper_bound_mutations if upper_bound
+
+            return unless upper_bound
+
+            emit_inverse
+            emit_upper_bound_mutations
           end
 
           def emit_inverse

data/lib/mutant/mutator/node/named_value/variable_assignment.rb

@@ -18,7 +18,7 @@ module Mutant
           }
 
           MAP = IceNine.deep_freeze(
-            Hash[map.map { |type, prefix| [type, [prefix, /^#{::Regexp.escape(prefix)}/]] }]
+            map.transform_values { |prefix| [prefix, /^#{::Regexp.escape(prefix)}/] }
           )
 
           handle(*MAP.keys)