chore: add shell command builder

commit-id:96859c27

crates/infra_utils/Cargo.toml

@@ -8,3 +8,9 @@ description = "Infrastructure utility."
 
 [lints]
 workspace = true
+
+[dependencies]
+tokio = { workspace = true, features = ["process"] }
+
+[dev-dependencies]
+rstest.workspace = true

crates/infra_utils/src/command.rs

@@ -0,0 +1,29 @@
+use std::env;
+
+use tokio::process::Command;
+
+use crate::path::project_path;
+
+#[cfg(test)]
+#[path = "command_test.rs"]
+mod command_test;
+
+/// Returns a shell command originating from the project root, with cargo environment variables
+/// filtered out.
+///
+/// # Arguments
+/// * `command_name` - The shell command name.
+///
+/// # Returns
+/// * A [`std::process::Command`] object with the current directory set to the project root, and
+///   cleared out cargo related environment variables.
+pub fn create_shell_command(command_name: &str) -> Command {
+    let project_path = project_path().expect("Failed to get project path");
+    let mut command = Command::new(command_name);
+    command.current_dir(&project_path);
+    // Filter out all CARGO_ environment variables.
+    env::vars().filter(|(key, _)| key.starts_with("CARGO_")).for_each(|(key, _)| {
+        command.env_remove(key);
+    });
+    command
+}

crates/infra_utils/src/command_test.rs

@@ -0,0 +1,15 @@
+use rstest::rstest;
+
+use crate::command::create_shell_command;
+
+#[rstest]
+#[tokio::test]
+async fn create_shell_command_example() {
+    let mut ls_command = create_shell_command("ls");
+    let output = ls_command.output().await.expect("Failed to execute command");
+    let stdout = String::from_utf8_lossy(&output.stdout);
+
+    assert!(output.status.success());
+    // Project root should contain the `crates` directory.
+    assert!(stdout.contains("crates"));
+}

crates/infra_utils/src/lib.rs

@@ -1 +1,2 @@
+pub mod command;
 pub mod path;