Crate covguard_orchestrator 

Application orchestration for covguard.

This crate provides the high-level check function that orchestrates the entire diff coverage analysis pipeline:

1. Parse the diff to extract changed line ranges
2. Parse LCOV coverage data
3. Detect ignore directives in source files
4. Evaluate coverage against the policy
5. Build and return a report with markdown and annotations

Example

use covguard_orchestrator::{check, CheckRequest};
use covguard_types::Scope;

let request = CheckRequest {
    diff_text: "...".to_string(),
    diff_file_path: Some("test.patch".to_string()),
    lcov_texts: vec!["...".to_string()],
    lcov_paths: vec!["coverage.info".to_string()],
    threshold_pct: 80.0,
    scope: Scope::Added,
    ..Default::default()
};

let result = check(request)?;
println!("Exit code: {}", result.exit_code);

Structs

CheckRequest

Request for a coverage check operation.

CheckResult

Result of a coverage check operation.

SystemClock

System clock implementation that returns the actual current time.

Enums

AppError

Errors that can occur during the check operation.

FailOn

Determines when the evaluation should fail.

MissingBehavior

How to handle missing coverage data.

Constants

DEFAULT_MAX_ANNOTATIONS

Backward-compatible constant aliases for output budgets.

DEFAULT_MAX_LINES

DEFAULT_MAX_SARIF_RESULTS

Traits

Clock

Port for obtaining the current UTC time.

CoverageProvider

Port for loading and merging LCOV coverage data.

DiffProvider

Port for obtaining changed ranges from diff input.

RepoReader

Port for reading source lines from the repository.

Functions

build_report

Build a Report from evaluation output.

check

Run a diff coverage check.

check_with_clock

Run a diff coverage check with a custom clock.

check_with_clock_and_reader

Run a diff coverage check with a custom clock and repo reader.

check_with_providers_and_reader

Run a diff coverage check with pluggable diff and coverage providers.

detect_ignored_lines

Detect lines with covguard: ignore directives in changed ranges.

render_annotations

Backward-compatible annotation renderer with project-wide default limit.

render_annotations_with_limit

Annotation renderer with configurable budget.

render_markdown

Backward-compatible markdown renderer with project-wide default limit.

render_markdown_with_limit

Markdown renderer with configurable budget.

render_sarif

Backward-compatible SARIF renderer with project-wide default limit.

render_sarif_with_limit

SARIF renderer with configurable budget.

Type Aliases

CoverageMap

Canonical line-hit representation used at the port boundary.