diff --git a/crates/common/src/errors/fs.rs b/crates/common/src/errors/fs.rs index 94506e20e0e8a..964761057bf30 100644 --- a/crates/common/src/errors/fs.rs +++ b/crates/common/src/errors/fs.rs @@ -3,39 +3,36 @@ use std::{ path::{Path, PathBuf}, }; -#[expect(unused_imports)] -use std::fs::{self, File}; - /// Various error variants for `fs` operations that serve as an addition to the io::Error which /// does not provide any information about the path. #[derive(Debug, thiserror::Error)] #[expect(missing_docs)] pub enum FsPathError { - /// Provides additional path context for [`fs::write`]. + /// Provides additional path context for [`std::fs::write`]. #[error("failed to write to {path:?}: {source}")] Write { source: io::Error, path: PathBuf }, - /// Provides additional path context for [`fs::read`]. + /// Provides additional path context for [`std::fs::read`]. #[error("failed to read from {path:?}: {source}")] Read { source: io::Error, path: PathBuf }, - /// Provides additional path context for [`fs::copy`]. + /// Provides additional path context for [`std::fs::copy`]. #[error("failed to copy from {from:?} to {to:?}: {source}")] Copy { source: io::Error, from: PathBuf, to: PathBuf }, - /// Provides additional path context for [`fs::read_link`]. + /// Provides additional path context for [`std::fs::read_link`]. #[error("failed to read from {path:?}: {source}")] ReadLink { source: io::Error, path: PathBuf }, - /// Provides additional path context for [`File::create`]. + /// Provides additional path context for [`std::fs::File::create`]. #[error("failed to create file {path:?}: {source}")] CreateFile { source: io::Error, path: PathBuf }, - /// Provides additional path context for [`fs::remove_file`]. + /// Provides additional path context for [`std::fs::remove_file`]. #[error("failed to remove file {path:?}: {source}")] RemoveFile { source: io::Error, path: PathBuf }, - /// Provides additional path context for [`fs::create_dir`]. + /// Provides additional path context for [`std::fs::create_dir`]. #[error("failed to create dir {path:?}: {source}")] CreateDir { source: io::Error, path: PathBuf }, - /// Provides additional path context for [`fs::remove_dir`]. + /// Provides additional path context for [`std::fs::remove_dir`]. #[error("failed to remove dir {path:?}: {source}")] RemoveDir { source: io::Error, path: PathBuf }, - /// Provides additional path context for [`File::open`]. + /// Provides additional path context for [`std::fs::File::open`]. #[error("failed to open file {path:?}: {source}")] Open { source: io::Error, path: PathBuf }, #[error("failed to lock file {path:?}: {source}")] @@ -51,57 +48,57 @@ pub enum FsPathError { } impl FsPathError { - /// Returns the complementary error variant for [`fs::write`]. + /// Returns the complementary error variant for [`std::fs::write`]. pub fn write(source: io::Error, path: impl Into) -> Self { Self::Write { source, path: path.into() } } - /// Returns the complementary error variant for [`fs::read`]. + /// Returns the complementary error variant for [`std::fs::read`]. pub fn read(source: io::Error, path: impl Into) -> Self { Self::Read { source, path: path.into() } } - /// Returns the complementary error variant for [`fs::copy`]. + /// Returns the complementary error variant for [`std::fs::copy`]. pub fn copy(source: io::Error, from: impl Into, to: impl Into) -> Self { Self::Copy { source, from: from.into(), to: to.into() } } - /// Returns the complementary error variant for [`fs::read_link`]. + /// Returns the complementary error variant for [`std::fs::read_link`]. pub fn read_link(source: io::Error, path: impl Into) -> Self { Self::ReadLink { source, path: path.into() } } - /// Returns the complementary error variant for [`File::create`]. + /// Returns the complementary error variant for [`std::fs::File::create`]. pub fn create_file(source: io::Error, path: impl Into) -> Self { Self::CreateFile { source, path: path.into() } } - /// Returns the complementary error variant for [`fs::remove_file`]. + /// Returns the complementary error variant for [`std::fs::remove_file`]. pub fn remove_file(source: io::Error, path: impl Into) -> Self { Self::RemoveFile { source, path: path.into() } } - /// Returns the complementary error variant for [`fs::create_dir`]. + /// Returns the complementary error variant for [`std::fs::create_dir`]. pub fn create_dir(source: io::Error, path: impl Into) -> Self { Self::CreateDir { source, path: path.into() } } - /// Returns the complementary error variant for [`fs::remove_dir`]. + /// Returns the complementary error variant for [`std::fs::remove_dir`]. pub fn remove_dir(source: io::Error, path: impl Into) -> Self { Self::RemoveDir { source, path: path.into() } } - /// Returns the complementary error variant for [`File::open`]. + /// Returns the complementary error variant for [`std::fs::File::open`]. pub fn open(source: io::Error, path: impl Into) -> Self { Self::Open { source, path: path.into() } } - /// Returns the complementary error variant for [`File::lock`]. + /// Returns the complementary error variant when locking a file. pub fn lock(source: io::Error, path: impl Into) -> Self { Self::Lock { source, path: path.into() } } - /// Returns the complementary error variant for [`File::unlock`]. + /// Returns the complementary error variant when unlocking a file. pub fn unlock(source: io::Error, path: impl Into) -> Self { Self::Unlock { source, path: path.into() } }