mutant 0.8.8 → 0.8.9

data/lib/mutant/parser.rb

@@ -0,0 +1,23 @@
+module Mutant
+  # An AST Parser
+  class Parser
+    include Adamantium::Mutable, Equalizer.new
+
+    # Initialize object
+    #
+    # @return [undefined]
+    def initialize
+      @cache = {}
+    end
+
+    # Parse path into AST
+    #
+    # @param [Pathname] path
+    #
+    # @return [AST::Node]
+    def call(path)
+      @cache[path] ||= ::Parser::CurrentRuby.parse(path.read)
+    end
+
+  end # Parser
+end # Mutant

data/lib/mutant/reporter.rb

@@ -8,8 +8,6 @@ module Mutant
     # @param [String] message
     #
     # @return [self]
-    #
-    # @api private
     abstract_method :warn
 
     # Report start
@@ -17,8 +15,6 @@ module Mutant
     # @param [Env] env
     #
     # @return [self]
-    #
-    # @api private
     abstract_method :start
 
     # Report collector state
@@ -26,8 +22,6 @@ module Mutant
     # @param [Runner::Collector] collector
     #
     # @return [self]
-    #
-    # @api private
     abstract_method :report
 
     # Report progress on object
@@ -35,9 +29,12 @@ module Mutant
     # @param [Object] object
     #
     # @return [self]
-    #
-    # @api private
     abstract_method :progress
 
+    # The reporter delay
+    #
+    # @return [Float]
+    abstract_method :delay
+
   end # Reporter
 end # Mutant

data/lib/mutant/reporter/cli.rb

@@ -9,8 +9,6 @@ module Mutant
       # @param [IO] output
       #
       # @return [Reporter::CLI]
-      #
-      # @api private
       def self.build(output)
         tput = Tput.detect
         tty = output.respond_to?(:tty?) && output.tty?
@@ -24,11 +22,9 @@ module Mutant
 
       # Report start
       #
-      # @param [Env] env
+      # @param [Env::Bootstrap] env
       #
       # @return [self]
-      #
-      # @api private
       def start(env)
         write(format.start(env))
         self
@@ -39,8 +35,6 @@ module Mutant
       # @param [Parallel::Status] status
       #
       # @return [self]
-      #
-      # @api private
       def progress(status)
         write(format.progress(status))
         self
@@ -51,8 +45,6 @@ module Mutant
       # TODO: Move this to a callback registration
       #
       # @return [Float]
-      #
-      # @api private
       def delay
         format.delay
       end
@@ -62,8 +54,6 @@ module Mutant
       # @param [String] message
       #
       # @return [self]
-      #
-      # @api private
       def warn(message)
         output.puts(message)
         self
@@ -74,8 +64,6 @@ module Mutant
       # @param [Result::Env] env
       #
       # @return [self]
-      #
-      # @api private
       def report(env)
         Printer::EnvResult.call(output, env)
         self
@@ -88,8 +76,6 @@ module Mutant
       # @param [String] frame
       #
       # @return [undefined]
-      #
-      # @api private
       def write(frame)
         output.write(frame)
       end

data/lib/mutant/reporter/cli/format.rb

@@ -7,11 +7,9 @@ module Mutant
 
         # Start representation
         #
-        # @param [Env] env
+        # @param [Env::Bootstrap] env
         #
         # @return [String]
-        #
-        # @api private
         abstract_method :start
 
         # Progress representation
@@ -19,15 +17,11 @@ module Mutant
         # @param [Runner::Status] status
         #
         # @return [String]
-        #
-        # @api private
         abstract_method :progress
 
         # Report delay in seconds
         #
         # @return [Float]
-        #
-        # @api private
         def delay
           self.class::REPORT_DELAY
         end
@@ -39,8 +33,6 @@ module Mutant
           # Test if output is a tty
           #
           # @return [Boolean]
-          #
-          # @api private
           alias_method :tty?, :tty
           public :tty?
 
@@ -59,8 +51,6 @@ module Mutant
         # @param [Object] object
         #
         # @return [String]
-        #
-        # @api private
         def format(printer, object)
           buffer = new_buffer
           printer.call(Output.new(tty, buffer), object)
@@ -77,8 +67,6 @@ module Mutant
           # Start representation
           #
           # @return [String]
-          #
-          # @api private
           def start(env)
             format(Printer::Config, env.config)
           end
@@ -86,8 +74,6 @@ module Mutant
           # Progress representation
           #
           # @return [String]
-          #
-          # @api private
           def progress(status)
             format(Printer::StatusProgressive, status)
           end
@@ -97,8 +83,6 @@ module Mutant
           # New buffer
           #
           # @return [StringIO]
-          #
-          # @api private
           def new_buffer
             StringIO.new
           end
@@ -116,11 +100,9 @@ module Mutant
 
           # Format start
           #
-          # @param [Env] env
+          # @param [Env::Bootstrap] env
           #
           # @return [String]
-          #
-          # @api private
           def start(_env)
             tput.prepare
           end
@@ -130,8 +112,6 @@ module Mutant
           # @param [Runner::Status] status
           #
           # @return [String]
-          #
-          # @api private
           def progress(status)
             format(Printer::Status, status)
           end
@@ -141,10 +121,8 @@ module Mutant
           # New buffer
           #
           # @return [StringIO]
-          #
-          # @api private
           def new_buffer
-            # For some reason this raises an Ernno::EACCESS errror:
+            # For some reason this raises an Errno::EACCESS error:
             #
             #  StringIO.new(Tput::INSTANCE.restore, BUFFER_FLAGS)
             #

data/lib/mutant/reporter/cli/printer.rb

@@ -14,8 +14,6 @@ module Mutant
         # Run printer
         #
         # @return [self]
-        #
-        # @api private
         abstract_method :run
 
       private
@@ -23,8 +21,6 @@ module Mutant
         # Status color
         #
         # @return [Color]
-        #
-        # @api private
         def status_color
           success? ? Color::GREEN : Color::RED
         end
@@ -35,8 +31,6 @@ module Mutant
         # @return [Enumerable<Object>] collection
         #
         # @return [undefined]
-        #
-        # @api private
         def visit_collection(printer, collection)
           collection.each do |object|
             visit(printer, object)
@@ -49,8 +43,6 @@ module Mutant
         # @param [Object] object
         #
         # @return [undefined]
-        #
-        # @api private
         def visit(printer, object)
           printer.call(output, object)
         end
@@ -58,8 +50,6 @@ module Mutant
         # Print an info line to output
         #
         # @return [undefined]
-        #
-        # @api private
         def info(string, *arguments)
           puts(format(string, *arguments))
         end
@@ -67,8 +57,6 @@ module Mutant
         # Print a status line to output
         #
         # @return [undefined]
-        #
-        # @api private
         def status(string, *arguments)
           puts(colorize(status_color, format(string, *arguments)))
         end
@@ -76,8 +64,6 @@ module Mutant
         # Print a line to output
         #
         # @return [undefined]
-        #
-        # @api private
         def puts(string)
           output.puts(string)
         end
@@ -90,8 +76,6 @@ module Mutant
         # @return [String]
         #   if color is enabled
         #   unmodified message otherwise
-        #
-        # @api private
         def colorize(color, message)
           color = Color::NONE unless tty?
           color.format(message)
@@ -100,8 +84,6 @@ module Mutant
         # Test if output is a tty
         #
         # @return [Boolean]
-        #
-        # @api private
         def tty?
           output.tty?
         end

data/lib/mutant/reporter/cli/printer/config.rb

@@ -10,8 +10,6 @@ module Mutant
           # @param [Mutant::Config] config
           #
           # @return [undefined]
-          #
-          # @api private
           def run
             info 'Mutant configuration:'
             info 'Matcher:         %s',      object.matcher.inspect

data/lib/mutant/reporter/cli/printer/env_progress.rb

@@ -35,8 +35,6 @@ module Mutant
           # Run printer
           #
           # @return [undefined]
-          #
-          # @api private
           def run
             visit(Config, env.config)
             FORMATS.each do |report, format, value|

data/lib/mutant/reporter/cli/printer/env_result.rb

@@ -9,8 +9,6 @@ module Mutant
           # Run printer
           #
           # @return [undefined]
-          #
-          # @api private
           def run
             visit_collection(SubjectResult, failed_subject_results)
             visit(EnvProgress, object)

data/lib/mutant/reporter/cli/printer/mutation_progress_result.rb

@@ -10,8 +10,6 @@ module Mutant
           # Run printer
           #
           # @return [undefined]
-          #
-          # @api private
           def run
             char(success? ? SUCCESS : FAILURE)
           end
@@ -23,8 +21,6 @@ module Mutant
           # @param [String] char
           #
           # @return [undefined]
-          #
-          # @api private
           def char(char)
             output.write(colorize(status_color, char))
           end

data/lib/mutant/reporter/cli/printer/mutation_result.rb

@@ -49,8 +49,6 @@ module Mutant
           # Run report printer
           #
           # @return [undefined]
-          #
-          # @api private
           def run
             puts(mutation.identification)
             print_details
@@ -62,8 +60,6 @@ module Mutant
           # Print mutation details
           #
           # @return [undefined]
-          #
-          # @api private
           def print_details
             __send__(MAP.fetch(mutation.class))
           end
@@ -71,8 +67,6 @@ module Mutant
           # Evil mutation details
           #
           # @return [String]
-          #
-          # @api private
           def evil_details
             diff = Diff.build(mutation.original_source, mutation.source)
             diff = color? ? diff.colorized_diff : diff.diff
@@ -86,8 +80,6 @@ module Mutant
           # Print no diff message
           #
           # @return [undefined]
-          #
-          # @api private
           def print_no_diff_message
             info(
               NO_DIFF_MESSAGE,
@@ -101,8 +93,6 @@ module Mutant
           # Noop details
           #
           # @return [String]
-          #
-          # @api private
           def noop_details
             info(NOOP_MESSAGE)
             visit_test_result
@@ -111,8 +101,6 @@ module Mutant
           # Neutral details
           #
           # @return [String]
-          #
-          # @api private
           def neutral_details
             info(NEUTRAL_MESSAGE, original_node.inspect, mutation.source)
             visit_test_result
@@ -121,8 +109,6 @@ module Mutant
           # Visit failed test results
           #
           # @return [undefined]
-          #
-          # @api private
           def visit_test_result
             visit(TestResult, test_result)
           end
@@ -130,8 +116,6 @@ module Mutant
           # Original node
           #
           # @return [Parser::AST::Node]
-          #
-          # @api private
           def original_node
             mutation.subject.node
           end

data/lib/mutant/reporter/cli/printer/status.rb

@@ -13,8 +13,6 @@ module Mutant
           # Print progress for collector
           #
           # @return [undefined]
-          #
-          # @api private
           def run
             visit(EnvProgress, payload)
             job_status
@@ -27,8 +25,6 @@ module Mutant
           # Print worker status
           #
           # @return [undefined]
-          #
-          # @api private
           def job_status
             return if active_jobs.empty?
             info(ACTIVE_JOB_HEADER)
@@ -40,8 +36,6 @@ module Mutant
           # Active subject results
           #
           # @return [Array<Result::Subject>]
-          #
-          # @api private
           def active_subject_results
             active_subjects = active_jobs.map(&:payload).flat_map(&:subject)