mutant 0.8.0 → 0.8.1

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

@@ -15,7 +15,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_singletons
           return unless value

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

@@ -24,6 +24,8 @@ module Mutant
           to_s:          %i[to_str],
           to_i:          %i[to_int],
           to_a:          %i[to_ary],
+          at:            %i[fetch],
+          :[] =>         %i[at fetch],
           :== =>         %i[eql? equal?],
           :>= =>         %i[> == eql? equal?],
           :<= =>         %i[< == eql? equal?],
@@ -38,7 +40,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_singletons
           if meta.index_assignment?
@@ -53,24 +54,31 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def non_index_dispatch
-          case
-          when meta.binary_method_operator?
+          if meta.binary_method_operator?
             run(Binary)
-          when meta.attribute_assignment?
+          elsif meta.attribute_assignment?
             run(AttributeAssignment)
           else
             normal_dispatch
           end
         end
 
-        # Return arguments
+        # AST metadata for node
         #
-        # @return [Enumerable<Parser::AST::Node>]
+        # @return [AST::Meta::Send]
         #
         # @api private
+        def meta
+          AST::Meta::Send.new(node)
+        end
+        memoize :meta
+
+        # Arguments being send
+        #
+        # @return [Enumerable<Parser::AST::Node>]
         #
+        # @api private
         alias_method :arguments, :remaining_children
 
         # Perform normal, non special case dispatch
@@ -78,7 +86,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def normal_dispatch
           emit_naked_receiver
           emit_selector_replacement
@@ -92,11 +99,8 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_selector_replacement
-          SELECTOR_REPLACEMENTS.fetch(selector, EMPTY_ARRAY).each do |replacement|
-            emit_selector(replacement)
-          end
+          SELECTOR_REPLACEMENTS.fetch(selector, EMPTY_ARRAY).each(&method(:emit_selector))
         end
 
         # Emit naked receiver mutation
@@ -104,7 +108,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_naked_receiver
           emit(receiver) if receiver && !NOT_ASSIGNABLE.include?(receiver.type)
         end
@@ -114,7 +117,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def mutate_arguments
           emit_type(receiver, selector)
           remaining_children_with_index.each do |_node, index|
@@ -128,7 +130,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_argument_propagation
           node = arguments.first
           emit(node) if arguments.one? && !NOT_STANDALONE.include?(node.type)
@@ -139,7 +140,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def mutate_receiver
           return unless receiver
           emit_implicit_self
@@ -153,7 +153,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_implicit_self
           emit_receiver(nil) if n_self?(receiver) && !(
             KEYWORDS.include?(selector)         ||

data/lib/mutant/mutator/node/send/attribute_assignment.rb

@@ -12,7 +12,6 @@ module Mutant
           # @return [undefined]
           #
           # @api private
-          #
           def dispatch
             normal_dispatch
             emit_attribute_read
@@ -23,7 +22,6 @@ module Mutant
           # @return [undefined]
           #
           # @api private
-          #
           def mutate_arguments
             remaining_children_indices.each do |index|
               mutate_child(index)
@@ -35,7 +33,6 @@ module Mutant
           # @return [undefined]
           #
           # @api private
-          #
           def emit_attribute_read
             emit_type(receiver, selector.to_s[0..-2].to_sym)
           end

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

@@ -15,7 +15,6 @@ module Mutant
           # @return [undefined]
           #
           # @api private
-          #
           def dispatch
             emit(left)
             emit_left_mutations

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

@@ -19,7 +19,6 @@ module Mutant
             # @return [undefined]
             #
             # @api private
-            #
             def dispatch
               emit_naked_receiver
               emit_value_mutations
@@ -33,7 +32,6 @@ module Mutant
             # @return [undefined]
             #
             # @api private
-            #
             def mutate_indices
               children_indices(INDEX_RANGE).each do |index|
                 delete_child(index)
@@ -46,7 +44,6 @@ module Mutant
             # @return [undefined]
             #
             # @api private
-            #
             def emit_index_read
               emit_type(receiver, :[], *children[INDEX_RANGE])
             end

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

@@ -15,7 +15,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_singletons
           emit_expression_mutations

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

@@ -14,7 +14,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_singletons
           emit(N_ZSUPER)

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

@@ -14,7 +14,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           if body
             mutate_body
@@ -29,7 +28,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def mutate_conditions
           conditions = children.length - 1
           children[0..-2].each_index do |index|
@@ -43,12 +41,11 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def mutate_body
           mutate_child(body_index)
         end
 
-        # Return body node
+        # Body node
         #
         # @return [Parser::AST::Node]
         #   if body is present
@@ -57,17 +54,15 @@ module Mutant
         #   otherwise
         #
         # @api private
-        #
         def body
           children[body_index]
         end
 
-        # Return body index
+        # Index of body node
         #
         # @return [Fixnum]
         #
         # @api private
-        #
         def body_index
           children.length - 1
         end

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

@@ -14,7 +14,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           super
           emit_singletons

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

@@ -14,7 +14,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_singletons
         end

data/lib/mutant/mutator/registry.rb

@@ -8,7 +8,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def initialize
         @registry = {}
       end
@@ -21,10 +20,9 @@ module Mutant
       # @param [Symbol] type
       # @param [Class:Mutator] mutator
       #
-      # @api private
-      #
       # @return [self]
       #
+      # @api private
       def register(type, mutator)
         fail RegistryError, "Invalid type registration: #{type}" unless AST::Types::ALL.include?(type)
         fail RegistryError, "Duplicate type registration: #{type}" if @registry.key?(type)
@@ -42,7 +40,6 @@ module Mutant
       #   raises argument error when mutator class cannot be found
       #
       # @api private
-      #
       def lookup(node)
         type = node.type
         @registry.fetch(type) do

data/lib/mutant/mutator/util.rb

@@ -15,7 +15,6 @@ module Mutant
       #   otherwise
       #
       # @api private
-      #
       def self.each(object, parent, &block)
         return to_enum(__method__, object, parent) unless block_given?
 
@@ -33,7 +32,6 @@ module Mutant
       # @return [Boolean]
       #
       # @api private
-      #
       def new?(generated)
         !input.eql?(generated)
       end

data/lib/mutant/mutator/util/array.rb

@@ -15,7 +15,6 @@ module Mutant
           # @return [undefined]
           #
           # @api private
-          #
           def dispatch
             input.each_index do |index|
               dup = dup_input
@@ -36,7 +35,6 @@ module Mutant
           # @return [undefined]
           #
           # @api private
-          #
           def dispatch
             input.each_with_index do |element, index|
               Mutator.each(element).each do |mutation|
@@ -56,7 +54,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           run(Element)
           run(Presence)

data/lib/mutant/mutator/util/symbol.rb

@@ -14,7 +14,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit((input.to_s + POSTFIX).to_sym)
         end

data/lib/mutant/parallel.rb

@@ -1,17 +1,16 @@
 module Mutant
-  # Parallel excecution engine of arbitrary payloads
+  # Parallel execution engine of arbitrary payloads
   module Parallel
 
     # Driver for parallelized execution
     class Driver
       include Concord.new(:binding)
 
-      # Return scheduler status
+      # Scheduler status
       #
       # @return [Object]
       #
       # @api private
-      #
       def status
         binding.call(__method__)
       end
@@ -21,7 +20,6 @@ module Mutant
       # @return [self]
       #
       # @api private
-      #
       def stop
         binding.call(__method__)
         self
@@ -33,7 +31,6 @@ module Mutant
     # @return [Driver]
     #
     # @api private
-    #
     def self.async(config)
       Driver.new(config.env.new_mailbox.bind(Master.call(config)))
     end
@@ -49,15 +46,13 @@ module Mutant
       # @return [self]
       #
       # @api private
-      #
       abstract_method :result
 
-      # Return status
+      # Sink status
       #
       # @return [Object]
       #
       # @api private
-      #
       abstract_method :status
 
       # Test if processing should stop
@@ -65,7 +60,6 @@ module Mutant
       # @return [Boolean]
       #
       # @api private
-      #
       abstract_method :stop?
     end # Sink
 

data/lib/mutant/parallel/master.rb

@@ -13,7 +13,6 @@ module Mutant
       # @return [Actor::Sender]
       #
       # @api private
-      #
       def self.call(config)
         config.env.spawn do |mailbox|
           new(config, mailbox).__send__(:run)
@@ -25,7 +24,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def initialize(*)
         super
 
@@ -39,10 +37,11 @@ module Mutant
 
       # Run work loop
       #
-      # @api private
-      #
       # rubocop:disable MethodLength
       #
+      # @return [undefined]
+      #
+      # @api private
       def run
         config.jobs.times do
           @workers += 1
@@ -72,7 +71,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def handle(message)
         type, payload = message.type, message.payload
         method = MAP.fetch(type) do
@@ -86,7 +84,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def receive_loop
         handle(mailbox.receiver.call) until @workers.zero? && @stop
       end
@@ -98,7 +95,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def handle_status(sender)
         status = Status.new(
           payload:     sink.status,
@@ -115,7 +111,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def handle_result(job_result)
         @active_jobs.delete(job_result.job)
         sink.result(job_result.payload)
@@ -128,7 +123,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def handle_stop(sender)
         @stop = true
         receive_loop
@@ -142,7 +136,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def handle_ready(sender)
         if stop_work?
           stop_worker(sender)
@@ -152,13 +145,14 @@ module Mutant
         sender.call(Actor::Message.new(:job, next_job))
       end
 
-      # Return next job if any
+      # Next job if any
       #
       # @return [Job]
       #   if next job is available
       #
       # @return [nil]
       #
+      # @api private
       def next_job
         Job.new(
           index:   @index,
@@ -176,7 +170,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def stop_worker(sender)
         @workers -= 1
         sender.call(Actor::Message.new(:stop))
@@ -187,27 +180,24 @@ module Mutant
       # @return [Boolean]
       #
       # @api private
-      #
       def stop_work?
         @stop || !source.next? || sink.stop?
       end
 
-      # Return source
+      # Job source
       #
       # @return [Source]
       #
       # @api private
-      #
       def source
         config.source
       end
 
-      # Return sink
+      # Job result sink
       #
       # @return [Sink]
       #
       # @api private
-      #
       def sink
         config.sink
       end