Struct openssh_sftp_client::fs::Fs

pub struct Fs<'s> { /* private fields */ }

A struct used to perform operations on remote filesystem.

Implementations

impl<'s> Fs<'s>

pub fn sftp(&self) -> &'s Sftp

Return the underlying sftp.

pub fn cwd(&self) -> &Path

Return current working dir.

pub fn set_cwd(&mut self, cwd: impl Into<PathBuf>)

Set current working dir.

• cwd - Can include ~. If it is empty, then it is set to use the default directory set by the remote sftp-server.

impl<'s> Fs<'s>

pub async fn open_dir(
    &mut self,
    path: impl AsRef<Path>
) -> Result<Dir<'_>, Error>

Open a remote dir

pub fn dir_builder(&mut self) -> DirBuilder<'_, 's>

Create a directory builder.

pub async fn create_dir(&mut self, path: impl AsRef<Path>) -> Result<(), Error>

Creates a new, empty directory at the provided path.

pub async fn remove_dir(&mut self, path: impl AsRef<Path>) -> Result<(), Error>

Removes an existing, empty directory.

pub async fn remove_file(&mut self, path: impl AsRef<Path>) -> Result<(), Error>

Removes a file from remote filesystem.

pub async fn canonicalize(
    &mut self,
    path: impl AsRef<Path>
) -> Result<PathBuf, Error>

Returns the canonical, absolute form of a path with all intermediate components normalized and symbolic links resolved.

pub async fn hard_link(
    &mut self,
    src: impl AsRef<Path>,
    dst: impl AsRef<Path>
) -> Result<(), Error>

Creates a new hard link on the remote filesystem.

pub async fn symlink(
    &mut self,
    src: impl AsRef<Path>,
    dst: impl AsRef<Path>
) -> Result<(), Error>

Creates a new symlink on the remote filesystem.

pub async fn rename(
    &mut self,
    from: impl AsRef<Path>,
    to: impl AsRef<Path>
) -> Result<(), Error>

Renames a file or directory to a new name, replacing the original file if to already exists.

This will not work if the new name is on a different mount point.

pub async fn read_link(
    &mut self,
    path: impl AsRef<Path>
) -> Result<PathBuf, Error>

Reads a symbolic link, returning the file that the link points to.

pub async fn set_metadata(
    &mut self,
    path: impl AsRef<Path>,
    metadata: MetaData
) -> Result<(), Error>

Change the metadata of a file or a directory.

pub async fn set_permissions(
    &mut self,
    path: impl AsRef<Path>,
    perm: Permissions
) -> Result<(), Error>

Changes the permissions found on a file or a directory.

pub async fn metadata(
    &mut self,
    path: impl AsRef<Path>
) -> Result<MetaData, Error>

Given a path, queries the file system to get information about a file, directory, etc.

pub async fn symlink_metadata(
    &mut self,
    path: impl AsRef<Path>
) -> Result<MetaData, Error>

Queries the file system metadata for a path.

pub async fn read(&mut self, path: impl AsRef<Path>) -> Result<BytesMut, Error>

Reads the entire contents of a file into a bytes.

pub async fn write(
    &mut self,
    path: impl AsRef<Path>,
    content: impl AsRef<[u8]>
) -> Result<(), Error>

Open/Create a file for writing and write the entire contents into it.

Trait Implementations

impl<'s> Clone for Fs<'s>

fn clone(&self) -> Fs<'s>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'s> Debug for Fs<'s>

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

Formats the value using the given formatter.