Add mutant test primary CLI

Author: mbj

Changelog.md

@@ -1,3 +1,11 @@
+# v0.13.1 2025-03-23
+
+  Add new `mutant test` primary subcommand. This subcommand allows
+  to run rspec (or minitest) tests via mutants *parallel* test runner.
+
+  Standard precautions to correctly synchronize or isolate global resources
+  (fileystems / database) apply.
+
 # v0.13.0 2025-03-23
 
   Significant unparser upgrade. Mutant now:

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mutant (0.13.0)
+    mutant (0.13.1)
       diff-lcs (~> 1.3)
       parser (~> 3.3.0)
       regexp_parser (~> 2.10)

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

@@ -63,6 +63,12 @@ def from_result(result)
                 Either::Left.new('Test failures, exiting nonzero!')
               end
             end
+
+            # Alias to root mount
+            class Root < self
+              NAME        = 'test'
+              SUBCOMMANDS = EMPTY_ARRAY
+            end
           end
 
           SUBCOMMANDS = [List, Run].freeze

lib/mutant/cli/command/root.rb

@@ -10,7 +10,7 @@ class Environment < self
       class Root < self
         NAME              = 'mutant'
         SHORT_DESCRIPTION = 'mutation testing engine main command'
-        SUBCOMMANDS       = [Environment::Run, Environment, Util].freeze
+        SUBCOMMANDS       = [Environment::Run, Environment::Test::Run::Root, Environment, Util].freeze
       end # Root
     end # Command
   end # CLI

lib/mutant/version.rb

@@ -2,5 +2,5 @@
 
 module Mutant
   # Current mutant version
-  VERSION = '0.13.0'
+  VERSION = '0.13.1'
 end # Mutant

spec/unit/mutant/cli_spec.rb

@@ -104,7 +104,7 @@ def self.make
     # rubocop:disable Metrics/MethodLength
     def self.main_body
       <<~MESSAGE.strip
-        usage: mutant <run|environment|util> [options]
+        usage: mutant <run|test|environment|util> [options]
 
         Summary: mutation testing engine main command
 
@@ -120,6 +120,7 @@ def self.main_body
         Available subcommands:
 
         run         - Run code analysis
+        test        - Run tests
         environment - Environment subcommands
         util        - Utility subcommands
       MESSAGE

test_app/Gemfile.minitest.lock

@@ -1,15 +1,15 @@
 PATH
   remote: ..
   specs:
-    mutant (0.13.0)
+    mutant (0.13.1)
       diff-lcs (~> 1.3)
       parser (~> 3.3.0)
       regexp_parser (~> 2.10)
       sorbet-runtime (~> 0.5.0)
       unparser (~> 0.7.0)
-    mutant-minitest (0.13.0)
+    mutant-minitest (0.13.1)
       minitest (~> 5.11)
-      mutant (= 0.13.0)
+      mutant (= 0.13.1)
       mutex_m (~> 0.2)
 
 GEM

test_app/Gemfile.rspec3.10.lock

@@ -1,14 +1,14 @@
 PATH
   remote: ..
   specs:
-    mutant (0.13.0)
+    mutant (0.13.1)
       diff-lcs (~> 1.3)
       parser (~> 3.3.0)
       regexp_parser (~> 2.10)
       sorbet-runtime (~> 0.5.0)
       unparser (~> 0.7.0)
-    mutant-rspec (0.13.0)
-      mutant (= 0.13.0)
+    mutant-rspec (0.13.1)
+      mutant (= 0.13.1)
       rspec-core (>= 3.8.0, < 4.0.0)
 
 GEM

test_app/Gemfile.rspec3.11.lock

@@ -1,14 +1,14 @@
 PATH
   remote: ..
   specs:
-    mutant (0.13.0)
+    mutant (0.13.1)
       diff-lcs (~> 1.3)
       parser (~> 3.3.0)
       regexp_parser (~> 2.10)
       sorbet-runtime (~> 0.5.0)
       unparser (~> 0.7.0)
-    mutant-rspec (0.13.0)
-      mutant (= 0.13.0)
+    mutant-rspec (0.13.1)
+      mutant (= 0.13.1)
       rspec-core (>= 3.8.0, < 4.0.0)
 
 GEM

test_app/Gemfile.rspec3.12.lock

@@ -1,14 +1,14 @@
 PATH
   remote: ..
   specs:
-    mutant (0.13.0)
+    mutant (0.13.1)
       diff-lcs (~> 1.3)
       parser (~> 3.3.0)
       regexp_parser (~> 2.10)
       sorbet-runtime (~> 0.5.0)
       unparser (~> 0.7.0)
-    mutant-rspec (0.13.0)
-      mutant (= 0.13.0)
+    mutant-rspec (0.13.1)
+      mutant (= 0.13.1)
       rspec-core (>= 3.8.0, < 4.0.0)
 
 GEM
@@ -57,4 +57,4 @@ DEPENDENCIES
   rspec-core (~> 3.9)
 
 BUNDLED WITH
-   2.5.22
+   2.6.2