Adding qasm lang + improving CLI

Author: ciaranra

Cargo.lock

@@ -40,9 +40,11 @@ bytemuck = {  version = "1", features = ["derive"] }
 bitflags = "2"
 dyn-clone = "1"
 regex = "1"
+pest = "2.7"
 
 pecos-core = { version = "0.1.1", path = "crates/pecos-core" }
 pecos-qsim = { version = "0.1.1", path = "crates/pecos-qsim" }
+pecos-qasm = { version = "0.1.1", path = "crates/pecos-qasm" }
 pecos-engines = { version = "0.1.1", path = "crates/pecos-engines" }
 pecos-qec = { version = "0.1.1", path = "crates/pecos-qec" }
 pecos = { version = "0.1.1", path = "crates/pecos" }

Cargo.toml

@@ -20,11 +20,14 @@ path = "src/main.rs"
 pecos.workspace = true
 clap.workspace = true
 env_logger.workspace = true
+rand.workspace = true
+log.workspace = true
 
 [dev-dependencies]
 assert_cmd = "2.0"
 predicates = "3.0"
 tempfile = "3.8"
+serde_json = "1.0"
 
 [lints]
 workspace = true

crates/pecos-cli/Cargo.toml

@@ -0,0 +1,50 @@
+use log::debug;
+use pecos::prelude::*;
+use std::error::Error;
+use std::path::Path;
+
+/// Sets up a classical engine for the CLI based on the program type
+///
+/// This function handles all engine types including QIR, PHIR, and QASM.
+pub fn setup_cli_engine(
+    program_path: &Path,
+    shots: Option<usize>,
+) -> Result<Box<dyn ClassicalEngine>, Box<dyn Error>> {
+    debug!("Setting up engine for path: {}", program_path.display());
+
+    // Create build directory for engine outputs
+    let build_dir = program_path.parent().unwrap().join("build");
+    debug!("Build directory: {}", build_dir.display());
+    std::fs::create_dir_all(&build_dir)?;
+
+    match detect_program_type(program_path)? {
+        ProgramType::QIR => {
+            debug!("Setting up QIR engine");
+            let mut engine = QirEngine::new(program_path.to_path_buf());
+
+            // Set the number of shots assigned to this engine if specified
+            if let Some(num_shots) = shots {
+                engine.set_assigned_shots(num_shots)?;
+            }
+
+            // Pre-compile the QIR library for efficient cloning
+            engine.pre_compile()?;
+
+            Ok(Box::new(engine))
+        }
+        ProgramType::PHIR => {
+            debug!("Setting up PHIR engine");
+            let engine = PHIREngine::new(program_path)?;
+            Ok(Box::new(engine))
+        }
+        ProgramType::QASM => {
+            debug!("Setting up QASM engine");
+
+            // Create a new QASMEngine from the path
+            // Let MonteCarloEngine handle all seeding and randomness
+            let engine = QASMEngine::with_file(program_path)?;
+
+            Ok(Box::new(engine))
+        }
+    }
+}