Struct LcovData 

pub struct LcovData {
    pub functions: HashMap<PathBuf, Vec<FunctionCoverage>>,
    pub total_lines: usize,
    pub lines_hit: usize,
    /* private fields */
}

Parsed LCOV coverage data.

Contains all coverage information extracted from an LCOV file, organized by file path for efficient lookup. Includes a pre-built index for O(1) function coverage lookups.

Thread Safety

The coverage_index is wrapped in Arc for lock-free sharing across threads during parallel analysis operations.

Example

use std::path::Path;
use debtmap::risk::lcov::{parse_lcov_file, LcovData};

let data = parse_lcov_file(Path::new("coverage.info"))?;
println!("Total lines: {}", data.total_lines);
println!("Lines hit: {}", data.lines_hit);
println!("Coverage: {:.1}%", data.get_overall_coverage());

Fields

functions: HashMap<PathBuf, Vec<FunctionCoverage>>

Map of file paths to their function coverage data

total_lines: usize

Total number of executable lines across all files

lines_hit: usize

Number of lines that were executed

Implementations

impl LcovData

pub fn with_loc_counter(self, loc_counter: LocCounter) -> Self

Set the LOC counter to use for consistent line counting.

Arguments

• loc_counter - The LOC counter instance to use

Returns

Self with the LOC counter set.

pub fn loc_counter(&self) -> Option<&LocCounter>

Get the LOC counter instance if set.

pub fn recalculate_with_loc_counter(&mut self)

Recalculate total lines using LOC counter for consistency.

This ensures coverage denominator matches the LOC count used elsewhere. Useful when you want the coverage percentage to align with LOC-based metrics.

pub fn get_function_coverage( &self, file: &Path, function_name: &str, ) -> Option<f64>

Get function coverage using O(1) indexed lookup.

This method uses the pre-built coverage index for fast lookups, avoiding the O(n) linear search through function arrays.

Arguments

• file - Path to the source file
• function_name - Name of the function

Returns

Coverage as a fraction (0.0 to 1.0), or None if not found.

pub fn get_function_coverage_with_line( &self, file: &Path, function_name: &str, line: usize, ) -> Option<f64>

Get function coverage with line number fallback using O(log n) indexed lookup.

Tries exact function name match first (O(1)), then falls back to line-based lookup (O(log n)) if needed.

Arguments

• file - Path to the source file
• function_name - Name of the function
• line - Line number for fallback lookup

Returns

Coverage as a fraction (0.0 to 1.0), or None if not found.

pub fn get_function_coverage_with_bounds( &self, file: &Path, function_name: &str, _start_line: usize, _end_line: usize, ) -> Option<f64>

Get function coverage using exact boundaries from AST analysis.

This is more accurate than guessing boundaries from LCOV data alone. Uses path normalization (Spec 201) and function name matching (Spec 202) to find the correct function even when names don’t match exactly.

Integration of Specs 201, 202, and 203:

• Uses path normalization (Spec 201) to find matching files
• Uses function name matching (Spec 202) to find matching functions
• Returns 0.0 instead of None when LCOV provided but function not found (Spec 203)
• Logs diagnostics when DEBTMAP_COVERAGE_DEBUG is set (Spec 203)

Arguments

• file - Path to the source file
• function_name - Name of the function
• _start_line - Start line (reserved for future use)
• _end_line - End line (reserved for future use)

Returns

Coverage as a fraction (0.0 to 1.0), or None if file not in LCOV data. Returns Some(0.0) if file is in LCOV but function not found.

pub fn get_overall_coverage(&self) -> f64

Get overall coverage percentage.

Returns

Overall coverage as a percentage (0.0 to 100.0).

pub fn get_file_coverage(&self, file: &Path) -> Option<f64>

Get coverage percentage for a specific file.

Arguments

• file - Path to the source file

Returns

Coverage as a fraction (0.0 to 1.0), or None if file not found.

pub fn get_function_uncovered_lines( &self, file: &Path, function_name: &str, line: usize, ) -> Option<Vec<usize>>

Get uncovered lines for a function using O(1) indexed lookup.

Arguments

• file - Path to the source file
• function_name - Name of the function
• line - Line number for fallback lookup

Returns

List of uncovered line numbers, or None if function not found.

pub fn batch_get_function_coverage( &self, queries: &[(PathBuf, String, usize)], ) -> Vec<Option<f64>>

Batch process coverage queries for multiple functions in parallel.

This is more efficient when querying coverage for many functions at once.

Arguments

• queries - List of (file, function_name, line) tuples

Returns

Vector of coverage values in the same order as queries.

pub fn get_all_file_coverages(&self) -> HashMap<PathBuf, f64>

Get coverage statistics for all files in parallel.

Returns

HashMap mapping file paths to their coverage (as fractions 0.0 to 1.0).

impl LcovData

pub fn new() -> Self

Create a new empty LcovData instance.

Example

let data = LcovData::new();
assert_eq!(data.total_lines, 0);
assert!(data.functions.is_empty());

pub fn build_index(&mut self)

Build the coverage index from current function data.

This should be called after modifying the functions HashMap to ensure the index is up to date for O(1) lookups.

Trait Implementations

impl Clone for LcovData

fn clone(&self) -> LcovData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LcovData

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

Formats the value using the given formatter.

impl Default for LcovData

fn default() -> Self

Returns the “default value” for a type.