feat: Add yolk exec-canonical subcommand

Author: elkowar

src/main.rs

@@ -60,6 +60,13 @@ enum Command {
     ///
     /// This renames `.git` to `.yolk_git` to ensure that git interaction happens through the yolk CLI
     Safeguard,
+
+    /// Run a given shell command within a canonical context. I.e.: `yolk exec-canonical gitui`.
+    #[clap(name = "exec-canonical")]
+    ExecCanonical {
+        #[clap(allow_hyphen_values = true)]
+        command: Vec<String>,
+    },
     /// Make sure you don't accidentally commit your local egg states
     ///
     /// Evaluate a rhai expression.
@@ -271,6 +278,17 @@ fn run_command(args: Args) -> Result<()> {
                 .map_err(|e| e.into_report("<inline>", expr))?;
             println!("{result}");
         }
+        Command::ExecCanonical { command } => {
+            yolk.with_canonical_state(|| {
+                let mut command = command.iter();
+                let binary = command.next().context("No command to run given")?;
+                yolk.paths()
+                    .start_command(binary)?
+                    .args(command)
+                    .status()
+                    .into_diagnostic()
+            })?;
+        }
         Command::Git {
             command,
             force_canonical,

src/yolk_paths.rs

@@ -1,4 +1,7 @@
-use std::path::{Path, PathBuf};
+use std::{
+    path::{Path, PathBuf},
+    process::Command,
+};
 
 use fs_err::PathExt;
 use miette::{Context as _, IntoDiagnostic, Result};
@@ -140,6 +143,19 @@ impl YolkPaths {
         Ok(())
     }
 
+    /// Start a [`std::process::Command`] with the `GIT_DIR` variable set to the git directory.
+    pub fn start_command(&self, binary: &str) -> Result<Command> {
+        let mut cmd = Command::new(binary);
+        cmd.env(
+            "GIT_DIR",
+            self.active_yolk_git_dir()?
+                .canonical()?
+                .to_string_lossy()
+                .to_string(),
+        );
+        Ok(cmd)
+    }
+
     /// Start a [Git] command helper with the paths correctly set for this yolk repository
     pub fn start_git(&self) -> Result<Git> {
         Ok(Git::new(self.root_path(), self.active_yolk_git_dir()?))