mutant 0.8.0 → 0.8.1

data/lib/mutant/mutator.rb

@@ -13,7 +13,6 @@ module Mutant
     # @return [self]
     #
     # @api private
-    #
     def self.each(input, parent = nil, &block)
       return to_enum(__method__, input, parent) unless block_given?
       REGISTRY.lookup(input).new(input, parent, block)
@@ -26,7 +25,6 @@ module Mutant
     # @return [undefined]
     #
     # @api private
-    #
     def self.handle(*types)
       types.each do |type|
         REGISTRY.register(type, self)
@@ -34,20 +32,18 @@ module Mutant
     end
     private_class_method :handle
 
-    # Return input
+    # Mutation input
     #
     # @return [Object]
     #
     # @api private
-    #
     attr_reader :input
 
-    # Return input
+    # Parent context of input
     #
     # @return [Object]
     #
     # @api private
-    #
     attr_reader :parent
 
   private
@@ -61,7 +57,6 @@ module Mutant
     # @return [undefined]
     #
     # @api private
-    #
     def initialize(input, parent, block)
       @input, @parent, @block = input, parent, block
       @seen = Set.new
@@ -76,7 +71,6 @@ module Mutant
     # @return [Boolean]
     #
     # @api private
-    #
     def new?(object)
       !@seen.include?(object)
     end
@@ -88,7 +82,6 @@ module Mutant
     # @return [undefined]
     #
     # @api private
-    #
     def guard(object)
       @seen << object
     end
@@ -98,7 +91,6 @@ module Mutant
     # @return [undefined]
     #
     # @api private
-    #
     abstract_method :dispatch
 
     # Emit generated mutation if object is not equivalent to input
@@ -108,7 +100,6 @@ module Mutant
     # @return [undefined]
     #
     # @api private
-    #
     def emit(object)
       return unless new?(object)
 
@@ -124,7 +115,6 @@ module Mutant
     # @return [self]
     #
     # @api private
-    #
     def emit!(node)
       @block.call(node)
       self
@@ -135,7 +125,6 @@ module Mutant
     # @return [undefined]
     #
     # @api private
-    #
     def run(mutator)
       mutator.new(input, self, method(:emit))
     end
@@ -145,7 +134,6 @@ module Mutant
     # @return [Object]
     #
     # @api private
-    #
     def dup_input
       input.dup
     end

data/lib/mutant/mutator/node.rb

@@ -19,7 +19,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def self.define_named_child(name, index)
         super
 
@@ -35,39 +34,25 @@ module Mutant
 
     private
 
-      # Return mutated node
+      # Node to mutate
       #
       # @return [Parser::AST::Node]
       #
       # @api private
-      #
       alias_method :node, :input
 
-      # Return duplicated node
+      # Duplicate of original
       #
       # @return [Parser::AST::Node]
       #
       # @api private
-      #
       alias_method :dup_node, :dup_input
 
-      # Return ast meta description
-      #
-      # @return [AST::Meta]
-      #
-      # @api private
-      #
-      def meta
-        AST::Meta.for(node)
-      end
-      memoize :meta
-
-      # Return children
+      # Original nodes children
       #
       # @return [Array<Parser::AST::Node>]
       #
       # @api private
-      #
       def children
         node.children
       end
@@ -79,7 +64,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def mutate_child(index, mutator = Mutator, &block)
         block ||= TAUTOLOGY
         child = children.at(index)
@@ -96,7 +80,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def delete_child(index)
         dup_children = children.dup
         dup_children.delete_at(index)
@@ -111,7 +94,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def emit_child_update(index, node)
         new_children = children.dup
         new_children[index] = node
@@ -125,7 +107,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def emit_type(*children)
         emit(Parser::AST::Node.new(node.type, children))
       end
@@ -135,7 +116,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def emit_singletons
         emit_nil
         emit_self
@@ -146,7 +126,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def emit_self
         emit(N_SELF)
       end
@@ -156,7 +135,6 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def emit_nil
         emit(N_NIL) unless asgn_left?
       end
@@ -168,14 +146,13 @@ module Mutant
       # @return [undefined]
       #
       # @api private
-      #
       def emit_values(values)
         values.each do |value|
           emit_type(value)
         end
       end
 
-      # Return parent node
+      # Parent node
       #
       # @return [Parser::AST::Node] node
       #   if parent with node is present
@@ -184,12 +161,11 @@ module Mutant
       #   otherwise
       #
       # @api private
-      #
       def parent_node
         parent.node if parent
       end
 
-      # Return parent type
+      # Parent type
       #
       # @return [Symbol] type
       #   if parent with type is present
@@ -198,7 +174,6 @@ module Mutant
       #   otherwise
       #
       # @api private
-      #
       def parent_type
         parent_node.type if parent_node
       end
@@ -208,19 +183,17 @@ module Mutant
       # @return [Boolean]
       #
       # @api private
-      #
       def asgn_left?
         AST::Types::OP_ASSIGN.include?(parent_type) && parent.node.children.first.equal?(node)
       end
 
-      # Return children indices
+      # Children indices
       #
       # @param [Range] range
       #
       # @return [Enumerable<Fixnum>]
       #
       # @api private
-      #
       def children_indices(range)
         range_end = range.end
         last_index = range_end >= 0 ? range_end : children.length + range_end

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

@@ -16,7 +16,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_singletons
           emit_left_mutations do |node|

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

@@ -17,7 +17,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_name_mutation
         end
@@ -27,7 +26,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_name_mutation
           return if skip?
           Mutator::Util::Symbol.each(name, self) do |name|
@@ -40,7 +38,6 @@ module Mutant
         # @return [Boolean]
         #
         # @api private
-        #
         def skip?
           name.to_s.start_with?(UNDERSCORE)
         end
@@ -59,7 +56,6 @@ module Mutant
           # @return [undefined]
           #
           # @api private
-          #
           def dispatch
             emit_name_mutation
             emit_required_mutation
@@ -71,7 +67,6 @@ module Mutant
           # @return [undefined]
           #
           # @api private
-          #
           def emit_required_mutation
             emit(s(:arg, name))
           end

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

@@ -13,7 +13,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_argument_presence
           emit_argument_mutations
@@ -25,7 +24,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_argument_presence
           emit_type
           Mutator::Util::Array::Presence.each(children, self) do |children|
@@ -38,7 +36,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_argument_mutations
           children.each_with_index do |child, index|
             Mutator.each(child) do |mutant|
@@ -55,7 +52,6 @@ module Mutant
         # @return [Boolean]
         #
         # @api private
-        #
         def invalid_argument_replacement?(mutant, index)
           original = children.fetch(index)
 
@@ -69,7 +65,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_mlhs_expansion
           mlhs_childs_with_index.each do |child, index|
             dup_children = children.dup
@@ -79,12 +74,11 @@ module Mutant
           end
         end
 
-        # Return mlhs childs
+        # Multiple left hand side childs
         #
         # @return [Enumerable<Parser::AST::Node, Fixnum>]
         #
         # @api private
-        #
         def mlhs_childs_with_index
           children.each_with_index.select do |child, _index|
             n_mlhs?(child)

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

@@ -14,7 +14,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           Util::Array.each(children, self, &method(:emit_child_subset))
           children.each_with_index do |child, index|
@@ -30,7 +29,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_child_subset(children)
           return if children.length < 2
           emit_type(*children)

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

@@ -20,7 +20,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_singletons
           emit(left)
@@ -36,7 +35,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def mutate_operator
           emit(s(INVERSE.fetch(node.type), left, right))
         end
@@ -46,7 +44,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def mutate_operands
           emit(s(node.type, n_not(left), right))
           emit(n_not(node))

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

@@ -15,7 +15,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_singletons
           emit(send)
@@ -30,7 +29,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def mutate_body
           emit_body(nil)
           emit_body(N_RAISE)

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

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

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

@@ -16,7 +16,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def dispatch
           emit_singletons
           emit_condition_mutations if condition
@@ -29,7 +28,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_when_mutations
           indices = children.each_index.drop(1).take(children.length - 2)
           one = indices.one?
@@ -44,7 +42,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def emit_else_mutations
           else_branch = children.last
           else_index = children.length - 1

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

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