Add test only runner

.github/workflows/ci.yml

@@ -26,13 +26,16 @@ jobs:
           ruby: ruby-3.1
         - os: macos-latest
           ruby: ruby-3.0
+        execution:
+        - bundle exec rspec spec/unit
+        - bundle exec mutant environment test run spec/unit
     steps:
     - uses: actions/checkout@v4
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ${{ matrix.ruby }}
         bundler-cache: true
-    - run: bundle exec rspec spec/unit
+    - run: ${{ matrix.execution }}
   ruby-mutant:
     name: Mutation coverage
     runs-on: ${{ matrix.os }}

Gemfile.lock

@@ -77,4 +77,4 @@ DEPENDENCIES
   rubocop (~> 1.7)
 
 BUNDLED WITH
-   2.4.10
+   2.5.3

docs/configuration.md

@@ -89,6 +89,7 @@ integration:
   # Below shows an example configuring rspec to use a static seed from the config file.
   arguments:
   - --fail-fast # rspec integration default, keep this when specifying manual options!
+  - --force-color # rspec integration default, keep this if colored output is not an issue for you
   - --seed # option
   - '0' # option value, needs to be a string.
   - spec # rspec integration default, tell rspec integration where to find specs

lib/mutant.rb

@@ -204,6 +204,8 @@ module Mutant
     require 'mutant/expression/namespace'
     require 'mutant/expression/parser'
     require 'mutant/test'
+    require 'mutant/test/runner'
+    require 'mutant/test/runner/sink'
     require 'mutant/timer'
     require 'mutant/integration'
     require 'mutant/integration/null'
@@ -243,6 +245,7 @@ module Mutant
     require 'mutant/reporter/cli/printer/mutation_result'
     require 'mutant/reporter/cli/printer/status_progressive'
     require 'mutant/reporter/cli/printer/subject_result'
+    require 'mutant/reporter/cli/printer/test'
     require 'mutant/reporter/cli/format'
     require 'mutant/repository'
     require 'mutant/repository/diff'

lib/mutant/bootstrap.rb

@@ -47,6 +47,32 @@ def self.call(env)
           selected_subjects.flat_map(&:mutations)
         end
 
+        setup_integration(
+          env:               env,
+          mutations:         mutations,
+          selected_subjects: selected_subjects
+        )
+      end
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    # Run test only bootstrap
+    #
+    # @param [Env] env
+    #
+    # @return [Either<String, Env>]
+    def self.call_test(env)
+      env.record(:bootstrap) do
+        setup_integration(
+          env:               load_hooks(env),
+          mutations:         [],
+          selected_subjects: []
+        )
+      end
+    end
+
+    def self.setup_integration(env:, mutations:, selected_subjects:)
+      env.record(__method__) do
         Integration.setup(env).fmap do |integration|
           env.with(
             integration: integration,
@@ -57,7 +83,7 @@ def self.call(env)
         end
       end
     end
-    # rubocop:enable Metrics/MethodLength
+    private_class_method :setup_integration
 
     def self.load_hooks(env)
       env.record(__method__) do

lib/mutant/cli/command/environment/test.rb

@@ -8,6 +8,21 @@ class Test < self
           NAME              = 'test'
           SHORT_DESCRIPTION = 'test subcommands'
 
+        private
+
+          def parse_remaining_arguments(arguments)
+            arguments.each(&method(:add_integration_argument))
+            Either::Right.new(self)
+          end
+
+          def bootstrap
+            env = Env.empty(world, @config)
+
+            env
+              .record(:config) { Config.load(cli_config: @config, world: world) }
+              .bind { |config| Bootstrap.call_test(env.with(config: config)) }
+          end
+
           class List < self
             NAME              = 'list'
             SHORT_DESCRIPTION = 'List tests detected in the environment'
@@ -28,7 +43,29 @@ def list_tests(env)
             end
           end
 
-          SUBCOMMANDS = [List].freeze
+          class Run < self
+            NAME              = 'run'
+            SHORT_DESCRIPTION = 'Run tests'
+            SUBCOMMANDS       = EMPTY_ARRAY
+
+          private
+
+            def action
+              bootstrap
+                .bind(&Mutant::Test::Runner.public_method(:call))
+                .bind(&method(:from_result))
+            end
+
+            def from_result(result)
+              if result.success?
+                Either::Right.new(nil)
+              else
+                Either::Left.new('Test failures, exiting nonzero!')
+              end
+            end
+          end
+
+          SUBCOMMANDS = [List, Run].freeze
         end # Test
       end # Environment
     end # Command

lib/mutant/integration.rb

@@ -4,7 +4,11 @@ module Mutant
 
   # Abstract base class mutant test framework integrations
   class Integration
-    include AbstractType, Adamantium, Anima.new(:arguments, :expression_parser, :world)
+    include AbstractType, Adamantium, Anima.new(
+      :arguments,
+      :expression_parser,
+      :world
+    )
 
     LOAD_MESSAGE = <<~'MESSAGE'
       Unable to load integration mutant-%<integration_name>s:

lib/mutant/integration/rspec.rb

@@ -24,28 +24,36 @@ class Rspec < self
       ALL_EXPRESSION       = Expression::Namespace::Recursive.new(scope_name: nil)
       EXPRESSION_CANDIDATE = /\A([^ ]+)(?: )?/
       EXIT_SUCCESS         = 0
-      DEFAULT_CLI_OPTIONS  = %w[--fail-fast spec].freeze
+      DEFAULT_CLI_OPTIONS  = %w[--fail-fast --force-color spec].freeze
       TEST_ID_FORMAT       = 'rspec:%<index>d:%<location>s/%<description>s'
 
       private_constant(*constants(false))
 
+      def freeze
+        super if @setup_elapsed
+        self
+      end
+
       # Initialize rspec integration
       #
       # @return [undefined]
       def initialize(*)
         super
-        @runner      = RSpec::Core::Runner.new(RSpec::Core::ConfigurationOptions.new(effective_arguments))
-        @rspec_world = RSpec.world
+        @runner        = RSpec::Core::Runner.new(RSpec::Core::ConfigurationOptions.new(effective_arguments))
+        @rspec_world   = RSpec.world
+        @setup_elapsed = nil
       end
 
       # Setup rspec integration
       #
       # @return [self]
       def setup
-        @runner.setup($stderr, $stdout)
-        example_group_map
+        @setup_elapsed = timer.elapsed do
+          @runner.setup(world.stderr, world.stdout)
+          example_group_map
+        end
         reset_examples
-        self
+        freeze
       end
       memoize :setup
 
@@ -55,7 +63,9 @@ def setup
       #
       # @return [Result::Test]
       def call(tests)
+        reset_examples
         setup_examples(tests.map(&all_tests_index))
+        @runner.configuration.start_time = ::Time.now - @setup_elapsed
         start = timer.now
         passed = @runner.run_specs(@rspec_world.ordered_example_groups).equal?(EXIT_SUCCESS)
         Result::Test.new(

lib/mutant/reporter/cli.rb

@@ -28,6 +28,16 @@ def start(env)
         self
       end
 
+      # Report test start
+      #
+      # @param [Env] env
+      #
+      # @return [self]
+      def test_start(env)
+        write(format.test_start(env))
+        self
+      end
+
       # Report progress object
       #
       # @param [Parallel::Status] status
@@ -38,6 +48,14 @@ def progress(status)
         self
       end
 
+      # Report progress object
+      #
+      # @return [self]
+      def test_progress(status)
+        write(format.test_progress(status))
+        self
+      end
+
       # Report delay in seconds
       #
       # @return [Float]
@@ -65,6 +83,16 @@ def report(env)
         self
       end
 
+      # Report env
+      #
+      # @param [Result::Env] env
+      #
+      # @return [self]
+      def test_report(env)
+        Printer::Test::EnvResult.call(output: output, object: env)
+        self
+      end
+
     private
 
       def write(frame)

lib/mutant/reporter/cli/format.rb

@@ -18,11 +18,14 @@ class Format
 
         # Progress representation
         #
-        # @param [Runner::Status] status
-        #
         # @return [String]
         abstract_method :progress
 
+        # Progress representation
+        #
+        # @return [String]
+        abstract_method :test_progress
+
         # Report delay in seconds
         #
         # @return [Float]
@@ -69,13 +72,27 @@ def start(env)
             format(Printer::Env, env)
           end
 
+          # Test start representation
+          #
+          # @return [String]
+          def test_start(env)
+            format(Printer::Test::Env, env)
+          end
+
           # Progress representation
           #
           # @return [String]
           def progress(status)
             format(Printer::StatusProgressive, status)
           end
 
+          # Progress representation
+          #
+          # @return [String]
+          def test_progress(status)
+            format(Printer::Test::StatusProgressive, status)
+          end
+
         private
 
           def new_buffer