Struct OsFileSystem

pub struct OsFileSystem {}

An implementation of FileSystem that interacts with the actual operating system’s file system.

This is primarily a wrapper for fs methods.

Implementations

impl OsFileSystem

pub fn new() -> Self

Trait Implementations

impl Clone for OsFileSystem

fn clone(&self) -> OsFileSystem

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OsFileSystem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OsFileSystem

fn default() -> OsFileSystem

Returns the “default value” for a type.

impl FileSystem for OsFileSystem

type DirEntry = DirEntry

type ReadDir = ReadDir

fn current_dir(&self) -> Result<PathBuf>

Returns the current working directory. This is based on std::env::current_dir.

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

Updates the current working directory. This is based on std::env::set_current_dir.

fn is_dir<P: AsRef<Path>>(&self, path: P) -> bool

Determines whether the path exists and points to a directory.

fn is_file<P: AsRef<Path>>(&self, path: P) -> bool

Determines whether the path exists and points to a file.

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

Creates a new directory. This is based on std::fs::create_dir.

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

Recursively creates a directory and any missing parents. This is based on std::fs::create_dir.

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

Removes an empty directory. This is based on std::fs::remove_dir.

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

Removes a directory and any child files or directories. This is based on std::fs::remove_dir_all.

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

Returns an iterator over the entries in a directory. This is based on std::fs::read_dir.

fn write_file<P, B>(&self, path: P, buf: B) -> Result<()>

where P: AsRef<Path>, B: AsRef<[u8]>,

Writes buf to a new or existing file at buf. This will overwrite any contents that already exist.

fn overwrite_file<P, B>(&self, path: P, buf: B) -> Result<()>

where P: AsRef<Path>, B: AsRef<[u8]>,

Writes buf to an existing file at buf. This will overwrite any contents that already exist.

fn read_file<P: AsRef<Path>>(&self, path: P) -> Result<Vec<u8>>

Returns the contents of path.

fn read_file_into<P, B>(&self, path: P, buf: B) -> Result<usize>

where P: AsRef<Path>, B: AsMut<Vec<u8>>,

Writes the contents of path into the buffer. If successful, returns the number of bytes that were read.

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

Returns the contents of path as a string.

fn create_file<P, B>(&self, path: P, buf: B) -> Result<()>

where P: AsRef<Path>, B: AsRef<[u8]>,

Writes buf to a new file at path.

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

Removes the file at path. This is based on std::fs::remove_file.

fn copy_file<P, Q>(&self, from: P, to: Q) -> Result<()>

where P: AsRef<Path>, Q: AsRef<Path>,

Copies the file at path from to the path to. This is based on std::fs::copy.

fn rename<P, Q>(&self, from: P, to: Q) -> Result<()>

where P: AsRef<Path>, Q: AsRef<Path>,

Renames a file or directory. If both from and to are files, to will be replaced. Based on std::fs::rename.

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

Returns true if path is a readonly file.

fn set_readonly<P: AsRef<Path>>(&self, path: P, readonly: bool) -> Result<()>

Sets or unsets the readonly flag of path.

fn len<P: AsRef<Path>>(&self, path: P) -> u64

Returns the length of the node at the path or 0 if the node does not exist.

impl TempFileSystem for OsFileSystem

type TempDir = OsTempDir

fn temp_dir<S: AsRef<str>>(&self, prefix: S) -> Result<Self::TempDir>

Creates a new temporary directory.

impl UnixFileSystem for OsFileSystem

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

Returns the current mode bits of path.

fn set_mode<P: AsRef<Path>>(&self, path: P, mode: u32) -> Result<()>

Sets the mode bits of path.

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

Creates a new symbolic link on the filesystem.

fn get_symlink_src<P: AsRef<Path>>(&self, dst: P) -> Result<PathBuf>

Gets the source for a symlink.