# mutagen_ex v0.2.0 - API Reference

## Modules

- [MutagenEx.GitDiff](MutagenEx.GitDiff.md): Reads changed source lines against a Git merge-base and reads blobs from it.
- [MutagenEx.Test.CaptureIo](MutagenEx.Test.CaptureIo.md): Default `MutagenEx.Test.CaptureIoFacade` implementation — thin wrapper
over `ExUnit.CaptureIO`.
- [MutagenEx.Test.CodeServer](MutagenEx.Test.CodeServer.md): Production implementation of `MutagenEx.Test.CodeServerFacade` — a
thin pass-through to the `:code` module.
- [MutagenEx.Test.Compiler](MutagenEx.Test.Compiler.md): Default `MutagenEx.Test.CompilerFacade` implementation — thin wrapper
over `Code.compile_quoted/2`.
- [MutagenEx.Test.Cover](MutagenEx.Test.Cover.md): Default `MutagenEx.Test.CoverFacade` implementation — thin wrapper
over Erlang's `:cover` module.
- [MutagenEx.Test.ExUnit](MutagenEx.Test.ExUnit.md): Default `MutagenEx.Test.ExUnitFacade` implementation — thin wrapper
over the real `ExUnit` module.
- [MutagenEx.Test.ExUnitServer](MutagenEx.Test.ExUnitServer.md): Default `MutagenEx.Test.ExUnitServerFacade` implementation — thin
wrapper over `ExUnit.Server`.

- Mutators
  - [MutagenEx.Mutators](MutagenEx.Mutators.md): Registry and behaviour for the ten v1 mutators.
  - [MutagenEx.Mutators.Arith](MutagenEx.Mutators.Arith.md): Swaps numeric binary operators: `+ ↔ -`, `* ↔ /`.
  - [MutagenEx.Mutators.Boolean](MutagenEx.Mutators.Boolean.md): Swaps boolean operators and drops boolean negations:
`and ↔ or`, `&& ↔ ||`, `not x → x`, `!x → x`.
  - [MutagenEx.Mutators.CaseDrop](MutagenEx.Mutators.CaseDrop.md): Drops the last clause of a `case` or `cond` expression.
  - [MutagenEx.Mutators.Compare](MutagenEx.Mutators.Compare.md): Swaps comparison operators: `== ↔ !=`, `< ↔ >=`, `> ↔ <=`.
  - [MutagenEx.Mutators.Dispatch](MutagenEx.Mutators.Dispatch.md): Static, order-preserving head-atom dispatch table for the mutator catalog.
  - [MutagenEx.Mutators.ElseRemoval](MutagenEx.Mutators.ElseRemoval.md): Removes the `else` branch from an `if` or `with` expression.
  - [MutagenEx.Mutators.GuardDrop](MutagenEx.Mutators.GuardDrop.md): Drops the guard from a function clause head.
  - [MutagenEx.Mutators.Literal](MutagenEx.Mutators.Literal.md): Flips `true ↔ false` and swaps small integer literals: `0 ↔ 1`, `1 ↔ 0`,
`-1 → 1`.
  - [MutagenEx.Mutators.Pipeline](MutagenEx.Mutators.Pipeline.md): Reorders two adjacent `|>` segments.
  - [MutagenEx.Mutators.ResultTuple](MutagenEx.Mutators.ResultTuple.md): Flips `{:ok, x}` and `{:error, x}` tagged tuples.
  - [MutagenEx.Mutators.WithSwap](MutagenEx.Mutators.WithSwap.md): Reorders the first two `<-` clauses of a `with` expression.

- Pipeline Facades
  - [MutagenEx.Pipeline.AstCacheFacade](MutagenEx.Pipeline.AstCacheFacade.md): Behaviour for the `:ast_cache` slot of the `Mix.Tasks.Mutagen`
dispatch table.
  - [MutagenEx.Pipeline.BaselineFacade](MutagenEx.Pipeline.BaselineFacade.md): Behaviour for the `:baseline` slot of the `Mix.Tasks.Mutagen`
dispatch table.
  - [MutagenEx.Pipeline.CliFacade](MutagenEx.Pipeline.CliFacade.md): Behaviour for the `:cli` slot of the `Mix.Tasks.Mutagen` dispatch table.
  - [MutagenEx.Pipeline.CoverageFacade](MutagenEx.Pipeline.CoverageFacade.md): Behaviour for the `:coverage` slot of the `Mix.Tasks.Mutagen`
dispatch table.
  - [MutagenEx.Pipeline.DefaultIo](MutagenEx.Pipeline.DefaultIo.md): Writes the report to the selected destination and halts with the pipeline's exit code.
  - [MutagenEx.Pipeline.EnumeratorFacade](MutagenEx.Pipeline.EnumeratorFacade.md): Behaviour for the `:enumerator` slot of the `Mix.Tasks.Mutagen`
dispatch table.
  - [MutagenEx.Pipeline.IoFacade](MutagenEx.Pipeline.IoFacade.md): Behaviour for the `:io` slot of the `Mix.Tasks.Mutagen` dispatch
table.
  - [MutagenEx.Pipeline.MutationFacade](MutagenEx.Pipeline.MutationFacade.md): Behaviour for the `:mutation` slot of the `Mix.Tasks.Mutagen`
dispatch table.
  - [MutagenEx.Pipeline.ReporterErrorFacade](MutagenEx.Pipeline.ReporterErrorFacade.md): Behaviour for the `:reporter_error` slot of the `Mix.Tasks.Mutagen`
dispatch table.
  - [MutagenEx.Pipeline.ReporterOkFacade](MutagenEx.Pipeline.ReporterOkFacade.md): Behaviour for the `:reporter_ok` slot of the `Mix.Tasks.Mutagen`
dispatch table.
  - [MutagenEx.Pipeline.ScopeFacade](MutagenEx.Pipeline.ScopeFacade.md): Behaviour for the `:scope` slot of the `Mix.Tasks.Mutagen` dispatch
table.
  - [MutagenEx.Pipeline.TestsFacade](MutagenEx.Pipeline.TestsFacade.md): Behaviour for the `:tests` slot of the `Mix.Tasks.Mutagen` dispatch
table.

- Test Facades
  - [MutagenEx.Test.CaptureIoFacade](MutagenEx.Test.CaptureIoFacade.md): Behaviour for the `ExUnit.CaptureIO` test seam used by
`MutagenEx.MutationRunner` (around the swap-compile call) and
`MutagenEx.MutationRunner.MutationLoop` (around the per-site test
run, to absorb compiler warnings and any other stderr emitted during
the mutation cycle).
  - [MutagenEx.Test.CodeServerFacade](MutagenEx.Test.CodeServerFacade.md): Behaviour for the `:code` module seam used by `MutagenEx.BeamCache`.
  - [MutagenEx.Test.CompilerFacade](MutagenEx.Test.CompilerFacade.md): Behaviour for the `Code` compile-quoted test seam used by
`MutagenEx.MutationRunner`.
  - [MutagenEx.Test.CoverFacade](MutagenEx.Test.CoverFacade.md): Behaviour for the OTP `:cover` test seam used by
`MutagenEx.CoverageRunner`.
  - [MutagenEx.Test.ExUnitFacade](MutagenEx.Test.ExUnitFacade.md): Behaviour for the `ExUnit` test seam used by `MutagenEx.Baseline`,
`MutagenEx.CoverageRunner`, `MutagenEx.MutationRunner`, and
`MutagenEx.MutationRunner.MutationLoop`.
  - [MutagenEx.Test.ExUnitServerFacade](MutagenEx.Test.ExUnitServerFacade.md): Behaviour for the `ExUnit.Server` test seam used by
`MutagenEx.MutationRunner.MutationLoop`.

- Core
  - [MutagenEx.Application](MutagenEx.Application.md): OTP `Application` callback for `:mutagen_ex`.
  - [MutagenEx.Ast](MutagenEx.Ast.md): Canonical shared AST helpers for the mutagen pipeline.
  - [MutagenEx.AstCache](MutagenEx.AstCache.md): Immutable cache of `{quoted_ast, source_text}` tuples for the in-scope
source files of a `mix mutagen` run.
  - [MutagenEx.Baseline](MutagenEx.Baseline.md): Pre-mutation test pass: do the cited tests pass on unmodified code?
  - [MutagenEx.BeamCache](MutagenEx.BeamCache.md): Per-run `.beam` snapshot store for `MutagenEx.MutationRunner`.
  - [MutagenEx.CLI](MutagenEx.CLI.md): Pure command-line argument parser for `mix mutagen`.
  - [MutagenEx.Config](MutagenEx.Config.md): Parsed, validated configuration for a single `mix mutagen` invocation.
  - [MutagenEx.CoverageRunner](MutagenEx.CoverageRunner.md): Runs the cited test suite once under `:cover` to determine which source
lines those tests exercise.
  - [MutagenEx.JsonPath](MutagenEx.JsonPath.md): Canonicalisation and safety checks for `--json <path>`.
  - [MutagenEx.JsonReporter](MutagenEx.JsonReporter.md): Single owner of the version 2 JSON output document for `mix mutagen`.
  - [MutagenEx.JsonReporter.Report](MutagenEx.JsonReporter.Report.md): In-memory shape the pipeline assembles before the JSON reporter
serialises it.
  - [MutagenEx.JsonReporter.Sanitizer](MutagenEx.JsonReporter.Sanitizer.md): Truncation + redaction of free-form text that flows into the version 2 JSON
document (warnings, compile-error messages, abort-detail messages, and
any other string field that captures user-code-derived bytes).
  - [MutagenEx.JsonStreamer](MutagenEx.JsonStreamer.md): Per-site NDJSON line emitter for `mix mutagen --stream`.
  - [MutagenEx.MutationEnumerator](MutagenEx.MutationEnumerator.md): Walks the in-scope ASTs from the AST cache and produces a deterministic,
ordered list of `%MutagenEx.MutationEnumerator.Site{}` records, plus a
parallel `skipped` list and a `warnings` list.
  - [MutagenEx.MutationEnumerator.Site](MutagenEx.MutationEnumerator.Site.md): A single mutation site emitted by `MutagenEx.MutationEnumerator`.
  - [MutagenEx.MutationRunner](MutagenEx.MutationRunner.md): Per-mutation execution: swap → run → classify → restore. Aggregates the
per-site outcomes into a result block the JSON reporter (S6) can
serialise.
  - [MutagenEx.Progress](MutagenEx.Progress.md): Human-readable per-site progress feedback written to stderr.
  - [MutagenEx.Runtime](MutagenEx.Runtime.md): Prepares a host Mix project and its ExUnit environment for an in-process run.

  - [MutagenEx.ScopeResolver](MutagenEx.ScopeResolver.md): Resolves user-supplied `--scope` targets into concrete
`%MutagenEx.ScopeResolver.Scope{}` records describing the file, line range,
and module each target points at.
  - [MutagenEx.ScopeResolver.Scope](MutagenEx.ScopeResolver.Scope.md): A resolved scope record. `file` is relative to the project root.
`line_range` is an inclusive range of source lines, and `module` is the
resolved module atom. MFA targets also carry a `{name, arity}` selector.

  - [MutagenEx.TestModuleDiscovery](MutagenEx.TestModuleDiscovery.md): Finds loaded ExUnit cases in the cited test files.
  - [MutagenEx.TestSelector](MutagenEx.TestSelector.md): Resolves user-supplied `--tests` targets into the `{include, exclude, files}`
shape ExUnit's filter system expects.
  - [MutagenEx.TestSelector.TestFilter](MutagenEx.TestSelector.TestFilter.md): The resolved ExUnit-shaped filter.
  - [MutagenEx.Types](MutagenEx.Types.md): Shared type definitions used across the `mutagen_ex` pipeline.

## Mix Tasks

- [mix mutagen](Mix.Tasks.Mutagen.md): # mix mutagen

