feat: add SymlinkCheck::verified_path_allow_nonexisting()

Author: Byron

gix-status/Cargo.toml

@@ -9,7 +9,7 @@ description = "A crate of the gitoxide project dealing with 'git status'-like fu
 authors = ["Sebastian Thiel <sebastian.thiel@icloud.com>", "Pascal Kuthe <pascal.kuthe@semimod.de>"]
 edition = "2021"
 include = ["src/**/*", "LICENSE-*"]
-rust-version = "1.70"
+rust-version = "1.74"
 autotests = false
 
 [lib]

gix-status/src/stack.rs

@@ -1,6 +1,7 @@
-use std::path::{Path, PathBuf};
-
+use bstr::BStr;
 use gix_fs::Stack;
+use std::borrow::Cow;
+use std::path::{Path, PathBuf};
 
 use crate::SymlinkCheck;
 
@@ -27,6 +28,22 @@ impl SymlinkCheck {
         self.inner.make_relative_path_current(relative_path, &mut Delegate)?;
         Ok(self.inner.current())
     }
+
+    /// Like [`Self::verified_path()`], but do not fail if there is no directory entry at `relative_path` or on the way
+    /// to `relative_path`. Instead.
+    /// For convenience, this incarnation is tuned to be easy to use with Git paths, i.e. slash-separated `BString` path.
+    pub fn verified_path_allow_nonexisting(&mut self, relative_path: &BStr) -> std::io::Result<Cow<'_, Path>> {
+        let rela_path = gix_path::try_from_bstr(relative_path).map_err(std::io::Error::other)?;
+        if let Err(err) = self.verified_path(&rela_path) {
+            if err.kind() == std::io::ErrorKind::NotFound {
+                Ok(Cow::Owned(self.inner.root().join(rela_path)))
+            } else {
+                Err(err)
+            }
+        } else {
+            Ok(Cow::Borrowed(self.inner.current()))
+        }
+    }
 }
 
 struct Delegate;