mutant 0.9.8 → 0.9.9

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

@@ -35,18 +35,10 @@ module Mutant
 
         private
 
-          # Object being printed
-          #
-          # @return [Result::Env]
           def object
             super().payload
           end
 
-          # Mutations processed per second
-          #
-          # @return [Float]
-          #
-          # @api private
           def mutations_per_second
             amount_mutation_results / runtime
           end

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

@@ -32,9 +32,6 @@ module Mutant
 
         private
 
-          # Print stats
-          #
-          # @return [undefined]
           def print_stats
             status(
               FORMAT,
@@ -47,16 +44,10 @@ module Mutant
             )
           end
 
-          # Print progress bar finish
-          #
-          # @return [undefined]
           def print_progress_bar_finish
             puts(nil) unless amount_mutation_results.zero?
           end
 
-          # Print mutation results
-          #
-          # @return [undefined]
           def print_mutation_results
             visit_collection(MutationProgressResult, object.mutation_results)
           end

data/lib/mutant/repository/diff.rb

@@ -29,10 +29,6 @@ module Mutant
 
     private
 
-      # Touched paths
-      #
-      # @return [Hash{Pathname => Path}]
-      #
       # rubocop:disable Metrics/MethodLength
       def touched_paths
         pathname = world.pathname
@@ -49,13 +45,8 @@ module Mutant
           .to_h
       end
       memoize :touched_paths
+      # rubocop:enable Metrics/MethodLength
 
-      # Parse path
-      #
-      # @param [Pathname] work_dir
-      # @param [String] line
-      #
-      # @return [Path]
       def parse_line(work_dir, line)
         match = FORMAT.match(line) or fail Error, "Invalid git diff-index line: #{line}"
 
@@ -88,9 +79,6 @@ module Mutant
 
       private
 
-        # Ranges of hunks in the diff
-        #
-        # @return [Array<Range<Integer>>]
         def diff_ranges
           world
             .capture_stdout(%W[git diff --unified=0 #{to} -- #{path}])

data/lib/mutant/repository/diff/ranges.rb

@@ -18,11 +18,6 @@ module Mutant
           diff.lines.flat_map(&method(:parse_ranges)).to_set
         end
 
-        # Parse ranges from line
-        #
-        # @param [String] line
-        #
-        # @return [Array<Range<Integer>>]
         def self.parse_ranges(line)
           match = REGEXP.match(line) or return EMPTY_ARRAY
 
@@ -34,12 +29,6 @@ module Mutant
         end
         private_class_method :parse_ranges
 
-        # Construct a range from start point and offset
-        #
-        # @param [String] start
-        # @param [String, nil] offset
-        #
-        # @return [Range<Integer>]
         def self.mk_range(start, offset)
           start = Integer(start)
 

data/lib/mutant/result.rb

@@ -193,9 +193,6 @@ module Mutant
 
     private
 
-      # Killed mutation results
-      #
-      # @return [Array<Result::Mutation>]
       def killed_mutation_results
         mutation_results.select(&:success?)
       end

data/lib/mutant/runner.rb

@@ -12,9 +12,6 @@ module Mutant
       Either::Right.new(run_mutation_analysis(env))
     end
 
-    # Run mutation analysis
-    #
-    # @return [undefined]
     def self.run_mutation_analysis(env)
       reporter = reporter(env)
 
@@ -27,13 +24,6 @@ module Mutant
     end
     private_class_method :run_mutation_analysis
 
-    # Run driver
-    #
-    # @param [Reporter] reporter
-    # @param [Driver] driver
-    #
-    # @return [Object]
-    #   the last returned status payload
     def self.run_driver(reporter, driver)
       loop do
         status = driver.wait_timeout(reporter.delay)
@@ -43,9 +33,6 @@ module Mutant
     end
     private_class_method :run_driver
 
-    # Configuration for parallel execution engine
-    #
-    # @return [Parallell::Config]
     def self.mutation_test_config(env)
       world = env.world
 
@@ -61,11 +48,6 @@ module Mutant
     end
     private_class_method :mutation_test_config
 
-    # Reporter to use
-    #
-    # @param [Env] env
-    #
-    # @return [Reporter]
     def self.reporter(env)
       env.config.reporter
     end

data/lib/mutant/runner/sink.rb

@@ -51,11 +51,6 @@ module Mutant
 
     private
 
-      # Return previous results
-      #
-      # @param [Subject]
-      #
-      # @return [Array<Result::Mutation>]
       def previous_mutation_results(subject)
         subject_result = @subject_results.fetch(subject) { return EMPTY_ARRAY }
         subject_result.mutation_results

data/lib/mutant/subject.rb

@@ -79,18 +79,10 @@ module Mutant
 
   private
 
-    # Neutral mutation
-    #
-    # @return [Mutation::Neutral]
     def neutral_mutation
       Mutation::Neutral.new(self, wrap_node(node))
     end
 
-    # Wrap node into subject specific container
-    #
-    # @param [Parser::AST::Node] node
-    #
-    # @return [Parser::AST::Node]
     def wrap_node(node)
       node
     end

data/lib/mutant/subject/method.rb

@@ -34,9 +34,6 @@ module Mutant
 
     private
 
-      # The scope
-      #
-      # @return [Class, Module]
       def scope
         context.scope
       end

data/lib/mutant/subject/method/instance.rb

@@ -33,11 +33,6 @@ module Mutant
 
         private
 
-          # Memoizer node for mutant
-          #
-          # @param [Parser::AST::Node] mutant
-          #
-          # @return [Parser::AST::Node]
           def wrap_node(mutant)
             s(:begin, mutant, s(:send, nil, :memoize, s(:args, s(:sym, name))))
           end

data/lib/mutant/subject/method/metaclass.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Mutant
+  class Subject
+    class Method
+      # Singleton method defined using metaclass syntax
+      # (class << self; def foo; end; end)
+      class Metaclass < self
+        include AST::Sexp
+
+        NAME_INDEX = 0
+        SYMBOL     = '.'
+
+        # Prepare subject for mutation insertion
+        #
+        # @return [self]
+        def prepare
+          scope.singleton_class.public_send(:undef_method, name)
+          self
+        end
+
+      private
+
+        def wrap_node(mutant)
+          s(:sclass, AST::Nodes::N_SELF, mutant)
+        end
+      end # Metaclass
+    end # Method
+  end # Subject
+end # Mutant

data/lib/mutant/transform.rb

@@ -49,9 +49,6 @@ module Mutant
 
     private
 
-      # Path representation to error
-      #
-      # @return [String]
       def path
         trace.map { |error| error.transform.slug }.reject(&:empty?).join('/')
       end
@@ -78,23 +75,6 @@ module Mutant
 
   private
 
-    # Make error from curent context
-    #
-    # @param [Error, nil] cause
-    #   original error, if any
-    #
-    # @param [Object] input
-    #   input that ran into the error
-    #
-    # @param [String] message
-    #   human readable error message
-    #
-    # @param [Transform, nil]
-    #   transform that generated the error from input
-    #
-    # @return [Error]
-    #
-    # ignore :reek:LongParameterList
     def error(cause: nil, input:, message: nil)
       Error.new(
         cause:     cause,
@@ -104,42 +84,18 @@ module Mutant
       )
     end
 
-    # Lift error
-    #
-    # @param [Error]
-    #
-    # @return [Error]
     def lift_error(error)
       error.with(transform: self)
     end
 
-    # Wrap error
-    #
-    # @param [Error]
-    #
-    # @return [Error]
     def wrap_error(error)
       error(cause: error, input: error.input)
     end
 
-    # Create failure
-    #
-    # @param [Object] value
-    #
-    # @return [Either::Left]
-    #
-    # ignore :reek:UtilityFunction
     def failure(value)
       Either::Left.new(value)
     end
 
-    # Create success
-    #
-    # @param [Object] value
-    #
-    # @return [Either::Right]
-    #
-    # ignore :reek:UtilityFunction
     def success(value)
       Either::Right.new(value)
     end
@@ -268,14 +224,6 @@ module Mutant
 
     private
 
-      # Transform array
-      #
-      # @param [Array<Object>] input
-      #
-      # @return [Either<Error, Array<Object>]
-      #
-      # ignore :reek:NestedIterators
-      #
       # rubocop:disable Metrics/MethodLength
       def run(input)
         output = []
@@ -357,31 +305,16 @@ module Mutant
 
     private
 
-      # Transform hash
-      #
-      # @param [Hash] input
-      #
-      # @return [Either<Error, Hash>]
       def transform(input)
         transform_required(input).bind do |required|
           transform_optional(input).fmap(&required.method(:merge))
         end
       end
 
-      # Transform required keys
-      #
-      # @param [Hash] input
-      #
-      # @return [Either<Error, Hash>]
       def transform_required(input)
         transform_keys(required, input)
       end
 
-      # Transform optional keys
-      #
-      # @param [Hash] input
-      #
-      # @return [Either<Error, Hash>]
       def transform_optional(input)
         transform_keys(
           optional.select { |key| input.key?(key.value) },
@@ -389,13 +322,6 @@ module Mutant
         )
       end
 
-      # Transform keys
-      #
-      # @param [Array<Transform::Hash::Key>] keys
-      # @param [Hash] input
-      #
-      # @return [Either<Error, Hash>]
-      #
       # ignore :reek:NestedIterators
       #
       # rubocop:disable Metrics/MethodLength
@@ -415,24 +341,12 @@ module Mutant
       end
       # rubocop:enable Metrics/MethodLength
 
-      # Coerce key value under key specific transformer
-      #
-      # @param [Hash::Key] key
-      # @param [Hash] input
-      #
-      # @return [Either<Error, Object>]
       def coerce_key(key, input)
         key.apply(input.fetch(key.value)).lmap do |error|
           error(input: input, cause: error)
         end
       end
 
-      # Reject unexpected keys
-      #
-      # @param [Hash]
-      #
-      # @return [Either<Error, Object>]
-      #
       # rubocop:disable Metrics/MethodLength
       def reject_keys(input)
         keys       = input.keys
@@ -452,17 +366,11 @@ module Mutant
       end
       # rubocop:enable Metrics/MethodLength
 
-      # Key values allowed to be present
-      #
-      # @return [Array<Object>]
       def allowed_keys
         required_keys + optional.map(&:value)
       end
       memoize :allowed_keys
 
-      # Key values required to be present
-      #
-      # @return [Array<Object>]
       def required_keys
         required.map(&:value)
       end

data/lib/mutant/version.rb

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

data/lib/mutant/warnings.rb

@@ -92,9 +92,6 @@ module Mutant
 
   private
 
-    # Hook called when capturing a warning
-    #
-    # @return [undefined]
     def capture(*arguments)
       if @disabled
         @original.call(*arguments)
@@ -103,9 +100,6 @@ module Mutant
       end
     end
 
-    # Assert warnings capture does not call itself
-    #
-    # Its currently not supported nor intended to be supported.
     def assert_no_recursion
       fail RecursiveUseError unless @disabled
     end