Struct MutateRun 

pub struct MutateRun { /* private fields */ }

Configuration for a mutation testing run.

Example

use dev_mutate::MutateRun;
use std::time::Duration;

let run = MutateRun::new("my-crate", "0.1.0")
    .workspace()
    .jobs(4)
    .timeout(Duration::from_secs(120))
    .exclude_re(r"^src/generated/");

let _result = run.execute().unwrap();

Implementations

impl MutateRun

pub fn new(name: impl Into<String>, version: impl Into<String>) -> Self

Begin a new mutation testing run.

name and version are descriptive — they identify the subject in the produced Report.

pub fn in_dir(self, dir: impl Into<PathBuf>) -> Self

Run cargo mutants from dir instead of the current directory.

pub fn workspace(self) -> Self

Pass --workspace so every workspace member is mutated.

pub fn jobs(self, n: u32) -> Self

Pass --jobs <N> (parallel mutation runs). Maps to cargo-mutants’ own job limit.

pub fn timeout(self, d: Duration) -> Self

Per-mutant timeout (passed through as --timeout <secs>).

pub fn exclude_re(self, pattern: impl Into<String>) -> Self

Skip files matching the given regex. Repeatable; maps to --exclude-re <pattern> per invocation.

pub fn file(self, pattern: impl Into<String>) -> Self

Restrict to files matching the given glob / path. Repeatable; maps to --file <pattern> per invocation.

pub fn allow(self, description: impl Into<String>) -> Self

Suppress a known-survivor by descriptor. The match is on the description field of SurvivingMutant (e.g. "replace + with -").

pub fn allow_all<I, S>(self, descriptions: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Bulk version of allow.

pub fn subject(&self) -> &str

Subject name passed in via new.

pub fn subject_version(&self) -> &str

Subject version passed in via new.

pub fn execute(&self) -> Result<MutateResult, MutateError>

Execute the run.

Spawns cargo mutants --json with the configured flags. Tool absence, subprocess failure, and parse failure surface as typed MutateError variants. No panics.

Trait Implementations

impl Clone for MutateRun

fn clone(&self) -> MutateRun

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MutateRun

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.