feat: support giving cwd as an argument

README.md

@@ -123,6 +123,24 @@ match cwd_parent {
 }
 ```
 
+### Starting from a given current working directory
+
+With the `absolutize_from` function, you can provide the current working directory that the relative paths should be resolved from.
+
+```rs
+extern crate path_absolutize;
+
+use std::path::Path;
+
+use path_absolutize::*;
+
+let p = Path::new("../path/to/123/456");
+let cwd = env::current_dir().unwrap();
+
+println!("{}", p.absolutize_from(cwd).unwrap().to_str().unwrap());
+```
+
+
 ### absolutize_virtually
 
 Get an absolute path **only under a specific directory**.

src/absolutize.rs

@@ -7,6 +7,9 @@ pub trait Absolutize {
     /// Get an absolute path. This works even if the path does not exist.
     fn absolutize(&self) -> io::Result<Cow<Path>>;
 
+    /// Get an absolute path. This works even if the path does not exist. It gets the current working directory as the second argument.
+    fn absolutize_from(&self, cwd: &Path) -> io::Result<Cow<'_, Path>>;
+
     /// Get an absolute path. This works even if the path does not exist.
     fn absolutize_virtually<P: AsRef<Path>>(&self, virtual_root: P) -> io::Result<Cow<Path>>;
 }

src/lib.rs

@@ -383,6 +383,11 @@ impl Absolutize for PathBuf {
         self.as_path().absolutize()
     }
 
+    #[inline]
+    fn absolutize_from(&self, cwd: &Path) -> io::Result<Cow<'_, Path>> {
+        self.as_path().absolutize_from(cwd)
+    }
+
     #[inline]
     fn absolutize_virtually<P: AsRef<Path>>(&self, virtual_root: P) -> io::Result<Cow<Path>> {
         self.as_path().absolutize_virtually(virtual_root)

src/unix.rs

@@ -8,12 +8,15 @@ use crate::Absolutize;
 
 impl Absolutize for Path {
     fn absolutize(&self) -> io::Result<Cow<Path>> {
+        let cwd = get_cwd!();
+        self.absolutize_from(&cwd)
+    }
+
+    fn absolutize_from(&self, cwd: &Path) -> io::Result<Cow<'_, Path>> {
         let mut iter = self.components();
 
         let mut has_change = false;
 
-        let cwd = get_cwd!();
-
         if let Some(first_component) = iter.next() {
             let mut tokens = Vec::new();
 
@@ -104,7 +107,7 @@ impl Absolutize for Path {
                 Ok(Cow::from(self))
             }
         } else {
-            Ok(Cow::from(cwd))
+            Ok(Cow::from(cwd.to_owned()))
         }
     }
 

src/windows.rs

@@ -8,12 +8,15 @@ use crate::Absolutize;
 
 impl Absolutize for Path {
     fn absolutize(&self) -> io::Result<Cow<Path>> {
+        let cwd = get_cwd!();
+        self.absolutize_from(&cwd)
+    }
+
+    fn absolutize_from(&self, cwd: &Path) -> io::Result<Cow<'_, Path>> {
         let mut iter = self.components();
 
         let mut has_change = false;
 
-        let cwd = get_cwd!();
-
         if let Some(first_component) = iter.next() {
             let mut tokens = Vec::new();
 
@@ -182,7 +185,7 @@ impl Absolutize for Path {
                 Ok(Cow::from(self))
             }
         } else {
-            Ok(Cow::from(cwd))
+            Ok(Cow::from(cwd.to_owned()))
         }
     }