hugr-cli 0.27.1

Compiler passes for Quantinuum's HUGR
Documentation
//! The `validate` subcommand.

use anyhow::Result;
use clap::Parser;
use std::io::Read;
#[cfg(feature = "tracing")]
use tracing::info;

use crate::CliError;
use crate::hugr_io::HugrInputArgs;

/// Validate and visualise a HUGR file.
#[derive(Parser, Debug)]
#[clap(version = "1.0", long_about = None)]
#[clap(about = "Validate a HUGR.")]
#[group(id = "hugr")]
#[non_exhaustive]
pub struct ValArgs {
    /// Hugr input.
    #[command(flatten)]
    pub input_args: HugrInputArgs,
}

/// String to print when validation is successful.
pub const VALID_PRINT: &str = "HUGR valid!";

impl ValArgs {
    /// Run the HUGR cli and validate against an extension registry.
    ///
    /// # Arguments
    ///
    /// * `input_override` - Optional reader to use instead of the CLI input argument.
    ///   If provided, this reader will be used for input instead of
    ///   `self.input_args.input`.
    pub fn run_with_input<R: Read>(&mut self, input_override: Option<R>) -> Result<()> {
        let (desc, package) = self
            .input_args
            .get_described_package_with_reader(input_override)?;
        let generator = desc.generator();
        package
            .validate()
            .map_err(|val_err| CliError::validation(generator, val_err))?;
        #[cfg(feature = "tracing")]
        info!("{VALID_PRINT}");
        #[cfg(not(feature = "tracing"))]
        eprintln!("{VALID_PRINT}");

        Ok(())
    }

    /// Run the HUGR cli and validate against an extension registry.
    pub fn run(&mut self) -> Result<()> {
        self.run_with_input(None::<&[u8]>)
    }
}