dir: Add try_exists()

I want to use this for the same reason as
rust-lang/rust#81822
was added to std.  While it's currently unstable, I can't imagine
it would change.

Author: cgwalters

cap-async-std/src/fs/dir.rs

@@ -754,6 +754,19 @@ impl Dir {
         self.metadata(path).await.is_ok()
     }
 
+    /// Returns `true` if the path points at an existing entity.
+    ///
+    /// This corresponds to [`async_std::path::Path::exists`], but only
+    /// accesses paths relative to `self`.
+    #[inline]
+    pub async fn try_exists<P: AsRef<Path>>(&self, path: P) -> io::Result<bool> {
+        match self.metadata(path.as_ref()).await {
+            Ok(_) => Ok(true),
+            Err(error) if error.kind() == io::ErrorKind::NotFound => Ok(false),
+            Err(e) => Err(e),
+        }
+    }
+
     /// Returns `true` if the path exists on disk and is pointing at a regular
     /// file.
     ///

cap-async-std/src/fs_utf8/dir.rs

@@ -546,6 +546,15 @@ impl Dir {
         }
     }
 
+    /// Returns `true` if the path points at an existing entity.
+    ///
+    /// This corresponds to [`async_std::path::Path::exists`], but only
+    /// accesses paths relative to `self`.
+    #[inline]
+    pub async fn try_exists<P: AsRef<Utf8Path>>(&self, path: P) -> io::Result<bool> {
+        self.cap_std.try_exists(from_utf8(path)?).await
+    }
+
     /// Returns `true` if the path exists on disk and is pointing at a regular
     /// file.
     ///

cap-std/src/fs/dir.rs

@@ -584,6 +584,19 @@ impl Dir {
         self.metadata(path).is_ok()
     }
 
+    /// Returns `true` if the path points at an existing entity.
+    ///
+    /// This corresponds to [`std::path::Path::try_exists`], but only
+    /// accesses paths relative to `self`.
+    #[inline]
+    pub fn try_exists<P: AsRef<Path>>(&self, path: P) -> io::Result<bool> {
+        match self.metadata(path) {
+            Ok(_) => Ok(true),
+            Err(error) if error.kind() == io::ErrorKind::NotFound => Ok(false),
+            Err(error) => Err(error),
+        }
+    }
+
     /// Returns `true` if the path exists on disk and is pointing at a regular
     /// file.
     ///

cap-std/src/fs_utf8/dir.rs

@@ -533,6 +533,15 @@ impl Dir {
         }
     }
 
+    /// Returns `true` if the path points at an existing entity.
+    ///
+    /// This corresponds to [`std::path::Path::exists`], but only
+    /// accesses paths relative to `self`.
+    #[inline]
+    pub fn try_exists<P: AsRef<Utf8Path>>(&self, path: P) -> io::Result<bool> {
+        self.cap_std.try_exists(from_utf8(path)?)
+    }
+
     /// Returns `true` if the path exists on disk and is pointing at a regular
     /// file.
     ///

tests/dir-ext.rs

@@ -11,7 +11,7 @@ fn remove_file() {
     let file = tempdir.create("file").expect("create file to delete");
     drop(file);
     tempdir.remove_file_or_symlink("file").expect("delete file");
-    assert!(!tempdir.exists("file"), "deletion worked");
+    assert!(!tempdir.try_exists("file").unwrap(), "deletion worked");
 }
 
 #[test]

tests/fs_additional.rs

@@ -191,6 +191,12 @@ fn optionally_recursive_mkdir() {
     assert!(tmpdir.is_dir(dir));
 }
 
+#[test]
+fn try_exists() {
+    let tmpdir = tmpdir();
+    assert_eq!(tmpdir.try_exists("somefile").unwrap(), false);
+}
+
 #[test]
 fn optionally_nonrecursive_mkdir() {
     let tmpdir = tmpdir();

tests/fs_utf8.rs

@@ -458,6 +458,7 @@ fn file_test_fileinfo_check_exists_before_and_after_file_creation() {
     let file = "fileinfo_check_exists_b_and_a.txt";
     check!(check!(tmpdir.create(file)).write(b"foo"));
     assert!(tmpdir.exists(file));
+    assert!(tmpdir.try_exists(file).unwrap());
     check!(tmpdir.remove_file(file));
     assert!(!tmpdir.exists(file));
 }