mutant 0.9.8 → 0.9.13

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

@@ -23,23 +23,57 @@ module Mutant
         class Memoized < self
           include AST::Sexp
 
+          FREEZER_OPTION_VALUES = {
+            Adamantium::Freezer::Deep => :deep,
+            Adamantium::Freezer::Flat => :flat,
+            Adamantium::Freezer::Noop => :noop
+          }.freeze
+
+          private_constant(*constants(false))
+
           # Prepare subject for mutation insertion
           #
           # @return [self]
           def prepare
-            scope.__send__(:memoized_methods).instance_variable_get(:@memory).delete(name)
+            memory.delete(name)
             super()
           end
 
         private
 
-          # Memoizer node for mutant
+          def wrap_node(mutant)
+            s(:begin, mutant, s(:send, nil, :memoize, s(:args, s(:sym, name), *options)))
+          end
+
+          # The optional AST node for adamantium memoization options
           #
-          # @param [Parser::AST::Node] mutant
+          # @return [Array(Parser::AST::Node), nil]
+          def options
+            # rubocop:disable Style/GuardClause
+            if FREEZER_OPTION_VALUES.key?(freezer)
+              [
+                s(:hash,
+                  s(:pair,
+                    s(:sym, :freezer),
+                    s(:sym, FREEZER_OPTION_VALUES.fetch(freezer))))
+              ]
+            end
+            # rubocop:enable Style/GuardClause
+          end
+
+          # The freezer used for memoization
           #
-          # @return [Parser::AST::Node]
-          def wrap_node(mutant)
-            s(:begin, mutant, s(:send, nil, :memoize, s(:args, s(:sym, name))))
+          # @return [Object]
+          def freezer
+            memory.fetch(name).instance_variable_get(:@freezer)
+          end
+          memoize :freezer, freezer: :noop
+
+          # The memory used for memoization
+          #
+          # @return [ThreadSafe::Cache]
+          def memory
+            scope.__send__(:memoized_methods).instance_variable_get(:@memory)
           end
 
         end # Memoized

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.13'
 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

data/lib/mutant/zombifier.rb

@@ -42,32 +42,20 @@ module Mutant
 
   private
 
-    # Original require method
+    attr_reader :original
+    private :original
     #
     # @return [Method]
-    attr_reader :original
 
-    # Run zombifier
-    #
-    # @return [undefined]
     def call
       @original = require_highjack.call(method(:require))
       require(root_require)
     end
 
-    # Test if logical name is subjected to zombification
-    #
-    # @param [String]
     def include?(logical_name)
       !@zombified.include?(logical_name) && includes =~ logical_name
     end
 
-    # Require file in zombie namespace
-    #
-    # @param [#to_s] logical_name
-    #
-    # @return [Bool]
-    #   true if successful and false if feature already loaded
     def require(logical_name)
       logical_name = logical_name.to_s
       loaded = original.call(logical_name)
@@ -77,14 +65,6 @@ module Mutant
       true
     end
 
-    # Find file by logical path
-    #
-    # @param [String] logical_name
-    #
-    # @return [File]
-    #
-    # @raise [LoadError]
-    #   otherwise
     def find(logical_name)
       file_name = "#{logical_name}.rb"
 
@@ -96,13 +76,6 @@ module Mutant
       fail LoadError, "Cannot find file #{file_name.inspect} in load path"
     end
 
-    # Zombify contents of file
-    #
-    # Probably the 2nd valid use of eval ever. (First one is inserting mutants!).
-    #
-    # @param [Pathname] source_path
-    #
-    # @return [undefined]
     def zombify(source_path)
       kernel.eval(
         Unparser.unparse(namespaced_node(source_path)),
@@ -111,11 +84,6 @@ module Mutant
       )
     end
 
-    # Namespaced root node
-    #
-    # @param [Pathname] source_path
-    #
-    # @return [Parser::AST::Node]
     def namespaced_node(source_path)
       s(:module, s(:const, nil, namespace), Unparser.parse(source_path.read))
     end