mutant 0.14.1 → 0.14.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d3a480fb26d943cb4a6b83edab4a59c8f82e887af44f2915d713187f3a1de52
-  data.tar.gz: fa67cd60285d710dea30b5de41d241f565b4fa1e199d957c05b2e250f3b4a71d
+  metadata.gz: 19ddb5cce03b640bb465057b2e6a0ee983b44b3990fff144dcd3a737b6e7ba5c
+  data.tar.gz: c97e3a1ac3fc5f4e431e70e86ee477933f1fa59e9ce338308a785c7fdab990c5
 SHA512:
-  metadata.gz: 73587288bb7e4d7c940e5fb2ed4d06c3d18c2c0e13a29e453014d2034bb84018c17b43bb6419faa51aed03363458343a83f73a016a13da21be5faea77b168b9b
-  data.tar.gz: fb6bd3cc6bd882b2fba0bf576de3076371d9f83711c13ea8bc88d520e36ebae516f3d618316c89092c78e4bb857018404512cf1c88d0cd52631145ca8a754c60
+  metadata.gz: aca0d3b5772f1b1caf6d075779dd6b54e02a4109917bc85f69b84afb038060f4610306b5f95c47f19cf429d287ffb4913b4cd5d71c19777a3f00a3df7cc7904e
+  data.tar.gz: 3dd977fa2018eac8935f471266af5fa77f1ca02095c130a3852f342fca3e2e099ab2cfabc75b746e3a44bcbbeeef9adf9979f92469e87df46227f98139fc859c

data/VERSION

@@ -1 +1 @@
-0.14.1
+0.14.2

data/lib/mutant/mutation/operators.rb

@@ -10,13 +10,18 @@ module Mutant
         NAME = :full
 
         SELECTOR_REPLACEMENTS = {
+          :& =>          %i[| ^],
           :< =>          %i[== eql? equal?],
+          :<< =>         %i[>>],
           :<= =>         %i[< == eql? equal?],
           :== =>         %i[eql? equal?],
           :=== =>        %i[is_a?],
           :=~ =>         %i[match?],
           :> =>          %i[== eql? equal?],
           :>= =>         %i[> == eql? equal?],
+          :>> =>         %i[<<],
+          :^ =>          %i[& |],
+          :| =>          %i[& ^],
           __send__:      %i[public_send],
           all?:          %i[any?],
           any?:          %i[all?],

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

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'io/console'
+
 module Mutant
   class Reporter
     class CLI
@@ -7,7 +9,20 @@ module Mutant
       #
       # rubocop:disable Style/FormatString
       class Format
-        include AbstractType, Anima.new(:tty)
+        include AbstractType, Anima.new(:tty, :output_io)
+
+        DEFAULT_TERMINAL_WIDTH = 80
+
+        # Dynamic terminal width - queries current size on each call
+        #
+        # @return [Integer]
+        def terminal_width
+          return DEFAULT_TERMINAL_WIDTH unless tty && output_io.respond_to?(:winsize)
+
+          output_io.winsize.last
+        rescue Errno::ENOTTY, Errno::EOPNOTSUPP
+          DEFAULT_TERMINAL_WIDTH
+        end
 
         # Start representation
         #
@@ -35,7 +50,7 @@ module Mutant
 
         # Output abstraction to decouple tty? from buffer
         class Output
-          include Anima.new(:tty, :buffer)
+          include Anima.new(:tty, :buffer, :terminal_width)
 
           # Test if output is a tty
           #
@@ -54,7 +69,7 @@ module Mutant
 
         def format(printer, object)
           buffer = new_buffer
-          printer.call(output: Output.new(tty:, buffer:), object:)
+          printer.call(output: Output.new(tty:, buffer:, terminal_width:), object:)
           buffer.rewind
           buffer.read
         end
@@ -65,6 +80,14 @@ module Mutant
           REPORT_FREQUENCY = 1.0
           REPORT_DELAY     = 1 / REPORT_FREQUENCY
 
+          # ANSI escape sequences
+          CLEAR_LINE  = "\e[2K"
+          CURSOR_UP   = "\e[A"
+          CURSOR_DOWN = "\e[B"
+
+          # Pattern to strip ANSI escape codes for visual length calculation
+          ANSI_ESCAPE = /\e\[[0-9;]*[A-Za-z]/
+
           # Start representation
           #
           # @return [String]
@@ -83,14 +106,14 @@ module Mutant
           #
           # @return [String]
           def progress(status)
-            format(Printer::StatusProgressive, status)
+            wrap_progress { format(status_progressive_printer, status) }
           end
 
           # Progress representation
           #
           # @return [String]
           def test_progress(status)
-            format(Printer::Test::StatusProgressive, status)
+            wrap_progress { format(test_status_progressive_printer, status) }
           end
 
         private
@@ -99,6 +122,75 @@ module Mutant
             StringIO.new
           end
 
+          def status_progressive_printer
+            tty ? Printer::StatusProgressive::Tty : Printer::StatusProgressive::Pipe
+          end
+
+          def test_status_progressive_printer
+            tty ? Printer::Test::StatusProgressive::Tty : Printer::Test::StatusProgressive::Pipe
+          end
+
+          # Wrap progress output with TTY-specific line handling
+          #
+          # Uses indicatif-style multi-line clearing to handle terminal resize:
+          # 1. Calculate how many visual lines previous content spans at current width
+          # 2. Clear all those lines using cursor movement
+          # 3. Write new content
+          #
+          # @return [String]
+          def wrap_progress
+            content = yield
+            return content unless tty
+
+            clear_seq            = clear_last_lines(visual_lines_at_width(@last_content_length, terminal_width))
+            @last_content_length = visual_length(content)
+
+            "#{clear_seq}#{content}"
+          end
+
+          # Calculate visual length of string (excluding ANSI escape sequences)
+          #
+          # @param string [String]
+          # @return [Integer]
+          def visual_length(string)
+            string.gsub(ANSI_ESCAPE, '').length
+          end
+
+          # Calculate visual lines content occupies at given terminal width
+          #
+          # @param content_length [Integer, nil]
+          # @param width [Integer]
+          # @return [Integer]
+          def visual_lines_at_width(content_length, width)
+            return 1 if width < 1
+
+            # nil.to_f = 0.0, and ceil(0.0/w).clamp(1,10) = 1
+            (content_length.to_f / width).ceil.clamp(1, 10)
+          end
+
+          # Build escape sequence to clear n lines (indicatif/console pattern)
+          #
+          # Algorithm from console crate's clear_last_lines:
+          # 1. Move cursor up (n-1) lines to reach top
+          # 2. For each line: clear it, move down (except last)
+          # 3. Move cursor back up (n-1) lines
+          #
+          # For n=1: produces "\r\e[2K" (no cursor movement needed)
+          # For n>1: moves up, clears each line with downs between, moves back up
+          #
+          # @param lines [Integer] number of lines to clear (must be >= 1)
+          # @return [String]
+          def clear_last_lines(lines)
+            buffer = StringIO.new
+            buffer << (CURSOR_UP * (lines - 1))
+            lines.times do |i|
+              buffer << "\r" << CLEAR_LINE
+              buffer << CURSOR_DOWN if i < lines - 1
+            end
+            buffer << (CURSOR_UP * (lines - 1))
+            buffer.string
+          end
+
         end # Progressive
       end # Format
     end # CLI

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

@@ -46,7 +46,9 @@ module Mutant
           end
 
           def coverage_percent
-            coverage * 100
+            # Floor to 2 decimal places to prevent rounding up to 100%
+            # when there are surviving mutations
+            (coverage * 10_000).floor / 100.0
           end
 
           def efficiency_percent

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

@@ -4,10 +4,8 @@ module Mutant
   class Reporter
     class CLI
       class Printer
-        # Reporter for progressive output format on scheduler Status objects
+        # Base class for progressive status output
         class StatusProgressive < self
-          FORMAT = 'progress: %02d/%02d alive: %d runtime: %0.02fs killtime: %0.02fs mutations/s: %0.02f'
-
           delegate(
             :amount_mutation_results,
             :amount_mutations,
@@ -17,21 +15,6 @@ module Mutant
             :runtime
           )
 
-          # Run printer
-          #
-          # @return [undefined]
-          def run
-            status(
-              FORMAT,
-              amount_mutation_results,
-              amount_mutations,
-              amount_mutations_alive,
-              runtime,
-              killtime,
-              mutations_per_second
-            )
-          end
-
         private
 
           def object
@@ -41,6 +24,50 @@ module Mutant
           def mutations_per_second
             amount_mutation_results / runtime
           end
+
+          # Pipe output format (non-TTY)
+          class Pipe < StatusProgressive
+            FORMAT = 'progress: %02d/%02d alive: %d runtime: %0.02fs killtime: %0.02fs mutations/s: %0.02f'
+
+            def run
+              status(
+                FORMAT,
+                amount_mutation_results,
+                amount_mutations,
+                amount_mutations_alive,
+                runtime,
+                killtime,
+                mutations_per_second
+              )
+            end
+          end # Pipe
+
+          # TTY output format with progress bar
+          class Tty < StatusProgressive
+            FORMAT              = '%s %d/%d (%5.1f%%) %s alive: %d %0.1fs %0.2f/s'
+            MAX_BAR_WIDTH       = 40
+            PREFIX              = 'RUNNING'
+            PERCENTAGE_ESTIMATE = 99.9
+
+            def run
+              bar  = ProgressBar.build(current: amount_mutation_results, total: amount_mutations, width: bar_width)
+              line = FORMAT % format_args(bar.percentage, bar.render)
+              output.write(colorize(status_color, line))
+            end
+
+          private
+
+            def format_args(percentage, bar)
+              [PREFIX, amount_mutation_results, amount_mutations, percentage, bar,
+               amount_mutations_alive, runtime, mutations_per_second]
+            end
+
+            def bar_width
+              non_bar_content = FORMAT % format_args(PERCENTAGE_ESTIMATE, nil)
+              available_width = output.terminal_width - non_bar_content.length
+              available_width.clamp(0, MAX_BAR_WIDTH)
+            end
+          end # Tty
         end # StatusProgressive
       end # Printer
     end # CLI

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

@@ -115,10 +115,8 @@ module Mutant
 
           end # Result
 
-          # Reporter for progressive output format on scheduler Status objects
+          # Base class for progressive test status output
           class StatusProgressive < self
-            FORMAT = 'progress: %02d/%02d failed: %d runtime: %0.02fs testtime: %0.02fs tests/s: %0.02f'
-
             delegate(
               :amount_test_results,
               :amount_tests,
@@ -127,21 +125,6 @@ module Mutant
               :runtime
             )
 
-            # Run printer
-            #
-            # @return [undefined]
-            def run
-              status(
-                FORMAT,
-                amount_test_results,
-                amount_tests,
-                amount_tests_failed,
-                runtime,
-                testtime,
-                tests_per_second
-              )
-            end
-
           private
 
             def object
@@ -151,6 +134,50 @@ module Mutant
             def tests_per_second
               amount_test_results / runtime
             end
+
+            # Pipe output format (non-TTY)
+            class Pipe < StatusProgressive
+              FORMAT = 'progress: %02d/%02d failed: %d runtime: %0.02fs testtime: %0.02fs tests/s: %0.02f'
+
+              def run
+                status(
+                  FORMAT,
+                  amount_test_results,
+                  amount_tests,
+                  amount_tests_failed,
+                  runtime,
+                  testtime,
+                  tests_per_second
+                )
+              end
+            end # Pipe
+
+            # TTY output format with progress bar
+            class Tty < StatusProgressive
+              FORMAT              = '%s %d/%d (%5.1f%%) %s failed: %d %0.1fs %0.2f/s'
+              MAX_BAR_WIDTH       = 40
+              PREFIX              = 'TESTING'
+              PERCENTAGE_ESTIMATE = 99.9
+
+              def run
+                bar  = ProgressBar.build(current: amount_test_results, total: amount_tests, width: bar_width)
+                line = FORMAT % format_args(bar.percentage, bar.render)
+                output.write(colorize(status_color, line))
+              end
+
+            private
+
+              def format_args(percentage, bar)
+                [PREFIX, amount_test_results, amount_tests, percentage, bar,
+                 amount_tests_failed, runtime, tests_per_second]
+              end
+
+              def bar_width
+                non_bar_content = FORMAT % format_args(PERCENTAGE_ESTIMATE, nil)
+                available_width = output.terminal_width - non_bar_content.length
+                available_width.clamp(0, MAX_BAR_WIDTH)
+              end
+            end # Tty
           end # StatusProgressive
         end # Test
       end # Printer

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

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Mutant
+  class Reporter
+    class CLI
+      # Visual progress bar renderer
+      #
+      # Renders nextest-style progress bars like:
+      #   45/100 (45.0%) ████████████░░░░░░░░ alive: 12 23.45s
+      class ProgressBar
+        include Anima.new(
+          :current,
+          :total,
+          :width,
+          :filled_char,
+          :empty_char
+        )
+
+        FILLED_CHAR = "\u2588" # █
+        EMPTY_CHAR  = "\u2591" # ░
+
+        DEFAULT_WIDTH = 30
+
+        # Render the progress bar string
+        #
+        # @return [String]
+        def render
+          "#{filled}#{empty}"
+        end
+
+        # Calculate percentage completion
+        #
+        # @return [Float]
+        def percentage
+          return 0.0 if total.zero?
+
+          (current.to_f / total * 100)
+        end
+
+        # Build a progress bar with defaults
+        #
+        # @param current [Integer] current progress value
+        # @param total [Integer] total value
+        # @param width [Integer] bar width in characters
+        #
+        # @return [ProgressBar]
+        def self.build(current:, total:, width: DEFAULT_WIDTH)
+          new(
+            current:,
+            total:,
+            width:,
+            filled_char: FILLED_CHAR,
+            empty_char:  EMPTY_CHAR
+          )
+        end
+
+      private
+
+        def filled_width
+          return 0 if total.zero?
+
+          [((current.to_f / total) * width).round, width].min
+        end
+
+        def empty_width
+          width - filled_width
+        end
+
+        def filled
+          filled_char * filled_width
+        end
+
+        def empty
+          empty_char * empty_width
+        end
+      end # ProgressBar
+    end # CLI
+  end # Reporter
+end # Mutant

data/lib/mutant/reporter/cli.rb

@@ -12,8 +12,10 @@ module Mutant
       #
       # @return [Reporter::CLI]
       def self.build(output)
+        tty = output.respond_to?(:tty?) && output.tty?
+
         new(
-          format:         Format::Progressive.new(tty: output.respond_to?(:tty?) && output.tty?),
+          format:         Format::Progressive.new(tty:, output_io: output),
           print_warnings: false,
           output:
         )
@@ -80,6 +82,7 @@ module Mutant
       #
       # @return [self]
       def report(env)
+        write_final_progress(env)
         Printer::EnvResult.call(output:, object: env)
         self
       end
@@ -90,6 +93,7 @@ module Mutant
       #
       # @return [self]
       def test_report(env)
+        write_final_test_progress(env)
         Printer::Test::EnvResult.call(output:, object: env)
         self
       end
@@ -100,6 +104,30 @@ module Mutant
         output.write(frame)
       end
 
+      def write_final_progress(env)
+        return unless format.tty
+
+        final_status = Parallel::Status.new(
+          active_jobs: Set.new,
+          done:        true,
+          payload:     env
+        )
+        write(format.progress(final_status))
+        output.puts
+      end
+
+      def write_final_test_progress(env)
+        return unless format.tty
+
+        final_status = Parallel::Status.new(
+          active_jobs: Set.new,
+          done:        true,
+          payload:     env
+        )
+        write(format.test_progress(final_status))
+        output.puts
+      end
+
     end # CLI
   end # Reporter
 end # Mutant

data/lib/mutant.rb

@@ -237,6 +237,7 @@ module Mutant
     require 'mutant/reporter/null'
     require 'mutant/reporter/sequence'
     require 'mutant/reporter/cli'
+    require 'mutant/reporter/cli/progress_bar'
     require 'mutant/reporter/cli/printer'
     require 'mutant/reporter/cli/printer/config'
     require 'mutant/reporter/cli/printer/coverage_result'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mutant
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.14.2
 platform: ruby
 authors:
 - Markus Schirp
@@ -327,6 +327,7 @@ files:
 - lib/mutant/reporter/cli/printer/status_progressive.rb
 - lib/mutant/reporter/cli/printer/subject_result.rb
 - lib/mutant/reporter/cli/printer/test.rb
+- lib/mutant/reporter/cli/progress_bar.rb
 - lib/mutant/reporter/null.rb
 - lib/mutant/reporter/sequence.rb
 - lib/mutant/repository.rb
@@ -377,7 +378,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: ''
 test_files: []