Trait DirExt

pub trait DirExt {
    // Required methods
    fn set_atime<P: AsRef<Path>>(
        &self,
        path: P,
        atime: SystemTimeSpec,
    ) -> Result<()>;
    fn set_mtime<P: AsRef<Path>>(
        &self,
        path: P,
        mtime: SystemTimeSpec,
    ) -> Result<()>;
    fn set_times<P: AsRef<Path>>(
        &self,
        path: P,
        atime: Option<SystemTimeSpec>,
        mtime: Option<SystemTimeSpec>,
    ) -> Result<()>;
    fn set_symlink_times<P: AsRef<Path>>(
        &self,
        path: P,
        atime: Option<SystemTimeSpec>,
        mtime: Option<SystemTimeSpec>,
    ) -> Result<()>;
    fn symlink<P: AsRef<Path>, Q: AsRef<Path>>(
        &self,
        src: P,
        dst: Q,
    ) -> Result<()>;
    fn symlink_file<P: AsRef<Path>, Q: AsRef<Path>>(
        &self,
        src: P,
        dst: Q,
    ) -> Result<()>;
    fn symlink_dir<P: AsRef<Path>, Q: AsRef<Path>>(
        &self,
        src: P,
        dst: Q,
    ) -> Result<()>;
    fn open_dir_nofollow<P: AsRef<Path>>(&self, path: P) -> Result<Self>
       where Self: Sized;
    fn remove_file_or_symlink<P: AsRef<Path>>(&self, path: P) -> Result<()>;
    fn access<P: AsRef<Path>>(&self, path: P, type_: AccessType) -> Result<()>;
    fn access_symlink<P: AsRef<Path>>(
        &self,
        path: P,
        type_: AccessType,
    ) -> Result<()>;
    fn set_symlink_permissions<P: AsRef<Path>>(
        &self,
        path: P,
        perm: Permissions,
    ) -> Result<()>;
}

Extension trait for Dir.

Required Methods

fn set_atime<P: AsRef<Path>>( &self, path: P, atime: SystemTimeSpec, ) -> Result<()>

Set the last access time for a file on a filesystem.

This corresponds to filetime::set_file_atime.

fn set_mtime<P: AsRef<Path>>( &self, path: P, mtime: SystemTimeSpec, ) -> Result<()>

Set the last modification time for a file on a filesystem.

This corresponds to filetime::set_file_mtime.

fn set_times<P: AsRef<Path>>( &self, path: P, atime: Option<SystemTimeSpec>, mtime: Option<SystemTimeSpec>, ) -> Result<()>

Set the last access and modification times for a file on a filesystem.

This corresponds to filetime::set_file_times.

fn set_symlink_times<P: AsRef<Path>>( &self, path: P, atime: Option<SystemTimeSpec>, mtime: Option<SystemTimeSpec>, ) -> Result<()>

Set the last access and modification times for a file on a filesystem. This function does not follow symlink.

This corresponds to filetime::set_symlink_file_times.

fn symlink<P: AsRef<Path>, Q: AsRef<Path>>(&self, src: P, dst: Q) -> Result<()>

Creates a new symbolic link on a filesystem.

This corresponds to std::os::unix::fs::symlink, except that it’s supported on non-Unix platforms as well, and it’s not guaranteed to be atomic.

fn symlink_file<P: AsRef<Path>, Q: AsRef<Path>>( &self, src: P, dst: Q, ) -> Result<()>

Creates a new file symbolic link on a filesystem.

This corresponds to std::os::windows::fs::symlink_file, except that it’s supported on non-Windows platforms as well, and it’s not guaranteed to fail if the target is not a file.

fn symlink_dir<P: AsRef<Path>, Q: AsRef<Path>>( &self, src: P, dst: Q, ) -> Result<()>

Creates a new directory symbolic link on a filesystem.

This corresponds to std::os::windows::fs::symlink_dir, except that it’s supported on non-Windows platforms as well, and it’s not guaranteed to fail if the target is not a directory.

fn open_dir_nofollow<P: AsRef<Path>>(&self, path: P) -> Result<Self>

where Self: Sized,

Similar to cap_std::fs::Dir::open_dir, but fails if the path names a symlink.

fn remove_file_or_symlink<P: AsRef<Path>>(&self, path: P) -> Result<()>

Removes a file or symlink from a filesystem.

Removal of symlinks has different behavior under Windows - if a symlink points to a directory, it cannot be removed with the remove_file operation. This method will remove files and all symlinks.

fn access<P: AsRef<Path>>(&self, path: P, type_: AccessType) -> Result<()>

Test for accessibility or existence of a filesystem object.

fn access_symlink<P: AsRef<Path>>( &self, path: P, type_: AccessType, ) -> Result<()>

Test for accessibility or existence of a filesystem object, without following symbolic links.

fn set_symlink_permissions<P: AsRef<Path>>( &self, path: P, perm: Permissions, ) -> Result<()>

Changes the permissions found on a file or a directory, without following symbolic links.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl DirExt for Dir

fn access<P: AsRef<Path>>(&self, path: P, type_: AccessType) -> Result<()>

Test for accessibility or existence of a filesystem object.

fn access_symlink<P: AsRef<Path>>( &self, path: P, type_: AccessType, ) -> Result<()>

Test for accessibility or existence of a filesystem object.

fn set_symlink_permissions<P: AsRef<Path>>( &self, path: P, perm: Permissions, ) -> Result<()>

Changes the permissions found on a file or a directory, without following symbolic links.

fn set_atime<P: AsRef<Path>>( &self, path: P, atime: SystemTimeSpec, ) -> Result<()>

fn set_mtime<P: AsRef<Path>>( &self, path: P, mtime: SystemTimeSpec, ) -> Result<()>

fn set_times<P: AsRef<Path>>( &self, path: P, atime: Option<SystemTimeSpec>, mtime: Option<SystemTimeSpec>, ) -> Result<()>

fn set_symlink_times<P: AsRef<Path>>( &self, path: P, atime: Option<SystemTimeSpec>, mtime: Option<SystemTimeSpec>, ) -> Result<()>

fn symlink<P: AsRef<Path>, Q: AsRef<Path>>(&self, src: P, dst: Q) -> Result<()>

fn symlink_file<P: AsRef<Path>, Q: AsRef<Path>>( &self, src: P, dst: Q, ) -> Result<()>

fn symlink_dir<P: AsRef<Path>, Q: AsRef<Path>>( &self, src: P, dst: Q, ) -> Result<()>

fn open_dir_nofollow<P: AsRef<Path>>(&self, path: P) -> Result<Self>

fn remove_file_or_symlink<P: AsRef<Path>>(&self, path: P) -> Result<()>

Implementors