Implement Path::try_exists

Implements the `Path::try_exists` associated function mentioned in #46. The aliased function was stabilized in 1.63 so to preserve compatibility with older Rust versions (ci targets 1.40) a new feature flag was added.

.github/workflows/ci.yml

@@ -54,9 +54,9 @@ jobs:
  args: --tests -- -D warnings
  if: matrix.rust_version == 'stable'
 
- - name: cargo check --features io_safety
+ - name: cargo check --features "io_safety path_try_exists"
  uses: actions-rs/cargo@v1
  with:
  command: clippy
- args: --features io_safety
+ args: --features "io_safety path_try_exists"
  if: matrix.rust_version == 'stable'

CHANGELOG.md

@@ -1,5 +1,7 @@
 # fs-err Changelog
 
+* Add `fs_err_try_exists` to `std::path::Path` via extension trait. This feature requires Rust 1.63 or later and is gated behind the `path_try_exists` feature flag. ([]())
+
 ## 2.9.0
 
 * Add wrappers for [`tokio::fs`](https://docs.rs/tokio/latest/tokio/fs/index.html) ([#40](https://github.com/andrewhickman/fs-err/pull/40)).

Cargo.toml

@@ -18,7 +18,9 @@ tokio = { version = "1.21", optional = true, default_features = false, features
 serde_json = "1.0.64"
 
 [features]
-# Adds I/O safety traits introduced in Rust 1.63
+# Adds `fs_err_try_exists` to `Path`, introduced in Rust 1.6.3
+path_try_exists = []
+# Adds I/O safety traits, introduced in Rust 1.63
 io_safety = []
 
 [package.metadata.release]

src/errors.rs

@@ -23,6 +23,8 @@ pub(crate) enum ErrorKind {
  Canonicalize,
  ReadLink,
  SymlinkMetadata,
+ #[allow(dead_code)]
+ FileExists,
 
  #[cfg(windows)]
  SeekRead,
@@ -84,6 +86,7 @@ impl fmt::Display for Error {
  Canonicalize => write!(formatter, "failed to canonicalize path `{}`", path),
  ReadLink => write!(formatter, "failed to read symbolic link `{}`", path),
  SymlinkMetadata => write!(formatter, "failed to query metadata of symlink `{}`", path),
+ FileExists => write!(formatter, "failed to check file existance `{}`", path),
 
  #[cfg(windows)]
  SeekRead => write!(formatter, "failed to seek and read from `{}`", path),

src/path.rs

@@ -1,3 +1,5 @@
+#[allow(unused_imports)]
+use crate::errors::{Error, ErrorKind};
 use std::fs;
 use std::io;
 use std::path::{Path, PathBuf};
@@ -8,6 +10,9 @@ use std::path::{Path, PathBuf};
 //
 // Because no one else can implement it, we can add methods backwards-compatibly.
 pub trait PathExt: crate::Sealed {
+ /// Wrapper for [`Path::try_exists`](https://doc.rust-lang.org/std/path/struct.Path.html#method.try_exists).
+ #[cfg(feature = "path_try_exists")]
+ fn fs_err_try_exists(&self) -> io::Result<bool>;
  /// Wrapper for [`crate::metadata`].
  fn fs_err_metadata(&self) -> io::Result<fs::Metadata>;
  /// Wrapper for [`crate::symlink_metadata`].
@@ -21,6 +26,12 @@ pub trait PathExt: crate::Sealed {
 }
 
 impl PathExt for Path {
+ #[cfg(feature = "path_try_exists")]
+ fn fs_err_try_exists(&self) -> io::Result<bool> {
+ self.try_exists()
+ .map_err(|source| Error::build(source, ErrorKind::FileExists, self))
+ }
+
  fn fs_err_metadata(&self) -> io::Result<fs::Metadata> {
  crate::metadata(self)
  }