davidteren/Mutineer Ruby
Mutation-test your Ruby suite in CI; fail the build on new surviving mutants or a mutation-score drop versus a baseline.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| sources | Space-separated source files or directories to mutate (positional args to `mutineer run`). A directory is expanded to its **/*.rb files. | yes | — |
| test | Space-separated test files covering the sources. Optional — when omitted, Mutineer auto-pairs each source to its test by convention. | no | "" |
| since | Mutate only lines changed since this git ref (e.g. `origin/main`). Ideal for PR CI — grades just the diff. Requires a non-shallow checkout. | no | "" |
| threshold | Fail (exit 1) when the mutation score is below this value (0 = off). | no | "" |
| baseline | Path to a prior `--format json` report. Fail (exit 1) on NEW survivors or a score drop versus this baseline. | no | "" |
| baseline-epsilon | Score-drop tolerance for `baseline` (default: 0 = any drop fails). | no | "" |
| operators | Comma-separated operator names (default: the Tier-1 set). | no | "" |
| framework | minitest or rspec (default: auto-detected from test file names). | no | "" |
| strategy | reload (whole-file) or redefine (surgical). | no | "" |
| jobs | Parallel worker count (default: processor count). | no | "" |
| rails | Set to 'true' to boot config/environment once (Rails apps). | no | false |
| format | Report format: human or json (default: json so the report is machine-readable). | no | json |
| output | Write the report to this file instead of stdout. | no | "" |
| extra-args | Any additional raw flags appended verbatim to the mutineer invocation. | no | "" |
| working-directory | Directory to run Mutineer in (the project root). | no | . |
| use-bundler | Run via `bundle exec mutineer` (true) instead of a standalone `gem install mutineer` (false). Use true when mutineer is in the project's Gemfile (required for --rails, which boots the app's bundle). | no | false |
| version | Gem version to install when use-bundler is false (default: latest). | no | "" |
Outputs
| name | description |
|---|---|
| exit-code | The exit code returned by mutineer (0 pass, 1 below-threshold/regressed, 2 usage). |
| report | Path to the written report file, when the `output` input is set. |