Struct CoverageRun 

pub struct CoverageRun { /* private fields */ }

Configuration for a coverage run.

Wraps cargo llvm-cov --json --summary-only. Use the builder methods to scope the run (working directory, workspace toggle, excludes, features), then call execute to invoke the subprocess and parse the result.

Example

use dev_coverage::CoverageRun;

let run = CoverageRun::new("my-crate", "0.1.0")
    .workspace()
    .exclude("tests/*")
    .all_features();

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

Implementations

impl CoverageRun

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

Begin a coverage run for the given crate name and version.

name and version are descriptive — they identify the subject in the produced dev-report::Report. They do NOT need to match the package being measured (that is determined by cargo’s own resolution from the working directory).

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

Run cargo llvm-cov from dir instead of the current directory.

pub fn subject(&self) -> &str

Descriptive subject name passed in via new.

pub fn subject_version(&self) -> &str

Descriptive subject version passed in via new.

pub fn workspace(self) -> Self

Pass --workspace so every workspace member is measured.

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

Pass --exclude <pattern>. May be called multiple times.

pub fn feature(self, name: impl Into<String>) -> Self

Add a specific feature to enable. May be called multiple times.

pub fn all_features(self) -> Self

Pass --all-features.

pub fn no_default_features(self) -> Self

Pass --no-default-features.

pub fn per_file(self) -> Self

Request a per-file breakdown (drops --summary-only).

Default is summary-only — much smaller JSON, faster parse. Enable this when you need CoverageResult::files populated.

pub fn execute(&self) -> Result<CoverageResult, CoverageError>

Execute the run.

Returns a CoverageResult on success, or a CoverageError describing what went wrong (missing tool, subprocess failure, parse failure).

Trait Implementations

impl Clone for CoverageRun

fn clone(&self) -> CoverageRun

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CoverageRun

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

Formats the value using the given formatter.