mutant 0.8.0 → 0.8.1

data/lib/mutant/runner.rb

@@ -8,7 +8,6 @@ module Mutant
     # @return [undefined]
     #
     # @api private
-    #
     def initialize(*)
       super
 
@@ -17,25 +16,21 @@ module Mutant
       run_mutation_analysis
     end
 
-    # Return result
+    # Final result
     #
     # @return [Result::Env]
     #
     # @api private
-    #
     attr_reader :result
 
   private
 
     # Run mutation analysis
     #
-    #  @return [undefined]
-    #
-    #  @api private
+    # @return [undefined]
     #
+    # @api private
     def run_mutation_analysis
-      config.integration.setup
-
       @result = run_driver(Parallel.async(mutation_test_config))
       reporter.report(@result)
     end
@@ -48,7 +43,6 @@ module Mutant
     #   the last returned status payload
     #
     # @api private
-    #
     def run_driver(driver)
       status = nil
 
@@ -64,12 +58,11 @@ module Mutant
       status.payload
     end
 
-    # Return mutation test config
+    # Confiugation for paralell execution engine
     #
-    # @return [Parallell::Config]
+    # @return [Parallel::Config]
     #
     # @api private
-    #
     def mutation_test_config
       Parallel::Config.new(
         env:       env.actor_env,
@@ -80,22 +73,20 @@ module Mutant
       )
     end
 
-    # Return reporter
+    # Reporter to use
     #
     # @return [Reporter]
     #
     # @api private
-    #
     def reporter
       env.config.reporter
     end
 
-    # Return config
+    # Config for this mutant execution
     #
     # @return [Config]
     #
     # @api private
-    #
     def config
       env.config
     end

data/lib/mutant/runner/sink.rb

@@ -4,12 +4,11 @@ module Mutant
     class Sink
       include AbstractType
 
-      # Return sink status
+      # sink status
       #
       # @return [Object]
       #
       # @api private
-      #
       abstract_method :status
 
       # Test if computation should be stopped
@@ -17,7 +16,6 @@ module Mutant
       # @return [Boolean]
       #
       # @api private
-      #
       abstract_method :stop?
 
       # Consume result
@@ -27,7 +25,6 @@ module Mutant
       # @return [self]
       #
       # @api private
-      #
       abstract_method :result
 
       # Mutation result sink
@@ -39,7 +36,6 @@ module Mutant
         # @return [undefined]
         #
         # @api private
-        #
         def initialize(*)
           super
           @start           = Time.now
@@ -52,12 +48,11 @@ module Mutant
           end
         end
 
-        # Return runner status
+        # Runner status
         #
         # @return [Status]
         #
         # @api private
-        #
         def status
           env_result
         end
@@ -67,7 +62,6 @@ module Mutant
         # @return [Boolean]
         #
         # @api private
-        #
         def stop?
           env.config.fail_fast && !env_result.subject_results.all?(&:success?)
         end
@@ -79,7 +73,6 @@ module Mutant
         # @return [self]
         #
         # @api private
-        #
         def result(mutation_result)
           mutation = mutation_result.mutation
 
@@ -95,12 +88,11 @@ module Mutant
 
       private
 
-        # Return current result
+        # Current result
         #
         # @return [Result::Env]
         #
         # @api private
-        #
         def env_result
           Result::Env.new(
             env:             env,

data/lib/mutant/selector.rb

@@ -3,14 +3,13 @@ module Mutant
   class Selector
     include AbstractType, Adamantium::Flat
 
-    # Return tests for subject
+    # Tests for subject
     #
     # @param [Subject] subjecto
     #
     # @return [Enumerable<Test>]
     #
     # @api private
-    #
     abstract_method :call
 
   end # Selector

data/lib/mutant/selector/expression.rb

@@ -4,14 +4,13 @@ module Mutant
     class Expression < self
       include Concord.new(:integration)
 
-      # Return tests for subject
+      # Tests for subject
       #
       # @param [Subject] subject
       #
       # @return [Enumerable<Test>]
       #
       # @api private
-      #
       def call(subject)
         subject.match_expressions.each do |match_expression|
           subject_tests = integration.all_tests.select do |test|

data/lib/mutant/subject.rb

@@ -4,13 +4,12 @@ module Mutant
     include AbstractType, Adamantium::Flat, Enumerable
     include Concord::Public.new(:context, :node)
 
-    # Return mutations
+    # Mutations for this subject
     #
     # @return [Enumerable<Mutation>]
     # @return [undefined]
     #
     # @api private
-    #
     def mutations
       mutations = [neutral_mutation]
       Mutator.each(node) do |mutant|
@@ -20,94 +19,85 @@ module Mutant
     end
     memoize :mutations
 
-    # Return source path
+    # Source path
     #
     # @return [String]
     #
     # @api private
-    #
     def source_path
       context.source_path
     end
 
-    # Prepare the subject for the insertion of mutation
+    # Prepare subject for insertion of mutation
     #
     # @return [self]
     #
     # @api private
-    #
     def prepare
       self
     end
 
-    # Return source lines
+    # Source line range
     #
     # @return [Range<Fixnum>]
     #
     # @api private
-    #
     def source_lines
       expression = node.location.expression
       expression.line..expression.source_buffer.decompose_position(expression.end_pos).first
     end
     memoize :source_lines
 
-    # Return source line
+    # First source line
     #
     # @return [Fixnum]
     #
     # @api private
-    #
     def source_line
       source_lines.begin
     end
 
-    # Return subject identification
+    # Identification string
     #
     # @return [String]
     #
     # @api private
-    #
     def identification
       "#{expression.syntax}:#{source_path}:#{source_line}"
     end
     memoize :identification
 
-    # Return source representation of ast
+    # Source representation of AST
     #
     # @return [String]
     #
     # @api private
-    #
     def source
       Unparser.unparse(wrap_node(node))
     end
     memoize :source
 
-    # Return match expression
+    # Match expression
     #
     # @return [Expression]
     #
     # @api private
-    #
     abstract_method :expression
 
-    # Return match expressions
+    # Match expressions
     #
     # @return [Enumerable<Expression>]
     #
     # @api private
-    #
     abstract_method :match_expressions
 
   private
 
-    # Return neutral mutation
+    # Neutral mutation
     #
     # @return [Mutation::Neutral]
     #
     # @api private
-    #
     def neutral_mutation
       Mutation::Neutral.new(self, wrap_node(node))
     end
@@ -119,7 +109,6 @@ module Mutant
     # @return [Parser::AST::Node]
     #
     # @api private
-    #
     def wrap_node(node)
       node
     end

data/lib/mutant/subject/method.rb

@@ -8,36 +8,36 @@ module Mutant
       # @return [Boolean]
       #
       # @api private
-      #
       abstract_method :public?
 
-      # Return method name
+      # Method name
       #
-      # @return [Symbol]
+      # @return [Expression]
       #
       # @api private
-      #
       def name
-        node.children[self.class::NAME_INDEX]
+        node.children.fetch(self.class::NAME_INDEX)
       end
 
-      # Return match expression
+      # Match expression
       #
       # @return [String]
       #
       # @api private
-      #
       def expression
-        Expression.parse("#{context.identification}#{self.class::SYMBOL}#{name}")
+        Expression::Method.new(
+          scope_symbol: self.class::SYMBOL,
+          scope_name:   scope.name,
+          method_name:  name.to_s
+        )
       end
       memoize :expression
 
-      # Return match expressions
+      # Match expressions
       #
       # @return [Array<Expression>]
       #
       # @api private
-      #
       def match_expressions
         [expression].concat(context.match_expressions)
       end
@@ -45,12 +45,11 @@ module Mutant
 
     private
 
-      # Return scope
+      # The scope
       #
       # @return [Class, Module]
       #
       # @api private
-      #
       def scope
         context.scope
       end

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

@@ -12,7 +12,6 @@ module Mutant
         # @return [Boolean]
         #
         # @api private
-        #
         def public?
           scope.public_method_defined?(name)
         end
@@ -23,7 +22,6 @@ module Mutant
         # @return [self]
         #
         # @api private
-        #
         def prepare
           scope.__send__(:undef_method, name)
           self
@@ -38,7 +36,6 @@ module Mutant
           # @return [self]
           #
           # @api private
-          #
           def prepare
             scope.__send__(:memoized_methods).instance_variable_get(:@memory).delete(name)
             super
@@ -47,14 +44,13 @@ module Mutant
 
         private
 
-          # Return memoizer node for mutant
+          # Memoizer node for mutant
           #
           # @param [Parser::AST::Node] mutant
           #
           # @return [Parser::AST::Node]
           #
           # @api private
-          #
           def wrap_node(mutant)
             s(:begin, mutant, s(:send, nil, :memoize, s(:args, s(:sym, name))))
           end

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

@@ -5,14 +5,13 @@ module Mutant
       class Singleton < self
 
         NAME_INDEX = 1
-        SYMBOL = '.'.freeze
+        SYMBOL     = '.'.freeze
 
         # Test if method is public
         #
         # @return [Boolean]
         #
         # @api private
-        #
         def public?
           scope.singleton_class.public_method_defined?(name)
         end
@@ -23,7 +22,6 @@ module Mutant
         # @return [self]
         #
         # @api private
-        #
         def prepare
           scope.singleton_class.__send__(:undef_method, name)
           self

data/lib/mutant/test.rb

@@ -3,12 +3,11 @@ module Mutant
   class Test
     include Adamantium::Flat, Anima.new(:id, :expression)
 
-    # Return test identification
+    # Identification string
     #
     # @return [String]
     #
     # @api private
-    #
     alias_method :identification, :id
 
   end # Test