clibra 0.10.3-beta

// SPDX-License-Identifier: MIT
// Copyright 2026 John Harwell, All rights reserved.
/*!
 * Implementation of the coverage command.
 */

// Imports
use anyhow;
use clap;
use log::debug;
use open;

use crate::cmake;
use crate::preset;
use crate::runner;

// Types
#[derive(clap::Parser, Debug)]
pub struct CoverageArgs {
    /// Generate HTML report.
    ///
    /// Tries gcovr and LLVM-based generation in order.
    #[arg(long, default_value_t = true)]
    pub html: bool,

    /// Check code coverage with gcovr.
    #[arg(long)]
    pub check: bool,

    /// Open the HTML report in the system browser after generation.
    #[arg(long)]
    pub open: bool,

    #[arg(short = 'D', value_name = "VAR=VALUE")]
    pub defines: Vec<String>,

    /// Force the configure step even if the build directory exists.
    #[arg(short, long)]
    pub reconfigure: bool,

    /// Reconfigure with a --fresh cmake build directory.
    #[arg(short, long)]
    pub fresh: bool,

}

// Traits

// Implementation

// Public API

pub fn run(ctx: &runner::Context, args: CoverageArgs) -> anyhow::Result<()> {
    preset::ensure_project_root(ctx)?;
    debug!("Begin");

    let preset = preset::resolve(ctx, Some("coverage"))?;

    if args.reconfigure {
        debug!("Begin reconfigure");
        cmake::reconf(ctx, &preset, args.fresh, &args.defines)?;
    }

    let mut success = false;
    if args.html {
        cmake::ensure_libra_feature_enabled(ctx, &preset, "LIBRA_CODE_COV")?;
        debug!("Checking ['gcovr-report','llvm-report'] existence");

        let target = if ctx.dry_run {
            "gcovr-report"
        } else {
            ["gcovr-report", "llvm-report"]
                .iter()
                .copied()
                .find_map(|t| match cmake::target_status(t, &preset, ctx) {
                    Ok(cmake::TargetStatus::Available) => Some(Ok(t)),
                    Ok(cmake::TargetStatus::Unavailable(_)) => None,
                    Err(e) => Some(Err(e)),
                })
                .ok_or_else(|| {
                    anyhow::anyhow!(
                        "no HTML-generating targets
                exist"
                    )
                })??
        };

        debug!("Found {target}");
        ctx.run(cmake::base_build(&preset).args(["--target", target]))?;

        if args.open && !ctx.dry_run {
            let bdir = cmake::binary_dir(&preset)
                .ok_or_else(|| anyhow::anyhow!("build directory not found"))?;
            open::that(bdir.join("coverage").join("index.html"))?;
        }
        success = true;
    }
    if args.check {
        cmake::ensure_libra_feature_enabled(ctx, &preset, "LIBRA_CODE_COV")?;
        debug!("Checking ['gcovr-check'] existence");

        let target = if ctx.dry_run {
            "gcovr-check"
        } else {
            ["gcovr-check"]
                .iter()
                .copied()
                .find_map(|t| match cmake::target_status(t, &preset, ctx) {
                    Ok(cmake::TargetStatus::Available) => Some(Ok(t)),
                    Ok(cmake::TargetStatus::Unavailable(_)) => None,
                    Err(e) => Some(Err(e)),
                })
                .ok_or_else(|| anyhow::anyhow!("no checking targets exist"))??
        };

        debug!("Found {target}");
        ctx.run(cmake::base_build(&preset).args(["--target", target]))?;

        success = true;
    }

    if !success {
        anyhow::bail!("Failed to run any coverage targets")
    }
    Ok(())
}