mutant 0.8.8 → 0.8.9

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

@@ -9,8 +9,6 @@ module Mutant
         # Run DSL on block
         #
         # @return [Example]
-        #
-        # @api private
         def self.run(file, block)
           instance = new(file)
           instance.instance_eval(&block)
@@ -20,8 +18,6 @@ module Mutant
         # Initialize DSL context
         #
         # @return [undefined]
-        #
-        # @api private
         def initialize(file)
           @file = file
           @source = nil
@@ -34,8 +30,6 @@ module Mutant
         #
         # @raise [RuntimeError]
         #   in case example cannot be build
-        #
-        # @api private
         def example
           fail 'source not defined' unless @source
           Example.new(@file, @source, @expected)
@@ -48,8 +42,6 @@ module Mutant
         # @param [String,Parser::AST::Node] input
         #
         # @return [self]
-        #
-        # @api private
         def source(input)
           fail 'source already defined' if @source
           @source = node(input)
@@ -62,8 +54,6 @@ module Mutant
         # @param [String,Parser::AST::Node] input
         #
         # @return [self]
-        #
-        # @api private
         def mutation(input)
           node = node(input)
           if @expected.include?(node)
@@ -77,8 +67,6 @@ module Mutant
         # Add singleton mutations
         #
         # @return [undefined]
-        #
-        # @api private
         def singleton_mutations
           mutation('nil')
           mutation('self')
@@ -92,13 +80,11 @@ module Mutant
         #
         # @raise [RuntimeError]
         #   in case input cannot be coerced
-        #
-        # @api private
         def node(input)
           case input
           when String
-            Unparser::Preprocessor.run(Parser::CurrentRuby.parse(input))
-          when Parser::AST::Node
+            Unparser::Preprocessor.run(::Parser::CurrentRuby.parse(input))
+          when ::Parser::AST::Node
             input
           else
             fail "Cannot coerce to node: #{source.inspect}"

data/lib/mutant/mutation.rb

@@ -10,8 +10,6 @@ module Mutant
     # Identification string
     #
     # @return [String]
-    #
-    # @api private
     def identification
       "#{self.class::SYMBOL}:#{subject.identification}:#{code}"
     end
@@ -20,8 +18,6 @@ module Mutant
     # Mutation code
     #
     # @return [String]
-    #
-    # @api private
     def code
       sha1[CODE_RANGE]
     end
@@ -30,8 +26,6 @@ module Mutant
     # Normalized mutation source
     #
     # @return [String]
-    #
-    # @api private
     def source
       Unparser.unparse(node)
     end
@@ -40,8 +34,6 @@ module Mutant
     # Normalized original source
     #
     # @return [String]
-    #
-    # @api private
     def original_source
       subject.source
     end
@@ -51,20 +43,23 @@ module Mutant
     # @param [Array<Report::Test>] test_reports
     #
     # @return [Boolean]
-    #
-    # @api private
     def self.success?(test_result)
       self::TEST_PASS_SUCCESS.equal?(test_result.passed)
     end
 
     # Insert mutated node
     #
-    # @return [self]
+    # @param kernel [Kernel]
     #
-    # @api private
-    def insert
+    # @return [self]
+    def insert(kernel)
       subject.prepare
-      Loader::Eval.call(root, subject)
+      Loader.call(
+        binding: TOPLEVEL_BINDING,
+        kernel:  kernel,
+        node:    root,
+        subject: subject
+      )
       self
     end
 
@@ -73,8 +68,6 @@ module Mutant
     # SHA1 sum of source and subject identification
     #
     # @return [String]
-    #
-    # @api private
     def sha1
       Digest::SHA1.hexdigest(subject.identification + CODE_DELIMITER + source)
     end
@@ -83,8 +76,6 @@ module Mutant
     # Mutated root node
     #
     # @return [Parser::AST::Node]
-    #
-    # @api private
     def root
       subject.context.root(node)
     end

data/lib/mutant/mutator.rb

@@ -11,8 +11,6 @@ module Mutant
     # @param [Mutator] parent
     #
     # @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)
@@ -23,8 +21,6 @@ module Mutant
     # Register node class handler
     #
     # @return [undefined]
-    #
-    # @api private
     def self.handle(*types)
       types.each do |type|
         REGISTRY.register(type, self)
@@ -35,15 +31,11 @@ module Mutant
     # Mutation input
     #
     # @return [Object]
-    #
-    # @api private
     attr_reader :input
 
     # Parent context of input
     #
     # @return [Object]
-    #
-    # @api private
     attr_reader :parent
 
   private
@@ -55,8 +47,6 @@ module Mutant
     # @param [#call(node)] block
     #
     # @return [undefined]
-    #
-    # @api private
     def initialize(input, parent, block)
       @input, @parent, @block = input, parent, block
       @seen = Set.new
@@ -69,8 +59,6 @@ module Mutant
     # @param [Object] object
     #
     # @return [Boolean]
-    #
-    # @api private
     def new?(object)
       !@seen.include?(object)
     end
@@ -80,8 +68,6 @@ module Mutant
     # @param [Object] object
     #
     # @return [undefined]
-    #
-    # @api private
     def guard(object)
       @seen << object
     end
@@ -89,8 +75,6 @@ module Mutant
     # Dispatch node generations
     #
     # @return [undefined]
-    #
-    # @api private
     abstract_method :dispatch
 
     # Emit generated mutation if object is not equivalent to input
@@ -98,8 +82,6 @@ module Mutant
     # @param [Object] object
     #
     # @return [undefined]
-    #
-    # @api private
     def emit(object)
       return unless new?(object)
 
@@ -113,8 +95,6 @@ module Mutant
     # @param [Parser::AST::Node] node
     #
     # @return [self]
-    #
-    # @api private
     def emit!(node)
       @block.call(node)
       self
@@ -123,8 +103,6 @@ module Mutant
     # Run input with mutator
     #
     # @return [undefined]
-    #
-    # @api private
     def run(mutator)
       mutator.new(input, self, method(:emit))
     end
@@ -132,8 +110,6 @@ module Mutant
     # Shortcut to create a new unfrozen duplicate of input
     #
     # @return [Object]
-    #
-    # @api private
     def dup_input
       input.dup
     end

data/lib/mutant/mutator/node.rb

@@ -17,8 +17,6 @@ module Mutant
       # @param [Fixnum] index
       #
       # @return [undefined]
-      #
-      # @api private
       def self.define_named_child(name, index)
         super
 
@@ -37,22 +35,16 @@ module Mutant
       # Node to mutate
       #
       # @return [Parser::AST::Node]
-      #
-      # @api private
       alias_method :node, :input
 
       # Duplicate of original
       #
       # @return [Parser::AST::Node]
-      #
-      # @api private
       alias_method :dup_node, :dup_input
 
       # Original nodes children
       #
       # @return [Array<Parser::AST::Node>]
-      #
-      # @api private
       def children
         node.children
       end
@@ -62,8 +54,6 @@ module Mutant
       # @param [Fixnum] index
       #
       # @return [undefined]
-      #
-      # @api private
       def mutate_child(index, mutator = Mutator, &block)
         block ||= TAUTOLOGY
         child = children.at(index)
@@ -78,8 +68,6 @@ module Mutant
       # @param [Fixnum] index
       #
       # @return [undefined]
-      #
-      # @api private
       def delete_child(index)
         dup_children = children.dup
         dup_children.delete_at(index)
@@ -92,8 +80,6 @@ module Mutant
       # @param [Parser::AST::Node] node
       #
       # @return [undefined]
-      #
-      # @api private
       def emit_child_update(index, node)
         new_children = children.dup
         new_children[index] = node
@@ -105,17 +91,13 @@ module Mutant
       # @param [Array<Parser::AST::Node>] children
       #
       # @return [undefined]
-      #
-      # @api private
       def emit_type(*children)
-        emit(Parser::AST::Node.new(node.type, children))
+        emit(::Parser::AST::Node.new(node.type, children))
       end
 
       # Emit singleton literals
       #
       # @return [undefined]
-      #
-      # @api private
       def emit_singletons
         emit_nil
         emit_self
@@ -124,8 +106,6 @@ module Mutant
       # Emit a literal self
       #
       # @return [undefined]
-      #
-      # @api private
       def emit_self
         emit(N_SELF)
       end
@@ -133,8 +113,6 @@ module Mutant
       # Emit a literal nil
       #
       # @return [undefined]
-      #
-      # @api private
       def emit_nil
         emit(N_NIL) unless asgn_left?
       end
@@ -144,8 +122,6 @@ module Mutant
       # @param [Array<Object>] values
       #
       # @return [undefined]
-      #
-      # @api private
       def emit_values(values)
         values.each do |value|
           emit_type(value)
@@ -159,8 +135,6 @@ module Mutant
       #
       # @return [nil]
       #   otherwise
-      #
-      # @api private
       def parent_node
         parent.node if parent
       end
@@ -172,8 +146,6 @@ module Mutant
       #
       # @return [nil]
       #   otherwise
-      #
-      # @api private
       def parent_type
         parent_node.type if parent_node
       end
@@ -181,8 +153,6 @@ module Mutant
       # Test if the node is the left of an or_asgn or op_asgn
       #
       # @return [Boolean]
-      #
-      # @api private
       def asgn_left?
         AST::Types::OP_ASSIGN.include?(parent_type) && parent.node.children.first.equal?(node)
       end
@@ -192,8 +162,6 @@ module Mutant
       # @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

@@ -14,8 +14,6 @@ module Mutant
         # Emit mutations
         #
         # @return [undefined]
-        #
-        # @api private
         def dispatch
           emit_singletons
           emit_left_mutations do |node|

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

@@ -15,8 +15,6 @@ module Mutant
         # Perform dispatch
         #
         # @return [undefined]
-        #
-        # @api private
         def dispatch
           emit_name_mutation
         end
@@ -24,8 +22,6 @@ module Mutant
         # Emit name mutations
         #
         # @return [undefined]
-        #
-        # @api private
         def emit_name_mutation
           return if skip?
           emit_name(:"#{UNDERSCORE}#{name}")
@@ -34,8 +30,6 @@ module Mutant
         # Test if argument mutation is skipped
         #
         # @return [Boolean]
-        #
-        # @api private
         def skip?
           name.to_s.start_with?(UNDERSCORE)
         end
@@ -52,8 +46,6 @@ module Mutant
           # Perform dispatch
           #
           # @return [undefined]
-          #
-          # @api private
           def dispatch
             emit_name_mutation
             emit_required_mutation
@@ -63,8 +55,6 @@ module Mutant
           # Emit required mutation
           #
           # @return [undefined]
-          #
-          # @api private
           def emit_required_mutation
             emit(s(:arg, name))
           end

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

@@ -11,8 +11,6 @@ module Mutant
         # Perform dispatch
         #
         # @return [undefined]
-        #
-        # @api private
         def dispatch
           emit_argument_presence
           emit_argument_mutations
@@ -22,8 +20,6 @@ module Mutant
         # Emit argument presence mutation
         #
         # @return [undefined]
-        #
-        # @api private
         def emit_argument_presence
           emit_type
           Mutator::Util::Array::Presence.each(children, self) do |children|
@@ -34,8 +30,6 @@ module Mutant
         # Emit argument mutations
         #
         # @return [undefined]
-        #
-        # @api private
         def emit_argument_mutations
           children.each_with_index do |child, index|
             Mutator.each(child) do |mutant|
@@ -50,8 +44,6 @@ module Mutant
         # @param [Parser::AST::Node]
         #
         # @return [Boolean]
-        #
-        # @api private
         def invalid_argument_replacement?(mutant, index)
           original = children.fetch(index)
 
@@ -63,8 +55,6 @@ module Mutant
         # Emit mlhs expansions
         #
         # @return [undefined]
-        #
-        # @api private
         def emit_mlhs_expansion
           mlhs_childs_with_index.each do |child, index|
             dup_children = children.dup
@@ -77,8 +67,6 @@ module Mutant
         # 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)