Enum distant_protocol::Request

pub enum Request {
    FileRead {
        path: PathBuf,
    },
    FileReadText {
        path: PathBuf,
    },
    FileWrite {
        path: PathBuf,
        data: Vec<u8>,
    },
    FileWriteText {
        path: PathBuf,
        text: String,
    },
    FileAppend {
        path: PathBuf,
        data: Vec<u8>,
    },
    FileAppendText {
        path: PathBuf,
        text: String,
    },
    DirRead {
        path: PathBuf,
        depth: usize,
        absolute: bool,
        canonicalize: bool,
        include_root: bool,
    },
    DirCreate {
        path: PathBuf,
        all: bool,
    },
    Remove {
        path: PathBuf,
        force: bool,
    },
    Copy {
        src: PathBuf,
        dst: PathBuf,
    },
    Rename {
        src: PathBuf,
        dst: PathBuf,
    },
    Watch {
        path: PathBuf,
        recursive: bool,
        only: Vec<ChangeKind>,
        except: Vec<ChangeKind>,
    },
    Unwatch {
        path: PathBuf,
    },
    Exists {
        path: PathBuf,
    },
    Metadata {
        path: PathBuf,
        canonicalize: bool,
        resolve_file_type: bool,
    },
    SetPermissions {
        path: PathBuf,
        permissions: Permissions,
        options: SetPermissionsOptions,
    },
    Search {
        query: SearchQuery,
    },
    CancelSearch {
        id: SearchId,
    },
    ProcSpawn {
        cmd: Cmd,
        environment: Environment,
        current_dir: Option<PathBuf>,
        pty: Option<PtySize>,
    },
    ProcKill {
        id: ProcessId,
    },
    ProcStdin {
        id: ProcessId,
        data: Vec<u8>,
    },
    ProcResizePty {
        id: ProcessId,
        size: PtySize,
    },
    SystemInfo {},
    Version {},
}

Represents the payload of a request to be performed on the remote machine

Variants

FileRead

Fields

path: PathBuf

The path to the file on the remote machine

Reads a file from the specified path on the remote machine

FileReadText

Fields

path: PathBuf

The path to the file on the remote machine

Reads a file from the specified path on the remote machine and treats the contents as text

FileWrite

Fields

path: PathBuf

The path to the file on the remote machine

data: Vec<u8>

Data for server-side writing of content

Writes a file, creating it if it does not exist, and overwriting any existing content on the remote machine

FileWriteText

Fields

path: PathBuf

The path to the file on the remote machine

text: String

Data for server-side writing of content

Writes a file using text instead of bytes, creating it if it does not exist, and overwriting any existing content on the remote machine

FileAppend

Fields

path: PathBuf

The path to the file on the remote machine

data: Vec<u8>

Data for server-side writing of content

Appends to a file, creating it if it does not exist, on the remote machine

FileAppendText

Fields

path: PathBuf

The path to the file on the remote machine

text: String

Data for server-side writing of content

Appends text to a file, creating it if it does not exist, on the remote machine

DirRead

Fields

path: PathBuf

The path to the directory on the remote machine

depth: usize

Maximum depth to traverse with 0 indicating there is no maximum depth and 1 indicating the most immediate children within the directory

absolute: bool

Whether or not to return absolute or relative paths

canonicalize: bool

Whether or not to canonicalize the resulting paths, meaning returning the canonical, absolute form of a path with all intermediate components normalized and symbolic links resolved

Note that the flag absolute must be true to have absolute paths returned, even if canonicalize is flagged as true

include_root: bool

Whether or not to include the root directory in the retrieved entries

If included, the root directory will also be a canonicalized, absolute path and will not follow any of the other flags

Reads a directory from the specified path on the remote machine

DirCreate

Fields

path: PathBuf

The path to the directory on the remote machine

all: bool

Whether or not to create all parent directories

Creates a directory on the remote machine

Remove

Fields

path: PathBuf

The path to the file or directory on the remote machine

force: bool

Whether or not to remove all contents within directory if is a directory. Does nothing different for files

Removes a file or directory on the remote machine

Copy

Fields

src: PathBuf

The path to the file or directory on the remote machine

dst: PathBuf

New location on the remote machine for copy of file or directory

Copies a file or directory on the remote machine

Rename

Fields

src: PathBuf

The path to the file or directory on the remote machine

dst: PathBuf

New location on the remote machine for the file or directory

Moves/renames a file or directory on the remote machine

Watch

Fields

path: PathBuf

The path to the file, directory, or symlink on the remote machine

recursive: bool

If true, will recursively watch for changes within directories, othewise will only watch for changes immediately within directories

only: Vec<ChangeKind>

Filter to only report back specified changes

except: Vec<ChangeKind>

Filter to report back changes except these specified changes

Watches a path for changes

Unwatch

Fields

path: PathBuf

The path to the file, directory, or symlink on the remote machine

Unwatches a path for changes, meaning no additional changes will be reported

Exists

Fields

path: PathBuf

The path to the file or directory on the remote machine

Checks whether the given path exists

Metadata

Fields

path: PathBuf

The path to the file, directory, or symlink on the remote machine

canonicalize: bool

Whether or not to include a canonicalized version of the path, meaning returning the canonical, absolute form of a path with all intermediate components normalized and symbolic links resolved

resolve_file_type: bool

Whether or not to follow symlinks to determine absolute file type (dir/file)

Retrieves filesystem metadata for the specified path on the remote machine

SetPermissions

Fields

path: PathBuf

The path to the file, directory, or symlink on the remote machine

permissions: Permissions

New permissions to apply to the file, directory, or symlink

options: SetPermissionsOptions

Additional options to supply when setting permissions

Sets permissions on a file, directory, or symlink on the remote machine

Search

Fields

query: SearchQuery

Query to perform against the filesystem

Searches filesystem using the provided query

CancelSearch

Fields

id: SearchId

Id of the search to cancel

Cancels an active search being run against the filesystem

ProcSpawn

Fields

cmd: Cmd

The full command to run including arguments

environment: Environment

Environment to provide to the remote process

current_dir: Option<PathBuf>

Alternative current directory for the remote process

pty: Option<PtySize>

If provided, will spawn process in a pty, otherwise spawns directly

Spawns a new process on the remote machine

ProcKill

Fields

id: ProcessId

Id of the actively-running process

Kills a process running on the remote machine

ProcStdin

Fields

id: ProcessId

Id of the actively-running process to send stdin data

data: Vec<u8>

Data to send to a process’s stdin pipe

Sends additional data to stdin of running process

ProcResizePty

Fields

id: ProcessId

Id of the actively-running process whose pty to resize

size: PtySize

The new pty dimensions

Resize pty of remote process

SystemInfo

Fields

Retrieve information about the server and the system it is on

Version

Fields

Retrieve information about the server’s protocol version

Implementations

impl Request

pub fn is_file_read(&self) -> bool

pub fn is_file_read_text(&self) -> bool

pub fn is_file_write(&self) -> bool

pub fn is_file_write_text(&self) -> bool

pub fn is_file_append(&self) -> bool

pub fn is_file_append_text(&self) -> bool

pub fn is_dir_read(&self) -> bool

pub fn is_dir_create(&self) -> bool

pub fn is_remove(&self) -> bool

pub fn is_copy(&self) -> bool

pub fn is_rename(&self) -> bool

pub fn is_watch(&self) -> bool

pub fn is_unwatch(&self) -> bool

pub fn is_exists(&self) -> bool

pub fn is_metadata(&self) -> bool

pub fn is_set_permissions(&self) -> bool

pub fn is_search(&self) -> bool

pub fn is_cancel_search(&self) -> bool

pub fn is_proc_spawn(&self) -> bool

pub fn is_proc_kill(&self) -> bool

pub fn is_proc_stdin(&self) -> bool

pub fn is_proc_resize_pty(&self) -> bool

pub fn is_system_info(&self) -> bool

pub fn is_version(&self) -> bool

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Request

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq<Request> for Request

fn eq(&self, other: &Request) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Request

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Request

impl StructuralEq for Request

impl StructuralPartialEq for Request